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. # Ingérer un état d'alarme externe dans AWS IoT SiteWise Les alarmes externes sont des alarmes que vous évaluez en dehors de celles-ci AWS IoT SiteWise. Vous pouvez utiliser des alarmes externes lorsqu'une source de données indique l'état des alarmes que vous souhaitez ingérer AWS IoT SiteWise. Les propriétés d'état d'alarme nécessitent un format spécifique pour les valeurs des données d'état d'alarme. Chaque valeur de données doit être un objet JSON sérialisé en chaîne. Ensuite, vous ingérez la chaîne sérialisée sous forme de valeur de chaîne. Pour de plus amples informations, veuillez consulter [Propriétés de l'état de l'alarme](industrial-alarms.md#alarm-state-properties). **Example Exemple de valeur de données d'état d'alarme (non sérialisée)** ``` { "stateName": "Active" } ``` **Example Exemple de valeur de données d'état d'alarme (sérialisée)** ``` {\"stateName\":\"Active\"} ``` **Note** Si votre source de données ne peut pas fournir de données dans ce format, ou si vous ne pouvez pas convertir vos données dans ce format avant de les ingérer, vous pouvez choisir de ne pas utiliser de propriété d'alarme. Au lieu de cela, vous pouvez ingérer les données en tant que propriété de mesure avec le type de données chaîne, par exemple. Pour plus d’informations, consultez [Définir les flux de données provenant de l'équipement (mesures)](measurements.md) et [Ingérez des données dans AWS IoT SiteWise](industrial-data-ingestion.md). # Cartographiez les flux d'état des alarmes externes dans AWS IoT SiteWise Vous pouvez définir des alias de propriété pour mapper vos flux de données aux propriétés de l'état de votre alarme. Cela vous permet d'identifier facilement une propriété d'état d'alarme lorsque vous ingérez ou récupérez des données. Pour plus d'informations sur les alias de propriété, consultez[Gérez les flux de données pour AWS IoT SiteWise](manage-data-streams.md). **Topics** + [Cartographier les flux d'état des alarmes externes (console)](#connect-alarm-data-stream-console) + [Cartographier les flux d'état des alarmes externes (AWS CLI)](#connect-alarm-data-stream-cli) ## Cartographier les flux d'état des alarmes externes (console) Vous pouvez définir des alias de propriété pour mapper vos flux de données aux propriétés de l'état de votre alarme. Cela vous permet d'identifier facilement une propriété d'état d'alarme lorsque vous ingérez ou récupérez des données. Pour plus d'informations sur les alias de propriété, consultez[Gérez les flux de données pour AWS IoT SiteWise](manage-data-streams.md). Vous pouvez utiliser la AWS IoT SiteWise console pour définir un alias pour une propriété d'état d'alarme. **Pour définir un alias de propriété pour une propriété d'état d'alarme (console)** 1. Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. Dans le panneau de navigation, choisissez **Ressources**. 1. Choisissez la ressource pour laquelle vous souhaitez définir un alias de propriété. **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. 1. Choisissez **Modifier**. 1. Faites défiler la page jusqu'à **Alarmes** et développez la section. 1. Sous **Alarmes externes**, entrez l'alias dans **Alias de propriété — *facultatif***. 1. Choisissez **Enregistrer**. ## Cartographier les flux d'état des alarmes externes (AWS CLI) Vous pouvez définir des alias de propriété pour mapper vos flux de données aux propriétés de l'état de votre alarme. Cela vous permet d'identifier facilement une propriété d'état d'alarme lorsque vous ingérez ou récupérez des données. Pour plus d'informations sur les alias de propriété, consultez[Gérez les flux de données pour AWS IoT SiteWise](manage-data-streams.md). Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour définir un alias pour une propriété d'état d'alarme. Vous devez connaître l'`assetId` de votre ressource et le `propertyId`de la propriété pour effectuer cette procédure. Vous pouvez également utiliser l'identifiant externe. Si vous avez créé un actif et que vous ne le connaissez pas`assetId`, utilisez l'[ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html)API pour répertorier tous les actifs d'un modèle spécifique. Utilisez cette [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)opération pour afficher les propriétés de votre actif, y compris les propriétés IDs. **Note** La [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)réponse inclut la liste des modèles d'actifs composites pour l'actif. Chaque alarme est un modèle composite. Pour trouver le`propertyId`, recherchez le modèle composite de l'alarme, puis recherchez la `AWS/ALARM_STATE` propriété dans ce modèle composite. Pour plus d'informations sur la définition de l'alias de propriété, consultez[Mettre à jour un alias de propriété d'actif](update-data-streams-method.md). # Ingérer les données d'état des alarmes dans AWS IoT SiteWise Les propriétés d'état d'alarme prévoient un état d'alarme sous forme de chaîne JSON sérialisée. Pour intégrer l'état d'alarme à une alarme externe AWS IoT SiteWise, vous devez ingérer cette chaîne sérialisée sous forme de valeur de chaîne horodatée. L'exemple suivant montre une valeur de données d'état pour une alarme active. ``` {\"stateName\":\"Active\"} ``` Pour identifier une propriété d'état d'alarme, vous pouvez spécifier l'une des options suivantes : + La `assetId` fin `propertyId` de la propriété d'alarme à laquelle vous envoyez des données. + Le`propertyAlias`, qui est un alias de flux de données (par exemple,`/company/windfarm/3/turbine/7/temperature/high`). Pour utiliser cette option, vous devez d'abord définir l'alias de la propriété de votre alarme. Pour savoir comment définir des alias de propriété pour les propriétés d'état des alarmes, consultez[Cartographiez les flux d'état des alarmes externes dans AWS IoT SiteWise](connect-alarm-data-streams.md). L'exemple de charge utile de [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html)l'API suivant montre comment formater l'état d'une alarme externe. Cette alarme externe signale lorsque le nombre de rotations par minute (RPM) d'une éolienne est trop élevé. **Example Exemple de BatchPutAssetPropertyValue charge utile pour les données d'état des alarmes** ``` { "entries": [ { "entryId": "unique entry ID", "propertyAlias": "/company/windfarm/3/turbine/7/temperature/high", "propertyValues": [ { "value": { "stringValue": "{\"stateName\":\"Active\"}" }, "timestamp": { "timeInSeconds": 1607550262 } } ] } ] } ``` Pour plus d'informations sur l'utilisation de l'`BatchPutAssetPropertyValue`API pour ingérer des données, consultez[Ingérez des données avec AWS IoT SiteWise APIs](ingest-api.md). Pour plus d'informations sur les autres méthodes d'ingestion de données, consultez[Ingérez des données dans AWS IoT SiteWise](industrial-data-ingestion.md).