Documentation Oracle Cloud Infrastructure

Création d'un domaine IoT

Créez un domaine Internet of Things (IoT) associé à un groupe de domaines IoT. Lorsque vous créez des ressources de jumeaux numériques pour un dispositif, vous associez toutes les ressources de jumeaux numériques associées à un domaine IoT spécifique.

Pour chaque domaine IoT, une adresse de périphérique unique et un schéma de base de données dédié sont créés avec un ID abrégé de domaine.

  • device-host:<domain-short-id-from-device-host>.device.iot.<region>.oci.oraclecloud.com
  • Schéma de base de données en lecture seule avec les définitions de jumeaux numériques et les données de télémétrie envoyées vers et depuis l'appareil : <domain-short-id-from-device-host>__IOT
Remarque

Vous pouvez créer jusqu'à 2 domaines IoT dans chaque groupe de domaines IoT. Le nombre maximal de groupes de domaines IoT est de 5 et le nombre maximal de domaines IoT est de 10 pour chaque région de votre location. Pour créer un domaine IoT, l'utilisateur doit disposer d'un accès en lecture pour le groupe de domaines IoT associé.

Toutes les ressources IoT doivent se trouver dans la même région.

    1. Sur la page de liste Domaine, sélectionnez Créer un domaine. Si vous avez besoin d'aide pour trouver la page de liste des domaines IoT, reportez-vous à Liste des domaines IoT.
    2. Entrez un nom convivial pour le domaine IoT. Evitez de saisir des informations confidentielles.
    3. (Facultatif) Saisissez une description.
    4. Sélectionnez un compartiment dans lequel stocker les domaines IoT. Le groupe de domaines IoT et le domaine IoT peuvent se trouver dans différents compartiments. Les ressources IoT peuvent se trouver dans des compartiments différents, mais doivent se trouver dans la même région.
    5. Sélectionnez le compartiment de groupe de domaines associé, puis le groupe de domaines à associer à ce domaine. S'il n'existe aucun groupe de domaines, créez un groupe de domaines.
    6. Sélectionnez Create (Créer).
      Vous pouvez maintenant afficher la demande de travail pour la création du domaine, y compris l'opération de la demande de travail, le statut du cycle de vie, le % d'avancement, ainsi que la date et l'heure du statut accepté, démarré et fini de la demande de travail.

      Par exemple, si le domaine est créé avec succès, l'état s'affiche comme accepté, puis quelques secondes plus tard comme réussi et le pourcentage d'avancement à 100.

      Sélectionnez le nom du domaine pour visualiser les détails du domaine.

      Actions

      Les détails du domaine affichent les détails suivants sur le domaine, sélectionnez les liens ou les onglets pour accéder à ces options.

      • Affichez les détails du domaine, y compris le nom, la description, l'OCID, le groupe de domaines associé et le compartiment, y compris la date et l'heure de création et de mise à jour du domaine.
      • Sélectionnez le nom du groupe de domaines pour visualiser les détails du groupe de domaines associé.
      • Affichez et copiez les adresses de l'hôte du périphérique pour le domaine. L'hôte du périphérique affiche l'ID abrégé du domaine. Sélectionnez Copier pour copier cette adresse.

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

      • Durée de conservation des données : pour tous les types de données, sélectionnez Augmenter pour mettre à jour le nombre de jours. Vous pouvez uniquement augmenter le nombre de jours. La valeur par défaut est de 16 jours pour les données brutes, rejetées et brutes, la valeur par défaut pour les données historiques est de 30 jours.
        • Données brutes : ensemble d'enregistrements contenant des données brutes reçues d'un périphérique IoT. Cela inclut une adresse, l'heure de réception, le type de contenu et le contenu réel.
        • Données historiques : si le contenu du modèle de jumeau numérique est marqué pour historique, les données de série temporelle des instances de jumeau numérique sont collectées pour chaque domaine IoT.
        • Données rejetées : ensemble d'enregistrements rejetés contenant des données brutes reçues d'un périphérique IoT. Cela inclut le code et un message détaillé contenant le motif du rejet.
        • Données de commande brutes : les commandes de données brutes sont envoyées aux instances de jumeaux numériques dans le domaine IoT avec tous les détails de réponse, y compris un statut de distribution.
      • Onglet Monitoring : visualisez les mesures d'un domaine IoT. Pour chaque graphique de mesures, vous pouvez afficher la requête dans l'explorateur de mesures, copier l'URL du graphique, copier le fichier MQL ou créer une alarme sur une requête.

        Pour obtenir la liste des graphiques et des détails de mesure, reportez-vous à Référence des mesures Internet of Things, à Visualisation des mesures à partir du service Monitoring et à Modification de l'expression MQL pour une requête.

      Sélectionnez le menu Actions pour effectuer les opérations suivantes :
      • Modifier l'accès aux données : sélectionnez le type d'accès pour ce domaine.
        • Accès direct aux données : entrez le groupe d'identités IAM autorisé à se connecter à l'hôte de données du groupe de domaines associé. Pour ajouter plusieurs groupes d'identités afin d'accéder aux données de ce domaine IoT, sélectionnez Ajouter un autre groupe d'identités.

          Entrez l'une des options de groupe d'identités IAM suivantes : <identity-group-name> est le groupe d'identités des utilisateurs ou un groupe dynamique d'identités. Le nombre maximal de noms de groupe d'identités autorisé est de 5.

          • Si le domaine d'identité par défaut est <identity-group-name>, utilisez le format suivant :

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

          • Si <identity-group-name> ne figure pas dans le domaine d'identité par défaut, utilisez ce format pour indiquer le nom de domaine d'identité du groupe d'utilisateurs de domaine d'identité ou du groupe dynamique d'identité :

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

        • Accès Oracle REST Data Services (ORDS) : entrez le nom d'hôte de domaine d'identité de base de données de la connexion d'hôte de données ORDS :

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

        • Accès à Oracle Application Express (APEX) : entrez le mot de passe APEX initial pour l'espace de travail APEX de votre domaine IoT : <your-apex-initial-password>

          Pour plus d'informations, voir Configuration de l'accès aux données d'un domaine IoT.

      • Sélectionnez Mettre à jour.
      • Déplacer la ressource : sélectionnez le compartiment de destination pour déplacer le domaine vers un autre compartiment. Sélectionnez Déplacer la ressource.
      • Supprimer : sélectionnez Supprimer pour supprimer le domaine.
      • Sélectionnez Modifier pour modifier les détails de ce domaine.

  • Utilisez la commande oci iot domain create et les paramètres requis pour créer un domaine IoT.

    Remplacez <iot-domain-group-OCID> par le groupe de domaines IoT à associer au domaine IoT. Remplacez <compartment-OCID> par l'OCID de compartiment du domaine IoT :

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

    Pour obtenir la liste complète des paramètres et des valeurs des commandes de la CLI, reportez-vous à Référence des commandes de la CLI.

  • Exécutez l'opération CreateIotDomain pour créer un domaine IoT.