Documentación de Oracle Cloud Infrastructure

Actualización de un adaptador gemelo digital

Actualice el adaptador gemelo digital para su Internet of Things (IoT).

Cuando actualiza una opción existente aplicada a un adaptador de gemelos digitales, solo cambia el valor que no agrega un nuevo valor al adaptador de gemelos digitales mediante esta opción de actualización. Si desea agregar un nuevo valor, debe crear un nuevo adaptador de gemelo digital y asociar el nuevo OCID de adaptador de gemelo digital a la instancia de gemelo digital con la que desea trabajar, puede hacerlo cuando cree una instancia de gemelo digital o actualice una instancia de gemelo digital.

Para conocer escenarios específicos con adaptadores gemelos digitales, consulte:

Opciones de adaptador de gemelo digital

  • Cuándo actualizar o volver a crear un adaptador de gemelos digitales: utilice la actualización para los metadatos, incluidos display-name, description y tags, si estas opciones se incluyeron inicialmente al crear el adaptador de gemelos digitales. Para asignar cambios de lógica en envelope-mapping o inbound-routes, cree un nuevo adaptador.
  • Mejores prácticas para actualizaciones de adaptadores: aplique actualizaciones en un nuevo adaptador, asócielas a la instancia de gemelo digital de prueba, publique la telemetría de ejemplo, verifique las respuestas 202 y los valores descendentes y, a continuación, asocie la instancia de gemelo digital de producción al nuevo adaptador.
  • Valores de adaptador: puede ser null o estar vacío.
  • Las rutas de entrada deben ser JSON válidas: los valores ${...} sin comillas no están soportados y se rechazarán. Las expresiones JQ deben estar entre cadenas entre comillas, por ejemplo, "${(.velocity_kph / 1.609) | floor}"
  • Límites en rutas de entrada: el número máximo de rutas de entrada es de 128 rutas de entrada.
  • Comillas de la CLI en Windows: según el sistema operativo o la aplicación con la que esté trabajando, los parámetros de cadena, las comillas y los espacios pueden causar problemas. Evite usar comillas que generen argumentos adicionales inesperados, también evite usar espacios. Por ejemplo, para introducir parámetros de la CLI de OCI, utilice algo similar a lo siguiente:

    --description your-description

Nota

La CLI de OCI utiliza palabras separadas por guiones para las definiciones del adaptador de gemelos digitales, la API utiliza la notación camelCase. Por ejemplo, al utilizar los comandos oci cli envelope-mapping utilizados para la CLI de OCI, se convierte en envelopeMapping al utilizar el SDK IoT de Python o la API IoT.
  • Utilice la opción de actualización para actualizar el valor de una opción de adaptador gemelo digital de IoT existente.
    1. En la página de lista Dominios, seleccione el dominio con el que desea trabajar. Si necesita ayuda para encontrar la página de lista de dominios de IoT o un dominio de IoT, consulte Listado de dominios de IoT.
    2. Seleccione el separador Adaptadores de gemelos digitales.
    3. Seleccione el nombre de adaptador gemelo digital. Seleccione Editar para actualizar el nombre, la descripción o para editar o cargar un nuevo archivo .json con el contenido del sobre de entrada o las condiciones de ruta de entrada para este adaptador.
    4. Seleccione No especificado para eliminar el sobre de entrada del adaptador de gemelo digital o la especificación de ruta de entrada.
    5. Seleccione Actualizar.

      En la lista Adaptador gemelo digital, seleccione el menú Acciones al final de la fila, para suprimir, gestionar las etiquetas o copiar su OCID.

  • Utilice el comando oci iot digital-twin-adapter update y los parámetros necesarios para actualizar un adaptador gemelo digital. Puede actualizar la descripción, las etiquetas de formato libre, las etiquetas definidas o el nombre mostrado de un adaptador de gemelo digital. Dependiendo de su sistema operativo, es posible que necesite un número diferente de barras, por ejemplo, en Mac o Linux usa: file:///inbound-routes.json para obtener más información, consulte

    Para actualizar las rutas de entrada de un adaptador gemelo digital: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --inbound-routes file://inbound-routes.json
    Para actualizar la asignación de sobres de entrada de un adaptador gemelo digital: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --inbound-envelop file://inbound-envelop.json
    Para actualizar la descripción de un adaptador gemelo digital: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --description "<updated-description>"
    Para actualizar las etiquetas de formato libre de un adaptador gemelo digital, puede definir pares de valores de clave como en este ejemplo o una ruta a un archivo similar a tags.json como en el siguiente ejemplo: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --freeform-tags '{"<key>": "<value>"}'
    Para obtener más información, consulte Descripción de etiquetas de formato gratuito.
    Para actualizar las etiquetas definidas de un adaptador de gemelos digitales, utilice un archivo .json para definir las etiquetas e incluya una ruta de acceso como el archivo tags.json, como en el ejemplo:
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --defined-tags file://tags.json
    Para obtener más información, consulte Trabajar con etiquetas definidas.
    Para actualizar el nombre mostrado de un adaptador gemelo digital: 
    oci iot digital-twin-adapter update --digital-twin-adapter-id <iot-digital-twin-adapter-OCID> --display-name "<updated-display-name>"

    Para obtener una lista completa de los parámetros y valores de los comandos de la CLI, consulte Referencia de comandos de la CLI.

  • Ejecute la operación UpdateDigitalTwinAdapter para actualizar el adaptador gemelo digital.