Création d'un modèle d'actif (console)Création d'un modèle d'actifs (AWS CLI)Exemples de modèles de ressources

Création de modèles d'actifs

AWS IoT SiteWise les modèles d'actifs favorisent la standardisation de vos données industrielles. Un modèle de ressource contient un nom, une description, des propriétés de ressource et des définitions de hiérarchie de ressources. Par exemple, vous pouvez définir un modèle d'éolienne avec des propriétés de température, de rotations par minute (RPM) et de puissance. Ensuite, vous pouvez définir un modèle de parc éolien avec une propriété de puissance de sortie nette et une définition de hiérarchie d'éoliennes.

Note

Nous vous recommandons de modéliser votre opération en commençant par les nœuds de niveau inférieur. Par exemple, créez votre modèle d'éolienne avant de créer votre modèle de parc éolien. Les définitions de hiérarchie des ressources contiennent des références à des modèles de ressources existants. En suivant cette approche, vous pouvez définir des hiérarchies de ressources lors de la création de vos modèles.
Les modèles d'actifs ne peuvent pas contenir d'autres modèles d'actifs. Si vous devez définir un modèle auquel vous pouvez faire référence en tant que sous-assemblage au sein d'un autre modèle, vous devez plutôt créer un modèle composant-->. Pour de plus amples informations, veuillez consulter Création de modèles de composants.

Les sections suivantes décrivent comment utiliser la AWS IoT SiteWise console ou API créer des modèles d'actifs. Les sections suivantes décrivent également les différents types de propriétés et de hiérarchies de ressources que vous pouvez utiliser pour créer des modèles.

Rubriques

Création d'un modèle d'actif (console)
Création d'un modèle d'actifs (AWS CLI)
Exemples de modèles de ressources
Définir les hiérarchies des modèles d'actifs

Création d'un modèle d'actif (console)

Vous pouvez utiliser la AWS IoT SiteWise console pour créer un modèle d'actif. La AWS IoT SiteWise console fournit diverses fonctionnalités, telles que la saisie automatique des formules, qui peuvent vous aider à définir des modèles d'actifs valides.

Pour créer un modèle de ressource (console)

Accédez à la console AWS IoT SiteWise.
Dans le panneau de navigation, choisissez Models (Modèles).
Sélectionnez Create model.
Sur la page Créer un modèle, procédez comme suit :
1. Saisissez un nom pour le modèle de ressource, tel que Wind Turbine ou Wind Turbine Model. Ce nom doit être unique pour tous les modèles de votre compte dans cette région.
2. (Facultatif) Ajoutez un ID externe pour le modèle. Il s'agit d'un identifiant défini par l'utilisateur. Pour plus d’informations, consultez Objets de référence avec interface externe IDs dans le Guide de l’utilisateur AWS IoT SiteWise .
3. (Facultatif) Ajoutez des définitions de mesures pour le modèle. Les mesures représentent des flux de données provenant de votre équipement. Pour de plus amples informations, veuillez consulter Définir les flux de données provenant de l'équipement (mesures).
4. (Facultatif) Ajoutez des définitions de transformations pour le modèle. Les transformations sont des formules qui font correspondre les données d'un formulaire à un autre. Pour de plus amples informations, veuillez consulter Transformer les données (transformations).
5. (Facultatif) Ajoutez des définitions de métriques pour le modèle. Les métriques sont des formules qui regroupent les données sur des intervalles de temps. Les métriques peuvent saisir des données provenant des actifs associés, afin que vous puissiez calculer des valeurs représentant votre activité ou un sous-ensemble de celle-ci. Pour de plus amples informations, veuillez consulter Données agrégées provenant de propriétés et d'autres actifs (métriques).
6. (Facultatif) Ajoutez des définitions de hiérarchies pour le modèle. Les hiérarchies sont des relations entre les actifs. Pour de plus amples informations, veuillez consulter Définir les hiérarchies des modèles d'actifs.
7. (Facultatif) Ajoutez des balises pour le modèle de ressource. Pour de plus amples informations, veuillez consulter Marquez vos AWS IoT SiteWise ressources.
8. Sélectionnez Create model.
Lorsque vous créez un modèle de ressource, la AWS IoT SiteWise console accède à la page du nouveau modèle. Sur cette page, vous pouvez voir le statut du modèle, qui est initialement CREATING. Cette page est automatiquement mise à jour, de sorte que vous pouvez attendre la mise à jour de l'état du modèle.

Note
Le processus de création de modèles de ressources peut prendre jusqu'à quelques minutes pour les modèles complexes. Une fois que le statut du modèle d'actif est défini ACTIVE, vous pouvez utiliser le modèle d'actif pour créer des actifs. Pour de plus amples informations, veuillez consulter État des ressources et des modèles.
(Facultatif) Après avoir créé votre modèle d'actif, vous pouvez le configurer pour la périphérie. Pour plus d'informations sur SiteWise Edge, consultezActiver le traitement des données Edge.
1. Sur la page du modèle, choisissez Configurer pour Edge.
2. Sur la page de configuration du modèle, choisissez la configuration des bords pour votre modèle. Cela contrôle les endroits où les propriétés associées à ce modèle d'actif AWS IoT SiteWise peuvent être calculées et stockées. Pour plus d'informations sur la configuration de votre modèle pour le bord, consultezConfiguration de la fonctionnalité Edge.
3. Pour la configuration personnalisée de la périphérie, choisissez l'emplacement où vous AWS IoT SiteWise souhaitez calculer et stocker chacune des propriétés de votre modèle d'actifs.
  
  Note
  Les transformations et les métriques associées doivent être configurées pour le même emplacement. Pour plus d'informations sur la configuration de votre modèle pour le bord, consultezConfiguration de la fonctionnalité Edge.
4. Choisissez Save (Enregistrer). Sur la page du modèle, votre configuration Edge doit maintenant être configurée.

Création d'un modèle d'actifs (AWS CLI)

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

Utilisez cette CreateAssetModelopération pour créer un modèle d'actif avec des propriétés et des hiérarchies. Cette opération attend une charge utile avec la structure suivante.


{
  "assetModelType": "ASSET_MODEL",
  "assetModelName": "String",
  "assetModelDescription": "String",
  "assetModelProperties": Array of AssetModelProperty,
  "assetModelHierarchies": Array of AssetModelHierarchyDefinition
}

Pour créer un modèle d'actif (AWS CLI)

Créez un fichier appelé, asset-model-payload.json puis copiez l'JSONobjet suivant dans le fichier.


{
  "assetModelType": "ASSET_MODEL",
  "assetModelName": "",
  "assetModelDescription": "",
  "assetModelProperties": [

  ],
  "assetModelHierarchies": [

  ],
  "assetModelCompositeModels": [

  ]
}

Utilisez votre éditeur de JSON texte préféré pour modifier le asset-model-payload.json fichier comme suit :
1. Saisissez un nom (assetModelName) pour le modèle de ressource, tel que Wind Turbine ou Wind Turbine Model. Ce nom doit être unique pour tous les modèles d'actifs et modèles de composants de votre compte Région AWS.
2. (Facultatif) Entrez un ID externe (assetModelExternalId) pour le modèle d'actif. Il s'agit d'un identifiant défini par l'utilisateur. Pour plus d’informations, consultez Objets de référence avec interface externe IDs dans le Guide de l’utilisateur AWS IoT SiteWise .
3. (Facultatif) Saisissez une description (assetModelDescription) pour le modèle de ressource ou supprimez la paire clé-valeur assetModelDescription.
4. (Facultatif) Définissez les propriétés de ressources (assetModelProperties) pour le modèle. Pour de plus amples informations, veuillez consulter Définir les propriétés des données.
5. (Facultatif) Définissez les hiérarchies de ressources (assetModelHierarchies) pour le modèle. Pour de plus amples informations, veuillez consulter Définir les hiérarchies des modèles d'actifs.
6. (Facultatif) Définissez les alarmes pour le modèle. Les alarmes surveillent d'autres propriétés afin que vous puissiez identifier les équipements ou les processus nécessitant une attention particulière. Chaque définition d'alarme est un modèle composite (assetModelCompositeModels) qui normalise l'ensemble de propriétés utilisées par l'alarme. Pour plus d’informations, consultez Surveillez les données avec des alarmes et Définissez des alarmes sur les modèles d'actifs.
7. (Facultatif) Ajoutez des balises (tags) pour le modèle de ressource. Pour de plus amples informations, veuillez consulter Marquez vos AWS IoT SiteWise ressources.
Exécutez la commande suivante pour créer un modèle de ressource à partir de la définition du JSON fichier.
```
aws iotsitewise create-asset-model --cli-input-json file://asset-model-payload.json
```
L'opération renvoie une réponse qui contient l'élément assetModelId auquel vous faites référence lors de la création d'une ressource. La réponse contient également l'état du modèle (assetModelStatus.state), qui est initialement CREATING. L'état du modèle de ressource correspond à CREATING jusqu'à ce que les modifications se propagent.

Note
Le processus de création de modèles de ressources peut prendre jusqu'à quelques minutes pour les modèles complexes. Pour vérifier l'état actuel de votre modèle d'actif, utilisez l'DescribeAssetModelopération en spécifiant leassetModelId. Une fois que le statut du modèle de ressource est ACTIVE, vous pouvez l'utiliser pour créer des ressources. Pour de plus amples informations, veuillez consulter État des ressources et des modèles.
(Facultatif) Créez des modèles composites personnalisés pour votre modèle d'actif. Avec les modèles composites personnalisés, vous pouvez regrouper les propriétés au sein du modèle ou inclure un sous-assemblage en faisant référence à un modèle de composant. Pour de plus amples informations, veuillez consulter Création de modèles composites personnalisés (composants).

Exemples de modèles de ressources

Cette section contient des exemples de définitions de modèles d'actifs que vous pouvez utiliser pour créer des modèles d'actifs avec le AWS CLI et AWS IoT SiteWise SDKs. Ces modèles d'actifs représentent une éolienne et un parc éolien. Les actifs des éoliennes ingèrent les données brutes des capteurs et calculent des valeurs telles que la puissance et la vitesse moyenne du vent. Les actifs du parc éolien calculent des valeurs telles que la puissance totale de toutes les éoliennes du parc éolien.

Modèle de ressource d’éolienne

Le modèle de ressource suivant représente une éolienne dans un parc éolien. L'éolienne ingère les données des capteurs pour calculer des valeurs telles que la puissance et la vitesse moyenne du vent.

Note

Cet exemple de modèle ressemble au modèle d'éolienne de la AWS IoT SiteWise démo. Pour de plus amples informations, veuillez consulter Utiliser la AWS IoT SiteWise démo.


{
  "assetModelType": "ASSET_MODEL",
  "assetModelName": "Wind Turbine Asset Model",
  "assetModelDescription": "Represents a turbine in a wind farm.",
  "assetModelProperties": [
    {
      "name": "Location",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "Renton"
        }
      }
    },
    {
      "name": "Make",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "Amazon"
        }
      }
    },
    {
      "name": "Model",
      "dataType": "INTEGER",
      "type": {
        "attribute": {
          "defaultValue": "500"
        }
      }
    },
    {
      "name": "Torque (KiloNewton Meter)",
      "dataType": "DOUBLE",
      "unit": "kNm",
      "type": {
        "measurement": {}
      }
    },
    {
      "name": "Wind Direction",
      "dataType": "DOUBLE",
      "unit": "Degrees",
      "type": {
        "measurement": {}
      }
    },
    {
      "name": "RotationsPerMinute",
      "dataType": "DOUBLE",
      "unit": "RPM",
      "type": {
        "measurement": {}
      }
    },
    {
      "name": "Wind Speed",
      "dataType": "DOUBLE",
      "unit": "m/s",
      "type": {
        "measurement": {}
      }
    },
    {
      "name": "RotationsPerSecond",
      "dataType": "DOUBLE",
      "unit": "RPS",
      "type": {
        "transform": {
          "expression": "rpm / 60",
          "variables": [
            {
              "name": "rpm",
              "value": {
                "propertyId": "RotationsPerMinute"
              }
            }
          ]
        }
      }
    },
    {
      "name": "Overdrive State",
      "dataType": "DOUBLE",
      "type": {
        "transform": {
          "expression": "gte(torque, 3)",
          "variables": [
            {
              "name": "torque",
              "value": {
                "propertyId": "Torque (KiloNewton Meter)"
              }
            }
          ]
        }
      }
    },
    {
      "name": "Average Power",
      "dataType": "DOUBLE",
      "unit": "Watts",
      "type": {
        "metric": {
          "expression": "avg(torque) * avg(rps) * 2 * 3.14",
          "variables": [
            {
              "name": "torque",
              "value": {
                "propertyId": "Torque (Newton Meter)"
              }
            },
            {
              "name": "rps",
              "value": {
                "propertyId": "RotationsPerSecond"
              }
            }
          ],
          "window": {
            "tumbling": {
              "interval": "5m"
            }
          }
        }
      }
    },
    {
      "name": "Average Wind Speed",
      "dataType": "DOUBLE",
      "unit": "m/s",
      "type": {
        "metric": {
          "expression": "avg(windspeed)",
          "variables": [
            {
              "name": "windspeed",
              "value": {
                "propertyId": "Wind Speed"
              }
            }
          ],
          "window": {
            "tumbling": {
              "interval": "5m"
            }
          }
        }
      }
    },
    {
      "name": "Torque (Newton Meter)",
      "dataType": "DOUBLE",
      "unit": "Nm",
      "type": {
        "transform": {
          "expression": "knm * 1000",
          "variables": [
            {
              "name": "knm",
              "value": {
                "propertyId": "Torque (KiloNewton Meter)"
              }
            }
          ]
        }
      }
    },
    {
      "name": "Overdrive State Time",
      "dataType": "DOUBLE",
      "unit": "Seconds",
      "type": {
        "metric": {
          "expression": "statetime(overdrive_state)",
          "variables": [
            {
              "name": "overdrive_state",
              "value": {
                "propertyId": "Overdrive State"
              }
            }
          ],
          "window": {
            "tumbling": {
              "interval": "5m"
            }
          }
        }
      }
    }
  ],
  "assetModelHierarchies": []
}

Modèle de ressource de parc éolien

Le modèle de ressource suivant représente un parc éolien qui comprend plusieurs éoliennes. Ce modèle d'actif définit une hiérarchie par rapport au modèle d'éolienne. Cela permet au parc éolien de calculer des valeurs (telles que la puissance moyenne) à partir des données de toutes les éoliennes du parc éolien.

Note

Cet exemple de modèle ressemble au modèle de parc éolien présenté dans la AWS IoT SiteWise démo. Pour de plus amples informations, veuillez consulter Utiliser la AWS IoT SiteWise démo.

Ce modèle de ressource dépend du Modèle de ressource d’éolienne. Remplacez les valeurs propertyId et childAssetModelId par celles d'un modèle de ressource d'éolienne existant.


{
  "assetModelName": "Wind Farm Asset Model",
  "assetModelDescription": "Represents a wind farm.",
  "assetModelProperties": [
    {
      "name": "Code",
      "dataType": "INTEGER",
      "type": {
        "attribute": {
          "defaultValue": "300"
        }
      }
    },
    {
      "name": "Location",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "Renton"
        }
      }
    },
    {
      "name": "Reliability Manager",
      "dataType": "STRING",
      "type": {
        "attribute": {
          "defaultValue": "Mary Major"
        }
      }
    },
    {
      "name": "Total Overdrive State Time",
      "dataType": "DOUBLE",
      "unit": "seconds",
      "type": {
        "metric": {
          "expression": "sum(overdrive_state_time)",
          "variables": [
            {
              "name": "overdrive_state_time",
              "value": {
                "propertyId": "ID of Overdrive State Time property in Wind Turbine Asset Model",
                "hierarchyId": "Turbine Asset Model"
              }
            }
          ],
          "window": {
            "tumbling": {
              "interval": "5m"
            }
          }
        }
      }
    },
    {
      "name": "Total Average Power",
      "dataType": "DOUBLE",
      "unit": "Watts",
      "type": {
        "metric": {
          "expression": "sum(turbine_avg_power)",
          "variables": [
            {
              "name": "turbine_avg_power",
              "value": {
                "propertyId": "ID of Average Power property in Wind Turbine Asset Model",
                "hierarchyId": "Turbine Asset Model"
              }
            }
          ],
          "window": {
            "tumbling": {
              "interval": "5m"
            }
          }
        }
      }
    }
  ],
  "assetModelHierarchies": [
    {
      "name": "Turbine Asset Model",
      "childAssetModelId": "ID of Wind Turbine Asset Model"
    }
  ]
}

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Création de modèles

Définir les hiérarchies des modèles d'actifs