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à.
Gestore delle ombre
Il componente shadow manager (aws.greengrass.ShadowManager) abilita il servizio shadow locale sul dispositivo principale. Il servizio shadow locale consente ai componenti di utilizzare la comunicazione tra processi per interagire con le ombre locali. Il componente shadow manager gestisce l'archiviazione dei documenti shadow locali e gestisce anche la sincronizzazione degli stati shadow locali con AWS IoT Servizio Device Shadow.
Per ulteriori informazioni su come i dispositivi principali di Greengrass possono interagire con le ombre, consulta Interagisci con le ombre dei dispositivi.
Versioni
Questo componente ha le seguenti versioni:
Tipo
Questo componente è un componente plug-in (aws.greengrass.plugin). Il Nucleo Greengrass esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.
Questo componente utilizza lo stesso file di registro del nucleo di Greengrass. Per ulteriori informazioni, consulta Monitora AWS IoT Greengrass i registri.
Per ulteriori informazioni, consulta Tipi di componenti.
Sistema operativo
Questo componente può essere installato sui dispositivi principali che eseguono i seguenti sistemi operativi:
Requisiti
Questo componente ha i seguenti requisiti:
-
(Facoltativo) Per sincronizzare le ombre con AWS IoT Servizio Device Shadow, il dispositivo principale di Greengrass AWS IoT la policy deve consentire quanto segue AWS IoT Core azioni politiche ombra:
-
iot:GetThingShadow
-
iot:UpdateThingShadow
-
iot:DeleteThingShadow
Per ulteriori informazioni su queste AWS IoT Core politiche, vedere AWS IoT Core azioni politiche nel AWS IoT Guida per gli sviluppatori.
Per ulteriori informazioni sul minimal AWS IoT politica, vedere AWS IoT Politica minima per i dispositivi AWS IoT Greengrass V2 principali
-
Il componente shadow manager è supportato per l'esecuzione in un VPC.
Dipendenze
Quando si distribuisce un componente, AWS IoT Greengrass distribuisce anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti del componente e tutte le sue dipendenze per distribuirlo correttamente. Questa sezione elenca le dipendenze per versioni rilasciate di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ciascuna dipendenza. È inoltre possibile visualizzare le dipendenze per ciascuna versione del componente nel AWS IoT Greengrass plancia. Nella pagina dei dettagli del componente, cerca Dipendenze elenco.
- 2.3.15
-
La tabella seguente elenca le dipendenze per la versione 2.3.15 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.5.0 <2.19.0 |
Flessibili |
- 2.3.14
-
La tabella seguente elenca le dipendenze per la versione 2.3.14 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.5.0 <2.18.0 |
Flessibili |
- 2.3.13
-
La tabella seguente elenca le dipendenze per la versione 2.3.13 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.5.0 <2.17.0 |
Flessibili |
- 2.3.12
-
La tabella seguente elenca le dipendenze per la versione 2.3.12 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.5.0 <2.17.0 |
Flessibili |
- 2.3.11
-
La tabella seguente elenca le dipendenze per la versione 2.3.11 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.5.0 <2.16.0 |
Flessibili |
- 2.3.10
-
La tabella seguente elenca le dipendenze per la versione 2.3.10 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.5.0 <2.15.0 |
Flessibili |
- 2.3.9
-
La tabella seguente elenca le dipendenze per la versione 2.3.9 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.5.0 <2.14.0 |
Flessibili |
- 2.3.5 – 2.3.8
-
La tabella seguente elenca le dipendenze per le versioni da 2.3.5 a 2.3.8 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
>=2.5.0 <2.13.0 |
Flessibili |
- 2.3.3 and 2.3.4
-
La tabella seguente elenca le dipendenze per le versioni 2.3.3 e 2.3.4 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.5.0 <2.12.0 |
Flessibili |
- 2.3.2
-
La tabella seguente elenca le dipendenze per la versione 2.3.2 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.5.0 <2.11.0 |
Flessibili |
- 2.3.0 and 2.3.1
-
La tabella seguente elenca le dipendenze per le versioni 2.3.0 e 2.3.1 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.5.0 <2.10.0 |
Flessibili |
- 2.2.3 and 2.2.4
-
La tabella seguente elenca le dipendenze per le versioni 2.2.3 e 2.2.4 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.2.0 <3.0.0 |
Flessibili |
- 2.2.2
-
La tabella seguente elenca le dipendenze per la versione 2.2.2 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.2.0 <2.9.0 |
Flessibili |
- 2.2.1
-
La tabella seguente elenca le dipendenze per la versione 2.2.1 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.2.0 <2.8.0 |
Flessibili |
- 2.1.1 and 2.2.0
-
La tabella seguente elenca le dipendenze per le versioni 2.1.1 e 2.2.0 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2,2.0 <2,7,0 |
Flessibili |
- 2.0.5 - 2.1.0
-
La tabella seguente elenca le dipendenze per le versioni da 2.0.5 a 2.1.0 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.2.0 <2.6.0 |
Flessibili |
- 2.0.3 and 2.0.4
-
La tabella seguente elenca le dipendenze per le versioni 2.0.3 e 2.0.4 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.2.0 <2.5.0 |
Flessibili |
- 2.0.1 and 2.0.2
-
La tabella seguente elenca le dipendenze per le versioni 2.0.1 e 2.0.2 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.2.0 <2.4.0 |
Flessibili |
- 2.0.0
-
La tabella seguente elenca le dipendenze per la versione 2.0.0 di questo componente.
| Dipendenza |
Versioni compatibili |
Tipo di dipendenza |
| Nucleo Greengrass |
> =2.2.0 <2.3.0 |
Flessibili |
Per ulteriori informazioni sulle dipendenze dei componenti, consulta la riferimento alla ricetta dei componenti.
Configurazione
Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.
- 2.3.x
-
strategy
-
(Facoltativo) La strategia utilizzata da questo componente per sincronizzare le ombre tra AWS IoT Core e il dispositivo principale.
Questo oggetto contiene le seguenti informazioni.
type
-
(Facoltativo) Il tipo di strategia utilizzata da questo componente per sincronizzare le ombre tra AWS IoT Core e il dispositivo principale. Seleziona una delle opzioni seguenti:
-
realTime — Sincronizza le ombre con AWS IoT Core ogni volta che si verifica un aggiornamento delle ombre.
-
periodic — Sincronizza le ombre con AWS IoT Core su un intervallo regolare specificato con delay parametro di configurazione.
Impostazione predefinita: realTime
delay
-
(Facoltativo) L'intervallo in secondi in cui questo componente sincronizza le ombre con AWS IoT Core, quando si specifica il periodic strategia di sincronizzazione.
Questo parametro è obbligatorio se si specifica periodic strategia di sincronizzazione.
synchronize
-
(Facoltativo) Le impostazioni di sincronizzazione che determinano il modo in cui le ombre vengono sincronizzate con Cloud AWS.
È necessario creare un aggiornamento della configurazione con questa proprietà per sincronizzare le ombre con Cloud AWS.
Questo oggetto contiene le seguenti informazioni.
coreThing
-
(Facoltativo) Le ombre del dispositivo principale da sincronizzare. Questo oggetto contiene le seguenti informazioni.
classic
-
(Facoltativo) Per impostazione predefinita, lo shadow manager sincronizza lo stato locale dello shadow classico per il dispositivo principale con Cloud AWS. Se non desideri sincronizzare la classica modalità shadow del dispositivo, impostala su false.
Impostazione predefinita: true
namedShadows
-
(Facoltativo) L'elenco delle ombre dei dispositivi principali denominate da sincronizzare. È necessario specificare i nomi esatti delle ombre.
Le AWS IoT Greengrass il servizio utilizza il AWSManagedGreengrassV2Deployment named shadow per gestire le distribuzioni destinate a singoli dispositivi principali. Questa shadow denominata è riservata all'uso da parte di AWS IoT Greengrass servizio. Non aggiornate o cancellate questa ombra denominata.
shadowDocumentsMap
-
(Facoltativo) Le ombre aggiuntive del dispositivo da sincronizzare. L'utilizzo di questo parametro di configurazione semplifica la specifica dei documenti shadow. Si consiglia di utilizzare questo parametro al posto di shadowDocuments oggetto.
Se si specifica un shadowDocumentsMap oggetto, non è necessario specificare un shadowDocuments oggetto.
Ogni oggetto contiene le seguenti informazioni:
thingName
-
La configurazione delle ombre per thingName per questa configurazione delle ombre.
classic
-
(Facoltativo) Se non desideri sincronizzare l'ombra classica del dispositivo per thingName dispositivo, impostalo su false.
namedShadows
-
L'elenco delle ombre denominate che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.
shadowDocuments
-
(Facoltativo) L'elenco delle ombre aggiuntive del dispositivo da sincronizzare. Ti consigliamo di utilizzare il shadowDocumentsMap parametro invece.
Se si specifica un shadowDocuments oggetto, non è necessario specificare un shadowDocumentsMap oggetto.
Ogni oggetto in questo elenco contiene le seguenti informazioni.
thingName
-
Il nome dell'oggetto del dispositivo per cui sincronizzare le ombre.
classic
-
(Facoltativo) Se non desideri sincronizzare l'ombra classica del dispositivo con thingName dispositivo, impostalo su false.
Impostazione predefinita: true
namedShadows
-
(Facoltativo) L'elenco delle ombre dei dispositivi denominate che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.
direction
-
(Facoltativo) La direzione per sincronizzare le ombre tra il servizio ombra locale e Cloud AWS. È possibile configurare questa opzione per ridurre la larghezza di banda e le connessioni al Cloud AWS. Seleziona una delle opzioni seguenti:
-
betweenDeviceAndCloud — Sincronizza le ombre tra il servizio ombra locale e il Cloud AWS.
-
deviceToCloud — Inviare aggiornamenti shadow dal servizio shadow locale al Cloud AWS e ignora gli aggiornamenti shadow provenienti da Cloud AWS.
-
cloudToDevice — Ricevi aggiornamenti ombra da Cloud AWS e non inviate aggiornamenti shadow dal servizio shadow locale al Cloud AWS.
Impostazione predefinita: BETWEEN_DEVICE_AND_CLOUD
rateLimits
-
(Facoltativo) Le impostazioni che determinano i limiti di frequenza per le richieste di servizi shadow.
Questo oggetto contiene le seguenti informazioni.
maxOutboundSyncUpdatesPerSecond
-
(Facoltativo) Il numero massimo di richieste di sincronizzazione al secondo trasmesse dal dispositivo.
Predefinito: 100 requests/second
maxTotalLocalRequestsRate
-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate al dispositivo principale.
Impostazione predefinita: 200 requests/second
maxLocalRequestsPerSecondPerThing
-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate per ogni oggetto IoT connesso.
Predefinito: 20 requests/second per ogni cosa
Questi parametri dei limiti di velocità definiscono il numero massimo di richieste al secondo per il servizio ombra locale. Il numero massimo di richieste al secondo per AWS IoT Il servizio Device Shadow dipende dal tuo Regione AWS. Per ulteriori informazioni, consulta i limiti per AWS IoT Device Shadow Service API nel Riferimenti generali di Amazon Web Services.
shadowDocumentSizeLimitBytes
-
(Facoltativo) La dimensione massima consentita di ogni documento di stato JSON per le ombre locali.
Se aumenti questo valore, devi aumentare anche il limite di risorse per il documento di stato JSON per le ombre delle nuvole. Per ulteriori informazioni, consulta i limiti per AWS IoT
Device Shadow Service API nel Riferimenti generali di Amazon Web Services.
Predefinito: 8192 byte
Massimo: 30720 byte
Esempio Esempio: aggiornamento dell'unione delle configurazioni
L'esempio seguente mostra un esempio di aggiornamento dell'unione delle configurazioni con tutti i parametri di configurazione disponibili per il componente shadow manager.
{
"strategy":{
"type":"periodic",
"delay":300
},
"synchronize":{
"shadowDocumentsMap":{
"MyDevice1":{
"classic":false,
"namedShadows":[
"MyShadowA",
"MyShadowB"
]
},
"MyDevice2":{
"classic":true,
"namedShadows":[]
}
},
"direction":"betweenDeviceAndCloud"
},
"rateLimits":{
"maxOutboundSyncUpdatesPerSecond":100,
"maxTotalLocalRequestsRate":200,
"maxLocalRequestsPerSecondPerThing":20
},
"shadowDocumentSizeLimitBytes":8192
}
- 2.2.x
-
strategy
-
(Facoltativo) La strategia utilizzata da questo componente per sincronizzare le ombre tra AWS IoT Core e il dispositivo principale.
Questo oggetto contiene le seguenti informazioni.
type
-
(Facoltativo) Il tipo di strategia utilizzata da questo componente per sincronizzare le ombre tra AWS IoT Core e il dispositivo principale. Seleziona una delle opzioni seguenti:
-
realTime — Sincronizza le ombre con AWS IoT Core ogni volta che si verifica un aggiornamento delle ombre.
-
periodic — Sincronizza le ombre con AWS IoT Core su un intervallo regolare specificato con delay parametro di configurazione.
Impostazione predefinita: realTime
delay
-
(Facoltativo) L'intervallo in secondi in cui questo componente sincronizza le ombre con AWS IoT Core, quando si specifica il periodic strategia di sincronizzazione.
Questo parametro è obbligatorio se si specifica periodic strategia di sincronizzazione.
synchronize
-
(Facoltativo) Le impostazioni di sincronizzazione che determinano il modo in cui le ombre vengono sincronizzate con Cloud AWS.
È necessario creare un aggiornamento della configurazione con questa proprietà per sincronizzare le ombre con Cloud AWS.
Questo oggetto contiene le seguenti informazioni.
coreThing
-
(Facoltativo) Le ombre del dispositivo principale da sincronizzare. Questo oggetto contiene le seguenti informazioni.
classic
-
(Facoltativo) Per impostazione predefinita, lo shadow manager sincronizza lo stato locale dello shadow classico per il dispositivo principale con Cloud AWS. Se non desideri sincronizzare la classica modalità shadow del dispositivo, impostala su false.
Impostazione predefinita: true
namedShadows
-
(Facoltativo) L'elenco delle ombre dei dispositivi principali denominate da sincronizzare. È necessario specificare i nomi esatti delle ombre.
Le AWS IoT Greengrass il servizio utilizza il AWSManagedGreengrassV2Deployment named shadow per gestire le distribuzioni destinate a singoli dispositivi principali. Questa shadow denominata è riservata all'uso da parte di AWS IoT Greengrass servizio. Non aggiornate o cancellate questa ombra denominata.
shadowDocumentsMap
-
(Facoltativo) Le ombre aggiuntive del dispositivo da sincronizzare. L'utilizzo di questo parametro di configurazione semplifica la specifica dei documenti shadow. Si consiglia di utilizzare questo parametro al posto di shadowDocuments oggetto.
Se si specifica un shadowDocumentsMap oggetto, non è necessario specificare un shadowDocuments oggetto.
Ogni oggetto contiene le seguenti informazioni:
thingName
-
La configurazione delle ombre per thingName per questa configurazione delle ombre.
classic
-
(Facoltativo) Se non desideri sincronizzare l'ombra classica del dispositivo per thingName dispositivo, impostalo su false.
namedShadows
-
L'elenco delle ombre denominate che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.
shadowDocuments
-
(Facoltativo) L'elenco delle ombre aggiuntive del dispositivo da sincronizzare. Ti consigliamo di utilizzare il shadowDocumentsMap parametro invece.
Se si specifica un shadowDocuments oggetto, non è necessario specificare un shadowDocumentsMap oggetto.
Ogni oggetto in questo elenco contiene le seguenti informazioni.
thingName
-
Il nome dell'oggetto del dispositivo per cui sincronizzare le ombre.
classic
-
(Facoltativo) Se non desideri sincronizzare l'ombra classica del dispositivo con thingName dispositivo, impostalo su false.
Impostazione predefinita: true
namedShadows
-
(Facoltativo) L'elenco delle ombre dei dispositivi denominate che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.
direction
-
(Facoltativo) La direzione per sincronizzare le ombre tra il servizio ombra locale e Cloud AWS. È possibile configurare questa opzione per ridurre la larghezza di banda e le connessioni al Cloud AWS. Seleziona una delle opzioni seguenti:
-
betweenDeviceAndCloud — Sincronizza le ombre tra il servizio ombra locale e Cloud AWS.
-
deviceToCloud — Inviare aggiornamenti shadow dal servizio shadow locale al Cloud AWS e ignora gli aggiornamenti shadow provenienti da Cloud AWS.
-
cloudToDevice — Ricevi aggiornamenti ombra da Cloud AWS e non inviate aggiornamenti shadow dal servizio shadow locale al Cloud AWS.
Impostazione predefinita: BETWEEN_DEVICE_AND_CLOUD
rateLimits
-
(Facoltativo) Le impostazioni che determinano i limiti di frequenza per le richieste di servizi shadow.
Questo oggetto contiene le seguenti informazioni.
maxOutboundSyncUpdatesPerSecond
-
(Facoltativo) Il numero massimo di richieste di sincronizzazione al secondo trasmesse dal dispositivo.
Predefinito: 100 requests/second
maxTotalLocalRequestsRate
-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate al dispositivo principale.
Impostazione predefinita: 200 requests/second
maxLocalRequestsPerSecondPerThing
-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate per ogni oggetto IoT connesso.
Predefinito: 20 requests/second per ogni cosa
Questi parametri dei limiti di velocità definiscono il numero massimo di richieste al secondo per il servizio ombra locale. Il numero massimo di richieste al secondo per AWS IoT Il servizio Device Shadow dipende dal tuo Regione AWS. Per ulteriori informazioni, consulta i limiti per AWS IoT Device Shadow Service API nel Riferimenti generali di Amazon Web Services.
shadowDocumentSizeLimitBytes
-
(Facoltativo) La dimensione massima consentita di ogni documento di stato JSON per le ombre locali.
Se aumenti questo valore, devi aumentare anche il limite di risorse per il documento di stato JSON per le ombre delle nuvole. Per ulteriori informazioni, consulta i limiti per AWS IoT
Device Shadow Service API nel Riferimenti generali di Amazon Web Services.
Predefinito: 8192 byte
Massimo: 30720 byte
Esempio Esempio: aggiornamento dell'unione delle configurazioni
L'esempio seguente mostra un esempio di aggiornamento dell'unione delle configurazioni con tutti i parametri di configurazione disponibili per il componente shadow manager.
{
"strategy":{
"type":"periodic",
"delay":300
},
"synchronize":{
"shadowDocumentsMap":{
"MyDevice1":{
"classic":false,
"namedShadows":[
"MyShadowA",
"MyShadowB"
]
},
"MyDevice2":{
"classic":true,
"namedShadows":[]
}
},
"direction":"betweenDeviceAndCloud"
},
"rateLimits":{
"maxOutboundSyncUpdatesPerSecond":100,
"maxTotalLocalRequestsRate":200,
"maxLocalRequestsPerSecondPerThing":20
},
"shadowDocumentSizeLimitBytes":8192
}
- 2.1.x
-
strategy
-
(Facoltativo) La strategia utilizzata da questo componente per sincronizzare le ombre tra AWS IoT Core e il dispositivo principale.
Questo oggetto contiene le seguenti informazioni.
type
-
(Facoltativo) Il tipo di strategia utilizzata da questo componente per sincronizzare le ombre tra AWS IoT Core e il dispositivo principale. Seleziona una delle opzioni seguenti:
-
realTime — Sincronizza le ombre con AWS IoT Core ogni volta che si verifica un aggiornamento delle ombre.
-
periodic — Sincronizza le ombre con AWS IoT Core su un intervallo regolare specificato con delay parametro di configurazione.
Impostazione predefinita: realTime
delay
-
(Facoltativo) L'intervallo in secondi in cui questo componente sincronizza le ombre con AWS IoT Core, quando si specifica il periodic strategia di sincronizzazione.
Questo parametro è obbligatorio se si specifica periodic strategia di sincronizzazione.
synchronize
-
(Facoltativo) Le impostazioni di sincronizzazione che determinano il modo in cui le ombre vengono sincronizzate con Cloud AWS.
È necessario creare un aggiornamento della configurazione con questa proprietà per sincronizzare le ombre con Cloud AWS.
Questo oggetto contiene le seguenti informazioni.
coreThing
-
(Facoltativo) Le ombre del dispositivo principale da sincronizzare. Questo oggetto contiene le seguenti informazioni.
classic
-
(Facoltativo) Per impostazione predefinita, lo shadow manager sincronizza lo stato locale dello shadow classico per il dispositivo principale con Cloud AWS. Se non desideri sincronizzare la classica modalità shadow del dispositivo, impostala su false.
Impostazione predefinita: true
namedShadows
-
(Facoltativo) L'elenco delle ombre dei dispositivi principali denominate da sincronizzare. È necessario specificare i nomi esatti delle ombre.
Le AWS IoT Greengrass il servizio utilizza il AWSManagedGreengrassV2Deployment named shadow per gestire le distribuzioni destinate a singoli dispositivi principali. Questa shadow denominata è riservata all'uso da parte di AWS IoT Greengrass servizio. Non aggiornate o cancellate questa ombra denominata.
shadowDocumentsMap
-
(Facoltativo) Le ombre aggiuntive del dispositivo da sincronizzare. L'utilizzo di questo parametro di configurazione semplifica la specifica dei documenti shadow. Si consiglia di utilizzare questo parametro al posto di shadowDocuments oggetto.
Se si specifica un shadowDocumentsMap oggetto, non è necessario specificare un shadowDocuments oggetto.
Ogni oggetto contiene le seguenti informazioni:
thingName
-
La configurazione delle ombre per thingName per questa configurazione delle ombre.
classic
-
(Facoltativo) Se non desideri sincronizzare l'ombra classica del dispositivo per thingName dispositivo, impostalo su false.
namedShadows
-
L'elenco delle ombre denominate che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.
shadowDocuments
-
(Facoltativo) L'elenco delle ombre aggiuntive del dispositivo da sincronizzare. Ti consigliamo di utilizzare il shadowDocumentsMap parametro invece.
Se si specifica un shadowDocuments oggetto, non è necessario specificare un shadowDocumentsMap oggetto.
Ogni oggetto in questo elenco contiene le seguenti informazioni.
thingName
-
Il nome dell'oggetto del dispositivo per cui sincronizzare le ombre.
classic
-
(Facoltativo) Se non desideri sincronizzare l'ombra classica del dispositivo con thingName dispositivo, impostalo su false.
Impostazione predefinita: true
namedShadows
-
(Facoltativo) L'elenco delle ombre dei dispositivi denominate che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.
rateLimits
-
(Facoltativo) Le impostazioni che determinano i limiti di frequenza per le richieste di servizi shadow.
Questo oggetto contiene le seguenti informazioni.
maxOutboundSyncUpdatesPerSecond
-
(Facoltativo) Il numero massimo di richieste di sincronizzazione al secondo trasmesse dal dispositivo.
Predefinito: 100 requests/second
maxTotalLocalRequestsRate
-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate al dispositivo principale.
Impostazione predefinita: 200 requests/second
maxLocalRequestsPerSecondPerThing
-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate per ogni oggetto IoT connesso.
Predefinito: 20 requests/second per ogni cosa
Questi parametri dei limiti di velocità definiscono il numero massimo di richieste al secondo per il servizio ombra locale. Il numero massimo di richieste al secondo per AWS IoT Il servizio Device Shadow dipende dal tuo Regione AWS. Per ulteriori informazioni, consulta i limiti per AWS IoT Device Shadow Service API nel Riferimenti generali di Amazon Web Services.
shadowDocumentSizeLimitBytes
-
(Facoltativo) La dimensione massima consentita di ogni documento di stato JSON per le ombre locali.
Se aumenti questo valore, devi aumentare anche il limite di risorse per il documento di stato JSON per le ombre delle nuvole. Per ulteriori informazioni, consulta i limiti per AWS IoT
Device Shadow Service API nel Riferimenti generali di Amazon Web Services.
Predefinito: 8192 byte
Massimo: 30720 byte
Esempio Esempio: aggiornamento dell'unione delle configurazioni
L'esempio seguente mostra un esempio di aggiornamento dell'unione delle configurazioni con tutti i parametri di configurazione disponibili per il componente shadow manager.
{
"strategy":{
"type":"periodic",
"delay":300
},
"synchronize":{
"shadowDocumentsMap":{
"MyDevice1":{
"classic":false,
"namedShadows":[
"MyShadowA",
"MyShadowB"
]
},
"MyDevice2":{
"classic":true,
"namedShadows":[]
}
},
"direction":"betweenDeviceAndCloud"
},
"rateLimits":{
"maxOutboundSyncUpdatesPerSecond":100,
"maxTotalLocalRequestsRate":200,
"maxLocalRequestsPerSecondPerThing":20
},
"shadowDocumentSizeLimitBytes":8192
}
- 2.0.x
-
synchronize
-
(Facoltativo) Le impostazioni di sincronizzazione che determinano il modo in cui le ombre vengono sincronizzate con Cloud AWS.
È necessario creare un aggiornamento della configurazione con questa proprietà per sincronizzare le ombre con Cloud AWS.
Questo oggetto contiene le seguenti informazioni.
coreThing
-
(Facoltativo) Le ombre del dispositivo principale da sincronizzare. Questo oggetto contiene le seguenti informazioni.
classic
-
(Facoltativo) Per impostazione predefinita, lo shadow manager sincronizza lo stato locale dello shadow classico per il dispositivo principale con Cloud AWS. Se non desideri sincronizzare la classica modalità shadow del dispositivo, impostala su false.
Impostazione predefinita: true
namedShadows
-
(Facoltativo) L'elenco delle ombre dei dispositivi principali denominate da sincronizzare. È necessario specificare i nomi esatti delle ombre.
Le AWS IoT Greengrass il servizio utilizza il AWSManagedGreengrassV2Deployment named shadow per gestire le distribuzioni destinate a singoli dispositivi principali. Questa shadow denominata è riservata all'uso da parte di AWS IoT Greengrass servizio. Non aggiornate o cancellate questa ombra denominata.
shadowDocumentsMap
-
(Facoltativo) Le ombre aggiuntive del dispositivo da sincronizzare. L'utilizzo di questo parametro di configurazione semplifica la specifica dei documenti shadow. Si consiglia di utilizzare questo parametro al posto di shadowDocuments oggetto.
Se si specifica un shadowDocumentsMap oggetto, non è necessario specificare un shadowDocuments oggetto.
Ogni oggetto contiene le seguenti informazioni:
thingName
-
La configurazione delle ombre per thingName per questa configurazione delle ombre.
classic
-
(Facoltativo) Se non desideri sincronizzare l'ombra classica del dispositivo per thingName dispositivo, impostalo su false.
namedShadows
-
L'elenco delle ombre denominate che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.
shadowDocuments
-
(Facoltativo) L'elenco delle ombre aggiuntive del dispositivo da sincronizzare. Ti consigliamo di utilizzare il shadowDocumentsMap parametro invece.
Se si specifica un shadowDocuments oggetto, non è necessario specificare un shadowDocumentsMap oggetto.
Ogni oggetto in questo elenco contiene le seguenti informazioni.
thingName
-
Il nome dell'oggetto del dispositivo per cui sincronizzare le ombre.
classic
-
(Facoltativo) Se non desideri sincronizzare l'ombra classica del dispositivo con thingName dispositivo, impostalo su false.
Impostazione predefinita: true
namedShadows
-
(Facoltativo) L'elenco delle ombre dei dispositivi denominate che desideri sincronizzare. È necessario specificare i nomi esatti delle ombre.
rateLimits
-
(Facoltativo) Le impostazioni che determinano i limiti di frequenza per le richieste di servizi shadow.
Questo oggetto contiene le seguenti informazioni.
maxOutboundSyncUpdatesPerSecond
-
(Facoltativo) Il numero massimo di richieste di sincronizzazione al secondo trasmesse dal dispositivo.
Predefinito: 100 requests/second
maxTotalLocalRequestsRate
-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate al dispositivo principale.
Impostazione predefinita: 200 requests/second
maxLocalRequestsPerSecondPerThing
-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate per ogni oggetto IoT connesso.
Predefinito: 20 requests/second per ogni cosa
Questi parametri dei limiti di velocità definiscono il numero massimo di richieste al secondo per il servizio ombra locale. Il numero massimo di richieste al secondo per AWS IoT Il servizio Device Shadow dipende dal tuo Regione AWS. Per ulteriori informazioni, consulta i limiti per AWS IoT Device Shadow Service API nel Riferimenti generali di Amazon Web Services.
shadowDocumentSizeLimitBytes
-
(Facoltativo) La dimensione massima consentita di ogni documento di stato JSON per le ombre locali.
Se aumenti questo valore, devi aumentare anche il limite di risorse per il documento di stato JSON per le ombre delle nuvole. Per ulteriori informazioni, consulta i limiti per AWS IoT
Device Shadow Service API nel Riferimenti generali di Amazon Web Services.
Predefinito: 8192 byte
Massimo: 30720 byte
Esempio Esempio: aggiornamento dell'unione delle configurazioni
L'esempio seguente mostra un esempio di aggiornamento dell'unione delle configurazioni con tutti i parametri di configurazione disponibili per il componente shadow manager.
{
"synchronize": {
"coreThing": {
"classic": true,
"namedShadows": [
"MyCoreShadowA",
"MyCoreShadowB"
]
},
"shadowDocuments": [
{
"thingName": "MyDevice1",
"classic": false,
"namedShadows": [
"MyShadowA",
"MyShadowB"
]
},
{
"thingName": "MyDevice2",
"classic": true,
"namedShadows": []
}
]
},
"rateLimits": {
"maxOutboundSyncUpdatesPerSecond": 100,
"maxTotalLocalRequestsRate": 200,
"maxLocalRequestsPerSecondPerThing": 20
},
"shadowDocumentSizeLimitBytes": 8192
}
File di registro locale
Questo componente utilizza lo stesso file di registro del Nucleo di Greengrass componente.
- Linux
-
/greengrass/v2/logs/greengrass.log
- Windows
-
C:\greengrass\v2\logs\greengrass.log
Per visualizzare i log di questo componente
Changelog
La tabella seguente descrive le modifiche in ciascuna versione del componente.
|
Versione
|
Modifiche
|
|
2.3.15
|
- Correzioni di bug e miglioramenti
-
-
Risolve un problema a causa del quale lo shadow manager poteva smettere di funzionare dopo che un'interruzione di corrente danneggiava il database locale.
-
Convalida l'integrità del database locale all'avvio e ricrea il database quando rileva un danneggiamento.
|
|
2.3.14
|
Aggiorna la versione del componente per la versione 2.17.0 di Greengrass nucleus.
|
|
2.3.13
|
- Correzioni di bug e miglioramenti
-
-
Risolve un problema a causa del quale gli aggiornamenti shadow locali non riuscivano a sincronizzarsi in modo intermittente con il cloud anche quando la configurazione della direzione di sincronizzazione lo consente.
-
Miglioramenti e correzioni di bug minori.
|
|
2.3.12
|
- Correzioni di bug e miglioramenti
-
|
|
2.3.11
|
Versione aggiornata per la versione 2.15.0 di Greengrass nucleus. |
|
2.3.10
|
Versione aggiornata per la versione 2.14.0 di Greengrass nucleus. |
|
2.3.9
|
Versione aggiornata per la versione 2.13.0 di Greengrass nucleus. |
|
2.3.8
|
- Correzioni di bug e miglioramenti
-
|
|
2.3.7
|
- Correzioni di bug e miglioramenti
-
|
|
2.3.6
|
- Correzioni di bug e miglioramenti
-
|
|
2.3.5
|
Versione aggiornata per Greengrass nucleus versione 2.12.0. |
|
2.3.4
|
- Correzioni di bug e miglioramenti
-
|
|
2.3.3
|
Versione aggiornata per la versione 2.11.0 di Greengrass nucleus. |
|
2.3.2
|
- Correzioni di bug e miglioramenti
-
|
|
2.3.1
|
- Correzioni di bug e miglioramenti
-
-
Risolve una condizione che potrebbe impedire la sincronizzazione degli aggiornamenti di Cloud Shadow.
-
Risolve un problema per cui le modifiche alla configurazione denominata shadow sync si applicano a una sola shadow denominata.
|
|
2.3.0
|
- Correzioni di bug e miglioramenti
-
|
|
2.2.4
|
- Correzioni di bug e miglioramenti
-
-
Risolve un problema per cui la convalida della dimensione dello shadow non era coerente con quella del cloud durante l'aggiornamento del documento shadow locale.
-
Risolve un problema a causa del quale lo shadow manager interrompe l'ascolto degli aggiornamenti di configurazione se una distribuzione esegue un RESET sui nodi di configurazione.
|
|
2.2.3
|
Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. |
|
2.2.2
|
Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. |
|
2.2.1
|
Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.
|
|
2.2.0
|
- Nuove funzionalità
-
-
Aggiunge il supporto per il servizio ombra locale rispetto a quello locale publish/subscribe interfaccia. Ora puoi comunicare con il locale publish/subscribe broker di messaggi attivo argomenti Shadow MQTT per ottenere, aggiornare ed eliminare le ombre sul dispositivo principale. Questa funzionalità consente di connettere i dispositivi client al servizio shadow locale utilizzando il bridge MQTT per inoltrare messaggi su argomenti ombra tra i dispositivi client e il locale publish/subscribe interfaccia.
Questa funzionalità richiede la versione 2.6.0 o successiva di Componente del nucleo di Greengrass. Per connettere i dispositivi client al servizio shadow locale, è necessario utilizzare anche la versione 2.2.0 o successiva di Componente bridge MQTT.
-
Aggiunge direction opzione che è possibile configurare per personalizzare la direzione per sincronizzare le ombre tra il servizio shadow locale e Cloud AWS. È possibile configurare questa opzione per ridurre la larghezza di banda e le connessioni al Cloud AWS.
|
|
2.1.1
|
- Correzioni di bug e miglioramenti
-
-
Risolve un problema in cui la profondità massima nel desired e reported le sezioni del documento sullo stato ombra del dispositivo JSON erano a 4 livelli anziché a 5 livelli.
-
Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.
|
|
2.1.0
|
|
|
2.0.6
|
Questa versione contiene correzioni di bug e miglioramenti.
|
|
2.0.5
|
Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.
|
|
2.0.4
|
- Correzioni di bug e miglioramenti
-
-
Risolve un problema che faceva sì che Shadow Manager cancellasse le versioni appena create di qualsiasi shadow precedentemente cancellata.
-
Aggiorna il DeleteThingShadow Operazione IPC per incrementare la versione shadow quando viene chiamata.
|
|
2.0.3
|
Versione aggiornata per Greengrass nucleus versione 2.4.0.
|
|
2.0.2
|
- Correzioni di bug e miglioramenti
-
-
È stato risolto un problema per il quale Shadow Manager non riconosceva il delta proprietà durante la sincronizzazione degli stati ombra da AWS IoT Core.
-
È stato risolto un problema che a volte causava l'unione errata delle richieste di sincronizzazione per uno shadow.
|
|
2.0.1
|
Versione aggiornata per Greengrass nucleus versione 2.3.0.
|
|
2.0.0
|
Versione iniziale.
|