Szenario: Mit einer IoT-Domaingruppe arbeiten

Ein Administrator muss Ihrem Mandanten und den Compartments, die Sie verwenden möchten, eine Policy hinzufügen. Policy-Beispiele und -Voraussetzungen finden Sie unter Policy-Details für die Internet of Things-(IoT-)Plattform und IoT-Voraussetzungen.

Eine Liste der anwendbaren Ressourcenlimits und Anweisungen zum Anfordern einer Limiterhöhung finden Sie unter Limits für Internet of Things-Ressourcen.

Sie müssen eine Domaingruppe einrichten, bevor Sie eine Domain erstellen. Jede Domaingruppe IoT verwendet eine dedizierte Datenbankinstanz, die von allen IoT-Domains gemeinsam verwendet wird, die mit der Domaingruppe IoT verknüpft sind.

oci iot domain-group create --compartment-id <compartment-OCID> --display-name <your-iot-domain-group-name>

Die Beispielantwort zeigt, wie die Domaingruppe erstellt wird, und enthält die Datenhost-URL mit einer Domaingruppen-Kurz-ID. Verwenden Sie die Datenhost-URL, um auf Ihre Metadaten und Daten zuzugreifen, die mit einer bestimmten IoT-Domaingruppe verknüpft sind, die alle Geräte für die verknüpfte IoT-Domain enthält.

data-host:<domain-group-short-id>.data.iot.<region>.oci.oraclecloud.com

Beachten Sie, dass die Datenbankverbindungsdetails null sind. Nachdem die Domaingruppe erstellt wurde, müssen Sie, je nachdem, wo Sie Ihre Daten anzeigen möchten, den Datenzugriff der zugehörigen IoT-Domain konfigurieren, um die Authentifizierungsdetails für die IoT-Domain hinzuzufügen, um eine Verbindung zu einem anderen System herzustellen.

{
  "data": {
    "compartment-id": "<compartment-OCID>",
    "data-host": "<domain-group-short-id>.data-iot.<region>.oci.oraclecloud.com,
    "db-allow-listed-vcn-ids": null,
    "db-connection-string": null,
    "db-token-scope": null,
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "default/user@oracle.com",
        "CreatedOn": "2025-08-05T18:15:41.260Z"
      }
    },
    "description": null,
    "display-name": "<your-iot-domain-group-name>",
    "freeform-tags": {},
    "id": "<domain-group-OCID>",
    "lifecycle-state": "CREATING",
    "system-tags": {},
    "time-created": "2025-08-05T18:15:43.054000+00:00",
    "time-updated": "2025-08-05T18:15:43.054000+00:00"
  },
  "etag": "<unique-id>",
  "opc-work-request-id": "<work-request-OCID>"
            }

Optional können Sie während dieses Arbeitsprozesses mit einer Domaingruppe die Arbeitsanforderung jedes Vorgangs überwachen, um zu bestätigen, ob er erfolgreich war, bevor Sie mit dem nächsten Vorgang fortfahren. Mit Arbeitsanforderungen können Sie Logs oder Fehlermeldungen prüfen.

Verwenden Sie die "opc-work-request-id": "<work-request-OCID>" aus einem beliebigen Vorgang, um die zugehörige Arbeitsanforderung für diesen bestimmten Vorgang abzurufen. Beispiel:

oci iot domain-group get --iot-domain-group-id <iot-domain-group-OCID>

Diese Beispielantwort zeigt, dass das VCN nicht für die Domaingruppe IoT konfiguriert ist:

{
  "data": {
    "compartment-id": "<compartment-OCID>",
    "data-host": "<domain-group-short-id>.data.iot.us-phoenix-1.oci.oraclecloud.com",
    "db-allow-listed-vcn-ids": null,
    "db-connection-string": null,
    "db-token-scope": null,
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "default/user@oracle.com",
        "CreatedOn": "2025-09-08T09:29:22.092Z"
      }
    },
    "description": null,
    "display-name": "Demo Domain Group",
    "freeform-tags": {},
    "id": "<iot-domain-group-OCID>",
    "lifecycle-state": "ACTIVE",
    "system-tags": {},
    "time-created": "2025-09-08T09:29:22.449000+00:00",
    "time-updated": "2025-09-08T09:38:01.413000+00:00"
  },
  "etag": "<unique-id>"
}

Wenn Sie eine direkte Datenbankverbindung herstellen möchten, um die Daten direkt in der Datenbank anzuzeigen, nachdem eine Domaingruppe IoT aktiv ist, oder wenn Sie die Daten mit Oracle Analytics Cloud verbinden möchten, müssen Sie als Teil dieser Konfiguration ein VCN oder VCNs hinzufügen, um Zugriff auf IoT-Daten für diese Domaingruppe zu ermöglichen.

Um die folgenden Schritte auszuführen, muss Ihr Benutzer mindestens Lesezugriff auf das VCN oder die VCNs haben, die Sie der Domaingruppe IoT hinzufügen möchten. Informationen zur Bestätigung, ob Sie Lesezugriff auf das VCN haben, finden Sie unter Details eines VCN abrufen, um die VCNs anzuzeigen, auf die Sie Zugriff haben. Wenn Sie keinen Lesezugriff für das VCN haben, bitten Sie einen Administrator, die zugehörige Policy für Details hinzuzufügen, siehe IoT-Voraussetzungen.

Verwenden Sie den Befehl oci iot domain-group configure-data-access, um das VCN oder die VCNs zu konfigurieren, die den Zugriff auf die Datenbank für die Domaingruppe zulassen sollen.

Ersetzen Sie ["vcn-OCID-1","vcn-OCID-2"] durch die für Ihre Umgebung konfigurierten VCN-OCIDs. Ersetzen Sie <domain-group-OCID> durch die OCID der Domaingruppe, mit der Sie arbeiten möchten:

oci iot domain-group configure-data-access --db-allow-listed-vcn-ids '["vcn-OCID-1","vcn-OCID-2"]' --iot-domain-group-id <domain-group-OCID>

Weitere Informationen finden Sie unter Datenzugriff für eine IoT-Domaingruppe konfigurieren.

Wenn Sie mit einer Domaingruppe IoT arbeiten, können Sie mit diesem Befehl die Details der Domaingruppe abrufen. In der Antwort können Sie die Datenbankverbindungsdetails prüfen, die für diese Domaingruppe IoT definiert sind. Ersetzen Sie <iot-domain-group-OCID> durch die OCID für die spezifische IoT-Domaingruppe:

oci iot iot-domain-group get --iot-domain-group-id <iot-domain-group-OCID>

Diese Beispielantwort zeigt, dass die Domaingruppe aktiv ist ("lifecycleState": "ACTIVE"). Wenn diese Antwort konfiguriert ist, enthält sie die Datenbankverbindungsdetails und den Datenhost für die Domaingruppe:

db-allow-listed-vcn-ids

db-connection-string

db-token-scope

{
  "data": {
    "compartment-id": "<compartment-OCID>",
    "data-host": "<domain-group-short-id>.iot-data.<region>.oci.oraclecloud.com",
    "db-allow-listed-vcn-ids": [
      "<vcn-OCID>"
    ],
    "db-connection-string": "tcps:adb.<region>.oraclecloud.com:1521/<unique-id>.adb.oraclecloud.com?retry_count=20&retry_delay=3",
    "db-token-scope": "urn:oracle:db::id::ocid1.<database-compartment-OCID>",
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "default/user@oracle.com",
        "CreatedOn": "2025-08-11T19:21:24.791Z"
      }
    },
    "description": "<your-domain-group-description>",
    "display-name": "<your-domain-group-name>",
    "freeform-tags": {},
    "id": "<iot-domain-group-OCID>",
    "lifecycle-state": "ACTIVE",
    "system-tags": {},
    "time-created": "2025-08-11T19:21:26.411000+00:00",
    "time-updated": "2025-08-12T02:17:02.763000+00:00"
  },
  "etag": "<unique-id>"
          }

Als Nächstes erstellen Sie eine IoT-Domain, und verknüpfen Sie die Domain mit einer IoT-Domaingruppe.