Créez des actifs - AWS IoT SiteWise
Création d'un actif (console)Création d'un actif (AWS CLI)

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Créez des actifs

Vous pouvez créer une ressource à partir d'un modèle de ressource. Vous devez disposer d'un modèle de ressource avant de pouvoir créer une ressource. Si vous n'avez pas encore créé de modèle de ressource, veuillez consulter Création de modèles d'actifs.

Note

Vous pouvez uniquement créer des ressources à partir de modèles ACTIVE. Si l'état de votre modèle n'est pas ACTIVE, vous devrez peut-être attendre quelques minutes avant de pouvoir créer des ressources à partir de ce modèle. Pour de plus amples informations, veuillez consulter État des ressources et des modèles.

Rubriques

Création d'un actif (console)

Vous pouvez utiliser la AWS IoT SiteWise console pour créer un actif.

Pour créer une ressource (console)

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

  2. Dans le panneau de navigation, choisissez Ressources.

  3. Choisissez Create asset (Créer une ressource).

  4. Sur la page Créer une ressource, procédez comme suit :

    1. Pour Modèle, choisissez le modèle de ressource à partir duquel créer une ressource.

      Note

      Si votre modèle ne l'est pas ACTIVE, vous devez attendre qu'il soit actif ou résoudre les problèmes s'il l'est FAILED.

    2. Saisissez un nom pour votre ressource.

    3. (Facultatif) Ajoutez des balises pour votre ressource. Pour de plus amples informations, veuillez consulter Marquez vos AWS IoT SiteWise ressources.

    4. Choisissez Create asset (Créer une ressource).

    Lorsque vous créez un actif, la AWS IoT SiteWise console accède à la page du nouvel actif. Sur cette page, vous pouvez voir le statut de l'actif, qui est initialement CREATING. Cette page est automatiquement mise à jour, de sorte que vous pouvez attendre la mise à jour de l'état de la ressource.

    Note

    Le processus de création des ressources peut prendre jusqu'à une minute. Une fois le statut défini ACTIVE, vous pouvez effectuer des opérations de mise à jour sur votre actif. Pour de plus amples informations, veuillez consulter État des ressources et des modèles.

Après avoir créé une ressource, veuillez consulter Configuration d'un nouvel actif.

Création d'un actif (AWS CLI)

Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour créer un actif à partir d'un modèle d'actif.

Vous devez avoir un assetModelId pour créer une ressource. Si vous avez créé un modèle d'actif, mais que vous ne le connaissez pasassetModelId, ListAssetModelsAPIutilisez-le pour afficher tous vos modèles d'actifs.

Pour créer un actif à partir d'un modèle d'actif, utilisez le CreateAssetAPIavec les paramètres suivants :

  • assetName— Le nom du nouvel actif. Donnez un nom à votre actif pour vous aider à l'identifier.

  • assetModelId— L'ID de l'actif. Il s'agit de l'identifiant réel au UUID format, ou du externalId:myExternalId s'il en a un. Pour plus d’informations, consultez Objets de référence avec interface externe IDs dans le Guide de l’utilisateur AWS IoT SiteWise .

Pour créer un actif (AWS CLI)

  • Exécutez la commande suivante pour créer une ressource. Remplacez asset-name avec un nom pour l'actif et asset-model-id avec l'ID ou l'ID externe du modèle d'actif. 

    aws iotsitewise create-asset \
  --asset-name asset-name \
  --asset-model-id asset-model-id

    L'opération renvoie une réponse qui contient les détails de votre nouvelle ressource et son état au format suivant.

    {
  "assetId": "String",
  "assetArn": "String",
  "assetStatus": {
    "state": "String",
    "error": {
      "code": "String",
      "message": "String"
    }
  }
}

    L'state de la ressource est CREATING jusqu'à ce que la ressource soit créée.

    Note

    Le processus de création des ressources peut prendre jusqu'à une minute. Pour vérifier l'état de votre actif, utilisez l'DescribeAssetopération avec l'ID de votre actif comme assetId paramètre. Une fois que l'actif state est en ACTIVE place, vous pouvez effectuer des opérations de mise à jour sur celui-ci. Pour de plus amples informations, veuillez consulter État des ressources et des modèles.

Après avoir créé une ressource, veuillez consulter Configuration d'un nouvel actif.