Documentación de Oracle Cloud Infrastructure

Creación de una instancia gemela digital

Cree una instancia de gemelo digital para un dispositivo o simule una conexión de dispositivo que sea una representación digital de una entidad física.

Para administradores, consulte Requisitos para obtener información sobre políticas para recursos, certificados y secretos de IoT. Para ver ejemplos específicos para configurar instancias de gemelos digitales, consulte Escenarios.

Tenga en cuenta las siguientes opciones al crear una instancia de gemelo digital:
  • Para los datos estructurados, cree una instancia de gemelo digital con un adaptador y un modelo: si está recibiendo datos estructurados de un dispositivo, debe crear y asociar un modelo de gemelo digital y un adaptador de gemelo digital a la instancia de gemelo digital.
  • Para los datos no estructurados, cree una instancia de gemelo digital sin un adaptador o modelo: si recibe datos no estructurados de un dispositivo, la instancia de gemelo digital no necesita un adaptador o modelo de gemelo digital.
  • Autenticación: (opcional)
    • Con autenticación: si la instancia de gemelo digital está configurada para recibir datos de dispositivo o está asociada a un adaptador de gemelo digital, debe utilizar el parámetro de ID de autenticación con un OCID de certificado o secreto de almacén, para que el gemelo digital se pueda autenticar. Hacer que se cree un secreto o un certificado.
    • Sin autenticación: si desea crear una instancia de gemelo digital sin datos ingeribles de un dispositivo, puede crear una instancia de gemelo digital sin un adaptador de gemelo digital y sin el parámetro de ID de autenticación, --auth-id. El modelo gemelo digital asociado es necesario y no debe contener telemetría ni propiedades. Después, puede crear una instancia de gemelo digital, crear una relación de gemelo digital para simular su entorno IoT para realizar pruebas sin la complejidad de los datos ni la autenticación.
  • Clave externa: (opcional)
    • Uso de una clave externa con un ID de autenticación de certificado mTLS: al crear una instancia de gemelo digital, el parámetro --external-key es opcional. Si incluye una clave externa y el ID de autenticación se especifica como un OCID de certificado mTLS, debe utilizar el nombre común del certificado como valor de clave externa.
    • Uso de un ID de autenticación de secreto de almacén: al crear una instancia de gemelo digital si utiliza el parámetro --auth-id con un secreto de almacén para autenticar un dispositivo al enviar datos, debe utilizar el valor de secreto de texto sin formato como contraseña del dispositivo al enviar datos.
    • Uso de un ID de dispositivo como clave externa: la clave externa puede ser un nombre para un dispositivo o puede utilizar un ID de dispositivo específico, por ejemplo, una dirección MAC o un número de serie.
    • Sin clave externa: si no incluye una --external-key al crear una instancia de gemelo digital, la clave externa se genera automáticamente. Después de crear la instancia de gemelo digital, utilice el comando update digital twin instance para cambiar la clave externa.
    1. En la página de lista Dominios de IoT, seleccione el dominio de IoT con el que desea trabajar. Si necesita ayuda para encontrar la página de lista de dominios de IoT, consulte Listado de dominios de IoT.
    2. Seleccione el separador Instancias gemelas digitales y, a continuación, seleccione Crear.
    3. Introduzca un nombre y, opcionalmente, una descripción. Evite introducir información confidencial.
    4. Opcional. Introduzca una clave externa que sea un identificador único. Si no especifica una clave externa, se genera al guardar esta instancia de gemelo digital. Utilice la clave externa como nombre de usuario del dispositivo cuando se conecte o envíe datos al dispositivo.
    5. Seleccione el tipo:
      • Conectado directamente: conecte un dispositivo o entidad directamente al dominio de IoT. Si el dispositivo o la entidad envía datos estructurados, seleccione un adaptador. Al seleccionar un adaptador, esta instancia de gemelo digital se asocia a una capa de transformación que convierte las cargas útiles del dispositivo de entrada en la estructura DTDL del modelo de gemelo digital asociado que espera la instancia.
      • No conectado: utilice esta opción para las instancias de gemelos digitales que no están respaldadas por un dispositivo IoT. Como resultado, estas instancias no pueden recibir telemetría y no pueden enviar ni recibir comandos. Los modelos gemelos digitales asociados a estas instancias pueden definir relaciones gemelas digitales, pero no pueden incluir telemetría ni propiedades. Puede utilizar esta opción para simular su entorno de IoT sin la complejidad de la autenticación de datos o dispositivos.
      • ID de autenticación: si el dispositivo o la entidad envía o recibe datos, debe especificar un ID de autenticación. Para probar el ID de autenticación de crear un secreto de almacén y para producción, crear un certificado mTLS para el ID de autenticación de la instancia de gemelo digital.
        • Seleccionar ID de autenticación: seleccione la opción de secreto o certificado. Para un secreto, seleccione el compartimento del almacén, el almacén y el secreto. Para un certificado, seleccione el compartimento del certificado y, a continuación, seleccione el certificado.
        • Pegar OCID de autenticación: pegue el OCID del certificado o secreto.
      • Etiquetas: (opcional) agregue una o más etiquetas al adaptador de gemelos digitales. Si tiene permisos para crear un recurso, también los tiene para aplicar etiquetas de formato libre a ese recurso. Para aplicar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de la etiqueta. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos. Si no está seguro de si desea aplicar etiquetas, omita esta opción o pregunte a un administrador. Puede aplicar etiquetas más tarde.
    6. Seleccione Crear.

  • Para datos no estructurados:

    Utilice el comando oci iot digital-twin-instance create y los parámetros necesarios para crear una instancia de gemelo digital para un dominio IoT asociado.

    Sustituya <iot-domain-OCID> por el OCID del dominio IoT que desea asociar a esta instancia de gemelo digital y sustituya <certificate-or-secret-OCID> por su certificado o secreto:

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

    Para datos estructurados:

    Utilice el comando oci iot digital-twin-instance create y los parámetros necesarios. Los datos estructurados requieren la creación de una instancia de gemelo digital con un identificador de autenticación y un adaptador de gemelo digital.

    Sustituya <iot-domain-OCID> por el OCID del dominio IoT que desea asociar a esta instancia de gemelo digital y sustituya <certificate-or-secret-OCID> por su certificado o secreto.

    Sustituya <digital-twin-adapter-OCID> por el OCID del adaptador gemelo 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 obtener más información, consulte Creación de un adaptador gemelo digital.
    Nota

    No utilice comillas con un valor de clave externa. Algunas aplicaciones o editores de código pueden agregar comillas no deseadas a sus valores, lo que puede causar un error. Cuando se trabaja con claves externas, se recomienda eliminar comillas. Esto también se aplica a las claves externas en los comandos curl. Este comando de la CLI muestra el parámetro --external-key y el valor correspondiente que no contiene comillas:

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

    Sin un ID de autenticación, un modelo gemelo digital o un adaptador gemelo digital:

    Este comando de ejemplo muestra cómo crear una instancia de gemelo digital sin un adaptador de gemelo digital, un modelo de gemelo digital o un ID de autenticación e incluye el parámetro de clave externa opcional.

    Sustituya la clave externa por una clave externa para el dispositivo. La clave externa debe ser única y puede ser un valor de texto descriptivo o puede usar la dirección MAC o el número de serie del dispositivo.

    En este ejemplo, el valor --external-key no contiene comillas: 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 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 CreateDigitalTwinInstance para crear una instancia de gemelo digital.