Documentation sur 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 jumeau numérique pour un appareil, vous associez toutes les ressources de jumeau numérique connexes à un domaine IoT spécifique.

Pour chaque domaine IoT, un point d'extrémité d'appareil unique et un schéma de base de données dédié sont créés avec un ID court 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 jumeau numérique et les données de télémétrie envoyées vers et depuis l'appareil : <domain-short-id-from-device-host>__IOT
Note

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, votre 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. Dans 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, voir Liste des domaines IoT.
    2. Entrez un nom convivial pour le domaine IoT. Évitez d'entrer des informations confidentielles.
    3. (Facultatif) Entrez une description.
    4. Sélectionnez un compartiment dans lequel stocker les domaines IoT. Votre groupe de domaines IoT et votre domaine IoT peuvent se trouver dans des compartiments différents. Vos 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 du groupe de domaines associé et sélectionnez le groupe de domaines à associer à ce domaine. S'il n'y a aucun groupe de domaines, créez un groupe de domaines.
    6. Sélectionnez Créer.
      Vous pouvez maintenant voir la demande de travail pour créer le domaine, notamment l'opération de la demande de travail, le statut du cycle de vie, le % terminé et la date et l'heure du statut accepté, commencé et terminé de la demande de travail.

      Par exemple, si le domaine a été créé avec succès, l'état s'affiche comme accepté, puis quelques secondes plus tard comme réussi et le % terminé à 100.

      Sélectionnez le nom du domaine pour voir 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.

      • Consultez les détails du domaine, notamment le nom, la description, l'OCID, le groupe de domaines associé, 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 voir les détails du groupe de domaines associé.
      • Consultez et copiez les points d'extrémité de l'hôte de l'appareil pour le domaine. L'hôte de l'appareil affiche l'ID abrégé du domaine. Sélectionnez Copier pour copier ce point d'extrémité.

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

      • Temps de conservation des données : Pour tous les types de données, sélectionnez Augmenter pour mettre à jour le nombre de jours. Vous ne pouvez augmenter que le nombre de jours. La valeur par défaut est 16 jours pour les données brutes, les données rejetées et les données de commande brutes, la valeur par défaut pour les données historiques est 30 jours.
        • Données brutes : Collection d'enregistrements contenant des données brutes reçues d'un appareil IoT. Cela inclut un point d'extrémité, le temps reçu, 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 historisation, les données de série chronologique des instances de jumeau numérique sont collectées pour chaque domaine IoT.
        • Données rejetées : Collection d'enregistrements rejetés contenant des données brutes reçues d'un appareil 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 jumeau numérique dans le domaine IoT, avec tous les détails de réponse, y compris le statut de transmission.
      • Onglet Surveillance : Voir les mesures d'un domaine IoT. Pour chaque graphique de mesure, vous pouvez voir l'interrogation dans l'explorateur de mesures, copier l'URL du graphique, copier MQL ou créer une alarme sur une interrogation.

        Pour obtenir la liste des graphiques et des détails des mesures, voir Informations de référence sur les mesures Internet of Things, Consultation des mesures à partir du service de surveillance et Modification de l'expression MQL pour une interrogation.

      Sélectionnez le menu Actions pour :
      • Modifier l'accès aux données : Sélectionnez le type d'accès pour ce domaine,
        • Accès direct aux données : Entrez un 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'utilisateurs Identity ou un groupe dynamique d'identités. Le nombre maximal de noms de groupe d'identités autorisés est de 5.

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

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

          • Si <identity-group-name> n'est pas dans le domaine d'identité par défaut, utilisez ce format pour spécifier le nom du domaine d'identité pour le groupe d'utilisateurs du domaine d'identité ou le groupe dynamique d'identités :

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

        • Accès à Oracle REST Data Services (ORDS) : Entrez le nom d'hôte du domaine d'identité de la base de données pour la connexion à l'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 pour 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 que vous voulez associer au domaine IoT. Remplacez <compartment-OCID> par l'OCID du compartiment pour le domaine IoT :

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

    Pour la liste complète des paramètres et des valeurs pour les commandes de l'interface de ligne de commande, voir Informations de référence sur les commandes de l'interface de ligne de commande.

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