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

Un administrateur doit ajouter une politique à votre location et aux compartiments à utiliser. Pour obtenir des exemples de politique et des préalables, voir Informations détaillées sur les politiques pour la plate-forme Internet of Things (IoT) et IoT Prerequisites.

Pour la liste des limites de ressources applicables et les instructions de demande d'augmentation de limite, voir Limites des 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, qui est 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 appareils du domaine IoT associé.

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

Notez que les détails de connexion à la base de données sont null. Une fois le groupe de domaines créé, selon l'endroit où vous voulez voir 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 pour 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>"
            }

Facultativement, au cours de ce processus d'utilisation d'un groupe de domaines, vous pouvez 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 à cette opération spécifique. 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 directe à la base de données pour voir les données directement dans la base de données ou si vous voulez connecter vos données pour utiliser Oracle Analytics Cloud, dans le cadre de cette configuration, vous devez ajouter un réseau VCN ou des réseaux en nuage virtuels pour permettre 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 en nuage virtuels à ajouter au groupe de domaines IoT. Pour confirmer que vous disposez d'un accès en lecture au VCN, voir Obtention des détails d'un VCN pour voir les réseaux en nuage 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 politique connexe pour plus de détails, voir Préalables pour IoT.

Utilisez la commande oci iot domain-group configure-data-access pour configurer le VCN ou les réseaux en nuage virtuels auxquels vous voulez autoriser l'accès à la base de données pour le groupe de domaines.

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, voir 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" et si cette réponse est configurée, elle inclut les détails de connexion à la base de données et l'hôte de données pour le 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 domaine à un groupe de domaines IoT.