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.
# Gérer les destinations AWS IoT SiteWise Edge
Après avoir ajouté des destinations, vous pouvez effectuer diverses opérations pour les gérer, telles que la modification des configurations de destination, la suppression de destinations et la gestion des filtres de chemin.
## Modifier une destination
Sélectionnez le bouton radio à côté de la destination dans le tableau et cliquez sur le bouton **Modifier** pour modifier une destination.
------
#### [ Console ]
**Pour modifier une destination à l'aide de la AWS IoT SiteWise console**
1. Ouvrez la [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/).
1. Dans le volet de navigation de gauche, choisissez **Edge gateway** dans la section **Edge**.
1. Sélectionnez la passerelle appropriée.
1. Dans la section **Destinations**, choisissez la destination que vous souhaitez modifier, puis sélectionnez **Modifier**.
1. Modifiez la destination, puis choisissez **Enregistrer**.
------
#### [ AWS CLI ]
**Pour modifier une destination à l'aide de AWS CLI**
+ Vous pouvez modifier une destination en modifiant les informations de configuration de la fonctionnalité JSON.
```
aws iotsitewise update-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--capability-configuration '{
"sources": [
{
"type": "MQTT"
}
],
"destinations": [
{
"id": "your-existing-destination-id",
"type": "SITEWISE_REALTIME",
"name": "your-updated-destination-name",
"config": {
"publishingOrder": "TIME_ORDER",
"enableCompression": true,
"dropPolicy": {
"cutoffAge": "10d",
"exportPolicy": {
"retentionPeriod": "10d",
"rotationPeriod": "6h",
"exportSizeLimitGB": 10
}
},
"maxBatchWaitTime": "15s"
},
"filters": [
{
...
}
]
}
]
}'
```
**Note**
Vous ne pouvez pas mettre à jour la destination `type` ou`capability-namespace`. Par exemple, vous ne pouvez pas passer d'un type de `SITEWISE_REALTIME` à`SITEWISE_BUFFERED`. Vous pouvez avoir une destination en temps réel pour chaque passerelle compatible MQTT.
------
## Supprimer une destination
Si vous n'avez plus besoin d'une destination, vous pouvez la supprimer de votre passerelle SiteWise Edge.
------
#### [ Console ]
**Pour supprimer une destination à l'aide de la AWS IoT SiteWise console**
1. Ouvrez la [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/).
1. Dans le volet de navigation de gauche, choisissez **Edge gateway** dans la section **Edge**.
1. Sélectionnez la passerelle appropriée.
1. Dans la section **Destinations**, choisissez la destination que vous souhaitez supprimer, puis sélectionnez **Supprimer**. Un écran de confirmation apparaît.
1. Pour confirmer votre choix de supprimer la destination, tapez « supprimer » dans le champ de confirmation.
------
#### [ AWS CLI ]
**Pour supprimer une destination à l'aide de AWS CLI**
+ Supprimez la configuration des fonctionnalités de la passerelle en spécifiant l'ID de la passerelle et en modifiant la configuration des fonctionnalités pour supprimer la destination que vous souhaitez supprimer.
```
aws iotsitewise update-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--capability-configuration '{
"sources": [
{
"type": "MQTT"
}
],
"destinations": []
}'
```
**Note**
Le tableau de destinations peut être vide (`[]`), mais l'objet de destinations lui-même doit être inclus dans la configuration des fonctionnalités.
------
## Télécharger tous les filtres de chemin d'une destination (console)
Téléchargez un fichier CSV contenant tous vos filtres de chemin dans la AWS IoT SiteWise console. Vous pouvez utiliser une liste de filtres de chemin téléchargée pour partager facilement des listes de filtres de chemin entre les destinations de passerelle.
**Pour télécharger un fichier CSV contenant tous les filtres de chemin à l'aide de la AWS IoT SiteWise console**
1. Ouvrez la [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/).
1. Dans le volet de navigation de gauche, choisissez **Edge gateway** dans la section **Edge**.
1. Sélectionnez la passerelle contenant vos filtres de chemin.
1. Choisissez **Ajouter une destination** ou **Modifier la destination**.
1. Accédez à la section **Filtres de chemin** et choisissez **Télécharger le fichier CSV**.
**Note**
Le fichier CSV inclut tous les filtres de chemin d'une destination donnée, quels que soient ceux que vous avez sélectionnés dans la liste des filtres de chemin.
## Modifier un filtre de chemin
Vous pouvez modifier les filtres de chemin individuels pour affiner les données que reçoit votre destination.
------
#### [ Console ]
À l'aide de la AWS IoT SiteWise console, vous pouvez modifier chaque filtre de chemin individuel dans chaque zone de texte correspondante.
**Pour modifier un filtre de chemin à l'aide de la AWS IoT SiteWise console**
1. Ouvrez la [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/).
1. Dans le volet de navigation de gauche, choisissez **Edge gateway** dans la section **Edge**.
1. Sélectionnez la passerelle contenant vos filtres de chemin.
1. Sélectionnez la destination appropriée.
1. Choisissez **Modifier**.
1. Choisissez la zone de texte correspondant à la ligne contenant le filtre de chemin que vous souhaitez modifier.
1. Mettez à jour le texte du filtre de chemin en vous assurant que la case du filtre de chemin modifié est cochée.
1. Choisissez **Enregistrer**.
------
#### [ AWS CLI ]
Pour modifier les filtres de chemin d'une destination à l'aide du AWS CLI, récupérez d'abord la configuration actuelle, modifiez-la, puis mettez-la à jour à l'aide de la `update-gateway-capability-configuration` commande.
**Pour modifier un filtre de chemin à l'aide de AWS CLI**
1. Récupérez la configuration de capacité actuelle :
```
aws iotsitewise describe-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--query "capabilityConfiguration"
```
1. Modifiez le JSON pour modifier les filtres de chemin selon vos besoins.
1. Mettez à jour la configuration des fonctionnalités avec les filtres de chemin modifiés :
```
aws iotsitewise update-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--capability-configuration json-containing-your-updated-path-filters
```
------
## Supprimer un filtre de chemin
Vous pouvez supprimer les filtres de chemin d'une destination afin de contrôler les données qu'elle reçoit des sources MQTT et des pipelines de traitement de données.
------
#### [ Console ]
**Pour supprimer un filtre de chemin à l'aide de la AWS IoT SiteWise console**
1. Ouvrez la [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/).
1. Dans le volet de navigation de gauche, choisissez **Edge gateway** dans la section **Edge**.
1. Sélectionnez la passerelle contenant vos filtres de chemin.
1. Sélectionnez la destination appropriée.
1. Choisissez **Modifier**.
1. Sur l'écran **Modifier la destination**, dans la section **Filtres de chemin**, sélectionnez un ou plusieurs filtres de chemin à supprimer.
1. Sélectionnez **Delete (Supprimer)**. Un message de confirmation de suppression s'affiche. Si vous souhaitez procéder à la suppression des filtres de chemin, choisissez **Supprimer** sur l'écran de confirmation.
------
#### [ AWS CLI ]
**Pour supprimer une destination à l'aide de AWS CLI**
+ Supprimez un filtre de chemin en le retirant de la configuration des fonctionnalités.
```
aws iotsitewise update-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--capability-configuration '{
"sources": [
{
"type": "MQTT"
}
],
"destinations": [
{
"id": "your-destination-id",
"type": "SITEWISE_REALTIME",
"name": "your-destination-name",
"config": {
...
},
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"/path1",
"/path2",
"/delete-a-path-to-remove-it"
]
}
}
]
}
]
}
```
**Note**
Le tableau de filtres peut être vide (`[]`), mais l'objet des filtres lui-même doit être inclus dans la configuration des fonctionnalités.
------