Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Gestisci le destinazioni AWS IoT SiteWise Edge
Dopo aver aggiunto le destinazioni, è possibile eseguire diverse operazioni per gestirle, ad esempio modificare le configurazioni delle destinazioni, eliminare le destinazioni e gestire i filtri dei percorsi.
## Modificare una destinazione
Seleziona il pulsante di opzione accanto alla destinazione nella tabella e scegli il pulsante **Modifica** per modificare una destinazione.
------
#### [ Console ]
**Per modificare una destinazione utilizzando la AWS IoT SiteWise console**
1. Apri la [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/).
1. Nella barra di navigazione a sinistra, scegli **Edge gateway** nella sezione **Edge**.
1. Seleziona il gateway appropriato.
1. Nella sezione **Destinazioni**, scegli la destinazione che desideri modificare, quindi scegli **Modifica**.
1. Modifica la destinazione, quindi scegli **Salva**.
------
#### [ AWS CLI ]
**Per modificare una destinazione utilizzando AWS CLI**
+ È possibile modificare una destinazione modificando le informazioni di configurazione della funzionalità 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": [
{
...
}
]
}
]
}'
```
**Nota**
Non puoi aggiornare la destinazione `type` o. `capability-namespace` Ad esempio, non puoi passare da un tipo `SITEWISE_REALTIME` a`SITEWISE_BUFFERED`. È possibile avere una destinazione in tempo reale per ogni gateway abilitato per MQTT.
------
## Eliminare una destinazione
Se non hai più bisogno di una destinazione, puoi eliminarla dal tuo gateway SiteWise Edge.
------
#### [ Console ]
**Per eliminare una destinazione utilizzando la AWS IoT SiteWise console**
1. Apri la [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/).
1. Nella barra di navigazione a sinistra, scegli **Edge gateway** nella sezione **Edge**.
1. Seleziona il gateway appropriato.
1. Nella sezione **Destinazioni**, scegli la destinazione che desideri eliminare, quindi scegli **Elimina**. Viene visualizzata una schermata di conferma.
1. Per confermare la scelta di eliminare la destinazione, digita «elimina» nella casella di conferma.
------
#### [ AWS CLI ]
**Per eliminare una destinazione utilizzando AWS CLI**
+ Eliminare la configurazione della funzionalità del gateway specificando l'ID del gateway e modificando la configurazione della funzionalità per rimuovere la destinazione che si desidera eliminare.
```
aws iotsitewise update-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--capability-configuration '{
"sources": [
{
"type": "MQTT"
}
],
"destinations": []
}'
```
**Nota**
L'array delle destinazioni può essere vuoto (`[]`), ma l'oggetto di destinazione stesso deve essere incluso nella configurazione delle funzionalità.
------
## Scarica tutti i filtri di percorso in una destinazione (console)
Scarica un file CSV contenente tutti i filtri di percorso nella AWS IoT SiteWise console. Puoi utilizzare un elenco scaricato di filtri di percorso per condividere facilmente gli elenchi di filtri di percorso tra le destinazioni del gateway.
**Per scaricare un file CSV di tutti i filtri di percorso utilizzando la console AWS IoT SiteWise**
1. Apri la [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/).
1. Nella barra di navigazione a sinistra, scegli **Edge gateway** nella sezione **Edge**.
1. Seleziona il gateway contenente i filtri di percorso.
1. Scegli **Aggiungi destinazione** o **Modifica destinazione**.
1. Vai alla sezione **Filtri Path** e scegli **Scarica CSV**.
**Nota**
Il file CSV include tutti i filtri di percorso in una particolare destinazione, indipendentemente da quelli selezionati dall'elenco dei filtri di percorso.
## Modifica un filtro di percorso
Puoi modificare i singoli filtri di percorso per definire i dati ricevuti dalla tua destinazione.
------
#### [ Console ]
Utilizzando la AWS IoT SiteWise console, è possibile modificare ogni singolo filtro di percorso all'interno di ogni rispettiva casella di testo.
**Per modificare un filtro di percorso utilizzando la AWS IoT SiteWise console**
1. Apri la [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/).
1. Nella barra di navigazione a sinistra, scegli **Edge gateway** nella sezione **Edge**.
1. Seleziona il gateway contenente i filtri di percorso.
1. Seleziona la destinazione appropriata.
1. Scegli **Modifica**.
1. Scegliete la casella di testo per la riga contenente il filtro del percorso che desiderate modificare.
1. Aggiorna il testo del filtro del percorso, assicurandoti che la casella di controllo del filtro del percorso modificato sia selezionata.
1. Scegli **Save** (Salva).
------
#### [ AWS CLI ]
Per modificare i filtri di percorso per una destinazione utilizzando il AWS CLI, recuperate prima la configurazione corrente, modificatela e quindi aggiornatela utilizzando il `update-gateway-capability-configuration` comando.
**Per modificare un filtro di percorso utilizzando AWS CLI**
1. Recupera la configurazione corrente delle funzionalità:
```
aws iotsitewise describe-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--query "capabilityConfiguration"
```
1. Modifica il JSON per modificare i filtri di percorso in base alle esigenze.
1. Aggiorna la configurazione delle funzionalità con i filtri di percorso modificati:
```
aws iotsitewise update-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--capability-configuration json-containing-your-updated-path-filters
```
------
## Eliminare un filtro di percorso
È possibile eliminare i filtri di percorso per una destinazione per controllare i dati che riceve dalle fonti MQTT e dalle pipeline di elaborazione dei dati.
------
#### [ Console ]
**Per eliminare un filtro di percorso utilizzando la console AWS IoT SiteWise**
1. Apri la [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/).
1. Nella barra di navigazione a sinistra, scegli **Edge gateway** nella sezione **Edge**.
1. Seleziona il gateway contenente i filtri di percorso.
1. Seleziona la destinazione appropriata.
1. Scegli **Modifica**.
1. Nella schermata **Modifica destinazione**, nella sezione **Filtri di percorso**, seleziona uno o più filtri di percorso da eliminare.
1. Scegli **Elimina**. Viene visualizzato un messaggio di conferma dell'eliminazione. Se desideri procedere con l'eliminazione dei filtri dei percorsi, scegli **Elimina** nella schermata di conferma.
------
#### [ AWS CLI ]
**Per eliminare una destinazione utilizzando AWS CLI**
+ Eliminare un filtro di percorso rimuovendolo dalla configurazione delle funzionalità.
```
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"
]
}
}
]
}
]
}
```
**Nota**
L'array dei filtri può essere vuoto (`[]`), ma l'oggetto filters stesso deve essere incluso nella configurazione delle funzionalità.
------