Cenário: Trabalhando com um Grupo de Domínios IoT

Um administrador deve adicionar uma política à sua tenancy e aos compartimentos que você deseja usar. Para obter exemplos de política e pré-requisitos, consulte Detalhes da Política da Plataforma Internet of Things (IoT) e Pré-requisitos do IoT.

Para obter uma lista de limites de recursos aplicáveis e instruções para solicitar um aumento de limite, consulte Limites de Recursos do Internet of Things.

Você deve configurar um grupo de domínios antes de criar um domínio. Cada grupo de domínios IoT usa uma instância de banco de dados dedicada, que é compartilhada por todos os domínios IoT associados ao grupo de domínios IoT.

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

O exemplo de resposta mostra que o grupo de domínios está criando e contém o URL do host de dados com um ID abreviado do grupo de domínios. Use o URL do host de dados para acessar seus metadados e dados associados a um grupo de domínios IoT específico que contém todos os dispositivos para o domínio IoT associado.

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

Observe que os detalhes da conexão do banco de dados são null. Depois que o grupo de domínios for criado, dependendo de onde você deseja exibir seus dados, será necessário configurar o acesso aos dados do domínio IoT associado para adicionar os detalhes de autenticação do domínio IoT para estabelecer conexão com outro 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>"
            }

Opcionalmente, durante esse processo de trabalho com um grupo de domínios, você pode monitorar a solicitação de serviço de cada operação para confirmar se ela foi bem-sucedida antes de passar para a próxima operação. Você pode usar solicitações de serviço para verificar logs ou mensagens de erro.

Use o "opc-work-request-id": "<work-request-OCID>" de qualquer operação para obter a solicitação de serviço relacionada para essa operação específica. Por exemplo:

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

Este exemplo de resposta mostra que a VCN não está configurada para o grupo de domínios 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>"
}

Depois que um grupo de domínios IoT estiver ativo, se você quiser estabelecer uma conexão direta com o banco de dados para exibir os dados diretamente no banco de dados ou se quiser conectar seus dados para usar o Oracle Analytics Cloud, como parte dessa configuração, você deverá adicionar uma VCN ou VCNs para permitir o acesso aos dados IoT desse grupo de domínios.

Para concluir as etapas a seguir, seu usuário deve ter pelo menos acesso de leitura à VCN ou às VCNs que você deseja adicionar ao grupo de domínios IoT. Para confirmar se você tem acesso de leitura à VCN, consulte Obtendo Detalhes de uma VCN para exibir as VCNs às quais você tem acesso. Se você não tiver acesso de leitura para a VCN, peça a um administrador para adicionar a política relacionada para obter detalhes, consulte Pré-requisitos do IoT.

Use o comando oci iot domain-group configure-data-access para configurar a VCN ou as VCNs que você deseja permitir o acesso ao banco de dados do grupo de domínios.

Substitua o ["vcn-OCID-1","vcn-OCID-2"] pelos OCIDs da VCN configurados para o seu ambiente. Substitua o <domain-group-OCID> pelo OCID do grupo de domínios com o qual você deseja trabalhar:

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 obter mais informações, consulte Configurando o acesso aos dados para um grupo de domínios IoT.

Ao trabalhar com um grupo de domínios IoT, você pode usar esse comando para obter os detalhes do grupo de domínios. Na resposta, você pode verificar os detalhes da conexão do banco de dados definidos para este grupo de domínios IoT. Substitua o <iot-domain-group-OCID> pelo OCID do grupo de domínios IoT específico:

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

Este exemplo de resposta mostra que o grupo de domínios está ativo, "lifecycleState": "ACTIVE" e, se configurado, essa resposta inclui os detalhes da conexão do banco de dados e o host de dados do grupo de domínios:

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

Em seguida, crie um domínio IoT e associe o domínio a um grupo de domínios IoT.