Scénario : Envoi de 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 voulez créer le groupe de domaines. Remplacez <domain-group-name> par le nom de votre 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 cours de création et utilise cette URL d'hôte de données :

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

ID abrégé du groupe de domaines : 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 de votre 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 de l'hôte de l'appareil avec l'ID court de domaine :

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

ID abrégé de 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, elle nécessite un ID authentification. Utilisez un certificat ou une clé secrète, voir 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>"
}

Envoyer des données à l'aide de l'URL de l'hôte de l'appareil à l'étape précédente.

Vous pouvez envoyer autant de données que vous le souhaitez. Cet exemple montre 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, voir 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 voir vos données dans APEX, vous devez configurer l'accès pour voir 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 court de domaine provenant de l'hôte de l'appareil 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

   Dans APEX, connectez-vous à l'aide de :

   • 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>

   Note
   
   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 Atelier SQL, puis Navigateur d'objets.

   URL de l'atelier SQL :

   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

   Vous pouvez maintenant 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.