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.
# Configurer les alarmes sur les actifs dans AWS IoT SiteWise
Après avoir défini une AWS IoT Events alarme sur un modèle d'actif, vous pouvez configurer l'alarme pour chaque actif en fonction du modèle d'actif. Vous pouvez modifier la valeur du seuil et les paramètres de notification de l'alarme. Chacune de ces valeurs est un attribut de la ressource. Vous pouvez donc mettre à jour la valeur par défaut de l'attribut pour configurer ces valeurs.
**Note**
Vous pouvez configurer ces valeurs pour les AWS IoT Events alarmes, mais pas pour les alarmes externes.
**Topics**
+ [Configuration d'une valeur de seuil (console)](#configure-alarm-threshold-value-console)
+ [Configurer une valeur de seuil (AWS CLI)](#configure-alarm-threshold-value-cli)
+ [Configurer les paramètres de notification dans AWS IoT SiteWise](configure-alarm-notification-settings.md)
## Configuration d'une valeur de seuil (console)
Vous pouvez utiliser la AWS IoT SiteWise console pour mettre à jour la valeur de l'attribut qui indique le seuil d'une alarme.
**Pour mettre à jour le seuil d'une 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 l'actif pour lequel vous souhaitez mettre à jour une valeur de seuil d'alarme.
**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. Recherchez l'attribut que l'alarme utilise pour sa valeur de seuil, puis entrez sa nouvelle valeur.
1. Choisissez **Enregistrer**.
## Configurer une valeur de seuil (AWS CLI)
Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour mettre à jour la valeur de l'attribut qui indique le seuil d'une 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.
Utilisez l'opération [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) pour affecter des valeurs d'attributs à votre ressource. Vous pouvez utiliser cette opération pour définir plusieurs attributs à la fois. La charge utile de cette opération contient une liste d'entrées, chacune contenant l'ID de ressource, l'ID de propriété et la valeur d'attribut.
**Pour mettre à jour la valeur d'un attribut (AWS CLI)**
1. Créez un fichier nommé `batch-put-payload.json` et copiez l'objet JSON suivant dans le fichier. Cet exemple de charge utile montre comment définir la latitude et la longitude d'une éolienne. Mettez à jour IDs les valeurs et les horodatages pour modifier la charge utile en fonction de votre cas d'utilisation.
```
{
"entries": [
{
"entryId": "windfarm3-turbine7-latitude",
"assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"propertyValues": [
{
"value": {
"doubleValue": 47.6204
},
"timestamp": {
"timeInSeconds": 1575691200
}
}
]
},
{
"entryId": "windfarm3-turbine7-longitude",
"assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE",
"propertyValues": [
{
"value": {
"doubleValue": 122.3491
},
"timestamp": {
"timeInSeconds": 1575691200
}
}
]
}
]
}
```
+ Chaque entrée de la charge utile contient un `entryId` que vous pouvez définir sous la forme d'une chaîne unique. Si des entrées de demande échouent, chaque erreur contiendra l'`entryId` de la demande correspondante afin que vous sachiez quelles demandes réessayer.
+ Pour définir une valeur d'attribut, vous pouvez inclure une structure timestamp-quality-value (TQV) dans la liste de chaque propriété `propertyValues` d'attribut. Cette structure doit contenir le nouveau `value` et le `timestamp` actuel.
+ `value`— Structure contenant l'un des champs suivants, en fonction du type de propriété défini :
+ `booleanValue`
+ `doubleValue`
+ `integerValue`
+ `stringValue`
+ `nullValue`
+ `timestamp`— Une structure qui contient l'heure actuelle d'Unix en secondes,. `timeInSeconds` AWS IoT SiteWise rejette tous les points de données dont l'horodatage existait depuis plus de 7 jours ou moins de 5 minutes dans le futur.
Pour de plus amples informations sur la préparation d'une charge utile pour [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html), veuillez consulter [Ingérez des données avec AWS IoT SiteWise APIs](ingest-api.md).
1. Exécutez la commande suivante pour envoyer les valeurs d'attribut à AWS IoT SiteWise :
```
aws iotsitewise batch-put-asset-property-value -\-cli-input-json file://batch-put-payload.json
```
# Configurer les paramètres de notification dans AWS IoT SiteWise
Vous pouvez configurer les paramètres de notification d'alarme à l'aide de la AWS IoT SiteWise console ou du AWS Command Line Interface (AWS CLI).
## Configuration des paramètres de notification (console)
Vous pouvez utiliser la AWS IoT SiteWise console pour mettre à jour la valeur des attributs qui spécifient les paramètres de notification pour une alarme.
**Pour mettre à jour les paramètres de notification d'une 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 l'actif pour lequel vous souhaitez mettre à jour les paramètres d'alarme.
1. Choisissez **Modifier**.
1. Recherchez l'attribut utilisé par l'alarme pour le paramètre de notification que vous souhaitez modifier, puis entrez sa nouvelle valeur.
1. Choisissez **Enregistrer**.
## Configuration des paramètres de notification (CLI)
Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour mettre à jour la valeur de l'attribut qui spécifie les paramètres de notification pour une 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.
Utilisez l'opération [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) pour affecter des valeurs d'attributs à votre ressource. Vous pouvez utiliser cette opération pour définir plusieurs attributs à la fois. La charge utile de cette opération contient une liste d'entrées, chacune contenant l'ID de ressource, l'ID de propriété et la valeur d'attribut.
**Pour mettre à jour la valeur d'un attribut (AWS CLI)**
1. Créez un fichier nommé `batch-put-payload.json` et copiez l'objet JSON suivant dans le fichier. Cet exemple de charge utile montre comment définir la latitude et la longitude d'une éolienne. Mettez à jour IDs les valeurs et les horodatages pour modifier la charge utile en fonction de votre cas d'utilisation.
```
{
"entries": [
{
"entryId": "windfarm3-turbine7-latitude",
"assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
"propertyValues": [
{
"value": {
"doubleValue": 47.6204
},
"timestamp": {
"timeInSeconds": 1575691200
}
}
]
},
{
"entryId": "windfarm3-turbine7-longitude",
"assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
"propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE",
"propertyValues": [
{
"value": {
"doubleValue": 122.3491
},
"timestamp": {
"timeInSeconds": 1575691200
}
}
]
}
]
}
```
+ Chaque entrée de la charge utile contient un `entryId` que vous pouvez définir sous la forme d'une chaîne unique. Si des entrées de demande échouent, chaque erreur contiendra l'`entryId` de la demande correspondante afin que vous sachiez quelles demandes réessayer.
+ Pour définir une valeur d'attribut, vous pouvez inclure une structure timestamp-quality-value (TQV) dans la liste de chaque propriété `propertyValues` d'attribut. Cette structure doit contenir le nouveau `value` et le `timestamp` actuel.
+ `value`— Structure contenant l'un des champs suivants, en fonction du type de propriété défini :
+ `booleanValue`
+ `doubleValue`
+ `integerValue`
+ `stringValue`
+ `nullValue`
+ `timestamp`— Une structure qui contient l'heure actuelle d'Unix en secondes,. `timeInSeconds` AWS IoT SiteWise rejette tous les points de données dont l'horodatage existait depuis plus de 7 jours ou moins de 5 minutes dans le futur.
Pour de plus amples informations sur la préparation d'une charge utile pour [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html), veuillez consulter [Ingérez des données avec AWS IoT SiteWise APIs](ingest-api.md).
1. Exécutez la commande suivante pour envoyer les valeurs d'attribut à AWS IoT SiteWise :
```
aws iotsitewise batch-put-asset-property-value -\-cli-input-json file://batch-put-payload.json
```