Scénario : envoyer des données non structurées à l'aide de HTTP

Utilisez la commande oci iot domain-group create et les paramètres requis <compartment-OCID> et <domain-group-name> pour créer un groupe de domaines IoT dans un compartiment spécifique. Remplacez <compartment-OCID> par l'OCID du compartiment dans lequel vous souhaitez créer le groupe de domaines. Remplacez <domain-group-name> par votre nom de groupe de domaines et éventuellement remplacez <your-sample-description> par une description :

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

La création d'un groupe de domaines IoT peut prendre quelques minutes. Cet exemple de réponse montre que le groupe de domaines est en train de créer et utilise cette URL d'hôte de données :

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

domain group short 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>"
}
        

Utilisez la commande oci iot domain create et les paramètres <domain-group-OCID> et <compartment-OCID> requis pour créer un domaine Internet of Things. Remplacez <domain-group-OCID> par l'OCID du groupe de domaines à associer à ce domaine IoT. Remplacez <your-sample-description> par une description du domaine IoT.

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>

La création d'un domaine peut prendre quelques minutes. Dans cet exemple de réponse, vous voyez l'URL device host avec l'domain short id :

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

ID abrégé du domaine : 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>"
}

Utilisez la commande oci iot digital-twin-instance create et le paramètre <iot-domain-OCID>requis pour créer une instance de jumeau numérique pour un domaine IoT associé. Lorsque vous créez une instance de jumeau numérique requiert un ID d'authentification. Utilisez un certificat ou une clé secrète. Reportez-vous à Création d'une clé secrète.

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>"
}

Envoyez des données à l'aide de l'URL de l'hôte de périphérique de l'étape précédente.

Vous pouvez envoyer autant de données que vous le souhaitez. Cet exemple illustre l'envoi de 2 messages de données en texte brut. Le premier exemple montre la commande utilisant les valeurs de ce scénario. La deuxième commande affiche les noms de valeur. Pour plus d'informations, reportez-vous à Utilisation de cURL.

Remplacez <domain-short-id> et <region> par les valeurs de votre environnement :

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"

Pour afficher vos données dans APEX, vous devez configurer l'accès afin de visualiser vos données IoT dans APEX. Une étape de ce processus utilise la commande suivante pour ajouter le mot de passe APEX au domaine IoT afin qu'il puisse accéder à APEX.

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

Exemple de réponse :

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

1. Utilisez l'ID abrégé de domaine provenant de l'hôte de périphérique pour vous connecter à APEX :

   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

   Connectez-vous à APEX à l'aide des éléments suivants :

   • Base de données : <domain-short-id-from-device-host>__WKSP
   • Nom d'utilisateur :<domain-short-id-from-device-host>__WKSP
   • Mot de passe initial défini lorsque vous avez utilisé la commande d'interface de ligne de commande pour configurer l'accès aux données d'un domaine IoT pour APEX : <initial-apex-password>

   Remarque
   
   Utilisez uniquement des lettres majuscules pour <domain-short-id-from-device-host> et notez les deux traits de soulignement : __WKSP
2. Pour interroger les données IoT, sélectionnez le schéma <domain-short-id-from-device-host>__IOT. Sélectionnez SQL Workshop, puis Object Browser (Navigateur d'objet).

   URL de SQL Workshop :

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

3. Interrogez les données IoT en entrant et en exécutant une commande SQL. Confirmez que vous avez sélectionné le schéma approprié pour la table de base de données à interroger, exécutez la commande suivante :

   select * from RAW_DATA

   Désormais, vous pouvez voir les vues de base de données, les schémas et les données brutes de votre appareil connecté à Internet of Things.

   Pour afficher une capture d'écran plus grande, cliquez avec le bouton droit de la souris et ouvrez l'image dans une nouvelle fenêtre du navigateur.