Scénario : utilisation d'un groupe de domaines IoT

Un administrateur doit ajouter une stratégie à votre location et aux compartiments à utiliser. Pour obtenir des exemples de stratégie et des prérequis, reportez-vous à Détails de stratégie pour la plate-forme Internet of Things (IoT) et à Prérequis IoT.

Pour obtenir la liste des limites de ressources applicables et des instructions de demande d'augmentation de limite, reportez-vous à Limites relatives aux ressources Internet of Things.

Vous devez configurer un groupe de domaines avant de créer un domaine. Chaque groupe de domaines IoT utilise une instance de base de données dédiée, partagée par tous les domaines IoT associés au groupe de domaines IoT.

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

L'exemple de réponse montre que le groupe de domaines est en cours de création et contient l'URL de l'hôte de données avec un ID abrégé de groupe de domaines. Utilisez l'URL de l'hôte de données pour accéder aux métadonnées et aux données associées à un groupe de domaines IoT spécifique qui contient tous les périphériques pour le domaine IoT associé.

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

Les détails de connexion à la base de données sont null. Une fois le groupe de domaines créé, en fonction de l'endroit où vous souhaitez visualiser vos données, vous devez configurer l'accès aux données du domaine IoT associé pour ajouter les détails d'authentification du domaine IoT afin de vous connecter à un autre système.

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

Au cours de ce processus d'utilisation d'un groupe de domaines, vous pouvez éventuellement surveiller la demande de travail de chaque opération pour vérifier si elle a réussi avant de passer à l'opération suivante. Vous pouvez utiliser des demandes de travail pour vérifier les journaux ou les messages d'erreur.

Utilisez "opc-work-request-id": "<work-request-OCID>" à partir de n'importe quelle opération pour obtenir la demande de travail associée pour cette opération spécifique. Par exemple :

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

Cet exemple de réponse montre que le VCN n'est pas configuré pour le groupe de domaines IoT :

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

Une fois qu'un groupe de domaines IoT est actif, si vous voulez établir une connexion de base de données directe pour afficher les données directement dans la base de données ou si vous voulez connecter vos données pour utiliser Oracle Analytics Cloud, vous devez ajouter un VCN ou des réseaux cloud virtuels dans le cadre de cette configuration afin d'autoriser l'accès aux données IoT pour ce groupe de domaines.

Pour effectuer les étapes suivantes, votre utilisateur doit disposer au moins d'un accès en lecture au VCN ou aux réseaux cloud virtuels à ajouter au groupe de domaines IoT. Pour vérifier si vous disposez d'un accès en lecture au VCN, reportez-vous à Obtention des détails d'un VCN pour visualiser les réseaux cloud virtuels auxquels vous avez accès. Si vous ne disposez pas d'un accès en lecture pour le VCN, demandez à un administrateur d'ajouter la stratégie associée pour plus de détails, reportez-vous à Prérequis IoT.

Use the oci iot domain-group configure-data-access command to configure the VCN or VCNs that you want to allow access to the database for the domain group.

Remplacez ["vcn-OCID-1","vcn-OCID-2"] par les OCID de VCN configurés pour votre environnement. Remplacez <domain-group-OCID> par l'OCID du groupe de domaines avec lequel vous voulez travailler :

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>

Pour plus d'informations, reportez-vous à Configuration de l'accès aux données pour un groupe de domaines IoT.

Lorsque vous utilisez un groupe de domaines IoT, vous pouvez utiliser cette commande pour obtenir les détails du groupe de domaines. Dans la réponse, vous pouvez vérifier les détails de connexion à la base de données pour ce groupe de domaines IoT. Remplacez <iot-domain-group-OCID> par l'OCID du groupe de domaines IoT spécifique :

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

Cet exemple de réponse montre que le groupe de domaines est actif, "lifecycleState": "ACTIVE". Si elle est configurée, cette réponse inclut les détails de connexion à la base de données et l'hôte de données du groupe de domaines :

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

Ensuite, créez un domaine IoT et associez-le à un groupe de domaines IoT.