Scénario : Utilisation d'un domaine IoT

Utilisez cette commande pour obtenir les détails d'un domaine IoT :

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

Cet exemple montre que le domaine IoT est actif. Notez que les noms de groupe de domaines d'identité suivants et les paramètres d'autorisation d'hôte de domaine d'identité sont null. Il s'agit du résultat attendu, car les détails de connexion à la base de données ne sont pas encore définis. Si vous voulez établir une connexion directe à la base de données, vous devez configurer l'accès aux données du domaine IoT à la base de données à l'étape suivante.

"db-allow-listed-identity-group-names": null,

{
  "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-09-08T09:47:17.759Z"
      }
    },
    "description": "<your-description>",
    "device-host": "<domain-short-id>.device.iot.<region>.oci.oraclecloud.com",
    "display-name": "<your-display-name>",
    "freeform-tags": {},
    "id": "<iot-domain-OCID>",
    "iot-domain-group-id": "<iot-domain-group-OCID>",
    "lifecycle-state": "ACTIVE",
    "system-tags": {},
    "time-created": "2025-09-08T09:47:17.987000+00:00",
    "time-updated": "2025-09-08T09:49:23.223000+00:00"
  },
  "etag": "<unique-id>"
}

Facultativement, si vous voulez voir vos données IoT directement dans la base de données ou si vous voulez configurer une connexion à la base de données pour voir vos données dans Oracle Analytics Cloud ou directement dans la base de données, utilisez la commande oci iot domain configure-direct-data-access pour configurer l'authentification d'un domaine IoT pour accéder à la base de données à l'aide du groupe ou des groupes de domaines d'identité configurés pendant la configuration.

Pour le paramètre <identity-domain-name>, entrez l'une des options suivantes : <identity-group-name> est le groupe d'identités ou un groupe dynamique d'identités :

• Si <identity-group-name> se trouve dans le domaine d'identité par défaut, utilisez le format suivant :

  <tenancy-OCID:<identity-group-name>

• Si <identity-group-name> n'est pas dans le domaine d'identité par défaut, utilisez ce format pour spécifier le nom du domaine d'identité pour le groupe de domaines d'identité ou le groupe dynamique du domaine d'identité :

  <tenancy-OCID>:<identity-domain-name>/<identity-group-name>

oci iot domain configure-direct-data-access --iot-domain-id <iot-domain-OCID> --db-allow-listed-identity-group-names '["<tenancy-OCID>:<identity-group-name>"]'

Cet exemple présente plusieurs groupes dynamiques d'identité qui ne figurent pas dans le domaine d'identité par défaut et qui sont configurés et autorisés à se connecter à la base de données. Utilisez ce format si une application ou un utilisateur s'exécute sur un VCN avec des groupes dynamiques configurés :

oci iot domain configure-direct-data-access --iot-domain-id <iot-domain-OCID> --db-allow-listed-identity-group-names '["<tenancy-OCID>:<identity-domain-name>/<identity-group-name>", "<tenancy-OCID>:<identity-domain-name>/<identity-group-name>"]'

Pour obtenir la liste complète des étapes de configuration d'une connexion directe à la base de données, voir Scénario : Connexion directe à la base de données IoT ou pour obtenir la liste complète des étapes de configuration de l'accès pour voir vos données IoT dans Oracle Analytics Cloud. Voir Scénario : Connexion de vos données IoT à Analytics Cloud.

Si vous voulez utiliser l'API de données IoT ou voir vos données dans Oracle REST Data Services (ORDS), vous devez effectuer la configuration d'une connexion à ORDS.

Dans le cadre de la configuration, utilisez la commande oci iot domain configure-ords-data-access pour configurer l'accès à l'hôte du domaine d'identité.

Remplacez idcs-<idcs-id>.identity.oraclecloud.com par l'hôte du domaine d'identité et l'OCID du domaine IoT pour votre environnement :

oci iot domain configure-ords-data-access --iot-domain-id <iot-domain-OCID> --db-allowed-identity-domain-host <idcs-unique-id.identity.oraclecloud.com>

Pour obtenir la liste complète des étapes de configuration de l'accès pour voir vos données dans ORDS, voir Scénario : Connexion des données IoT à Oracle REST Data Services (ORDS).

Si vous voulez utiliser l'API de données IoT ou voir vos données dans Oracle Application Express (APEX), vous devez effectuer la configuration d'une connexion à APEX.

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

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

Cet exemple de réponse inclut les détails de connexion à la base de données qui sont maintenant définis pour le domaine IoT :

{
  "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": [
      "<tenancy-OCID>:<identity-domain-name>/<identity-group-name>"
    ],
  "db-allowed-identity-domain-host": "<idcs-unique-id.identity.oraclecloud.com>",
  "defined-tags": {
    "Oracle-Tags": {
      "CreatedBy": "default/user@oracle.com",
      "CreatedOn": "2025-08-05T18:02:51.633Z"
    }
  },
  "description": "<your-description>",
  "device-host": "<domain-short-id>.device.iot.<region>.oci.oraclecloud.com",
  "display-name": "<your-display-name>",
  "freeform-tags": {},
  "id": "<iot-domain-OCID>",
  "iot-domain-group-id": "<iot-domain-group-OCID>",
  "lifecycle-state": "ACTIVE",
  "system-tags": {},
  "time-created": "2025-08-05T18:02:53.418000+00:00",
  "time-updated": "2025-08-05T18:04:42.585000+00:00"
}