Documentação do Oracle Cloud Infrastructure

Criando um Domínio IoT

Crie um domínio do Internet of Things (IoT) associado a um grupo de domínios do IoT. Ao criar recursos de gêmeo digital para um dispositivo, você associa todos os recursos de gêmeo digital relacionados a um domínio IoT específico.

Para cada domínio IoT, um ponto final de dispositivo exclusivo e um esquema de banco de dados dedicado são criados com um id curto de domínio.

  • device-host:<domain-short-id-from-device-host>.device.iot.<region>.oci.oraclecloud.com
  • Esquema de banco de dados somente leitura com as definições de gêmeos digitais e dados de telemetria enviados de/para o dispositivo: <domain-short-id-from-device-host>__IOT
Observação

Você pode criar até 2 domínios IoT em cada grupo de domínios IoT. O número máximo de grupos de domínios IoT é 5 e o número máximo de domínios IoT é 10 para cada região da sua tenancy. Para criar um domínio IoT, seu usuário deve ter acesso de leitura para o grupo de domínios IoT associado.

Todos os recursos do IoT devem estar na mesma região.

    1. Na página de lista Domínio, selecione Criar domínio. Se precisar de ajuda para localizar a página de lista de domínios IoT, consulte Listando Domínios IoT.
    2. Informe um nome amigável para o domínio IoT. Evite digitar informações confidenciais.
    3. (Opcional) Digite uma descrição.
    4. Selecione um compartimento no qual você deseja armazenar seus domínios IoT. Seu grupo de domínios IoT e o domínio IoT podem estar em compartimentos distintos. Seus recursos do IoT podem estar em compartimentos distintos, mas devem estar na mesma região.
    5. Selecione o compartimento do grupo de domínios associado e selecione o grupo de domínios que você deseja associar a esse domínio. Se não houver grupos de domínios, crie um grupo de domínios.
    6. Selecione Criar.
      Agora, você pode exibir a solicitação de serviço para criar o domínio, incluindo a operação da solicitação de serviço, o status do ciclo de vida, a % de conclusão e a data e a hora do status aceito, iniciado e finalizado da solicitação de serviço.

      Por exemplo, se o domínio for criado com sucesso, o estado será exibido como aceito e, em seguida, alguns segundos depois, como bem-sucedido e a % concluída em 100.

      Selecione o nome do domínio para exibir os detalhes do domínio.

      Ações

      Os detalhes do domínio exibem os seguintes detalhes sobre o domínio, selecionam os links ou as guias para acessar essas opções.

      • Exiba os detalhes do domínio incluindo o nome, a descrição, o OCID, o grupo de domínios associado, o Compartimento, incluindo a data e a hora que o domínio foi criado e atualizado.
      • Selecione o nome do grupo de domínios para exibir os detalhes do grupo de domínios associado.
      • Exiba e copie os Pontos Finais do host do dispositivo para o domínio. O host do dispositivo exibe o id abreviado do domínio. Selecione Copiar para copiar esse ponto final.

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

      • Tempo de retenção de dados: Para qualquer tipo de dados, selecione Aumentar para atualizar o número de dias. Você só pode aumentar o número de dias. O valor padrão é 16 dias para dados brutos, dados rejeitados e dados de comando brutos. O valor padrão para dados históricos é 30 dias.
        • Dados brutos: Um conjunto de registros que contêm dados brutos recebidos de um dispositivo IoT. Isso inclui um ponto final, tempo recebido, tipo de conteúdo e conteúdo real.
        • Dados históricos: Se o conteúdo do modelo de gêmeo digital for marcado para histórico, os dados de série temporal das instâncias de gêmeo digital serão coletados para cada domínio IoT.
        • Dados rejeitados: Um conjunto de registros rejeitados que contêm dados brutos recebidos de um dispositivo IoT. Isso inclui o código e uma mensagem detalhada que contém o motivo da rejeição.
        • Dados de comando bruto: Os comandos de dados brutos são enviados para instâncias de gêmeos digitais no domínio IoT, juntamente com quaisquer detalhes de resposta, incluindo um status de entrega.
      • Guia Monitoramento: Exiba métricas de um domínio IoT. Para cada gráfico de métricas, você pode exibir a consulta no Metrics Explorer, Copiar o URL do gráfico, Copiar o MQL ou Criar um alarme em uma consulta.

        Para obter uma lista de gráficos e detalhes de métricas, consulte Referência de Métricas do Internet of Things, Exibindo Métricas do Serviço Monitoring e Editando a Expressão MQL para uma Consulta.

      Selecione o menu Ações para:
      • Alterar acesso aos dados: Selecione o Tipo de acesso para este domínio,
        • acesso direto a dados: Informe um Grupo de Identidades do IAM com permissão para estabelecer conexão com o host de dados do grupo de domínios associado. Para adicionar vários grupos de Identidades para acessar dados desse domínio IoT, selecione Adicionar outro Grupo de Identidades.

          Informe qualquer uma das opções de grupo de Identidades do IAM a seguir. Um <identity-group-name> é o grupo de usuários de Identidades ou um grupo dinâmico de Identidades. O número máximo permitido de nomes de grupo de Identidades é 5.

          • Se o <identity-group-name> estiver no domínio de Identidades padrão, use este formato:

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

          • Se o <identity-group-name> não estiver no domínio de Identidades padrão, use este formato para especificar o nome do domínio de Identidades para o grupo de usuários do domínio de Identidades ou o grupo dinâmico de identidades:

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

        • Acesso ao ORDS (Oracle REST Data Services): Digite o nome do host do domínio de Identidades do banco de dados para a conexão do host de dados do ORDS:

          idcs-<unique-id>.identity.oraclecloud.com

        • Acesso ao Oracle Application Express (APEX): Digite a senha inicial do APEX para o espaço de trabalho do APEX para o seu domínio IoT: <your-apex-initial-password>

          Para obter mais informações, consulte Configurando o acesso aos dados de um domínio IoT.

      • Selecione Atualizar.
      • Mover o recurso: Selecione o compartimento de destino para mover o domínio para outro compartimento. Selecione Mover Recurso.
      • Deletar: Selecione Deletar para excluir o domínio.
      • Selecione Editar para editar os detalhes deste domínio.

  • Use o comando oci iot domain create e os parâmetros necessários para criar um domínio IoT.

    Substitua o <iot-domain-group-OCID> pelo grupo de domínios IoT que você deseja associar ao domínio IoT. Substitua o <compartment-OCID> pelo OCID do compartimento para o domínio IoT:

    oci iot domain create --compartment-id <compartment-OCID> --iot-domain-group-id <iot-domain-group-OCID>

    Para obter uma lista completa de parâmetros e valores para comandos CLI, consulte Referência de Comando CLI.

  • Execute a operação CreateIotDomain para criar um domínio IoT.