As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Gerenciador de sombras
O componente do gerenciador de sombras (aws.greengrass.ShadowManager) ativa o serviço paralelo local em seu dispositivo principal. O serviço de sombra local permite que os componentes usem a comunicação entre processos para interagir com as sombras locais. O componente shadow manager gerencia o armazenamento de documentos paralelos locais e também gerencia a sincronização dos estados de sombra locais com o serviço AWS IoT Device Shadow.
Para obter mais informações sobre como os dispositivos principais do Greengrass podem interagir com sombras, consulte. Interaja com as sombras do dispositivo
Versões
Esse componente tem as seguintes versões:
Tipo
Este componente é um componente de plug-in (aws.greengrass.plugin). O núcleo do Greengrass executa esse componente na mesma Java Virtual Machine (JVM) do núcleo. O núcleo reinicia quando você altera a versão desse componente no dispositivo principal.
Esse componente usa o mesmo arquivo de log do núcleo do Greengrass. Para ter mais informações, consulte Monitore AWS IoT Greengrass os registros.
Para ter mais informações, consulte Tipos de componentes.
Sistema operacional
Esse componente pode ser instalado em dispositivos principais que executam os seguintes sistemas operacionais:
Requisitos
Esse componente tem os seguintes requisitos:
-
(Opcional) Para sincronizar sombras com o serviço AWS IoT Device Shadow, a política do dispositivo principal AWS IoT do Greengrass deve permitir as AWS IoT Core seguintes ações de política paralela:
-
iot:GetThingShadow
-
iot:UpdateThingShadow
-
iot:DeleteThingShadow
Para obter mais informações sobre essas AWS IoT Core políticas, consulte as ações AWS IoT Core políticas no Guia do AWS IoT desenvolvedor.
Para obter mais informações sobre a AWS IoT política mínima, consulte AWS IoTPolítica mínima para dispositivos AWS IoT Greengrass V2 principais
-
O componente do gerenciador de sombras tem suporte para execução em uma VPC.
Dependências
Quando você implanta um componente, AWS IoT Greengrass também implanta versões compatíveis de suas dependências. Isso significa que você deve atender aos requisitos do componente e de todas as suas dependências para implantá-lo com êxito. Esta seção lista as dependências das versões lançadas desse componente e as restrições de versão semântica que definem as versões dos componentes para cada dependência. Você também pode visualizar as dependências de cada versão do componente no AWS IoT Greengrass console. Na página de detalhes do componente, procure a lista de dependências.
- 2.3.5 – 2.3.8
-
A tabela a seguir lista as dependências das versões 2.3.5 a 2.3.8 desse componente.
| Dependência |
Versões compatíveis |
Tipo de dependência |
| Núcleo Greengrass |
>=2,5.0 <2,13.0 |
Flexível |
- 2.3.3 and 2.3.4
-
A tabela a seguir lista as dependências das versões 2.3.3 e 2.3.4 desse componente.
| Dependência |
Versões compatíveis |
Tipo de dependência |
| Núcleo Greengrass |
>=2,5.0 <2,12.0 |
Flexível |
- 2.3.2
-
A tabela a seguir lista as dependências da versão 2.3.2 desse componente.
| Dependência |
Versões compatíveis |
Tipo de dependência |
| Núcleo Greengrass |
>=2,5.0 <2,11.0 |
Flexível |
- 2.3.0 and 2.3.1
-
A tabela a seguir lista as dependências das versões 2.3.0 e 2.3.1 desse componente.
| Dependência |
Versões compatíveis |
Tipo de dependência |
| Núcleo Greengrass |
>=2.5.0 <2.10.0 |
Flexível |
- 2.2.3 and 2.2.4
-
A tabela a seguir lista as dependências das versões 2.2.3 e 2.2.4 desse componente.
| Dependência |
Versões compatíveis |
Tipo de dependência |
| Núcleo Greengrass |
>=2.2.0 <3.0.0 |
Flexível |
- 2.2.2
-
A tabela a seguir lista as dependências da versão 2.2.2 desse componente.
| Dependência |
Versões compatíveis |
Tipo de dependência |
| Núcleo Greengrass |
>=2.2.0 <2.9.0 |
Flexível |
- 2.2.1
-
A tabela a seguir lista as dependências da versão 2.2.1 desse componente.
| Dependência |
Versões compatíveis |
Tipo de dependência |
| Núcleo Greengrass |
>=2.2.0 <2.8.0 |
Flexível |
- 2.1.1 and 2.2.0
-
A tabela a seguir lista as dependências das versões 2.1.1 e 2.2.0 desse componente.
| Dependência |
Versões compatíveis |
Tipo de dependência |
| Núcleo Greengrass |
>=2.2.0 <2.7.0 |
Flexível |
- 2.0.5 - 2.1.0
-
A tabela a seguir lista as dependências das versões 2.0.5 a 2.1.0 desse componente.
| Dependência |
Versões compatíveis |
Tipo de dependência |
| Núcleo Greengrass |
>=2.2.0 <2.6.0 |
Flexível |
- 2.0.3 and 2.0.4
-
A tabela a seguir lista as dependências das versões 2.0.3 e 2.0.4 desse componente.
| Dependência |
Versões compatíveis |
Tipo de dependência |
| Núcleo Greengrass |
>=2.2.0 <2.5.0 |
Flexível |
- 2.0.1 and 2.0.2
-
A tabela a seguir lista as dependências das versões 2.0.1 e 2.0.2 desse componente.
| Dependência |
Versões compatíveis |
Tipo de dependência |
| Núcleo Greengrass |
>=2.2.0 <2.4.0 |
Flexível |
- 2.0.0
-
A tabela a seguir lista as dependências da versão 2.0.0 desse componente.
| Dependência |
Versões compatíveis |
Tipo de dependência |
| Núcleo Greengrass |
>=2.2.0 <2.3.0 |
Flexível |
Para obter mais informações sobre dependências de componentes, consulte a referência da receita do componente.
Configuração
Esse componente fornece os seguintes parâmetros de configuração que você pode personalizar ao implantar o componente.
- 2.3.x
-
strategy-
(Opcional) A estratégia que esse componente usa para sincronizar sombras entre AWS IoT Core e o dispositivo principal.
Esse objeto contém as seguintes informações.
type-
(Opcional) O tipo de estratégia que esse componente usa para sincronizar sombras entre AWS IoT Core e o dispositivo principal. Escolha uma das seguintes opções:
-
realTime— Sincronize sombras AWS IoT Core sempre que ocorrer uma atualização de sombras.
-
periodic— Sincronize sombras AWS IoT Core em um intervalo regular que você especifica com o parâmetro delay de configuração.
Padrão: realTime
delay-
(Opcional) O intervalo em segundos com AWS IoT Core o qual esse componente sincroniza sombras quando você especifica a estratégia de periodic sincronização.
Esse parâmetro é necessário se você especificar a estratégia de periodic sincronização.
synchronize-
(Opcional) As configurações de sincronização que determinam como as sombras são sincronizadas com o. Nuvem AWS
Você deve criar uma atualização de configuração com essa propriedade para sincronizar sombras com o. Nuvem AWS
Esse objeto contém as seguintes informações.
coreThing-
(Opcional) O dispositivo principal faz sombras para sincronizar. Esse objeto contém as seguintes informações.
classic-
(Opcional) Por padrão, o gerenciador de sombras sincroniza o estado local da sombra clássica do seu dispositivo principal com o. Nuvem AWS Se você não quiser sincronizar a sombra clássica do dispositivo, defina-a comofalse.
Padrão: true
namedShadows-
(Opcional) A lista de sombras nomeadas do dispositivo principal a serem sincronizadas. Você deve especificar os nomes exatos das sombras.
O AWS IoT Greengrass serviço usa a sombra AWSManagedGreengrassV2Deployment nomeada para gerenciar implantações direcionadas a dispositivos principais individuais. Essa sombra nomeada é reservada para uso pelo AWS IoT Greengrass serviço. Não atualize nem exclua essa sombra nomeada.
shadowDocumentsMap-
(Opcional) As sombras adicionais do dispositivo a serem sincronizadas. O uso desse parâmetro de configuração facilita a especificação de documentos de sombra. Recomendamos que você use esse parâmetro em vez do shadowDocuments objeto.
Se você especificar um shadowDocumentsMap objeto, não deverá especificar um shadowDocuments objeto.
Cada objeto contém as seguintes informações:
thingName-
A configuração de sombra do ThingName para essa configuração de sombra.
classic-
(Opcional) Se você não quiser sincronizar a sombra clássica do dispositivo com o thingName dispositivo, defina-a comofalse.
namedShadows-
A lista de sombras nomeadas que você deseja sincronizar. Você deve especificar os nomes exatos das sombras.
shadowDocuments-
(Opcional) A lista de sombras adicionais do dispositivo a serem sincronizadas. Recomendamos que você use o shadowDocumentsMap parâmetro em vez disso.
Se você especificar um shadowDocuments objeto, não deverá especificar um shadowDocumentsMap objeto.
Cada objeto nessa lista contém as seguintes informações.
thingName-
O nome do dispositivo para o qual sincronizar sombras.
classic-
(Opcional) Se você não quiser sincronizar a sombra clássica do dispositivo com o thingName dispositivo, defina-a comofalse.
Padrão: true
namedShadows-
(Opcional) A lista de sombras de dispositivos nomeados que você deseja sincronizar. Você deve especificar os nomes exatos das sombras.
direction-
(Opcional) A direção para sincronizar sombras entre o serviço de sombra local e o. Nuvem AWS Você pode configurar essa opção para reduzir a largura de banda e as conexões com o. Nuvem AWS Escolha uma das seguintes opções:
-
betweenDeviceAndCloud— Sincronize sombras entre o serviço de sombra local e o. Nuvem AWS
-
deviceToCloud— Envie atualizações paralelas do serviço paralelo local para o. Nuvem AWS e ignore as atualizações paralelas do Nuvem AWS.
-
cloudToDevice— Receba atualizações Nuvem AWS paralelas do e não envie atualizações paralelas do serviço paralelo local para Nuvem AWS o.
Padrão: BETWEEN_DEVICE_AND_CLOUD
rateLimits-
(Opcional) As configurações que determinam os limites de taxa para solicitações de serviço paralelo.
Esse objeto contém as seguintes informações.
maxOutboundSyncUpdatesPerSecond-
(Opcional) O número máximo de solicitações de sincronização por segundo que o dispositivo transmite.
Padrão: 100 solicitações/segundo
maxTotalLocalRequestsRate-
(Opcional) O número máximo de solicitações IPC locais por segundo enviadas ao dispositivo principal.
Padrão: 200 solicitações/segundo
maxLocalRequestsPerSecondPerThing-
(Opcional) O número máximo de solicitações locais de IPC por segundo enviadas para cada dispositivo de IoT conectado.
Padrão: 20 solicitações/segundo para cada item
Esses parâmetros de limite de taxa definem o número máximo de solicitações por segundo para o serviço paralelo local. O número máximo de solicitações por segundo para o serviço AWS IoT Device Shadow depende do seu Região da AWS. Para obter mais informações, consulte os limites da API AWS IoT Device Shadow Service no Referência geral da Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Opcional) O tamanho máximo permitido de cada documento de estado JSON para sombras locais.
Se você aumentar esse valor, também deverá aumentar o limite de recursos do documento de estado JSON para sombras na nuvem. Para obter mais informações, consulte os limites da API AWS IoT
Device Shadow Service no Referência geral da Amazon Web Services.
Padrão: 8192 bytes
Máximo: 30720 bytes
exemplo Exemplo: atualização da mesclagem de configurações
O exemplo a seguir mostra um exemplo de atualização de mesclagem de configurações com todos os parâmetros de configuração disponíveis para o 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-
(Opcional) A estratégia que esse componente usa para sincronizar sombras entre AWS IoT Core e o dispositivo principal.
Esse objeto contém as seguintes informações.
type-
(Opcional) O tipo de estratégia que esse componente usa para sincronizar sombras entre AWS IoT Core e o dispositivo principal. Escolha uma das seguintes opções:
-
realTime— Sincronize sombras AWS IoT Core sempre que ocorrer uma atualização de sombras.
-
periodic— Sincronize sombras AWS IoT Core em um intervalo regular que você especifica com o parâmetro delay de configuração.
Padrão: realTime
delay-
(Opcional) O intervalo em segundos com AWS IoT Core o qual esse componente sincroniza sombras quando você especifica a estratégia de periodic sincronização.
Esse parâmetro é necessário se você especificar a estratégia de periodic sincronização.
synchronize-
(Opcional) As configurações de sincronização que determinam como as sombras são sincronizadas com o. Nuvem AWS
Você deve criar uma atualização de configuração com essa propriedade para sincronizar sombras com o. Nuvem AWS
Esse objeto contém as seguintes informações.
coreThing-
(Opcional) O dispositivo principal faz sombras para sincronizar. Esse objeto contém as seguintes informações.
classic-
(Opcional) Por padrão, o gerenciador de sombras sincroniza o estado local da sombra clássica do seu dispositivo principal com o. Nuvem AWS Se você não quiser sincronizar a sombra clássica do dispositivo, defina-a comofalse.
Padrão: true
namedShadows-
(Opcional) A lista de sombras nomeadas do dispositivo principal a serem sincronizadas. Você deve especificar os nomes exatos das sombras.
O AWS IoT Greengrass serviço usa a sombra AWSManagedGreengrassV2Deployment nomeada para gerenciar implantações direcionadas a dispositivos principais individuais. Essa sombra nomeada é reservada para uso pelo AWS IoT Greengrass serviço. Não atualize nem exclua essa sombra nomeada.
shadowDocumentsMap-
(Opcional) As sombras adicionais do dispositivo a serem sincronizadas. O uso desse parâmetro de configuração facilita a especificação de documentos de sombra. Recomendamos que você use esse parâmetro em vez do shadowDocuments objeto.
Se você especificar um shadowDocumentsMap objeto, não deverá especificar um shadowDocuments objeto.
Cada objeto contém as seguintes informações:
thingName-
A configuração de sombra do ThingName para essa configuração de sombra.
classic-
(Opcional) Se você não quiser sincronizar a sombra clássica do dispositivo com o thingName dispositivo, defina-a comofalse.
namedShadows-
A lista de sombras nomeadas que você deseja sincronizar. Você deve especificar os nomes exatos das sombras.
shadowDocuments-
(Opcional) A lista de sombras adicionais do dispositivo a serem sincronizadas. Recomendamos que você use o shadowDocumentsMap parâmetro em vez disso.
Se você especificar um shadowDocuments objeto, não deverá especificar um shadowDocumentsMap objeto.
Cada objeto nessa lista contém as seguintes informações.
thingName-
O nome do dispositivo para o qual sincronizar sombras.
classic-
(Opcional) Se você não quiser sincronizar a sombra clássica do dispositivo com o thingName dispositivo, defina-a comofalse.
Padrão: true
namedShadows-
(Opcional) A lista de sombras de dispositivos nomeados que você deseja sincronizar. Você deve especificar os nomes exatos das sombras.
direction-
(Opcional) A direção para sincronizar sombras entre o serviço de sombra local e o. Nuvem AWS Você pode configurar essa opção para reduzir a largura de banda e as conexões com o. Nuvem AWS Escolha uma das seguintes opções:
-
betweenDeviceAndCloud— Sincronize sombras entre o serviço de sombra local e o. Nuvem AWS
-
deviceToCloud— Envie atualizações paralelas do serviço paralelo local para o. Nuvem AWS e ignore as atualizações paralelas do Nuvem AWS.
-
cloudToDevice— Receba atualizações Nuvem AWS paralelas do e não envie atualizações paralelas do serviço paralelo local para Nuvem AWS o.
Padrão: BETWEEN_DEVICE_AND_CLOUD
rateLimits-
(Opcional) As configurações que determinam os limites de taxa para solicitações de serviço paralelo.
Esse objeto contém as seguintes informações.
maxOutboundSyncUpdatesPerSecond-
(Opcional) O número máximo de solicitações de sincronização por segundo que o dispositivo transmite.
Padrão: 100 solicitações/segundo
maxTotalLocalRequestsRate-
(Opcional) O número máximo de solicitações IPC locais por segundo enviadas ao dispositivo principal.
Padrão: 200 solicitações/segundo
maxLocalRequestsPerSecondPerThing-
(Opcional) O número máximo de solicitações locais de IPC por segundo enviadas para cada dispositivo de IoT conectado.
Padrão: 20 solicitações/segundo para cada item
Esses parâmetros de limite de taxa definem o número máximo de solicitações por segundo para o serviço paralelo local. O número máximo de solicitações por segundo para o serviço AWS IoT Device Shadow depende do seu Região da AWS. Para obter mais informações, consulte os limites da API AWS IoT Device Shadow Service no Referência geral da Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Opcional) O tamanho máximo permitido de cada documento de estado JSON para sombras locais.
Se você aumentar esse valor, também deverá aumentar o limite de recursos do documento de estado JSON para sombras na nuvem. Para obter mais informações, consulte os limites da API AWS IoT
Device Shadow Service no Referência geral da Amazon Web Services.
Padrão: 8192 bytes
Máximo: 30720 bytes
exemplo Exemplo: atualização da mesclagem de configurações
O exemplo a seguir mostra um exemplo de atualização de mesclagem de configurações com todos os parâmetros de configuração disponíveis para o 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-
(Opcional) A estratégia que esse componente usa para sincronizar sombras entre AWS IoT Core e o dispositivo principal.
Esse objeto contém as seguintes informações.
type-
(Opcional) O tipo de estratégia que esse componente usa para sincronizar sombras entre AWS IoT Core e o dispositivo principal. Escolha uma das seguintes opções:
-
realTime— Sincronize sombras AWS IoT Core sempre que ocorrer uma atualização de sombras.
-
periodic— Sincronize sombras AWS IoT Core em um intervalo regular que você especifica com o parâmetro delay de configuração.
Padrão: realTime
delay-
(Opcional) O intervalo em segundos com AWS IoT Core o qual esse componente sincroniza sombras quando você especifica a estratégia de periodic sincronização.
Esse parâmetro é necessário se você especificar a estratégia de periodic sincronização.
synchronize-
(Opcional) As configurações de sincronização que determinam como as sombras são sincronizadas com o. Nuvem AWS
Você deve criar uma atualização de configuração com essa propriedade para sincronizar sombras com o. Nuvem AWS
Esse objeto contém as seguintes informações.
coreThing-
(Opcional) O dispositivo principal faz sombras para sincronizar. Esse objeto contém as seguintes informações.
classic-
(Opcional) Por padrão, o gerenciador de sombras sincroniza o estado local da sombra clássica do seu dispositivo principal com o. Nuvem AWS Se você não quiser sincronizar a sombra clássica do dispositivo, defina-a comofalse.
Padrão: true
namedShadows-
(Opcional) A lista de sombras nomeadas do dispositivo principal a serem sincronizadas. Você deve especificar os nomes exatos das sombras.
O AWS IoT Greengrass serviço usa a sombra AWSManagedGreengrassV2Deployment nomeada para gerenciar implantações direcionadas a dispositivos principais individuais. Essa sombra nomeada é reservada para uso pelo AWS IoT Greengrass serviço. Não atualize nem exclua essa sombra nomeada.
shadowDocumentsMap-
(Opcional) As sombras adicionais do dispositivo a serem sincronizadas. O uso desse parâmetro de configuração facilita a especificação de documentos de sombra. Recomendamos que você use esse parâmetro em vez do shadowDocuments objeto.
Se você especificar um shadowDocumentsMap objeto, não deverá especificar um shadowDocuments objeto.
Cada objeto contém as seguintes informações:
thingName-
A configuração de sombra do ThingName para essa configuração de sombra.
classic-
(Opcional) Se você não quiser sincronizar a sombra clássica do dispositivo com o thingName dispositivo, defina-a comofalse.
namedShadows-
A lista de sombras nomeadas que você deseja sincronizar. Você deve especificar os nomes exatos das sombras.
shadowDocuments-
(Opcional) A lista de sombras adicionais do dispositivo a serem sincronizadas. Recomendamos que você use o shadowDocumentsMap parâmetro em vez disso.
Se você especificar um shadowDocuments objeto, não deverá especificar um shadowDocumentsMap objeto.
Cada objeto nessa lista contém as seguintes informações.
thingName-
O nome do dispositivo para o qual sincronizar sombras.
classic-
(Opcional) Se você não quiser sincronizar a sombra clássica do dispositivo com o thingName dispositivo, defina-a comofalse.
Padrão: true
namedShadows-
(Opcional) A lista de sombras de dispositivos nomeados que você deseja sincronizar. Você deve especificar os nomes exatos das sombras.
rateLimits-
(Opcional) As configurações que determinam os limites de taxa para solicitações de serviço paralelo.
Esse objeto contém as seguintes informações.
maxOutboundSyncUpdatesPerSecond-
(Opcional) O número máximo de solicitações de sincronização por segundo que o dispositivo transmite.
Padrão: 100 solicitações/segundo
maxTotalLocalRequestsRate-
(Opcional) O número máximo de solicitações IPC locais por segundo enviadas ao dispositivo principal.
Padrão: 200 solicitações/segundo
maxLocalRequestsPerSecondPerThing-
(Opcional) O número máximo de solicitações locais de IPC por segundo enviadas para cada dispositivo de IoT conectado.
Padrão: 20 solicitações/segundo para cada item
Esses parâmetros de limite de taxa definem o número máximo de solicitações por segundo para o serviço paralelo local. O número máximo de solicitações por segundo para o serviço AWS IoT Device Shadow depende do seu Região da AWS. Para obter mais informações, consulte os limites da API AWS IoT Device Shadow Service no Referência geral da Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Opcional) O tamanho máximo permitido de cada documento de estado JSON para sombras locais.
Se você aumentar esse valor, também deverá aumentar o limite de recursos do documento de estado JSON para sombras na nuvem. Para obter mais informações, consulte os limites da API AWS IoT
Device Shadow Service no Referência geral da Amazon Web Services.
Padrão: 8192 bytes
Máximo: 30720 bytes
exemplo Exemplo: atualização da mesclagem de configurações
O exemplo a seguir mostra um exemplo de atualização de mesclagem de configurações com todos os parâmetros de configuração disponíveis para o 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-
(Opcional) As configurações de sincronização que determinam como as sombras são sincronizadas com o. Nuvem AWS
Você deve criar uma atualização de configuração com essa propriedade para sincronizar sombras com o. Nuvem AWS
Esse objeto contém as seguintes informações.
coreThing-
(Opcional) O dispositivo principal faz sombras para sincronizar. Esse objeto contém as seguintes informações.
classic-
(Opcional) Por padrão, o gerenciador de sombras sincroniza o estado local da sombra clássica do seu dispositivo principal com o. Nuvem AWS Se você não quiser sincronizar a sombra clássica do dispositivo, defina-a comofalse.
Padrão: true
namedShadows-
(Opcional) A lista de sombras nomeadas do dispositivo principal a serem sincronizadas. Você deve especificar os nomes exatos das sombras.
O AWS IoT Greengrass serviço usa a sombra AWSManagedGreengrassV2Deployment nomeada para gerenciar implantações direcionadas a dispositivos principais individuais. Essa sombra nomeada é reservada para uso pelo AWS IoT Greengrass serviço. Não atualize nem exclua essa sombra nomeada.
shadowDocumentsMap-
(Opcional) As sombras adicionais do dispositivo a serem sincronizadas. O uso desse parâmetro de configuração facilita a especificação de documentos de sombra. Recomendamos que você use esse parâmetro em vez do shadowDocuments objeto.
Se você especificar um shadowDocumentsMap objeto, não deverá especificar um shadowDocuments objeto.
Cada objeto contém as seguintes informações:
thingName-
A configuração de sombra do ThingName para essa configuração de sombra.
classic-
(Opcional) Se você não quiser sincronizar a sombra clássica do dispositivo com o thingName dispositivo, defina-a comofalse.
namedShadows-
A lista de sombras nomeadas que você deseja sincronizar. Você deve especificar os nomes exatos das sombras.
shadowDocuments-
(Opcional) A lista de sombras adicionais do dispositivo a serem sincronizadas. Recomendamos que você use o shadowDocumentsMap parâmetro em vez disso.
Se você especificar um shadowDocuments objeto, não deverá especificar um shadowDocumentsMap objeto.
Cada objeto nessa lista contém as seguintes informações.
thingName-
O nome do dispositivo para o qual sincronizar sombras.
classic-
(Opcional) Se você não quiser sincronizar a sombra clássica do dispositivo com o thingName dispositivo, defina-a comofalse.
Padrão: true
namedShadows-
(Opcional) A lista de sombras de dispositivos nomeados que você deseja sincronizar. Você deve especificar os nomes exatos das sombras.
rateLimits-
(Opcional) As configurações que determinam os limites de taxa para solicitações de serviço paralelo.
Esse objeto contém as seguintes informações.
maxOutboundSyncUpdatesPerSecond-
(Opcional) O número máximo de solicitações de sincronização por segundo que o dispositivo transmite.
Padrão: 100 solicitações/segundo
maxTotalLocalRequestsRate-
(Opcional) O número máximo de solicitações IPC locais por segundo enviadas ao dispositivo principal.
Padrão: 200 solicitações/segundo
maxLocalRequestsPerSecondPerThing-
(Opcional) O número máximo de solicitações locais de IPC por segundo enviadas para cada dispositivo de IoT conectado.
Padrão: 20 solicitações/segundo para cada item
Esses parâmetros de limite de taxa definem o número máximo de solicitações por segundo para o serviço paralelo local. O número máximo de solicitações por segundo para o serviço AWS IoT Device Shadow depende do seu Região da AWS. Para obter mais informações, consulte os limites da API AWS IoT Device Shadow Service no Referência geral da Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Opcional) O tamanho máximo permitido de cada documento de estado JSON para sombras locais.
Se você aumentar esse valor, também deverá aumentar o limite de recursos do documento de estado JSON para sombras na nuvem. Para obter mais informações, consulte os limites da API AWS IoT
Device Shadow Service no Referência geral da Amazon Web Services.
Padrão: 8192 bytes
Máximo: 30720 bytes
exemplo Exemplo: atualização da mesclagem de configurações
O exemplo a seguir mostra um exemplo de atualização de mesclagem de configurações com todos os parâmetros de configuração disponíveis para o 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
}
Arquivo de log local
Esse componente usa o mesmo arquivo de log do componente do núcleo do Greengrass.
- Linux
-
/greengrass/v2
- Windows
-
C:\greengrass\v2\logs\greengrass.log
Para ver os registros desse componente
Changelog
A tabela a seguir descreve as alterações em cada versão do componente.
|
Version (Versão)
|
Alterações
|
|
2.3.8
|
- Correções de erros e melhorias
-
|
|
2.3.7
|
- Correções de erros e melhorias
-
|
|
2.3.6
|
- Correções de erros e melhorias
-
|
|
2.3.5
|
Versão atualizada para a versão 2.12.0 do Greengrass nucleus. |
|
2.3.4
|
- Correções de erros e melhorias
-
|
|
2.3.3
|
Versão atualizada para a versão 2.11.0 do Greengrass nucleus. |
|
2.3.2
|
- Correções de erros e melhorias
-
|
|
2.3.1
|
- Correções de erros e melhorias
-
-
Corrige uma condição que pode impedir a sincronização das atualizações do Cloud Shadow.
-
Corrige um problema em que as alterações na configuração de sincronização de sombra nomeada se aplicam somente a uma sombra nomeada.
|
|
2.3.0
|
- Correções de erros e melhorias
-
|
|
2.2.4
|
- Correções de erros e melhorias
-
-
Corrige um problema em que a validação do tamanho da sombra não era consistente com a nuvem ao atualizar o documento de sombra local.
-
Corrige um problema em que o gerenciador paralelo para de ouvir as atualizações de configuração se uma implantação executa uma RESET nos nós de configuração.
|
|
2.2.3
|
Versão atualizada para a versão 2.9.0 do Greengrass nucleus. |
|
2.2.2
|
Versão atualizada para a versão 2.8.0 do Greengrass nucleus. |
|
2.2.1
|
Versão atualizada para a versão 2.7.0 do Greengrass nucleus.
|
|
2.2.0
|
- Novos atributos
-
-
Adiciona suporte para o serviço paralelo local na interface local de publicação/assinatura. Agora você pode se comunicar com o agente de mensagens local de publicação/assinatura sobre tópicos paralelos do MQTT para obter, atualizar e excluir sombras no dispositivo principal. Esse recurso permite conectar dispositivos cliente ao serviço paralelo local usando a ponte MQTT para retransmitir mensagens sobre tópicos paralelos entre dispositivos cliente e a interface local de publicação/assinatura.
Esse recurso requer a versão v2.6.0 ou posterior do componente do núcleo do Greengrass. Para conectar dispositivos cliente ao serviço paralelo local, você também deve usar a versão 2.2.0 ou posterior do componente de ponte MQTT.
-
Adiciona a direction opção que você pode configurar para personalizar a direção para sincronizar sombras entre o serviço de sombra local e o. Nuvem AWS Você pode configurar essa opção para reduzir a largura de banda e as conexões com o. Nuvem AWS
|
|
2.1.1
|
- Correções de erros e melhorias
-
-
Corrige um problema em que a profundidade máxima nas reported seções desired e no documento de estado de sombra do dispositivo JSON era de 4 níveis em vez de 5 níveis.
-
Versão atualizada para a versão 2.6.0 do Greengrass nucleus.
|
|
2.1.0
|
|
|
2.0.6
|
Esta versão contém correções de erros e melhorias.
|
|
2.0.5
|
Versão atualizada para a versão 2.5.0 do Greengrass nucleus.
|
|
2.0.4
|
- Correções de erros e melhorias
-
-
Corrige um problema que fazia com que o gerenciador de sombras excluísse versões recém-criadas de qualquer sombra que tenha sido excluída anteriormente.
-
Atualiza a operação DeleteThingShadow IPC para incrementar a versão de sombra quando chamada.
|
|
2.0.3
|
Versão atualizada para a versão 2.4.0 do Greengrass nucleus.
|
|
2.0.2
|
- Correções de erros e melhorias
-
-
Corrigido um problema que fazia com que o gerenciador de sombras não reconhecesse a delta propriedade ao sincronizar estados de sombra de AWS IoT Core.
-
Corrigido um problema que às vezes fazia com que as solicitações de sincronização de uma sombra fossem mescladas incorretamente.
|
|
2.0.1
|
Versão atualizada para a versão 2.3.0 do Greengrass nucleus.
|
|
2.0.0
|
Versão inicial.
|
