Atualizando uma Instância Digital Twin
Atualize o ID do adaptador de uma instância do gêmeo digital, o ID do modelo, o URI da especificação do modelo, o ID de autenticação, a chave externa, a descrição, as tags ou um nome para exibição para sua IoT (Internet of Things).
Ao atualizar uma opção existente aplicada a uma instância de gêmeo digital, você altera apenas o valor que não pode adicionar um novo valor à instância de gêmeo digital usando essa opção de atualização. Se você não tiver incluído o parâmetro que deseja atualizar ao criar a instância do gêmeo digital, não poderá atualizar o valor. Em vez disso, crie uma nova instância de gêmeo digital para adicionar um novo parâmetro.
Por exemplo, se você criar uma instância do gêmeo digital sem um parâmetro de autenticação para teste, precisará criar uma nova instância do gêmeo digital com o parâmetro de autenticação quando quiser enviar ou receber dados da instância do gêmeo digital. Se a instância do gêmeo digital tiver sido criada com um ID de autenticação, você poderá atualizar o ID de autenticação.
- Use a opção de atualização para atualizar o valor de uma opção de instância de gêmeo digital IoT existente.
- Na página de lista Domínios, selecione o domínio com o qual você deseja trabalhar. Se precisar de ajuda para localizar a página de lista de domínios IoT ou um domínio IoT, consulte Listando Domínios IoT.
- Selecione a guia Instâncias gêmeas digitais.
- Selecione o nome da instância gêmea digital. Selecione a opção Editar para atualizar:
- Atualize o nome, a descrição ou a Chave externa para evitar inserir informações confidenciais.
- Digite: tipo
- Conectado diretamente: Conecte um dispositivo ou entidade diretamente ao domínio IoT. Se o dispositivo ou a entidade enviar dados estruturados, ative a opção para Selecionar um adaptador. A seleção de um adaptador associa essa instância de gêmeo digital a uma camada de transformação usando um envelope de entrada e rotas de entrada para converter cargas úteis do dispositivo de entrada na estrutura de especificação DTDL do modelo de gêmeo digital associado esperada pela instância. Se você não vir um adaptador para selecionar na lista, crie um adaptador.
Opcional. Se o dispositivo ou a entidade enviar ou receber dados, selecione um ID de autenticação. Use um segredo com autenticação básica apenas para teste, para ambientes seguros ou de produção use um certificado mTLS. Você pode selecionar o ID de autenticação ou colar o OCID de autenticação.
- Não conectado: Use esta opção para criar uma instância de gêmeo digital somente para simulação sem ingestão de dados. Um modelo de gêmeo digital é necessário e não deve conter telemetria ou propriedades. Selecione o modelo na lista ou selecione o modelo informando o DTMI. Depois de criar essa instância de gêmeo digital, você pode adicionar relacionamentos de gêmeos digitais para simular seu ambiente IoT sem a complexidade da ingestão ou autenticação de dados.
- Conectado diretamente: Conecte um dispositivo ou entidade diretamente ao domínio IoT. Se o dispositivo ou a entidade enviar dados estruturados, ative a opção para Selecionar um adaptador. A seleção de um adaptador associa essa instância de gêmeo digital a uma camada de transformação usando um envelope de entrada e rotas de entrada para converter cargas úteis do dispositivo de entrada na estrutura de especificação DTDL do modelo de gêmeo digital associado esperada pela instância. Se você não vir um adaptador para selecionar na lista, crie um adaptador.
- Selecione Atualizar.
- Dados: Selecione para exibir os dados do instantâneo mais recentes da instância do gêmeo digital.Na lista Instância gêmea digital, selecione o menu Ações no final da linha para excluir, gerenciar tags ou copiar seu OCID.
Se você não incluir a chave externa, ela será gerada.
Use o comando oci iot digital-twin-instance update e o parâmetro necessário para atualizar o parâmetro existente de uma instância do gêmeo digital.
Por exemplo, use este comando para atualizar a chave externa de uma instância de gêmeo digital. Evite problemas de cotação não usando aspas com um valor de chave externa. Você pode substituir
<your-device-id>por um número de série, um endereço MAC ou um nome de dispositivo como chave externa para associar o dispositivo à instância do gêmeo digital:oci iot digital-twin-instance update --digital-twin-instance-id <digital-twin-instance-OCID> --external-key <your-device-id>Use esse comando e o parâmetro
<digital-twin-instance-OCID>necessário para atualizar o parâmetro de autenticação opcional de uma instância do gêmeo digital. Atualize o valor com o OCID do segredo ou do certificado. Essa é a senha do dispositivo quando você envia dados para o dispositivo:oci iot digital-twin-instance update --digital-twin-instance-id <digital-twin-instance-OCID> --auth "<updated-auth-ocid>"Para obter uma lista completa dos parâmetros da instância do gêmeo digital, consulte OCI iot digital-twin-instance update e, para obter uma lista completa de todos os comandos da CLI do OCI, consulte Referência de Comando da CLI.
Execute a operação UpdateDigitalTwinInstance para atualizar uma instância de gêmeo digital.