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 il servizio AWS IoT Device Shadow.
Per ulteriori informazioni su come i dispositivi core Greengrass possono interagire con le ombre, vedere. Interagisci con le ombre dei dispositivi
Versioni
Questo componente ha le seguenti versioni:
Type
Questo componente è un componente del plugin ()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 Greengrass. Per ulteriori informazioni, consulta Monitora AWS IoT Greengrass i registri.
Per ulteriori informazioni, consultare Tipi di componenti.
Sistema operativo
Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
Requisiti
Questo componente presenta i seguenti requisiti:
-
(Facoltativo) Per sincronizzare le ombre con il servizio AWS IoT Device Shadow, la policy AWS IoT del dispositivo principale di Greengrass deve consentire le AWS IoT Core seguenti azioni di policy ombra:
-
iot:GetThingShadow
-
iot:UpdateThingShadow
-
iot:DeleteThingShadow
Per ulteriori informazioni su queste AWS IoT Core politiche, consulta le azioni AWS IoT Core politiche nella Guida per gli AWS IoT sviluppatori.
Per ulteriori informazioni sulla AWS IoT politica minima, vedere AWS IoTPolitica 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, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le versioni rilasciate di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass Nella pagina dei dettagli del componente, cerca l'elenco delle dipendenze.
- 2.3.5 – 2.3.7
-
La tabella seguente elenca le dipendenze per le versioni da 2.3.5 a 2.3.7 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, vedere il 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 utilizzato da questo componente per sincronizzare le ombre tra AWS IoT Core e il dispositivo principale. Seleziona una delle opzioni seguenti:
-
realTime— Sincronizza le ombre AWS IoT Core ogni volta che si verifica un aggiornamento delle ombre.
-
periodic— Sincronizza le ombre con AWS IoT Core un intervallo regolare specificato con il delay parametro di configurazione.
Impostazione predefinita: realTime
delay-
(Facoltativo) L'intervallo in secondi con cui questo componente sincronizza le ombre AWS IoT Core, quando si specifica la strategia di sincronizzazione. periodic
Questo parametro è obbligatorio se si specifica la strategia di sincronizzazione. periodic
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 vuoi sincronizzare la classica ombra 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.
Il AWS IoT Greengrass servizio utilizza lo shadow AWSManagedGreengrassV2Deployment denominato per gestire le distribuzioni destinate a singoli dispositivi core. Questa ombra denominata è riservata all'uso da parte del AWS IoT Greengrass servizio. Non aggiornare o eliminare questa ombra denominata.
shadowDocumentsMap-
(Facoltativo) Le ombre aggiuntive del dispositivo da sincronizzare. L'utilizzo di questo parametro di configurazione semplifica la specificazione dei documenti shadow. Si consiglia di utilizzare questo parametro al posto dell'shadowDocumentsoggetto.
Se si specifica un shadowDocumentsMap oggetto, non è necessario specificare un shadowDocuments oggetto.
Ogni oggetto contiene le seguenti informazioni:
thingName-
La configurazione shadow per ThingName per questa configurazione shadow.
classic-
(Facoltativo) Se non desiderate sincronizzare la classica ombra del dispositivo per il thingName dispositivo, impostatela false su.
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 invece di utilizzare il shadowDocumentsMap parametro.
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 la classica ombra del dispositivo per il thingName dispositivo, impostala 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 in cui sincronizzare le ombre tra il servizio shadow locale e il. Cloud AWSÈ possibile configurare questa opzione per ridurre la larghezza di banda e le connessioni a. Cloud AWS Seleziona una delle opzioni seguenti:
-
betweenDeviceAndCloud— Sincronizza le ombre tra il servizio shadow locale e il. Cloud AWS
-
deviceToCloud— Invia gli aggiornamenti shadow dal servizio shadow locale al e ignora gli aggiornamenti shadow provenienti da. Cloud AWS Cloud AWS
-
cloudToDevice— Ricevi aggiornamenti shadow dal Cloud AWS servizio shadow locale e non inviali dal servizio shadow locale a Cloud AWS.
Impostazione predefinita: BETWEEN_DEVICE_AND_CLOUD
rateLimits-
(Facoltativo) Le impostazioni che determinano i limiti di velocità per le richieste del servizio shadow.
Questo oggetto contiene le seguenti informazioni.
maxOutboundSyncUpdatesPerSecond-
(Facoltativo) Il numero massimo di richieste di sincronizzazione al secondo trasmesse dal dispositivo.
Impostazione predefinita: 100 richieste/secondo
maxTotalLocalRequestsRate-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate al dispositivo principale.
Impostazione predefinita: 200 richieste/secondo
maxLocalRequestsPerSecondPerThing-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate per ogni oggetto IoT connesso.
Impostazione predefinita: 20 richieste/secondo per ogni cosa
Questi parametri relativi ai limiti di velocità definiscono il numero massimo di richieste al secondo per il servizio shadow locale. Il numero massimo di richieste al secondo per il servizio AWS IoT Device Shadow dipende dal tuo Regione AWS. Per ulteriori informazioni, consulta i limiti per l'API AWS IoT Device Shadow Service in Riferimenti generali di Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Facoltativo) La dimensione massima consentita di ogni documento di stato JSON per le ombre locali.
Se si aumenta questo valore, è necessario aumentare anche il limite di risorse per il documento di stato JSON per le ombre nel cloud. Per ulteriori informazioni, consulta i limiti per l'API AWS IoT
Device Shadow Service in Riferimenti generali di Amazon Web Services.
Impostazione predefinita: 8192 byte
Massimo: 30720 byte
Esempio: aggiornamento di fusione della configurazione
L'esempio seguente mostra un esempio di aggiornamento di fusione della configurazione 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 utilizzato da questo componente per sincronizzare le ombre tra AWS IoT Core e il dispositivo principale. Seleziona una delle opzioni seguenti:
-
realTime— Sincronizza le ombre AWS IoT Core ogni volta che si verifica un aggiornamento delle ombre.
-
periodic— Sincronizza le ombre con AWS IoT Core un intervallo regolare specificato con il delay parametro di configurazione.
Impostazione predefinita: realTime
delay-
(Facoltativo) L'intervallo in secondi con cui questo componente sincronizza le ombre AWS IoT Core, quando si specifica la strategia di sincronizzazione. periodic
Questo parametro è obbligatorio se si specifica la strategia di sincronizzazione. periodic
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 vuoi sincronizzare la classica ombra 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.
Il AWS IoT Greengrass servizio utilizza lo shadow AWSManagedGreengrassV2Deployment denominato per gestire le distribuzioni destinate a singoli dispositivi core. Questa ombra denominata è riservata all'uso da parte del AWS IoT Greengrass servizio. Non aggiornare o eliminare questa ombra denominata.
shadowDocumentsMap-
(Facoltativo) Le ombre aggiuntive del dispositivo da sincronizzare. L'utilizzo di questo parametro di configurazione semplifica la specificazione dei documenti shadow. Si consiglia di utilizzare questo parametro al posto dell'shadowDocumentsoggetto.
Se si specifica un shadowDocumentsMap oggetto, non è necessario specificare un shadowDocuments oggetto.
Ogni oggetto contiene le seguenti informazioni:
thingName-
La configurazione shadow per ThingName per questa configurazione shadow.
classic-
(Facoltativo) Se non desiderate sincronizzare la classica ombra del dispositivo per il thingName dispositivo, impostatela false su.
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 invece di utilizzare il shadowDocumentsMap parametro.
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 la classica ombra del dispositivo per il thingName dispositivo, impostala 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 in cui sincronizzare le ombre tra il servizio shadow locale e il. Cloud AWSÈ possibile configurare questa opzione per ridurre la larghezza di banda e le connessioni a. Cloud AWS Seleziona una delle opzioni seguenti:
-
betweenDeviceAndCloud— Sincronizza le ombre tra il servizio shadow locale e il. Cloud AWS
-
deviceToCloud— Invia gli aggiornamenti shadow dal servizio shadow locale al e ignora gli aggiornamenti shadow provenienti da. Cloud AWS Cloud AWS
-
cloudToDevice— Ricevi aggiornamenti shadow dal Cloud AWS servizio shadow locale e non inviali dal servizio shadow locale a Cloud AWS.
Impostazione predefinita: BETWEEN_DEVICE_AND_CLOUD
rateLimits-
(Facoltativo) Le impostazioni che determinano i limiti di velocità per le richieste del servizio shadow.
Questo oggetto contiene le seguenti informazioni.
maxOutboundSyncUpdatesPerSecond-
(Facoltativo) Il numero massimo di richieste di sincronizzazione al secondo trasmesse dal dispositivo.
Impostazione predefinita: 100 richieste/secondo
maxTotalLocalRequestsRate-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate al dispositivo principale.
Impostazione predefinita: 200 richieste/secondo
maxLocalRequestsPerSecondPerThing-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate per ogni oggetto IoT connesso.
Impostazione predefinita: 20 richieste/secondo per ogni cosa
Questi parametri relativi ai limiti di velocità definiscono il numero massimo di richieste al secondo per il servizio shadow locale. Il numero massimo di richieste al secondo per il servizio AWS IoT Device Shadow dipende dal tuo Regione AWS. Per ulteriori informazioni, consulta i limiti per l'API AWS IoT Device Shadow Service in Riferimenti generali di Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Facoltativo) La dimensione massima consentita di ogni documento di stato JSON per le ombre locali.
Se si aumenta questo valore, è necessario aumentare anche il limite di risorse per il documento di stato JSON per le ombre nel cloud. Per ulteriori informazioni, consulta i limiti per l'API AWS IoT
Device Shadow Service in Riferimenti generali di Amazon Web Services.
Impostazione predefinita: 8192 byte
Massimo: 30720 byte
Esempio: aggiornamento di fusione della configurazione
L'esempio seguente mostra un esempio di aggiornamento di fusione della configurazione 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 utilizzato da questo componente per sincronizzare le ombre tra AWS IoT Core e il dispositivo principale. Seleziona una delle opzioni seguenti:
-
realTime— Sincronizza le ombre AWS IoT Core ogni volta che si verifica un aggiornamento delle ombre.
-
periodic— Sincronizza le ombre con AWS IoT Core un intervallo regolare specificato con il delay parametro di configurazione.
Impostazione predefinita: realTime
delay-
(Facoltativo) L'intervallo in secondi con cui questo componente sincronizza le ombre AWS IoT Core, quando si specifica la strategia di sincronizzazione. periodic
Questo parametro è obbligatorio se si specifica la strategia di sincronizzazione. periodic
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 vuoi sincronizzare la classica ombra 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.
Il AWS IoT Greengrass servizio utilizza lo shadow AWSManagedGreengrassV2Deployment denominato per gestire le distribuzioni destinate a singoli dispositivi core. Questa ombra denominata è riservata all'uso da parte del AWS IoT Greengrass servizio. Non aggiornare o eliminare questa ombra denominata.
shadowDocumentsMap-
(Facoltativo) Le ombre aggiuntive del dispositivo da sincronizzare. L'utilizzo di questo parametro di configurazione semplifica la specificazione dei documenti shadow. Si consiglia di utilizzare questo parametro al posto dell'shadowDocumentsoggetto.
Se si specifica un shadowDocumentsMap oggetto, non è necessario specificare un shadowDocuments oggetto.
Ogni oggetto contiene le seguenti informazioni:
thingName-
La configurazione shadow per ThingName per questa configurazione shadow.
classic-
(Facoltativo) Se non desiderate sincronizzare la classica ombra del dispositivo per il thingName dispositivo, impostatela false su.
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 invece di utilizzare il shadowDocumentsMap parametro.
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 la classica ombra del dispositivo per il thingName dispositivo, impostala 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 velocità 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.
Impostazione predefinita: 100 richieste/secondo
maxTotalLocalRequestsRate-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate al dispositivo principale.
Impostazione predefinita: 200 richieste/secondo
maxLocalRequestsPerSecondPerThing-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate per ogni oggetto IoT connesso.
Impostazione predefinita: 20 richieste/secondo per ogni cosa
Questi parametri relativi ai limiti di velocità definiscono il numero massimo di richieste al secondo per il servizio shadow locale. Il numero massimo di richieste al secondo per il servizio AWS IoT Device Shadow dipende dal tuo Regione AWS. Per ulteriori informazioni, consulta i limiti per l'API AWS IoT Device Shadow Service in Riferimenti generali di Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Facoltativo) La dimensione massima consentita di ogni documento di stato JSON per le ombre locali.
Se si aumenta questo valore, è necessario aumentare anche il limite di risorse per il documento di stato JSON per le ombre nel cloud. Per ulteriori informazioni, consulta i limiti per l'API AWS IoT
Device Shadow Service in Riferimenti generali di Amazon Web Services.
Impostazione predefinita: 8192 byte
Massimo: 30720 byte
Esempio: aggiornamento di fusione della configurazione
L'esempio seguente mostra un esempio di aggiornamento di fusione della configurazione 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 vuoi sincronizzare la classica ombra 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.
Il AWS IoT Greengrass servizio utilizza lo shadow AWSManagedGreengrassV2Deployment denominato per gestire le distribuzioni destinate a singoli dispositivi core. Questa ombra denominata è riservata all'uso da parte del AWS IoT Greengrass servizio. Non aggiornare o eliminare questa ombra denominata.
shadowDocumentsMap-
(Facoltativo) Le ombre aggiuntive del dispositivo da sincronizzare. L'utilizzo di questo parametro di configurazione semplifica la specificazione dei documenti shadow. Si consiglia di utilizzare questo parametro al posto dell'shadowDocumentsoggetto.
Se si specifica un shadowDocumentsMap oggetto, non è necessario specificare un shadowDocuments oggetto.
Ogni oggetto contiene le seguenti informazioni:
thingName-
La configurazione shadow per ThingName per questa configurazione shadow.
classic-
(Facoltativo) Se non desiderate sincronizzare la classica ombra del dispositivo per il thingName dispositivo, impostatela false su.
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 invece di utilizzare il shadowDocumentsMap parametro.
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 la classica ombra del dispositivo per il thingName dispositivo, impostala 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 velocità 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.
Impostazione predefinita: 100 richieste/secondo
maxTotalLocalRequestsRate-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate al dispositivo principale.
Impostazione predefinita: 200 richieste/secondo
maxLocalRequestsPerSecondPerThing-
(Facoltativo) Il numero massimo di richieste IPC locali al secondo inviate per ogni oggetto IoT connesso.
Impostazione predefinita: 20 richieste/secondo per ogni cosa
Questi parametri relativi ai limiti di velocità definiscono il numero massimo di richieste al secondo per il servizio shadow locale. Il numero massimo di richieste al secondo per il servizio AWS IoT Device Shadow dipende dal tuo Regione AWS. Per ulteriori informazioni, consulta i limiti per l'API AWS IoT Device Shadow Service in Riferimenti generali di Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Facoltativo) La dimensione massima consentita di ogni documento di stato JSON per le ombre locali.
Se si aumenta questo valore, è necessario aumentare anche il limite di risorse per il documento di stato JSON per le ombre nel cloud. Per ulteriori informazioni, consulta i limiti per l'API AWS IoT
Device Shadow Service in Riferimenti generali di Amazon Web Services.
Impostazione predefinita: 8192 byte
Massimo: 30720 byte
Esempio: aggiornamento di fusione della configurazione
L'esempio seguente mostra un esempio di aggiornamento di fusione della configurazione 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 componente Greengrass nucleus.
- Linux
-
/greengrass/v2
- Windows
-
C:\greengrass\v2\logs\greengrass.log
Per visualizzare i log di questo componente
Changelog
La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.
|
Versione
|
Modifiche
|
|
2.3.7
|
- Correzioni di bug e miglioramenti
-
|
|
2.3.6
|
- Correzioni di bug e miglioramenti
-
|
|
2.3.5
|
Versione aggiornata per la versione 2.12.0 di Greengrass nucleus. |
|
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 di Named 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 dell'ombra non era coerente con quella del cloud durante l'aggiornamento del documento shadow locale.
-
Risolve un problema per cui lo shadow manager interrompe l'ascolto degli aggiornamenti di configurazione se una distribuzione esegue un errore 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
|
|
|
2.1.1
|
- Correzioni di bug e miglioramenti
-
-
Risolve un problema per cui la profondità massima nelle reported sezioni desired e nelle sezioni del documento sullo stato ombra del dispositivo JSON era di 4 livelli anziché 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 causava l'eliminazione di versioni appena create di qualsiasi shadow precedentemente eliminata da Shadow Manager.
-
Aggiorna l'operazione DeleteThingShadow IPC per incrementare la versione shadow quando viene chiamata.
|
|
2.0.3
|
Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.
|
|
2.0.2
|
- Correzioni di bug e miglioramenti
-
-
È stato risolto un problema che impediva al gestore di ombra di riconoscere la 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 un'ombra.
|
|
2.0.1
|
Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.
|
|
2.0.0
|
Versione iniziale.
|
