Documentação do Oracle Cloud Infrastructure

Atualizando um Adaptador Digital Twin

Atualize o adaptador de gêmeo digital para sua Internet of Things (IoT).

Ao atualizar uma opção existente aplicada a um adaptador de gêmeo digital, você altera apenas o valor que não adiciona um novo valor ao adaptador de gêmeo digital usando essa opção de atualização. Se quiser adicionar um novo valor, crie um novo adaptador de gêmeo digital e associe o OCID do novo adaptador de gêmeo digital à instância de gêmeo digital com a qual deseja trabalhar, você poderá fazer isso ao criar uma instância de gêmeo digital ou atualizar uma instância de gêmeo digital.

Para cenários específicos com adaptadores de gêmeos digitais, consulte:

Opções do Adaptador Digital Twin

  • Quando atualizar ou recriar um adaptador de gêmeo digital: Use a atualização para metadados, incluindo display-name, description e tags, se essas opções tiverem sido incluídas inicialmente quando você criou o adaptador de gêmeo digital. Para alterações lógicas de mapeamento em um envelope-mapping ou inbound-routes, crie um novo adaptador.
  • Melhores práticas para atualizações de adaptador: aplique atualizações em um novo adaptador, associe à sua instância de gêmeo digital de teste, faça pós-telemetria de amostra, verifique respostas 202 e valores downstream e associe a instância de gêmeo digital de produção ao novo adaptador.
  • Valores do adaptador: pode ser null ou estar vazio.
  • Inbound-routes deve ser um JSON válido: valores ${...} sem aspas não são suportados e serão rejeitados. Expressões de JQ devem estar dentro de strings entre aspas, por exemplo, "${(.velocity_kph / 1.609) | floor}"
  • Limites em rotas de entrada: o número máximo de rotas de entrada é de 128 rotas de entrada.
  • Cotação de CLI no Windows: Dependendo do seu sistema operacional ou aplicativo com o qual você está trabalhando, os parâmetros de string, aspas e espaços podem causar problemas. Evite usar aspas que resultem em argumentos extras inesperados, também evite usar espaços. Por exemplo, para inserir parâmetros da CLI do OCI, use algo como:

    --description your-description

Observação

A CLI do OCI usa palavras separadas por hífen para as definições do adaptador de gêmeos digitais. A API usa a notação camelCase. Por exemplo, ao usar os comandos oci cli envelope-mapping usados para a CLI do OCI, você se torna envelopeMapping ao usar o SDK IoT do Python ou a API IoT.
  • Use a opção de atualização para atualizar o valor de uma opção de adaptador de gêmeo digital IoT existente.
    1. 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.
    2. Selecione a guia Adaptadores gêmeos digitais.
    3. Selecione o nome do adaptador gêmeo digital. Selecione Editar para atualizar o nome, a descrição ou para editar ou fazer upload de um novo arquivo .json com o conteúdo do envelope de entrada ou das condições de rota de entrada deste adaptador.
    4. Selecione Não especificado para remover o envelope de entrada do adaptador de gêmeo digital ou a especificação de rota de entrada.
    5. Selecione Atualizar.

      Na lista Adaptador de gêmeos digitais, selecione o menu Ações no final da linha, para excluir, gerenciar tags ou copiar seu OCID.

  • Use o comando oci iot digital-twin-adapter update e os parâmetros necessários para atualizar um adaptador de gêmeo digital. É possível atualizar a descrição, as tags de formato livre, as tags definidas ou o nome de exibição de um adaptador de gêmeo digital. Dependendo do seu sistema operacional, você pode precisar de um número diferente de barras, por exemplo, no Mac ou Linux, use: file:///inbound-routes.json para obter mais informações, consulte

    Para atualizar as rotas de entrada de um adaptador de gêmeo digital: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --inbound-routes file://inbound-routes.json
    Para atualizar o mapeamento de envelope de entrada de um adaptador de gêmeo digital: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --inbound-envelop file://inbound-envelop.json
    Para atualizar a descrição de um adaptador de gêmeo digital: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --description "<updated-description>"
    Para atualizar as tags de formato livre de um adaptador de gêmeo digital, você pode definir pares de chave/valor como neste exemplo ou um caminho para um arquivo tags.json, como no exemplo a seguir: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --freeform-tags '{"<key>": "<value>"}'
    Para obter mais informações, consulte Noções Básicas sobre Tags de Formato Livre.
    Para atualizar as tags definidas de um adaptador de gêmeo digital, use um arquivo .json para definir as tags e inclua um caminho semelhante ao arquivo tags.json, como no exemplo:
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --defined-tags file://tags.json
    Para obter mais informações, consulte Trabalhando com Tags Definidas.
    Para atualizar o nome de exibição de um adaptador de gêmeo digital: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --display-name "<updated-display-name>"

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

  • Execute a operação UpdateDigitalTwinAdapter para atualizar o adaptador de gêmeos digitais.