Documentação do Oracle Cloud Infrastructure

Criando uma Instância Digital Twin

Crie uma instância de gêmeo digital para um dispositivo ou simule uma conexão de dispositivo que seja uma representação digital de uma entidade física.

Para administradores, consulte Pré-requisitos para obter informações sobre políticas para recursos, certificados e segredos do IoT. Para obter exemplos específicos para configurar instâncias de gêmeos digitais, consulte Cenários.

Considere as seguintes opções ao criar uma instância de gêmeo digital:
  • Para dados estruturados, crie uma instância de gêmeo digital com um adaptador e um modelo : Se você estiver recebendo dados estruturados de um dispositivo, deverá criar e associar um modelo de gêmeo digital e um adaptador de gêmeo digital à instância de gêmeo digital.
  • Para dados não estruturados, crie uma instância de gêmeo digital sem um adaptador ou modelo: Se você estiver recebendo dados não estruturados de um dispositivo, sua instância de gêmeo digital não exigirá um adaptador ou modelo de gêmeo digital.
  • Autenticação: (Opcional)
    • Com autenticação: Se a instância de gêmeo digital estiver configurada para receber dados do dispositivo ou estiver associada a um adaptador de gêmeo digital, você deverá usar o parâmetro de ID de autenticação com um segredo de vault ou OCID de certificado, para que o gêmeo digital possa se autenticar. Para isso, crie um segredo ou crie um certificado.
    • Sem autenticação: Se quiser criar uma instância de gêmeo digital sem dados ingeríveis de um dispositivo, você poderá criar uma instância de gêmeo digital sem um adaptador de gêmeo digital e sem o parâmetro de ID de autenticação, --auth-id. O modelo de gêmeo digital associado é obrigatório e não deve conter telemetria ou propriedades. Depois de criar uma instância de gêmeo digital, você poderá criar um relacionamento de gêmeo digital para simular seu ambiente IoT para teste sem a complexidade dos dados ou da autenticação.
  • Chave Externa: (Opcional)
    • Usando uma chave externa com um ID de autenticação de certificado mTLS: Quando você cria uma instância de gêmeo digital, o parâmetro --external-key é opcional. Se você incluir uma chave externa e o ID de autenticação for especificado como um OCID do certificado mTLS, use o nome comum do certificado como o valor de chave externa.
    • Usando um ID de autenticação de segredo do vault: Ao criar uma instância de gêmeo digital se você usar o parâmetro --auth-id com um segredo do vault para autenticar um dispositivo ao enviar dados, use o valor do segredo de texto simples como a senha do dispositivo ao enviar dados.
    • Usando um ID de dispositivo como a chave externa: A chave externa pode ser um nome para um dispositivo ou você pode usar um ID de dispositivo específico, por exemplo, um endereço MAC ou um número de série.
    • Sem uma chave externa: Se você não incluir uma --external-key ao criar uma instância de gêmeo digital, a chave externa será gerada automaticamente. Após a criação da instância de gêmeo digital, use o comando update digital twin instance para alterar a chave externa.
    1. Na página de lista Domínios IoT, selecione o domínio IoT com o qual você deseja trabalhar. Se precisar de ajuda para localizar a página de lista de domínios IoT, consulte Listando Domínios IoT.
    2. Selecione a guia Instâncias gêmeas digitais e, em seguida, Criar.
    3. Informe um Nome e, opcionalmente, uma Descrição. Evite inserir qualquer informação confidencial.
    4. Opcional. Informe uma Chave externa que seja um identificador exclusivo. Se você não especificar uma chave externa, ela será gerada quando você salvar essa instância de gêmeo digital. Use a chave externa como o nome de usuário do dispositivo quando você se conectar ou enviar dados para o dispositivo.
    5. Selecione o tipo:
      • Conectado diretamente: Conecte um dispositivo ou entidade diretamente ao domínio IoT. Se o dispositivo ou a entidade enviar dados estruturados, selecione um adaptador. A seleção de um adaptador associa essa instância de gêmeo digital a uma camada de transformação que converte as cargas úteis do dispositivo de entrada na estrutura DTDL do modelo de gêmeo digital associado esperada pela instância.
      • Não conectado: Use esta opção para instâncias de gêmeos digitais que não são suportadas por um dispositivo IoT. Como resultado, essas instâncias não podem receber telemetria e não podem enviar ou receber comandos. Os modelos de gêmeos digitais associados a essas instâncias podem definir relacionamentos de gêmeos digitais, mas não podem incluir telemetria ou propriedades. Você pode usar essa opção para simular seu ambiente IoT sem a complexidade da autenticação de dados ou dispositivos.
      • ID de Autenticação: Se o dispositivo ou a entidade enviar ou receber dados, especifique um ID de autenticação. Para testar o ID de autenticação criar um segredo do vault e para a produção, crie um certificado mTLS para o ID de autenticação da instância do gêmeo digital.
        • Selecionar ID de autenticação: Selecione a opção de segredo ou certificado. Para um segredo, selecione o compartimento do vault, o vault e o segredo. Para um certificado, selecione o compartimento do certificado e, em seguida, selecione o certificado.
        • Colar OCID de autenticação: Cole o OCID do certificado ou do segredo.
      • Tags: (Opcional) Adicione uma ou mais tags ao adaptador de gêmeos digitais. Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deverá ter permissões para usar o namespace de tag. Para obter mais informações sobre tags, consulte Tags de Recurso. Se você não tiver certeza se deseja aplicar tags, ignore essa opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.
    6. Selecione Criar.

  • Para dados não estruturados:

    Use o comando oci iot digital-twin-instance create e os parâmetros necessários para criar uma instância de gêmeo digital para um domínio IoT associado.

    Substitua o <iot-domain-OCID> pelo OCID do domínio IoT que você deseja associar a esta instância de gêmeo digital e substitua o <certificate-or-secret-OCID> pelo seu certificado ou segredo:

    oci iot digital-twin-instance create --auth-id <certificate-or-secret-OCID> --iot-domain-id <iot-domain-OCID>

    Para dados estruturados:

    Use o comando oci iot digital-twin-instance create e os parâmetros necessários. Dados estruturados exigem a criação de uma instância de gêmeo digital com um id de autenticação e um adaptador de gêmeo digital.

    Substitua o <iot-domain-OCID> pelo OCID do domínio IoT que você deseja associar a essa instância de gêmeo digital e substitua o <certificate-or-secret-OCID> pelo seu certificado ou segredo.

    Substitua o <digital-twin-adapter-OCID> pelo OCID do adaptador duplo digital relacionado: 
    oci iot digital-twin-instance create --iot-domain-id <iot-domain-OCID> --auth-id <certificate-or-secret-OCID> --digital-twin-adapter-id <digital-twin-adapter-OCID>
    Para obter mais informações, consulte Criando um Adaptador Digital Twin.
    Observação

    Não use aspas com um valor de chave externa. Alguns aplicativos ou editores de código podem adicionar aspas indesejadas aos seus valores, o que pode causar um erro. Ao trabalhar com chaves externas, é uma prática recomendada remover aspas. Isso também se aplica a chaves externas nos comandos curl. Este comando da CLI mostra o parâmetro --external-key e o valor correspondente que não contém aspas:

    --external-key 01-23-45-67-89-ab

    Sem um ID de Autenticação, um modelo de gêmeo digital ou adaptador de gêmeo digital:

    Este exemplo de comando mostra como criar uma instância de gêmeo digital sem um adaptador de gêmeo digital, um modelo de gêmeo digital ou um ID de autenticação e inclui o parâmetro de chave externa opcional.

    Substitua a chave externa por uma chave externa para o dispositivo. A chave externa deve ser exclusiva e pode ser um valor de texto descritivo ou você pode usar o endereço MAC ou o número de série do dispositivo.

    Neste exemplo, o valor --external-key não contém aspas: 01-23-45-67-89-ab
    oci iot digital-twin-instance create --iot-domain-id <iot-domain-OCID> --external-key 01-23-45-67-89-ab

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

  • Execute a operação CreateDigitalTwinInstance para criar uma instância de gêmeo digital.