Documentación de Oracle Cloud Infrastructure

Creación de un dominio IoT

Cree un dominio de Internet of Things (IoT) asociado a un grupo de dominios IoT. Cuando crea recursos de gemelos digitales para un dispositivo, asocia todos los recursos de gemelos digitales relacionados a un dominio IoT específico.

Para cada dominio IoT, se crean un punto final de dispositivo único y un esquema de base de datos dedicado con un identificador corto de dominio.

  • device-host:<domain-short-id-from-device-host>.device.iot.<region>.oci.oraclecloud.com
  • Esquema de base de datos de solo lectura con las definiciones de gemelos digitales y los datos de telemetría enviados desde y hacia el dispositivo: <domain-short-id-from-device-host>__IOT
Nota

Puede crear hasta 2 dominios IoT en cada grupo de dominios IoT. El número máximo de grupos de dominios IoT es 5 y el número máximo de dominios IoT es 10 para cada región de su arrendamiento. Para crear un dominio IoT, el usuario debe tener acceso de lectura para el grupo de dominios IoT asociado.

Todos los recursos IoT deben estar en la misma región.

    1. En la página de lista Dominio, seleccione Crear dominio. Si necesita ayuda para encontrar la página de lista de dominios IoT, consulte Listado de dominios IoT.
    2. Introduzca un nombre fácil de recordar para el dominio IoT. Evite introducir información confidencial.
    3. (Opcional) introduzca una descripción.
    4. Seleccione un compartimento donde desea almacenar los dominios IoT. El grupo de dominios IoT y el dominio IoT pueden estar en diferentes compartimentos. Sus recursos IoT pueden estar en diferentes compartimentos, pero deben estar en la misma región.
    5. Seleccione el compartimento de grupo de dominios asociado y seleccione el grupo de dominios que desea asociar a este dominio. Si no hay ningún grupo de dominios, cree un grupo de dominios.
    6. Seleccione Crear.
      Ahora, puede ver la solicitud de trabajo para crear el dominio, incluida la operación de la solicitud de trabajo, el estado del ciclo de vida, el % finalizado y la fecha y hora del estado aceptado, iniciado y finalizado para la solicitud de trabajo.

      Por ejemplo, si el dominio se ha creado correctamente, el estado se muestra como aceptado y, a continuación, unos segundos después, como correcto y el porcentaje finalizado a las 100.

      Seleccione el nombre de dominio para ver los detalles del dominio.

      Acciones

      En Detalles de dominio se muestran los siguientes detalles sobre el dominio, seleccione los enlaces o separadores para acceder a estas opciones.

      • Consulte los detalles del dominio, incluidos el nombre, la descripción, el OCID, el grupo de dominios y el compartimento asociados, incluida la fecha y hora en que se creó y actualizó el dominio.
      • Seleccione el nombre de grupo de dominios para ver los detalles del grupo de dominios asociado.
      • Visualice y copie los puntos finales del host del dispositivo para el dominio; el host del dispositivo muestra el ID corto del dominio. Seleccione Copiar para copiar este punto final.

        device-host:<domain-short-id>.device.iot.<region>.oci.oraclecloud.com

      • Tiempo de retención de datos: para cualquier tipo de dato, seleccione Aumentar para actualizar el número de días. Solo se puede aumentar el número de días. El valor por defecto es 16 días para los datos raw, los datos rechazados y los datos de comando raw; el valor por defecto para los datos historizados es 30 días.
        • Datos sin procesar: recopilación de registros que contienen datos sin procesar recibidos de un dispositivo IoT. Esto incluye un punto final, el tiempo recibido, el tipo de contenido y el contenido real.
        • Datos históricos: si el contenido del modelo de gemelos digitales está marcado para el historial, los datos de serie temporal para las instancias de gemelos digitales se recopilan para cada dominio IoT.
        • Datos rechazados: recopilación de registros rechazados que contienen datos no procesados recibidos de un dispositivo IoT. Esto incluye el código y un mensaje detallado que contiene el motivo del rechazo.
        • Datos de comandos sin formato: los comandos de datos sin formato se envían a instancias de gemelos digitales en el dominio IoT junto con los detalles de respuesta, incluido el estado de entrega.
      • Separador Supervisión: permite ver las métricas de un dominio IoT. Para cada gráfico de métricas, puede ver la consulta en el explorador de métricas, copiar la URL del gráfico, copiar la MQL o crear una alarma en una consulta.

        Para obtener una lista de gráficos y detalles de métricas, consulte Referencia de métricas de Internet of Things, Visualización de métricas desde el servicio Monitoring y Edición de la expresión MQL para una consulta.

      Seleccione el menú Acciones para:
      • Cambiar acceso a datos: seleccione el tipo de acceso para este dominio.
        • Acceso directo a datos: introduzca un grupo de identidades de IAM que pueda conectarse al host de datos del grupo de dominios asociado. Para agregar varios grupos de identidades para acceder a los datos de este dominio IoT, seleccione Agregar otro grupo de identidades.

          Introduzca cualquiera de las siguientes opciones de grupo de identidades de IAM: <identity-group-name> es el grupo de usuarios de Identity o un grupo dinámico de Identity. El máximo de nombres de grupo de identidad permitidos es 5.

          • Si <identity-group-name> está en el dominio de identidad por defecto, utilice este formato:

            <tenancy-OCID>:<identity-group-name>

          • Si <identity-group-name> no está en el dominio de identidad por defecto, utilice este formato para especificar el nombre de dominio de identidad para el grupo de usuarios de dominio de identidad o el grupo dinámico de identidad:

            <tenancy-OCID>:<identity-domain-name>/<identity-group-name>

        • Acceso a Oracle REST Data Services (ORDS): introduzca el nombre de host de dominio de identidad de base de datos para la conexión de host de datos de ORDS:

          idcs-<unique-id>.identity.oraclecloud.com

        • Acceso a Oracle Application Express (APEX): introduzca la contraseña de APEX inicial para el espacio de trabajo de APEX del dominio IoT: <your-apex-initial-password>

          Para obtener más información, consulte Configuring an IoT Domain's Data Access.

      • Seleccione Actualizar.
      • Mover el recurso: seleccione el compartimento de destino para mover el dominio a otro compartimento. Seleccione Mover recurso.
      • Suprimir: seleccione Suprimir para suprimir el dominio.
      • Seleccione Editar para editar los detalles de este dominio.

  • Utilice el comando oci iot domain create y los parámetros necesarios para crear un dominio IoT.

    Sustituya <iot-domain-group-OCID> por el grupo de dominios IoT que desea asociar al dominio IoT. Sustituya <compartment-OCID> por el OCID del compartimento para el dominio IoT:

    oci iot domain create --compartment-id <compartment-OCID> --iot-domain-group-id <iot-domain-group-OCID>

    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 CreateIotDomain para crear un dominio IoT.