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à.
# Destinazioni e filtri di percorso
Le destinazioni in AWS IoT SiteWise Edge offrono un modo flessibile ed efficiente per gestire il flusso dei dati industriali dai dispositivi periferici al cloud. Questa sezione spiega come configurare le destinazioni, utilizzare i filtri di percorso per indirizzare flussi di dati specifici e scegliere il tipo di destinazione giusto per il proprio caso d'uso.
È possibile utilizzare destinazioni e filtri di percorso su gateway V3 e gateway ospitati autonomamente, dotati di MQTT e utilizzati insieme all'applicazione Edge ospitata su. AWS IoT SiteWise Siemens Industrial Edge I filtri di destinazione e percorso non funzionano con i gateway Classic Streams e V2.
**Topics**
+ [Comprendi le destinazioni Edge AWS IoT SiteWise](#source-destination)
+ [Comprendi i filtri di percorso per AWS IoT SiteWise le destinazioni Edge](#destinations-path-filters)
+ [Aggiungi una AWS IoT SiteWise destinazione Edge in tempo reale](destinations-real-time.md)
+ [Aggiungi una destinazione AWS IoT SiteWise con buffer utilizzando Amazon S3](destinations-buffered.md)
+ [Aggiungi filtri di percorso alle destinazioni AWS IoT SiteWise Edge](destinations-add-path-filters.md)
+ [Gestisci le destinazioni AWS IoT SiteWise Edge](destinations-manage.md)
## Comprendi le destinazioni Edge AWS IoT SiteWise
Utilizza le destinazioni AWS IoT SiteWise Edge per determinare dove inviare i dati di origine. Puoi scegliere la destinazione dei dati in base alle caratteristiche specifiche di cui hai bisogno, come convenienza, bassa latenza o requisiti di archiviazione. Integra i dati dei dispositivi acquisiti dai AWS IoT SiteWise nostri partner o dalle applicazioni personalizzate per pubblicare e sottoscrivere i filtri di percorso (argomenti) sull'edge. È quindi possibile modellare, trasferire e archiviare i dati del dispositivo nel cloud.
**Nota**
Per sfruttare appieno tutte le funzionalità di destinazione sui gateway ospitati autonomamente, esegui l'upgrade alle versioni più recenti di IoT SiteWise Publisher e IoT SiteWise OPC UA Collector. Il supporto per lo streaming continua sui gateway Classic Streams e V2 per mantenere la compatibilità con le configurazioni esistenti. Per ulteriori informazioni, consulta [Stream classici, gateway V2 per Edge AWS IoT SiteWise](classic-streams-v2-gateway.md)
**Topics**
+ [In che modo le destinazioni SiteWise Edge migliorano la gestione dei dati](#how-destinations-work)
+ [Tipi di destinazione](#destination-types)
+ [Confronta le funzionalità di destinazione tra le versioni del gateway](#destinations-vs-publisher-component)
+ [Limitazioni relative alla destinazione](#destinations-limitiations)
+ [Casi d'uso per le destinazioni SiteWise Edge](#destinations-use-cases)
### In che modo le destinazioni SiteWise Edge migliorano la gestione dei dati
Esporta i dati dall'edge AWS IoT SiteWise in tempo reale o in batch utilizzando Amazon S3.
Le destinazioni migliorano la flessibilità e la scalabilità nel tuo ambiente. AWS IoT SiteWise Le destinazioni implementano un modello di gestione dei dati centralizzato, in cui le fonti pubblicano i dati su un sistema centrale. Le destinazioni determinano dove vengono inviati i dati utilizzando i filtri di percorso. Le destinazioni possono sottoscrivere più filtri di percorso.
I gateway abilitati per MQTT, ospitati autonomamente o in esecuzioneSiemens Industrial Edge, utilizzano MQTT per la comunicazione locale e sono dotati di una destinazione predefinita in tempo reale con filtri impostati su. `#` Ciò significa che, per impostazione predefinita, tutti i messaggi su tutti gli argomenti vengono pubblicati nella destinazione in tempo reale. AWS IoT SiteWise Per ulteriori informazioni, consulta [Comprendi i filtri di percorso per AWS IoT SiteWise le destinazioni EdgeUnderstand path filters](#destinations-path-filters). È possibile aggiungere una destinazione in tempo reale in ogni gateway.
### Tipi di destinazione
Quando configuri una destinazione per il tuo gateway, hai due opzioni principali: configurazione in tempo reale utilizzando AWS IoT SiteWise e configurazione bufferizzata con Amazon S3. Ogni tipo di destinazione ha il proprio set di impostazioni e considerazioni.
**AWS IoT SiteWise impostazioni in tempo reale**
Scegli questa opzione per inviare i dati direttamente allo storage di AWS IoT SiteWise livello più elevato per facilitare l'acquisizione e il monitoraggio dei dati in tempo reale. Le impostazioni in tempo reale gestiscono il flusso di dati, in particolare quando un gateway presenta problemi di connettività con il cloud. Durante la perdita della connessione, i dati vengono temporaneamente archiviati localmente sul gateway. Una volta ristabilita la connessione, i dati memorizzati vengono inviati automaticamente al cloud.
È possibile modificare vari aspetti del processo di pubblicazione dei dati, ad esempio la quantità massima di dati da archiviare localmente, la velocità con cui i dati vengono inviati al cloud al momento della riconnessione e quando eliminare i dati una volta raggiunta la capacità di archiviazione.
Per ulteriori informazioni sui livelli AWS IoT SiteWise di storage, consulta,. [Gestisci l'archiviazione dei dati in AWS IoT SiteWise](manage-data-storage.md)
**AWS IoT SiteWise bufferizzato utilizzando le impostazioni di Amazon S3**
Questo tipo di destinazione consente di bufferizzare i dati localmente sul gateway e di inviarli periodicamente a un bucket Amazon S3 in batch. I dati vengono archiviati nell'efficiente formato Parquet, ottimizzato per i carichi di lavoro analitici. Una volta che i dati sono in Amazon S3, puoi importarli AWS IoT SiteWise per l'archiviazione, l'elaborazione e l'analisi.
Scegli questa opzione per importare i dati in batch e archiviare i dati storici in modo conveniente. Puoi configurare la posizione preferita del bucket Amazon S3 e la frequenza con cui desideri che i dati vengano caricati su Amazon S3. Puoi anche scegliere cosa fare con i dati dopo l'ingestione. AWS IoT SiteWise Puoi scegliere di rendere i dati disponibili sia SiteWise in Amazon S3 che in Amazon S3 oppure puoi scegliere di eliminarli automaticamente da Amazon S3.
### Confronta le funzionalità di destinazione tra le versioni del gateway
La funzionalità di destinazione nei gateway compatibili con MQTT semplifica la gestione del flusso di dati. Le destinazioni semplificano la gestione dei dati attraverso la configurazione centralizzata del routing dei dati verso vari endpoint. Questo approccio elimina la necessità di configurazioni complesse di singoli flussi, rendendo l'intero sistema più flessibile e facile da gestire.
In confronto, Classic Streams, V2 gateway, SiteWise Edge trasmette i dati dalle fonti di dati agli editori tramite AWS IoT Greengrass stream, configurando le destinazioni dei dati individualmente per ciascuna fonte di dati.
Con la funzionalità di AWS IoT SiteWise destinazione, la configurazione del routing dell'editore viene consolidata. La configurazione della destinazione consente di gestire destinazioni e filtri di percorso in modo centralizzato. È possibile aggiungere facilmente una destinazione, gestire i filtri di percorso, eliminare filtri o destinazioni non necessari, a seconda delle esigenze.
Inoltre, la funzionalità di destinazione utilizza MQTT (Message Queuing Telemetry Transport), un protocollo standard di settore ampiamente utilizzato nelle applicazioni IoT industriali. Questa adozione di MQTT aiuta a facilitare l'integrazione con vari dispositivi e sistemi. AWS IoT SiteWise
### Limitazioni relative alla destinazione
Le attuali limitazioni per le destinazioni sui gateway SiteWise Edge includono:
+ Il pacchetto di elaborazione dati non è supportato sui gateway abilitati per MQTT.
+ Il supporto dei tipi di dati è limitato ai tipi di dati. AWS IoT SiteWise Per informazioni sull'attivazione della conversione dei tipi di dati, consulta[Conversione di tipi di dati non supportati](string-conversion.md).
### Casi d'uso per le destinazioni SiteWise Edge
SiteWise Le destinazioni Edge vengono utilizzate in diverse applicazioni. Ecco alcuni esempi chiave:
**Automazione industriale***Monitoraggio in tempo reale e manutenzione predittiva*
In ambienti industriali, i sensori e i dispositivi in fabbrica possono pubblicare dati su SiteWise Edge. Le destinazioni possono essere configurate per filtrare e indirizzare i dati pertinenti, consentendo il monitoraggio e l'analisi in tempo reale delle prestazioni delle macchine. È possibile abbonarsi agli argomenti MQTT pertinenti utilizzando i filtri di percorso, elaborare i dati e quindi pubblicare i dati elaborati. In questo modo, puoi indirizzare selettivamente i dati elaborati verso servizi di analisi AWS cloud o sistemi locali. I produttori possono quindi implementare strategie di manutenzione predittiva, ottimizzare i processi di produzione e ridurre i tempi di inattività.
**Edifici intelligenti***Efficienza energetica e ottimizzazione dell'occupazione*
I sistemi di automazione degli edifici generano flussi di dati per monitorare e controllare vari aspetti di un edificio, come i sistemi HVAC, l'illuminazione e il controllo degli accessi. Con SiteWise Edge, questi flussi di dati possono essere acquisiti, elaborati e indirizzati verso destinazioni diverse. I facility manager possono configurare le destinazioni per filtrare e inoltrare i dati pertinenti, abilitando funzionalità avanzate come le misure di efficienza energetica e l'ottimizzazione dell'occupazione, garantendo al contempo la privacy e la conformità dei dati.
Questi casi d'uso dimostrano come la funzionalità Destinations di SiteWise Edge possa essere sfruttata in vari settori per acquisire, elaborare e instradare i dati in modo efficiente. Ciò consente funzionalità avanzate come il monitoraggio in tempo reale, la manutenzione predittiva, l'efficienza energetica e la diagnostica remota, garantendo al contempo la privacy e la conformità dei dati.
## Comprendi i filtri di percorso per AWS IoT SiteWise le destinazioni Edge
**Topics**
+ [Requisiti del filtro dei percorsi](#path-filter-requirements)
+ [Procedure consigliate per i filtri di percorso](#create-effective-path-filters)
+ [Filtri di percorso per server OPC UA](#path-filters-opcua)
+ [Caratteri speciali nei nomi dei filtri di percorso](#path-filters-special-characters)
Ogni destinazione è configurata per instradare i dati verso AWS IoT SiteWise o verso Amazon S3. I filtri di percorso consentono di selezionare dati specifici da filtrare quando si ricevono messaggi MQTT per una destinazione. I filtri di percorso rappresentano i nomi logici dei flussi di dati e fungono da sottoscrizioni agli argomenti MQTT desiderati.
In MQTT, i dati sono organizzati in argomenti, che sono stringhe gerarchiche separate da barre (). `/` Ad esempio, un dispositivo potrebbe pubblicare dati sulla temperatura sull'argomento. `home/livingroom/sensor1/temperature` Qui `home/livingroom/sensor1` rappresenta il percorso o il nome logico del sensore ed `temperature` è il tipo di dati da pubblicare.
È possibile utilizzare i filtri di percorso per sottoscrivere argomenti specifici o una serie di argomenti utilizzando i caratteri jolly (`+`e`#`). Il carattere `+` jolly corrisponde a un singolo livello nella gerarchia degli argomenti. Ad esempio, `home/+/sensor1/temperature` `home/livingroom/sensor1/temperature` corrisponderebbe a e. `home/bedroom/sensor1/temperature` Il `#` carattere jolly, se usato alla fine di un filtro, corrisponde a più livelli.
È inoltre possibile utilizzare una varietà di caratteri generalmente non consentiti nella specifica MQTT all'interno del nome di un filtro di percorso. Questi caratteri non funzionano come caratteri jolly quando vengono utilizzati all'interno di un nome. AWS IoT SiteWise converte questi caratteri utilizzando la codifica per garantire la conformità MQTT preservando al contempo la struttura di denominazione originale. Questa funzionalità è particolarmente utile per adattarsi alle convenzioni di denominazione esistenti di altri sistemi. Per ulteriori informazioni, consulta [Caratteri speciali nei nomi dei filtri di percorso](#path-filters-special-characters).
Selezionando attentamente i filtri di percorso appropriati, è possibile controllare quali dati vengono inviati a una destinazione specifica. Personalizza il flusso di dati in base ai requisiti del tuo sistema IoT utilizzando filtri di percorso.
### Requisiti del filtro dei percorsi
Quando inserite i filtri di percorso utilizzando il Console AWS IoT SiteWise, tenete presente quanto segue:
+ I filtri di percorso sono delimitati da una nuova riga, con ogni riga che rappresenta un filtro di percorso separato.
+ I filtri di percorso individuali possono avere una dimensione compresa tra 1 e 65.535 byte.
+ Un filtro di percorso non può essere vuoto.
+ I valori nulli (U\$10000) non sono consentiti.
+ È possibile inserire fino a 100 filtri di percorso o 65.535 caratteri alla volta, a seconda del limite raggiunto per primo.
+ Il limite complessivo è di 20.000 filtri di percorso per tutte le destinazioni su un gateway combinato.
+ È possibile utilizzare`%`, `#``+`, e `$` caratteri all'interno dei nomi dei filtri di percorso, tuttavia li converte AWS IoT SiteWise automaticamente nella codifica URI.
### Procedure consigliate per i filtri di percorso
Quando crei filtri di percorso per le tue AWS IoT SiteWise destinazioni, prendi in considerazione le seguenti strategie per gestire efficacemente i tuoi dati.
+ Strutturate i filtri in modo da rispecchiare la gerarchia dei dispositivi. Ad esempio, in un ambiente di produzione`factory/+/machine/#`, acquisisce i dati da tutte le macchine su diverse linee di produzione.
+ Utilizza livelli specifici per tipi di dispositivi, ubicazioni o funzioni. Ad esempio, `factory/assembly-line/robot/temperature`. Oppure, nell'agricoltura intelligente`farm/+/crop/+/moisture`, per monitorare i livelli di umidità di varie colture in diversi campi.
+ Sfrutta le wildcard in modo strategico: utilizzale `+` per le variazioni di un singolo livello e per `#` acquisire tutti i livelli successivi. Ad esempio`building/+/+/energy-consumption`, tiene traccia del consumo di energia in diverse zone e piani di un edificio. Ciò presuppone che il primo `+` catturi tutti i piani e il secondo tutte `+` le zone.
+ Bilancia specificità e flessibilità creando filtri sufficientemente specifici per acquisire dati pertinenti ma sufficientemente flessibili per adattarsi alle modifiche future. Ad esempio, `site/+/equipment-type/+/measurement` consente l'aggiunta di nuovi siti o tipi di apparecchiature senza modificare la struttura del filtro.
Testa a fondo i tuoi filtri per assicurarti che acquisiscano i dati previsti e si allineino con l'architettura e gli obiettivi del tuo sistema IoT.
### Filtri di percorso per server OPC UA
Per i server OPC UA, i filtri di percorso devono corrispondere ai nomi dei tag OPC UA. Il livello finale del filtro di percorso deve corrispondere esattamente al nome del tag OPC UA. Ad esempio, se il tag OPC UA è`Device1.Temperature`, il filtro del percorso potrebbe esserlo. `factory/line1/Device1.Temperature` È possibile utilizzare i caratteri jolly nei livelli precedenti, ad esempio `factory/+/Device1.Temperature` per acquisire il tag su più linee di produzione. Se nei nomi dei filtri di percorso sono presenti caratteri speciali, consulta [Caratteri speciali nei nomi dei filtri di percorso](#path-filters-special-characters) per ulteriori informazioni.
### Caratteri speciali nei nomi dei filtri di percorso
AWS IoT SiteWise contiene caratteri comunemente usati nei protocolli industriali come OPC UA, che in genere non sono consentiti nei nomi degli argomenti MQTT standard. Questa funzionalità facilita l'integrazione più fluida dei sistemi industriali con architetture basate su MQTT.
**Nota**
Sebbene la nostra gestione speciale dei caratteri sia utile per l'integrazione e la migrazione, si consiglia di allinearsi alle convenzioni di denominazione MQTT standard per le nuove implementazioni, quando possibile, per garantire una compatibilità più ampia.
Quando riceve dati da fonti industriali, AWS IoT SiteWise normalizza i nomi degli argomenti utilizzando la codifica URI per i caratteri speciali:
+ `%`diventa `%25` (codificato prima come carattere di escape)
+ `#`diventa `%23`
+ `+`diventa `%2B`
+ `$`diventa `%24` (solo all'inizio di un argomento)
Questa codifica garantisce che i dati di origine contenenti questi caratteri MQTT speciali possano essere utilizzati in modo sicuro come nomi di argomenti MQTT, preservando al contempo le convenzioni di denominazione industriale originali.
**Example : caratteri speciali nei nomi dei filtri di percorso**
Ecco alcuni esempi di come i nomi degli argomenti industriali potrebbero apparire nei filtri di AWS IoT SiteWise percorso:
+ `Factory1/Line#2/Sensor+3`diventa `Factory1/Line%232/Sensor%2B3`
+ `Plant%A/Unit$1/Temp`diventa `Plant%25A/Unit%241/Temp`
+ `Site1/#Section/+Node`diventa `Site1/%23Section/%2BNode`
Quando crei abbonamenti o visualizzi i nomi degli argomenti in AWS IoT SiteWise, vedrai le versioni originali non codificate. La codifica viene gestita automaticamente per garantire la conformità MQTT.
# Aggiungi una AWS IoT SiteWise destinazione Edge in tempo reale
Il tipo di destinazione in tempo reale consente di trasmettere i dati IoT direttamente dai dispositivi e dai gateway AWS IoT SiteWise allo storage in tempo reale. Questa opzione è ideale per i casi d'uso che richiedono l'inserimento e l'elaborazione immediati dei dati man mano che vengono generati, senza la necessità di operazioni di batch o buffering. È possibile configurare una sola destinazione in tempo reale in ogni gateway, poiché trasmette i dati in modo continuo. AWS IoT SiteWise
**Nota**
La duplicazione TQVs può comportare un doppio addebito.
**Per aggiungere una destinazione in tempo reale**
Usa la AWS IoT SiteWise console o aggiungi una destinazione in tempo reale AWS CLI al tuo gateway abilitato per SiteWise Edge MQTT.
------
#### [ Console ]
1. Apri la [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/).
1. **Nel riquadro di navigazione, scegli Edge gateway.**
1. Seleziona il gateway a cui desideri aggiungere una destinazione.
1. Nella sezione **Destinazioni**, scegli **Aggiungi destinazione**.
1. Nella pagina **Aggiungi destinazione**, inserisci **i dettagli della destinazione**:
1. Un nome per la destinazione nel campo **Nome destinazione**.
1. Seleziona il **AWS IoT SiteWise tempo reale** per il **tipo di destinazione**.
1. Configura l'ordine di pubblicazione del gateway impostando l'**ordine di pubblicazione** su **Pubblica prima i dati più vecchi o Pubblica prima** **i dati più recenti**. Per impostazione predefinita, il gateway pubblica per primi i dati più vecchi.
1. Utilizza **Tempo di attesa massimo per il batch** per impostare il tempo massimo di attesa per l'editore prima di inviare un batch di dati a AWS IoT SiteWise. Questa impostazione si applica a ogni alias. I dati vengono archiviati localmente fino a quando:
+ Il tempo impostato è trascorso, oppure
+ Sono state time-quality-value ricevute 10 voci (TQV) per l'alias
La condizione soddisfatta per prima attiva l'invio del batch al cloud.
1. Per comprimere i dati caricati, seleziona la casella di controllo **Attiva la compressione durante il caricamento dei** dati. Consentire al gateway di comprimere i dati prima di caricarli sul cloud riduce l'utilizzo della larghezza di banda.
1. Per filtrare i dati scaduti degli editori, seleziona la casella di controllo **Escludi** dati scaduti. Questa selezione invia solo i dati attivi e correnti a. AWS IoT SiteWise
1. Nel campo **Periodo limite**, inserisci la frequenza con cui i dati devono essere considerati scaduti all'interno del set di dati. È possibile determinare se i dati vengono conteggiati in termini di minuti o giorni. Il periodo limite minimo è di cinque minuti. Il periodo limite massimo è di sette giorni.
1. Configura facoltativamente le impostazioni di **archiviazione locale**:
1. Imposta la frequenza del **periodo di conservazione**: la quantità di tempo in cui il gateway archivia localmente i dati più vecchi del periodo limite. Il periodo di conservazione minimo è di un minuto.
Il periodo di conservazione massimo è di 30 giorni ed è maggiore o uguale al periodo di rotazione.
1. Imposta il **periodo di rotazione**: l'intervallo di tempo da specificare quando si salvano dati precedenti al periodo limite per un singolo file. Il gateway trasferisce un batch di dati nella seguente directory locale alla fine di ogni periodo di rotazione:. `/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports`
La conservazione deve essere superiore a un minuto e pari al periodo di conservazione.
1. Fornisci il valore **della capacità di archiviazione (GB)** per impostare la dimensione massima dei dati archiviati localmente in GB. Se i dati superano la dimensione massima di archiviazione locale determinata, il gateway inizia a eliminare prima i dati più vecchi. Il gateway continua a eliminare finché la dimensione dei dati archiviati localmente non è uguale o inferiore alla quota.
La capacità di archiviazione deve essere maggiore o uguale a un GB.
1. Aggiungi filtri di percorso alla tua destinazione. Per ulteriori informazioni, consultare [Aggiungi filtri di percorso alle destinazioni AWS IoT SiteWise Edge](destinations-add-path-filters.md).
Per ulteriori informazioni, consulta [Tipi di destinazione](gw-destinations.md#destination-types).
------
#### [ AWS CLI ]
**Example : crea una nuova destinazione AWS IoT SiteWise in tempo reale**
Utilizza l'[UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API per configurare l'editore.
Imposta il parametro `capabilityNamespace` su `iotsitewise:publisher:3`.
```
{
"sources": [
{
"type": "MQTT"
}
],
"destinations": [
{
"type": "SITEWISE_REALTIME",
"name": "your-destination-name",
"config": {
"publishingOrder": "TIME_ORDER",
"enableCompression": true,
"maxBatchWaitTime": "10s"
},
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"#"
]
}
}
]
}
]
}
```
Per aggiornare una destinazione esistente AWS IoT SiteWise in tempo reale, utilizza innanzitutto l'`DescribeGatewayCapabilityConfiguration`API per trovare il`destinationId`.
**Example : aggiorna una destinazione AWS IoT SiteWise in tempo reale**
Utilizza l'[UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API per configurare l'editore.
Imposta il parametro `capabilityNamespace` su `iotsitewise:publisher:3`.
```
{
"sources": [
{
"type": "MQTT"
}
],
"destinations": [
{
"id": "your-existing-destination-id",
"type": "SITEWISE_REALTIME",
"name": "your-destination-name",
"config": {
"publishingOrder": "TIME_ORDER",
"enableCompression": true,
"dropPolicy": {
"cutoffAge": "7d",
"exportPolicy": {
"retentionPeriod": "7d",
"rotationPeriod": "6h",
"exportSizeLimitGB": 10
}
},
"maxBatchWaitTime": "10s"
},
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"#"
]
}
}
]
}
]
}
```
Le seguenti opzioni di configurazione sono specifiche per i gateway che utilizzano lo `iotsitewise:publisher:3` spazio dei nomi.
`sources`
Definisce le fonti di dati a cui trasferire i dati dalle apparecchiature industriali. AWS IoT SiteWise Per i gateway compatibili con MQTT, utilizzare. `MQTT`
Tipo: matrice di oggetti
Obbligatorio: sì
`destinations`
Definisce dove inviare i dati. Le destinazioni sono in tempo reale o memorizzate nel buffer utilizzando Amazon S3. È richiesto almeno un oggetto di destinazione, ma puoi aggiungere un array vuoto. È possibile avere una destinazione in tempo reale per ogni gateway. Per ulteriori informazioni, consulta [Comprendi le destinazioni Edge AWS IoT SiteWise](gw-destinations.md#source-destination).
Tipo: matrice di oggetti
Obbligatorio: sì
`id`
L'identificatore univoco della destinazione. Puoi fornire un ID di destinazione esistente o lasciarlo vuoto. Se non si specifica un ID, per impostazione predefinita viene generato un UUID.
▬Tipo: stringa
Obbligatorio: no
`type`
Tipo di destinazione. Le opzioni includono: `SITEWISE_REALTIME` e. `SITEWISE_BUFFERED`
+ `SITEWISE_REALTIME`— Invia i dati direttamente allo AWS IoT SiteWise storage in tempo reale.
+ `SITEWISE_BUFFERED`— Invia dati ad Amazon S3 in batch in formato Parquet, quindi importali nello storage. AWS IoT SiteWise
Tipo: stringa
Obbligatorio: sì
`name`
Un nome univoco per la destinazione.
Tipo: stringa
Obbligatorio: sì
`config`
Configurazione specifica per il tipo di destinazione in formato JSON. La configurazione varia tra destinazioni in tempo reale e destinazioni con buffer.
Tipo: oggetto
Obbligatorio: sì
Ordine di pubblicazione
Determina l'ordine in cui i dati vengono pubblicati. I dati vengono pubblicati in base al relativo timestamp. Le opzioni includono e. `TIME_ORDER` `RECENT_DATA`
+ `TIME_ORDER`(impostazione predefinita): pubblica prima i dati più vecchi.
+ `RECENT_DATA`— Pubblica prima i dati più recenti.
▬Tipo: stringa
Obbligatorio: no
Abilita la compressione
Se impostato su`true`, abilita la compressione dei dati prima dell'invio a. AWS IoT SiteWise Consentire al gateway di comprimere i dati prima di caricarli sul cloud riduce l'utilizzo della larghezza di banda. Il valore predefinito è `true`.
Tipo: Booleano
Obbligatorio: no
DropPolicy
Definisce come gestire i dati più vecchi.
Tipo: oggetto
Obbligatorio: no
+ `cutoffAge`
L'età massima dei dati da pubblicare specificata in giorni, ore e minuti. Ad esempio `7d` o `1d7h16m`. I dati più vecchi di quelli specificati non vengono inviati a AWS IoT SiteWise.
I dati precedenti al periodo limite non vengono pubblicati nel cloud. L'età limite deve essere compresa tra cinque minuti e sette giorni.
È possibile utilizzare `m``h`, e `d` quando si specifica un'età limite. Nota che `m` rappresenta i minuti, `h` rappresenta le ore e `d` rappresenta i giorni.
Tipo: stringa
Obbligatorio: sì
+ `exportPolicy`
Definisce come gestire i dati che superano l'età limite.
Tipo: oggetto
Obbligatorio: no
+ `retentionPeriod`
Il gateway SiteWise Edge elimina tutti i dati sull'edge che sono precedenti al periodo limite dall'archiviazione locale dopo che sono stati archiviati per il periodo di conservazione specificato. Il periodo di conservazione deve essere compreso tra un minuto e 30 giorni e deve essere superiore o uguale al periodo di rotazione.
È possibile utilizzare `m``h`, e `d` quando si specifica un periodo di conservazione. Nota che `m` rappresenta i minuti, `h` rappresenta le ore e `d` rappresenta i giorni.
▬Tipo: stringa
Obbligatorio: no
+ `rotationPeriod`
L'intervallo di tempo durante il quale raggruppare e salvare i dati precedenti al periodo limite in un singolo file. Il gateway SiteWise Edge trasferisce un batch di dati nella seguente directory locale alla fine di ogni periodo di rotazione:. `/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports` Il periodo di rotazione deve essere maggiore di un minuto, e uguale o inferiore al periodo di conservazione.
È possibile utilizzare `m``h`, e `d` quando si specifica un periodo di rotazione. Nota che `m` rappresenta i minuti, `h` rappresenta le ore e `d` rappresenta i giorni.
▬Tipo: stringa
Obbligatorio: no
+ `exportSizeLimitGB`
La dimensione massima consentita dei dati archiviati localmente, in GB. Se questa quota viene violata, il gateway SiteWise Edge inizia a eliminare i primi dati fino a quando la dimensione dei dati archiviati localmente non è uguale o inferiore alla quota. Il valore di questo parametro deve essere maggiore o uguale a 1.
Tipo: Integer
Obbligatorio: no
`maxBatchWaitTime`
Imposta un tempo massimo di attesa per l'editore prima di inviare un batch di dati a AWS IoT SiteWise. Questa impostazione si applica a ogni alias. I dati vengono archiviati localmente fino a quando:
+ Il tempo impostato è trascorso, oppure
+ Sono state time-quality-value ricevute 10 voci (TQV) per l'alias
Usare `m``h`, e `d` per specificare un orario limite. Nota che `m` rappresenta i minuti, `h` rappresenta le ore e `d` rappresenta i giorni.
▬Tipo: stringa
Obbligatorio: no
`filters`
Filtri da applicare ai dati. È richiesto almeno un filtro.
Tipo: stringa
Obbligatorio: sì
`type`
Tipo di filtro. Utilizza `PATH`.
Tipo: stringa
Obbligatorio: sì
`config`
Configurazione specifica per il tipo di filtro in formato JSON. È richiesto almeno un oggetto, ma l'array può essere vuoto.
Tipo: oggetto
Obbligatorio: sì
+ `paths`
Una serie di filtri di percorso. Per ulteriori informazioni, consulta [Comprendi i filtri di percorso per AWS IoT SiteWise le destinazioni EdgeUnderstand path filters](gw-destinations.md#destinations-path-filters). Il percorso predefinito è `#`.
Tipo: array di stringhe
Obbligatorio: sì
------
# Aggiungi una destinazione AWS IoT SiteWise con buffer utilizzando Amazon S3
Il tipo di destinazione memorizzata nel buffer consente di risparmiare sui costi di importazione AWS IoT SiteWise se non sono necessari i dati in tempo reale. Consente di archiviare temporaneamente i dati IoT in un bucket Amazon S3 prima di importarli. AWS IoT SiteWise In alternativa, puoi semplicemente caricare i tuoi dati su S3 per l'archiviazione, indipendentemente dal fatto che tu abbia intenzione di importarli in. AWS IoT SiteWise Ciò è utile per raggruppare e memorizzare i dati dai dispositivi e dai gateway prima di inserirli. AWS IoT SiteWise Con questa opzione, i dati vengono caricati nel bucket S3 specificato in formato Parquet a una frequenza configurata. È quindi possibile importare questi dati in un AWS IoT SiteWise archivio per ulteriori analisi ed elaborazioni.
**Per aggiungere una destinazione bufferizzata utilizzando Amazon S3**
Usa la AWS IoT SiteWise console o AWS CLI aggiungi una destinazione che bufferizza i dati utilizzando Amazon S3 al SiteWise tuo gateway Edge.
------
#### [ Console ]
Usa Console di gestione AWS per aggiungere una AWS IoT SiteWise destinazione bufferizzata utilizzando Amazon S3.
1. Apri la [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/).
1. Nel riquadro di navigazione, scegli **Edge** gateway.
1. Seleziona il gateway a cui desideri aggiungere una destinazione.
1. Nella sezione **Destinazioni**, scegli **Aggiungi destinazione**.
1. Nella pagina **Aggiungi destinazione**, inserisci **i dettagli della destinazione**:
1. Un nome per la destinazione nel campo **Nome destinazione**.
1. Seleziona **AWS IoT SiteWise bufferizzato utilizzando Amazon** S3 **per** il tipo di destinazione. AWS IoT SiteWise memorizzato nel buffer con Amazon S3 invia i dati ad Amazon Simple Storage Service in batch, in formato Parquet, quindi li importa nello storage. AWS IoT SiteWise
1. Inserisci l'URL di Amazon S3 per la posizione in cui desideri archiviare i dati del gateway. Puoi cercare il percorso scegliendo **Browse S3**. **Una volta aggiunto un bucket, puoi anche visualizzarlo scegliendo Visualizza.**
1. Specificate la frequenza con cui il gateway deve caricare i dati su Amazon S3 inserendo un intervallo di tempo e selezionando un incremento di tempo per la frequenza di caricamento **dei dati**. Il valore della frequenza deve essere maggiore di 0 e minore o uguale a 30 giorni.
1. Nelle **impostazioni di archiviazione dei dati**, stabilisci cosa fare con i dati del gateway dopo averli importati in AWS IoT SiteWise. Esistono due decisioni da prendere in merito all'archiviazione dei dati:
+ Se desideri copiare i dati importati nell' AWS IoT SiteWise archivio, seleziona la casella di controllo **Copia i dati nell'archivio**. Questa opzione duplica i dati importati dal AWS IoT SiteWise bucket Amazon S3 configurato nello storage.
+ Se scegli di importare i dati dal tuo bucket Amazon S3 nello AWS IoT SiteWise storage, puoi anche specificare se i dati importati devono essere eliminati una volta completata l'importazione. Seleziona la casella di controllo **Elimina dati da Amazon S3** per eliminare la data importata dal bucket Amazon S3 configurato dopo averla importata nello storage. AWS IoT SiteWise
1. Aggiungi filtri di percorso alla tua destinazione. Per ulteriori informazioni, consultare [Aggiungi filtri di percorso alle destinazioni AWS IoT SiteWise Edge](destinations-add-path-filters.md).
------
#### [ AWS CLI ]
**Example : creazione di una nuova AWS IoT SiteWise destinazione con buffer utilizzando Amazon S3**
Utilizza l'[UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API per configurare l'editore.
Imposta il parametro `capabilityNamespace` su `iotsitewise:publisher:3`.
```
{
"sources": [
{
"type": "MQTT"
}
],
"destinations": [
{
"type": "SITEWISE_BUFFERED",
"name": "your-s3-destination-name",
"config": {
"targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/Optional/SomeFolder",
"publishPolicy": {
"publishFrequency": "15m",
"localSizeLimitGB": 10
},
"siteWiseImportPolicy": {
"enableSiteWiseStorageImport": true,
"enableDeleteAfterImport": true,
"bulkImportJobRoleArn": "arn:aws:iam::123456789012:role/your-role-name"
}
},
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"#"
]
}
}
]
}
]
}
```
**Example : aggiorna una AWS IoT SiteWise destinazione con buffer utilizzando Amazon S3**
Per aggiornare una destinazione esistente AWS IoT SiteWise in tempo reale, utilizza innanzitutto l'`DescribeGatewayCapabilityConfiguration`API per trovare la. `destinationId`
Lo spazio dei nomi dell'editore: `iotsitewise:publisher:3`
```
{
"sources": [
{
"type": "MQTT"
}
],
"destinations": [
{
"id": "your-existing-destination-id",
"type": "SITEWISE_BUFFERED",
"name": "your-s3-destination-name",
"config": {
"targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/Optional/SomeFolder",
"publishPolicy": {
"publishFrequency": "15m",
"localSizeLimitGB": 10
},
"siteWiseImportPolicy": {
"enableSiteWiseStorageImport": true,
"enableDeleteAfterImport": true,
"bulkImportJobRoleArn": "arn:aws:iam::123456789012:role/your-role-name"
}
},
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"#"
]
}
}
]
}
]
}
```
Le seguenti opzioni di configurazione sono specifiche per i gateway abilitati per MQTT che utilizzano lo spazio dei nomi. `iotsitewise:publisher:3`
`sources`
Definisce le fonti di dati a cui trasferire i dati dalle apparecchiature industriali. AWS IoT SiteWise Per i gateway compatibili con MQTT, utilizzare. `MQTT`
Tipo: matrice di oggetti
Obbligatorio: sì
`destinations`
Definisce dove inviare i dati. Le destinazioni sono in tempo reale o memorizzate nel buffer utilizzando Amazon S3. È richiesto almeno un oggetto di destinazione, ma puoi aggiungere un array vuoto. È possibile avere una destinazione in tempo reale per ogni gateway. Per ulteriori informazioni, consulta [Comprendi le destinazioni Edge AWS IoT SiteWise](gw-destinations.md#source-destination).
Tipo: matrice di oggetti
Obbligatorio: sì
`id`
L'identificatore univoco della destinazione. Puoi fornire un ID di destinazione esistente o lasciarlo vuoto per generare automaticamente un nuovo ID per la destinazione.
▬Tipo: stringa
Obbligatorio: no
`type`
Tipo di destinazione. Le opzioni includono: `SITEWISE_REALTIME` e`SITEWISE_BUFFERED`. Scegli `SITEWISE_BUFFERED`.
+ `SITEWISE_REALTIME`(impostazione predefinita): invia i dati direttamente allo AWS IoT SiteWise storage in tempo reale. Per ulteriori informazioni, consulta [Aggiungi una AWS IoT SiteWise destinazione Edge in tempo reale](destinations-real-time.md).
+ `SITEWISE_BUFFERED`— Invia dati ad Amazon S3 in batch in formato Parquet, quindi importali nello storage. AWS IoT SiteWise
Tipo: stringa
Obbligatorio: sì
`name`
Un nome univoco per la destinazione.
Tipo: stringa
Obbligatorio: sì
`config`
Configurazione specifica per il tipo di destinazione in formato JSON. La configurazione varia tra destinazioni in tempo reale e destinazioni con buffer.
Tipo: oggetto
Obbligatorio: sì
`targetBucketArn`
Il bucket in ARN cui pubblicare. Scegli lo stesso Regione AWS per entrambi AWS IoT SiteWise e per Amazon S3. Se viene scelto un prefisso, deve avere tra 1 e 255 caratteri.
AWS IoT SiteWise, incluso il gateway, avrà accesso all'intero bucket S3 specificato. Ti consigliamo di utilizzare un bucket dedicato per l'inserimento di dati nel buffer.
Tipo: stringa
Obbligatorio: sì
`publishPolicy`
Dettagli della politica di pubblicazione.
Tipo: oggetto
Obbligatorio: sì
`publishFrequency`
La frequenza con cui il gateway SiteWise Edge pubblica nel bucket Amazon S3. La frequenza di caricamento dei dati su Amazon S3 deve essere superiore a 0 minuti e inferiore o uguale a 30 giorni. È possibile utilizzare `m``h`, e `d` quando si specifica una frequenza di pubblicazione. Nota che `m` rappresenta i minuti, `h` rappresenta le ore e `d` rappresenta i giorni. Il valore predefinito è 15 minuti.
Tipo: stringa
Obbligatorio: sì
`localSizeLimitGB`
La dimensione massima dei file scritti sul disco locale in GB. Se questa soglia viene superata, l'editore pubblica tutti i dati memorizzati nel buffer nella relativa destinazione.
Tipo: numero intero
Obbligatorio: sì
`siteWiseImportPolicy`
Dettagli della politica di importazione per l'importazione dei dati in. AWS IoT SiteWise
Tipo: oggetto
Obbligatorio: sì
`enableSiteWiseStorageImport`
Imposta questa opzione `true` su per importare i dati da un bucket Amazon S3 allo storage. AWS IoT SiteWise Inizialmente crea una copia dei dati in. AWS IoT SiteWise Quindi, se imposti su `enableDeleteAfterImport` true, i dati in S3 vengono eliminati dopo la copia su. AWS IoT SiteWise Si applicano le implicazioni relative ai prezzi. Il valore predefinito è `true`.
Tipo: Booleano
Obbligatorio: sì
`enableDeleteAfterImport`
Imposta questa opzione `true` su per eliminare il file nel bucket Amazon S3 dopo l'ingestione nello storage. AWS IoT SiteWise Il valore predefinito è `true`.
Tipo: Booleano
Obbligatorio: sì
`bulkImportJobRoleArn`
L'ARN del ruolo IAM che AWS IoT SiteWise presuppone la lettura dei dati bufferizzati da Amazon S3 durante l'ingestione dei dati. Questo ruolo viene utilizzato quando un dispositivo periferico chiama per avviare il processo di importazione in blocco AWS IoT SiteWise APIs .
Se `enableSiteWiseStorageImport` impostato su`true`, questo parametro è obbligatorio.
▬Tipo: stringa
Obbligatorio: no
------
Aggiungi filtri di percorso per la tua destinazione. Per ulteriori informazioni, consulta [Aggiungi filtri di percorso alle destinazioni AWS IoT SiteWise Edge](destinations-add-path-filters.md).
# Aggiungi filtri di percorso alle destinazioni AWS IoT SiteWise Edge
Aggiungi filtri di percorso a una destinazione. I filtri di percorso utilizzano la sintassi degli argomenti MQTT, dove `#` è un carattere jolly che corrisponde a un numero qualsiasi di livelli e `+` un carattere jolly che corrisponde a un singolo livello. È possibile aggiungere più destinazioni a un gateway, ognuna con il proprio set di filtri di percorso abbonati alla telemetria dell'apparecchiatura.
Siemens Industrial Edgei gateway utilizzano un prefisso per la compatibilità. Per ulteriori informazioni, consulta [Prefissi per i filtri di percorso](sitewise-edge-on-siemens.md#siemens-path-filters).
------
#### [ Console ]
**Per aggiungere filtri di percorso**
1. Apri la [AWS IoT SiteWise console](https://console.aws.amazon.com/iotsitewise/).
1. Nel riquadro di navigazione, scegli **Edge gateway**.
1. Seleziona il gateway a cui desideri aggiungere i filtri di percorso.
1. Nella sezione **Filtri di percorso** sotto **Aggiungi destinazione**, scegli **Aggiungi filtro di percorso**.
1. Inserisci il filtro del percorso a cui desideri sottoscrivere questa destinazione. Puoi usare caratteri jolly (`#`e`+`) per iscriverti a più percorsi.
1. Scegli **Aggiungi filtro di percorso** per aggiungere il filtro del percorso all'elenco.
1. Ripeti i passaggi per aggiungere filtri di percorso aggiuntivi, se necessario.
1. Dopo aver aggiunto tutti i filtri di percorso richiesti, scegli **Crea**.
------
#### [ AWS CLI for self-hosted gateways ]
**Example : configurazione del filtro di percorso**
```
{
"destinations": [
{
...
}
],
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"home/+/sensor1/temperature",
"home/livingroom/sensor1/temperature",
"home/livingroom/sensor1/temperature",
"building/#"
]
}
}
]
}
```
------
#### [ AWS CLI for Siemens IEgateways ]
**Example : Configurazione del prefisso per i filtri di percorso**
Acquisisci tutti i dati utilizzando i prefissi data (`ie/d`) e metadata (`ie/m`) per ogni filtro di percorso.
```
{
"destinations": [
{
...
}
],
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"ie/d/home/+/sensor12/temperature",
"ie/m/home/livingroom/sensor12/temperature",
"ie/d/home/livingroom/sensor13/temperature2",
"ie/m/home/livingroom/sensor13/temperature2",
"ie/d/building/#",
"ie/m/building/#"
]
}
}
]
}
```
------
**Nota**
Copia i filtri di percorso tra le destinazioni scaricando l'elenco dei filtri di percorso. Per ulteriori informazioni, consulta [Scarica tutti i filtri di percorso in una destinazione (console)](destinations-manage.md#destinations-download-list).
## Carica i filtri di percorso in blocco
Per caricare i filtri di percorso in blocco, usa un file CSV o di testo. AWS IoT SiteWise rimuove automaticamente i duplicati esatti quando carichi i file. Ad esempio, `windfarm/site1/` e `windfarm/site1/` sono duplicati esatti che vengono rilevati AWS IoT SiteWise perché la stringa è esattamente la stessa. I duplicati parziali non vengono rimossi e comportano costi aggiuntivi. Ad esempio, `windfarm/#` e `windfarm/site1` sono argomenti sovrapposti perché `windfarm/site1` sono già inclusi in. `windfarm/#`
**Nota**
Evita i duplicati per evitare costi aggiuntivi. Il file caricato deve essere in formato.csv o.txt. Non può contenere alcuna intestazione e deve essere composto da un'unica colonna. Nella colonna, elenca i tuoi filtri di percorso, con ogni filtro su una riga separata. Nel file non devono essere incluse altre informazioni.
**Requisiti di caricamento dei file**
Questi sono requisiti aggiuntivi per il filtro dei percorsi.
+ Puoi caricare un file.csv o .txt. Altri formati di file non sono supportati.
+ I file CSV (.csv) non possono avere intestazioni e devono contenere solo una colonna.
+ Puoi avere un filtro di percorso su ogni riga.
+ I file caricati non possono essere vuoti.
+ Se si utilizza `#` come carattere jolly, deve essere l’ultimo carattere nel filtro degli argomenti. Ad esempio, `topic/#` o come carattere autonomo a un determinato livello di argomento. Tuttavia, `#` può essere utilizzato anche come carattere normale all’interno di un nome a livello di argomento, ad esempio `factory/machine#1/topic`. Per ulteriori informazioni, consulta [Caratteri speciali nei nomi dei filtri di percorso](gw-destinations.md#path-filters-special-characters).
+ Puoi anche usare il `+` personaggio. Ad esempio, `factory/+/temp` utilizzatelo per misurare tutte le temperature delle fabbriche anziché `factory/machine2/temp` `factory/machine3/temp` singolarmente.
# 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à.
------