Szenario: Unstrukturierte Daten mit HTTPs senden

Verwenden Sie den Befehl oci iot domain-group create und die erforderlichen Parameter <compartment-OCID> und <domain-group-name>, um eine Domaingruppe IoT in einem bestimmten Compartment zu erstellen. Ersetzen Sie die <compartment-OCID> durch die OCID des Compartments, in dem Sie die Domaingruppe erstellen möchten. Ersetzen Sie <domain-group-name> durch Ihren Domaingruppennamen, und ersetzen Sie optional <your-sample-description> durch eine Beschreibung:

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

Das Erstellen einer IoT-Domaingruppe kann einige Minuten dauern. Diese Beispielantwort zeigt, dass die Domaingruppe diese Datenhost-URL erstellt und verwendet:

wtmn2xs4ifkba.data.iot.us-phoenix-1.oci.oraclecloud.com

Domaingruppen-Kurz-ID: wtmn2xs4ifkba

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

{
  "data": {
    "compartment-id": "<compartment-OCID>",
    "data-host": "wtmn2xs4ifkba.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-14T16:43:02.950Z"
      }
    },
    "description": "<your-domain-group-description>",
    "display-name": "<your-domain-group-name>",
    "freeform-tags": {},
    "id": "<domain-group-OCID>",
    "lifecycle-state": "CREATING",
    "system-tags": {},
    "time-created": "2025-08-14T16:43:03.307000+00:00",
    "time-updated": "2025-08-14T16:43:03.307000+00:00"
  },
  "etag": "<unique-id>",
  "opc-work-request-id": "<work-request-OCID>"
}
        

Verwenden Sie den Befehl oci iot domain create und die erforderlichen Parameter <domain-group-OCID> und <compartment-OCID>, um eine Internet of Things-Domain zu erstellen. Ersetzen Sie <domain-group-OCID> durch die OCID für die Domaingruppe, die Sie mit dieser IoT-Domain verknüpfen möchten. Ersetzen Sie <your-sample-description> durch eine Beschreibung für Ihre IoT-Domain.

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

Das Erstellen einer Domain kann einige Minuten dauern. In dieser Beispielantwort wird die URL für den Gerätehost mit der Domain-Kurz-ID angezeigt:

"device-host": "cuay2mrhlgrrg.device.iot.<region>.oci.oraclecloud.com"

Domain-Kurz-ID: cuay2mrhlgrrg

"device-host": "<domain-short-id>.device.iot.<region>.oci.oraclecloud.com"

{
  "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-08-14T16:57:03.140Z"
      }
    },
    "description": "<your-iot-domain-description>",
    "device-host": "cuay2mrhlgrrg.device.iot.<region>.oci.oraclecloud.com",
    "display-name": "<your-iot-domain-name>",
    "freeform-tags": {},
    "id": "<iot-domain-OCID>",
    "iot-domain-group-id": "<iot-domain-group-OCID>",
    "lifecycle-state": "CREATING",
    "system-tags": {},
    "time-created": "2025-08-14T16:57:03.384000+00:00",
    "time-updated": "2025-08-14T16:57:03.384000+00:00"
  },
  "etag": "<unique-id>",
  "opc-work-request-id": "<work-request-OCID>"
}

Verwenden Sie den Befehl oci iot digital-twin-instance create und den erforderlichen Parameter <iot-domain-OCID>, um eine digitale Zwillingsinstanz für eine verknüpfte IoT-Domain zu erstellen. Wenn Sie eine digitale Zwillingsinstanz erstellen, ist eine Authentifizierungs-ID erforderlich. Verwenden Sie ein Zertifikat oder ein Secret. Informationen hierzu finden Sie unter Secret erstellen.

oci iot digital-twin-instance create --iot-domain-id <iot-domain-OCID> --auth-id <vault-secret-OCID> --display-name <display-name>

{
  "data": {
    "auth-id": "<vault-secret-OCID>",
    "defined-tags": {
      "Oracle-Tags": {
        "CreatedBy": "default/user@oracle.com",
        "CreatedOn": "2025-08-14T06:12:43.393Z"
      }
    },
    "description": null,
    "digital-twin-adapter-id": "<iot-digital-twin-adapter-OCID>",
    "digital-twin-model-id": "<iot-digital-twin-model-OCID>",
    "digital-twin-model-spec-uri": "dtmi:com:oracle:example:core:Space:sp;1",
    "display-name": "device for conference room 103",
    "external-key": "<unique-id>",
    "freeform-tags": {},
    "id": "<iot-digital-twin-instance-OCID>",
    "iot-domain-id": "<iot-domain-OCID>",
    "lifecycle-state": "ACTIVE",
    "system-tags": {},
    "time-created": "2025-09-11T06:12:44.178000+00:00",
    "time-updated": "2025-09-11T06:12:44.178000+00:00"
  },
  "etag": "<unique-id>"
}

Senden Sie Daten mit der URL des Gerätehosts aus dem vorherigen Schritt.

Sie können so viele Daten senden, wie Sie senden möchten. Dieses Beispiel zeigt das Senden von 2 Nur-Text-Datennachrichten. Das erste Beispiel zeigt den Befehl, der Werte aus diesem Szenario verwendet. Der zweite Befehl zeigt die Wertnamen an. Weitere Informationen finden Sie unter cURL verwenden.

Ersetzen Sie <domain-short-id> und <region> durch die Werte für Ihre Umgebung:

https://<domain-short-id>.device.iot.<region>.oci.oraclecloud.com/sampletopic

curl -u '9K7F8Y3HJGX1FA1GFG9QVV9E2C<vault-secret-OCID>' https://<domain-short-id>.device.iot.us-phoenix-1.oci.oraclecloud.com/sampletopic -H 'Content-Type: plain-text' -d "sample data 2"

curl -u '<external-key>:<vault-secret-OCID>' https://<domain-short-id>.device.iot.<region>.oci.oraclecloud.com/sampletopic -H 'Content-Type: plain-text' -d "sample data 1"

Um Ihre Daten in APEX anzuzeigen, müssen Sie den Zugriff zum Anzeigen Ihrer IoT-Daten in APEX konfigurieren. In einem Schritt in diesem Prozess wird der folgende Befehl verwendet, um das APEX-Kennwort zur IoT-Domain hinzuzufügen, damit sie auf APEX zugreifen kann.

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

Beispielantwort:

{
  "opc-work-request-id": "<work-request-OCID>"
}

1. Melden Sie sich mit der Domain-Kurz-ID, die vom Gerätehost stammt, bei APEX an:

   https://<domain-group-short-id-from-data-host>.data.iot.<region>.oci.oraclecloud.com/ords/r/apex

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

   Melden Sie sich unter APEX an:

   • Datenbank: <domain-short-id-from-device-host>__WKSP
   • Benutzername:<domain-short-id-from-device-host>__WKSP
   • Anfängliches Kennwort, das festgelegt wird, wenn Sie den CLI-Befehl verwendet haben, um den Datenzugriff einer IoT-Domain für APEX zu konfigurieren: <initial-apex-password>

   Hinweis
   
   Verwenden Sie nur Großbuchstaben für die <domain-short-id-from-device-host>, und beachten Sie die beiden Unterstriche: __WKSP
2. Um die IoT-Daten abzufragen, wählen Sie das Schema <domain-short-id-from-device-host>__IOT aus. Wählen Sie SQL Workshop und dann Object Browser aus.

   SQL Workshop-URL:

   https://<domain-group-short-id-from-data-host>.data.iot.<region>.oci.oraclecloud.com/ords/r/apex/sql-workshop

3. Fragen Sie IoT-Daten ab, indem Sie einen SQL-Befehl eingeben und ausführen. Bestätigen Sie, dass Sie das richtige Schema für die Datenbanktabelle ausgewählt haben, die Sie abfragen möchten, und führen Sie den folgenden Befehl aus:

   select * from RAW_DATA

   Jetzt können Sie die Datenbankansichten, Schemas und Rohdaten für Ihr verbundenes Internet of Things-Gerät anzeigen.

   Um einen größeren Screenshot anzuzeigen, klicken Sie mit der rechten Maustaste und öffnen Sie das Bild in einem neuen Browserfenster.