Escenario: Trabajar con un grupo de dominios IoT

Un administrador debe agregar una política a su arrendamiento y a los compartimentos que desea utilizar. Para ver ejemplos de políticas y requisitos previos, consulte Policy Details for the Internet of Things (IoT) Platform y IoT Prerequisites.

Para obtener una lista de los límites de recursos aplicables y las instrucciones para solicitar un aumento del límite, consulte Límites sobre recursos de Internet of Things.

Debe configurar un grupo de dominios antes de crear un dominio. Cada grupo de dominios IoT utiliza una instancia de base de datos dedicada, que comparten todos los dominios IoT asociados al grupo de dominios IoT.

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

La respuesta de ejemplo muestra que el grupo de dominios está creando y contiene la URL del host de datos con un ID corto de grupo de dominios. Utilice la URL del host de datos para acceder a los metadatos y datos asociados a un grupo de dominios IoT específico que contiene todos los dispositivos para el dominio IoT asociado.

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

Observe que los detalles de conexión a la base de datos son null. Después de crear el grupo de dominios, según dónde desee ver los datos, debe configurar el acceso a datos del dominio IoT asociado para agregar los detalles de autenticación para que el dominio IoT se conecte a otro sistema.

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

De manera opcional, durante este proceso de trabajo con un grupo de dominios, puede supervisar la solicitud de trabajo de cada operación para confirmar si se ha realizado correctamente antes de continuar con la siguiente operación. Puede utilizar solicitudes de trabajo para comprobar logs o mensajes de error.

Utilice "opc-work-request-id": "<work-request-OCID>" de cualquier operación para obtener la solicitud de trabajo relacionada para esa operación específica. Por ejemplo:

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

En esta respuesta de ejemplo se muestra que la VCN no está configurada para el grupo de dominios 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>"
}

Después de que un grupo de dominios IoT esté activo, si desea establecer una conexión directa a la base de datos para ver los datos directamente en la base de datos o si desea conectar los datos para utilizar Oracle Analytics Cloud, como parte de esa configuración, debe agregar una VCN o una VCN para permitir el acceso a los datos IoT para este grupo de dominios.

Para realizar los siguientes pasos, el usuario debe tener al menos acceso de lectura a la VCN o las redes virtuales en la red que desea agregar al grupo de dominios IoT. To confirm if you have read access to the VCN, see Getting a VCN's Details to view the VCNs you have access to. Si no tiene acceso de lectura para la VCN, solicite a un administrador que agregue la política relacionada para obtener más información, consulte Requisitos previos de IoT.

Utilice el comando oci iot domain-group configure-data-access para configurar la VCN o las redes virtuales en la nube que desea permitir el acceso a la base de datos para el grupo de dominios.

Sustituya ["vcn-OCID-1","vcn-OCID-2"] por los OCID de VCN configurados para el entorno. Sustituya <domain-group-OCID> por el OCID del grupo de dominios con el que desea trabajar:

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>

Para obtener más información, consulte Configuración de acceso a datos para un grupo de dominios IoT.

Al trabajar con un grupo de dominios IoT, puede utilizar este comando para obtener los detalles del grupo de dominios. En la respuesta, puede verificar los detalles de conexión a la base de datos definidos para este grupo de dominios IoT. Sustituya <iot-domain-group-OCID> por el OCID para el grupo de dominios IoT específico:

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

En esta respuesta de ejemplo se muestra que el grupo de dominios está activo, "lifecycleState": "ACTIVE" y, si se configura, esta respuesta incluye los detalles de conexión a la base de datos y el host de datos para el grupo de dominios:

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

A continuación, cree un dominio IoT y asocie el dominio a un grupo de dominios IoT.