Szenario: Mit einer IoT-Domain arbeiten

Mit diesem Befehl können Sie die Details für eine IoT-Domain abrufen:

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

Dieses Beispiel zeigt, dass die Domain IoT aktiv ist. Beachten Sie, dass die folgenden Identitätsdomaingruppennamen und Hostparameter der Identitätsdomain null zulassen. Dies ist das erwartete Ergebnis, da die Datenbankverbindungsdetails noch nicht definiert sind. Wenn Sie eine direkte Datenbankverbindung herstellen möchten, müssen Sie im nächsten Schritt den Datenzugriff der Domain IoT auf die Datenbank konfigurieren.

"db-allow-listed-identity-group-names": null,

{
  "data": {
    "compartment-id": "<compartment-OCID>",
    "data-retention-periods-in-days": {
      "historized-data": 30,
      "raw-command-data": 16,
      "raw-data": 16,
      "rejected-data": 16
    },
    "db-allow-listed-identity-group-names": null,
    "db-allowed-identity-domain-host": null,
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "default/user@oracle.com",
        "CreatedOn": "2025-09-08T09:47:17.759Z"
      }
    },
    "description": "<your-description>",
    "device-host": "<domain-short-id>.device.iot.<region>.oci.oraclecloud.com",
    "display-name": "<your-display-name>",
    "freeform-tags": {},
    "id": "<iot-domain-OCID>",
    "iot-domain-group-id": "<iot-domain-group-OCID>",
    "lifecycle-state": "ACTIVE",
    "system-tags": {},
    "time-created": "2025-09-08T09:47:17.987000+00:00",
    "time-updated": "2025-09-08T09:49:23.223000+00:00"
  },
  "etag": "<unique-id>"
}

Wenn Sie optional Ihre IoT-Daten direkt in der Datenbank anzeigen oder eine Datenbankverbindung konfigurieren möchten, um Ihre Daten in Oracle Analytics Cloud oder direkt in der Datenbank anzuzeigen, konfigurieren Sie mit dem Befehl oci iot domain configure-direct-data-access die Authentifizierung einer IoT-Domain für den Zugriff auf die Datenbank mit der oder den während der Konfiguration eingerichteten Identitätsdomaingruppen.

Geben Sie für den Parameter <identity-domain-name> eine der folgenden Optionen ein: <identity-group-name> ist entweder die Identitätsgruppe oder eine dynamische Identitätsgruppe:

• Wenn die <identity-group-name> in der Standardidentitätsdomain enthalten ist, verwenden Sie dieses Format:

  <tenancy-OCID:<identity-group-name>

• Wenn sich die <identity-group-name> nicht in der Standardidentitätsdomain befindet, geben Sie mit diesem Format den Identitätsdomainnamen für die Identitätsdomaingruppe oder die dynamische Identitätsdomaingruppe an:

  <tenancy-OCID>:<identity-domain-name>/<identity-group-name>

oci iot domain configure-direct-data-access --iot-domain-id <iot-domain-OCID> --db-allow-listed-identity-group-names '["<tenancy-OCID>:<identity-group-name>"]'

Dieses Beispiel zeigt mehrere dynamische Identitätsgruppen, die sich nicht in der Standardidentitätsdomain befinden und für die Anmeldung bei der Datenbank konfiguriert sind. Verwenden Sie dieses Format, wenn eine Anwendung oder ein Benutzer in einem VCN mit konfigurierten dynamischen Gruppen ausgeführt wird:

oci iot domain configure-direct-data-access --iot-domain-id <iot-domain-OCID> --db-allow-listed-identity-group-names '["<tenancy-OCID>:<identity-domain-name>/<identity-group-name>", "<tenancy-OCID>:<identity-domain-name>/<identity-group-name>"]'

Eine vollständige Liste der Schritte zum Konfigurieren einer direkten Verbindung zur Datenbank finden Sie unter Szenario: Direkte Verbindung zur IoT-Datenbank herstellen. Eine vollständige Liste der Schritte zum Konfigurieren des Zugriffs zum Anzeigen der IoT-Daten in Oracle Analytics Cloud finden Sie unter Szenario: Verbindung der IoT-Daten mit Analytics Cloud herstellen.

Wenn Sie die Daten-API IoT verwenden oder Ihre Daten in Oracle REST Data Services (ORDS) anzeigen möchten, müssen Sie die Verbindung zu ORDS konfigurieren.

Verwenden Sie als Teil der Konfiguration den Befehl oci iot domain configure-ords-data-access, um den Zugriff auf den Identitätsdomainhost zu konfigurieren.

Ersetzen Sie idcs-<idcs-id>.identity.oraclecloud.com durch den Identitätsdomainhost und die OCID der IoT-Domain für Ihre Umgebung:

oci iot domain configure-ords-data-access --iot-domain-id <iot-domain-OCID> --db-allowed-identity-domain-host <idcs-unique-id.identity.oraclecloud.com>

Eine vollständige Liste der Schritte zum Konfigurieren des Zugriffs zum Anzeigen Ihrer Daten in ORDS finden Sie unter Szenario: Verbindung von IoT-Daten mit Oracle REST Data Services (ORDS).

Wenn Sie die Daten-API IoT verwenden oder Ihre Daten in Oracle Application Express (APEX) anzeigen möchten, müssen Sie die Verbindung zu APEX konfigurieren abschließen.

oci iot domain configure-apex-data-access --db-workspace-admin-initial-password "<your-initial-apex-password>" --iot-domain-id <iot-domain-OCID>

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

Diese Beispielantwort enthält die Datenbankverbindungsdetails, die jetzt für die Domain IoT definiert sind:

{
  "compartment-id": "<compartment-OCID>",
  "data-retention-periods-in-days": {
    "historized-data": 30,
    "raw-command-data": 16,
    "raw-data": 16,
    "rejected-data": 16
  },
  "db-allow-listed-identity-group-names": [
      "<tenancy-OCID>:<identity-domain-name>/<identity-group-name>"
    ],
  "db-allowed-identity-domain-host": "<idcs-unique-id.identity.oraclecloud.com>",
  "defined-tags": {
    "Oracle-Tags": {
      "CreatedBy": "default/user@oracle.com",
      "CreatedOn": "2025-08-05T18:02:51.633Z"
    }
  },
  "description": "<your-description>",
  "device-host": "<domain-short-id>.device.iot.<region>.oci.oraclecloud.com",
  "display-name": "<your-display-name>",
  "freeform-tags": {},
  "id": "<iot-domain-OCID>",
  "iot-domain-group-id": "<iot-domain-group-OCID>",
  "lifecycle-state": "ACTIVE",
  "system-tags": {},
  "time-created": "2025-08-05T18:02:53.418000+00:00",
  "time-updated": "2025-08-05T18:04:42.585000+00:00"
}