État des ressources et des modèles

Lorsque vous créez, mettez à jour ou supprimez une ressource, un modèle de ressource ou un modèle de composant, les modifications mettent du temps à se propager. AWS IoT SiteWise résout ces opérations de manière asynchrone et met à jour le statut de chaque ressource. Chaque actif, modèle d'actif et modèle de composant possède un champ d'état qui contient l'état de la ressource et tout message d'erreur, le cas échéant. L'état peut avoir l'une des valeurs suivantes :

• ACTIVE— La ressource est active. Il s'agit du seul état dans lequel vous pouvez interroger et interagir avec les actifs, les modèles d'actifs et les modèles de composants.

• CREATING— La ressource est en cours de création.

• UPDATING— La ressource est en cours de mise à jour.

• DELETING— La ressource est en cours de suppression.

• PROPAGATING— (Modèles d'actifs et modèles de composants uniquement) Les modifications se propagent à toutes les ressources dépendantes (du modèle d'actif aux actifs, ou du modèle de composant aux modèles d'actifs).

• FAILED— La ressource n'a pas pu être validée lors d'une opération de création ou de mise à jour, probablement en raison d'une référence circulaire dans une expression. Vous pouvez supprimer les ressources qui se trouvent dans FAILED cet état.

Certaines des opérations de création, de mise à jour et de suppression mettent en AWS IoT SiteWise place un actif, un modèle d'actif ou un modèle de composant dans un état autre que celui ACTIVE pendant la résolution de l'opération. Pour interroger ou interagir avec une ressource après avoir effectué l'une de ces opérations, vous devez attendre que son état passe àACTIVE. Sinon, vos demandes échouent.

Vérification de l'état d'une ressource

Vous pouvez utiliser la AWS IoT SiteWise console ou l'API pour vérifier l'état d'un actif.

Rubriques

• Vérification de l'état d'une ressource (console)
• Vérifier l'état d'un actif (AWS CLI)

Vérification de l'état d'une ressource (console)

Utilisez la procédure suivante pour vérifier l'état d'une ressource dans la console AWS IoT SiteWise .

Pour vérifier l'état d'une ressource (console)

1. Accédez à la console AWS IoT SiteWise.

2. Dans le panneau de navigation, choisissez Ressources.

3. Choisissez la ressource à vérifier.

   Astuce

   Vous pouvez cliquer sur l'icône en forme de flèche pour développer une hiérarchie de ressources afin de trouver votre ressource.

4. Recherchez l’état dans le volet Informations relatives à la ressource.

   

Vérifier l'état d'un actif (AWS CLI)

Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour vérifier l'état d'un actif.

Pour vérifier l'état d'un actif, utilisez l'DescribeAssetopération avec le assetId paramètre.

Pour vérifier l'état d'un actif (AWS CLI)

• Exécutez la commande suivante pour décrire la ressource. Remplacez asset-id par l'ID de l'actif ou par l'ID externe. L'identifiant externe est un identifiant défini par l'utilisateur. Pour plus d’informations, consultez Référencement d'objets avec des identifiants externes dans le Guide de l’utilisateur AWS IoT SiteWise .

  aws iotsitewise describe-asset --asset-id asset-id

  L'opération renvoie une réponse qui contient les détails de la ressource. La réponse contient un assetStatus objet dont la structure est la suivante :

  {
      ...
      "assetStatus": {
        "state": "String",
        "error": {
           "code": "String",
           "message": "String"
        }
      }
    }

  L'état de la ressource est dans assetStatus.state dans l'objet JSON.

Vérification de l'état d'un modèle d'actif ou d'un modèle de composant

Vous pouvez utiliser la AWS IoT SiteWise console ou l'API pour vérifier l'état d'un modèle d'actif ou d'un modèle de composant.

Rubriques

• Vérification de l'état d'un modèle d'actif ou d'un modèle de composant (console)
• Vérification de l'état d'un modèle d'actif ou d'un modèle de composant (AWS CLI)

Vérification de l'état d'un modèle d'actif ou d'un modèle de composant (console)

Utilisez la procédure suivante pour vérifier l'état d'un modèle de ressource ou d'un modèle de composant dans la AWS IoT SiteWise console.

Astuce

Les modèles d'actifs et les modèles de composants sont tous deux répertoriés sous Modèles dans le volet de navigation. Le panneau Détails du modèle d'actif ou du modèle de composant sélectionné indique de quel type il s'agit.

Pour vérifier l'état d'un modèle d'actif ou d'un modèle de composant (console)

1. Accédez à la console AWS IoT SiteWise.

2. Dans le panneau de navigation, choisissez Models (Modèles).

3. Choisissez le modèle à vérifier.

4. Recherchez État dans le volet Détails.

   

Vérification de l'état d'un modèle d'actif ou d'un modèle de composant (AWS CLI)

Vous pouvez utiliser le AWS CLI pour vérifier l'état d'un modèle d'actif ou d'un modèle de composant.

Pour vérifier l'état d'un modèle d'actif ou d'un modèle de composant, utilisez l'opération DescribeAssetModel avec le assetModelId paramètre.

Astuce

AWS CLI définit les modèles de composants comme un type de modèle d'actif. Par conséquent, vous utilisez la même opération de DescribeAssetmodèle pour les deux types de modèles. Le assetModelType champ de la réponse indique s'il s'agit d'un ASSET_MODEL ou d'unCOMPONENT_MODEL.

Pour vérifier l'état d'un modèle d'actif ou d'un modèle de composant (AWS CLI)

• Exécutez la commande suivante pour décrire le modèle. Remplacez asset-model-id par l'ID ou l'ID externe du modèle d'actif ou du modèle de composant. L'identifiant externe est un identifiant défini par l'utilisateur. Pour plus d’informations, consultez Référencement d'objets avec des identifiants externes dans le Guide de l’utilisateur AWS IoT SiteWise .

  aws iotsitewise describe-asset-model --asset-model-id asset-model-id

  L'opération renvoie une réponse contenant les détails du modèle. La réponse contient un objet assetModelStatus qui présente la structure suivante.

  {
      ...
      "assetModelStatus": {
        "state": "String",
        "error": {
           "code": "String",
           "message": "String"
        }
      }
    }

  L'état du modèle se trouve assetModelStatus.state dans l'objet JSON.