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 Gerenciador de sombras (aws.greengrass.ShadowManager) habilita o serviço de sombra local no 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 as 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 é reiniciado 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 obter mais informações, consulte Monitore AWS IoT Greengrass logs.
Para obter mais informações, consulte Tipos de componente.
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 Política mínima de AWS IoT para dispositivos principais do AWS IoT Greengrass V2
-
O componente do gerenciador de sombras tem suporte para ser executado em umVPC.
Dependências
Quando você implanta um componente, AWS IoT Greengrass também implanta versões compatíveis de suas dependências. Isso significa que é preciso atender aos requisitos do componente e de todas as dependências dele para implantá-lo com êxito. Nesta seção, há uma lista de todas 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. Também é possível visualizar as dependências de cada versão do componente no console do AWS IoT Greengrass. Na página de detalhes do componente, procure a lista de dependências.
- 2.3.10
-
A tabela a seguir lista as dependências da versão 2.3.10 desse componente.
- 2.3.9
-
A tabela a seguir lista as dependências da versão 2.3.9 desse componente.
- 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.
- 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.
- 2.3.2
-
A tabela a seguir lista as dependências da versão 2.3.2 desse componente.
- 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.
- 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.
- 2.2.2
-
A tabela a seguir lista as dependências da versão 2.2.2 deste componente.
- 2.2.1
-
A tabela a seguir lista as dependências da versão 2.2.1 deste componente.
- 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.
- 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.
- 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.
- 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.
- 2.0.0
-
A tabela a seguir lista as dependências da versão 2.0.0 deste componente.
Para obter mais informações sobre as dependências dos componentes, consulte referência de fórmula do componente.
Configuração
Esse componente fornece os seguintes parâmetros de configuração que podem ser personalizados 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 informações a seguir.
type-
(Opcional) O tipo de estratégia que esse componente usa para sincronizar as sombras entre o 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 no qual esse componente sincroniza as sombras com o AWS IoT Core quando você especifica a estratégia de sincronização periodic.
Esse parâmetro será obrigatório se você especificar a estratégia de sincronização periodic.
synchronize-
(Opcional) As configurações de sincronização que determinam como as sombras são sincronizadas com a Nuvem AWS.
Você deve criar uma atualização de configuração com essa propriedade para sincronizar as sombras com a Nuvem AWS.
Esse objeto contém as informações abaixo.
coreThing-
(Opcional) A sombra do dispositivo principal para sincronização. Esse objeto contém as informações a seguir.
classic-
(Opcional) Por padrão, o Gerenciador de sombras sincroniza o estado local da sombra clássica do seu dispositivo núcleo com a Nuvem AWS. Se você não deseja sincronizar a sombra clássica do dispositivo, defina essa propriedade como false.
Padrão: true
namedShadows-
(Opcional) A lista de sombras nomeadas do dispositivo principal para sincronização. 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 a atualize nem exclua.
shadowDocumentsMap-
(Opcional) As sombras adicionais do dispositivo para sincronização. O uso desse parâmetro de configuração facilita a especificação de documentos de sombra. Recomendamos o uso deste parâmetro, em vez do objeto shadowDocuments.
Se você especificar um objeto shadowDocumentsMap, não deverá especificar o shadowDocuments.
Cada objeto contém as seguintes informações:
thingName-
A configuração de sombra thingName para esta configuração de sombra.
classic-
(Opcional) Se você não deseja sincronizar a sombra clássica do dispositivo thingName, defina essa propriedade como false.
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 para sincronização. Em vez disso, recomendamos o uso do parâmetro shadowDocumentsMap.
Se você especificar um objeto shadowDocuments, não deverá especificar o shadowDocumentsMap.
Cada objeto na lista contém as informações abaixo.
thingName-
O nome do item do dispositivo com o qual sincronizar as sombras.
classic-
(Opcional) Se você não deseja sincronizar a sombra clássica do dispositivo thingName, defina essa propriedade como false.
Padrão: true
namedShadows-
(Opcional) A lista de sombras nomeadas do dispositivo que você deseja sincronizar. Você deve especificar os nomes exatos das sombras.
direction-
(Opcional) A direção de sincronização das sombras entre o serviço de sombra local e a Nuvem AWS. Você pode configurar essa opção para reduzir a largura de banda e as conexões com a Nuvem AWS. Escolha uma das seguintes opções:
-
betweenDeviceAndCloud: sincronizar as sombras entre o serviço de sombra local e a 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: receber as atualizações de sombras da Nuvem AWS e não enviar as atualizações de sombras do serviço de sombra local para a Nuvem AWS.
Padrão: BETWEEN_DEVICE_AND_CLOUD
rateLimits-
(Opcional) As configurações que determinam os limites de taxa para solicitações de serviço de sombra.
Esse objeto contém as informações abaixo.
maxOutboundSyncUpdatesPerSecond-
(Opcional) O número máximo de solicitações de sincronização por segundo que o dispositivo transmite.
Padrão: 100 solicitações por segundo
maxTotalLocalRequestsRate-
(Opcional) O número máximo de IPC solicitações locais por segundo enviadas ao dispositivo principal.
Padrão: 200 solicitações por segundo
maxLocalRequestsPerSecondPerThing-
(Opcional) O número máximo de IPC solicitações locais por segundo enviadas para cada dispositivo de IoT conectado.
Padrão: 20 solicitações por 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 de sombra 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 do AWS IoT Device Shadow Service API no Referência geral da Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Opcional) O tamanho máximo permitido de cada documento JSON estadual para sombras locais.
Se você aumentar esse valor, também deverá aumentar o limite de recursos do documento de JSON estado para sombras na nuvem. Para obter mais informações, consulte os limites do AWS IoT
Device Shadow Service API no Referência geral da Amazon Web Services.
Padrão: 8192 bytes
Máximo: 30720 bytes
exemplo Exemplo: atualização da mesclagem de configuração
Veja a seguir exemplo de atualização da mesclagem de configuração com todos os parâmetros de configuração disponíveis para o componente Gerenciador de sombras.
{
"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 informações a seguir.
type-
(Opcional) O tipo de estratégia que esse componente usa para sincronizar as sombras entre o 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 no qual esse componente sincroniza as sombras com o AWS IoT Core quando você especifica a estratégia de sincronização periodic.
Esse parâmetro será obrigatório se você especificar a estratégia de sincronização periodic.
synchronize-
(Opcional) As configurações de sincronização que determinam como as sombras são sincronizadas com a Nuvem AWS.
Você deve criar uma atualização de configuração com essa propriedade para sincronizar as sombras com a Nuvem AWS.
Esse objeto contém as informações abaixo.
coreThing-
(Opcional) A sombra do dispositivo principal para sincronização. Esse objeto contém as informações a seguir.
classic-
(Opcional) Por padrão, o Gerenciador de sombras sincroniza o estado local da sombra clássica do seu dispositivo núcleo com a Nuvem AWS. Se você não deseja sincronizar a sombra clássica do dispositivo, defina essa propriedade como false.
Padrão: true
namedShadows-
(Opcional) A lista de sombras nomeadas do dispositivo principal para sincronização. 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 a atualize nem exclua.
shadowDocumentsMap-
(Opcional) As sombras adicionais do dispositivo para sincronização. O uso desse parâmetro de configuração facilita a especificação de documentos de sombra. Recomendamos o uso deste parâmetro, em vez do objeto shadowDocuments.
Se você especificar um objeto shadowDocumentsMap, não deverá especificar o shadowDocuments.
Cada objeto contém as seguintes informações:
thingName-
A configuração de sombra thingName para esta configuração de sombra.
classic-
(Opcional) Se você não deseja sincronizar a sombra clássica do dispositivo thingName, defina essa propriedade como false.
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 para sincronização. Em vez disso, recomendamos o uso do parâmetro shadowDocumentsMap.
Se você especificar um objeto shadowDocuments, não deverá especificar o shadowDocumentsMap.
Cada objeto na lista contém as informações abaixo.
thingName-
O nome do item do dispositivo com o qual sincronizar as sombras.
classic-
(Opcional) Se você não deseja sincronizar a sombra clássica do dispositivo thingName, defina essa propriedade como false.
Padrão: true
namedShadows-
(Opcional) A lista de sombras nomeadas do dispositivo que você deseja sincronizar. Você deve especificar os nomes exatos das sombras.
direction-
(Opcional) A direção de sincronização das sombras entre o serviço de sombra local e a Nuvem AWS. Você pode configurar essa opção para reduzir a largura de banda e as conexões com a Nuvem AWS. Escolha uma das seguintes opções:
-
betweenDeviceAndCloud: sincronizar as sombras entre o serviço de sombra local e a 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: receber as atualizações de sombras da Nuvem AWS e não enviar as atualizações de sombras do serviço de sombra local para a Nuvem AWS.
Padrão: BETWEEN_DEVICE_AND_CLOUD
rateLimits-
(Opcional) As configurações que determinam os limites de taxa para solicitações de serviço de sombra.
Esse objeto contém as informações abaixo.
maxOutboundSyncUpdatesPerSecond-
(Opcional) O número máximo de solicitações de sincronização por segundo que o dispositivo transmite.
Padrão: 100 solicitações por segundo
maxTotalLocalRequestsRate-
(Opcional) O número máximo de IPC solicitações locais por segundo enviadas ao dispositivo principal.
Padrão: 200 solicitações por segundo
maxLocalRequestsPerSecondPerThing-
(Opcional) O número máximo de IPC solicitações locais por segundo enviadas para cada dispositivo de IoT conectado.
Padrão: 20 solicitações por 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 de sombra 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 do AWS IoT Device Shadow Service API no Referência geral da Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Opcional) O tamanho máximo permitido de cada documento JSON estadual para sombras locais.
Se você aumentar esse valor, também deverá aumentar o limite de recursos do documento de JSON estado para sombras na nuvem. Para obter mais informações, consulte os limites do AWS IoT
Device Shadow Service API no Referência geral da Amazon Web Services.
Padrão: 8192 bytes
Máximo: 30720 bytes
exemplo Exemplo: atualização da mesclagem de configuração
Veja a seguir exemplo de atualização da mesclagem de configuração com todos os parâmetros de configuração disponíveis para o componente Gerenciador de sombras.
{
"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 informações a seguir.
type-
(Opcional) O tipo de estratégia que esse componente usa para sincronizar as sombras entre o 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 no qual esse componente sincroniza as sombras com o AWS IoT Core quando você especifica a estratégia de sincronização periodic.
Esse parâmetro será obrigatório se você especificar a estratégia de sincronização periodic.
synchronize-
(Opcional) As configurações de sincronização que determinam como as sombras são sincronizadas com a Nuvem AWS.
Você deve criar uma atualização de configuração com essa propriedade para sincronizar as sombras com a Nuvem AWS.
Esse objeto contém as informações abaixo.
coreThing-
(Opcional) A sombra do dispositivo principal para sincronização. Esse objeto contém as informações a seguir.
classic-
(Opcional) Por padrão, o Gerenciador de sombras sincroniza o estado local da sombra clássica do seu dispositivo núcleo com a Nuvem AWS. Se você não deseja sincronizar a sombra clássica do dispositivo, defina essa propriedade como false.
Padrão: true
namedShadows-
(Opcional) A lista de sombras nomeadas do dispositivo principal para sincronização. 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 a atualize nem exclua.
shadowDocumentsMap-
(Opcional) As sombras adicionais do dispositivo para sincronização. O uso desse parâmetro de configuração facilita a especificação de documentos de sombra. Recomendamos o uso deste parâmetro, em vez do objeto shadowDocuments.
Se você especificar um objeto shadowDocumentsMap, não deverá especificar o shadowDocuments.
Cada objeto contém as seguintes informações:
thingName-
A configuração de sombra thingName para esta configuração de sombra.
classic-
(Opcional) Se você não deseja sincronizar a sombra clássica do dispositivo thingName, defina essa propriedade como false.
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 para sincronização. Em vez disso, recomendamos o uso do parâmetro shadowDocumentsMap.
Se você especificar um objeto shadowDocuments, não deverá especificar o shadowDocumentsMap.
Cada objeto na lista contém as informações abaixo.
thingName-
O nome do item do dispositivo com o qual sincronizar as sombras.
classic-
(Opcional) Se você não deseja sincronizar a sombra clássica do dispositivo thingName, defina essa propriedade como false.
Padrão: true
namedShadows-
(Opcional) A lista de sombras nomeadas do dispositivo 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 de sombra.
Esse objeto contém as informações abaixo.
maxOutboundSyncUpdatesPerSecond-
(Opcional) O número máximo de solicitações de sincronização por segundo que o dispositivo transmite.
Padrão: 100 solicitações por segundo
maxTotalLocalRequestsRate-
(Opcional) O número máximo de IPC solicitações locais por segundo enviadas ao dispositivo principal.
Padrão: 200 solicitações por segundo
maxLocalRequestsPerSecondPerThing-
(Opcional) O número máximo de IPC solicitações locais por segundo enviadas para cada dispositivo de IoT conectado.
Padrão: 20 solicitações por 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 de sombra 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 do AWS IoT Device Shadow Service API no Referência geral da Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Opcional) O tamanho máximo permitido de cada documento JSON estadual para sombras locais.
Se você aumentar esse valor, também deverá aumentar o limite de recursos do documento de JSON estado para sombras na nuvem. Para obter mais informações, consulte os limites do AWS IoT
Device Shadow Service API no Referência geral da Amazon Web Services.
Padrão: 8192 bytes
Máximo: 30720 bytes
exemplo Exemplo: atualização da mesclagem de configuração
Veja a seguir exemplo de atualização da mesclagem de configuração com todos os parâmetros de configuração disponíveis para o componente Gerenciador de sombras.
{
"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 a Nuvem AWS.
Você deve criar uma atualização de configuração com essa propriedade para sincronizar as sombras com a Nuvem AWS.
Esse objeto contém as informações abaixo.
coreThing-
(Opcional) A sombra do dispositivo principal para sincronização. Esse objeto contém as informações a seguir.
classic-
(Opcional) Por padrão, o Gerenciador de sombras sincroniza o estado local da sombra clássica do seu dispositivo núcleo com a Nuvem AWS. Se você não deseja sincronizar a sombra clássica do dispositivo, defina essa propriedade como false.
Padrão: true
namedShadows-
(Opcional) A lista de sombras nomeadas do dispositivo principal para sincronização. 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 a atualize nem exclua.
shadowDocumentsMap-
(Opcional) As sombras adicionais do dispositivo para sincronização. O uso desse parâmetro de configuração facilita a especificação de documentos de sombra. Recomendamos o uso deste parâmetro, em vez do objeto shadowDocuments.
Se você especificar um objeto shadowDocumentsMap, não deverá especificar o shadowDocuments.
Cada objeto contém as seguintes informações:
thingName-
A configuração de sombra thingName para esta configuração de sombra.
classic-
(Opcional) Se você não deseja sincronizar a sombra clássica do dispositivo thingName, defina essa propriedade como false.
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 para sincronização. Em vez disso, recomendamos o uso do parâmetro shadowDocumentsMap.
Se você especificar um objeto shadowDocuments, não deverá especificar o shadowDocumentsMap.
Cada objeto na lista contém as informações abaixo.
thingName-
O nome do item do dispositivo com o qual sincronizar as sombras.
classic-
(Opcional) Se você não deseja sincronizar a sombra clássica do dispositivo thingName, defina essa propriedade como false.
Padrão: true
namedShadows-
(Opcional) A lista de sombras nomeadas do dispositivo 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 de sombra.
Esse objeto contém as informações abaixo.
maxOutboundSyncUpdatesPerSecond-
(Opcional) O número máximo de solicitações de sincronização por segundo que o dispositivo transmite.
Padrão: 100 solicitações por segundo
maxTotalLocalRequestsRate-
(Opcional) O número máximo de IPC solicitações locais por segundo enviadas ao dispositivo principal.
Padrão: 200 solicitações por segundo
maxLocalRequestsPerSecondPerThing-
(Opcional) O número máximo de IPC solicitações locais por segundo enviadas para cada dispositivo de IoT conectado.
Padrão: 20 solicitações por 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 de sombra 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 do AWS IoT Device Shadow Service API no Referência geral da Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Opcional) O tamanho máximo permitido de cada documento JSON estadual para sombras locais.
Se você aumentar esse valor, também deverá aumentar o limite de recursos do documento de JSON estado para sombras na nuvem. Para obter mais informações, consulte os limites do AWS IoT
Device Shadow Service API no Referência geral da Amazon Web Services.
Padrão: 8192 bytes
Máximo: 30720 bytes
exemplo Exemplo: atualização da mesclagem de configuração
Veja a seguir exemplo de atualização da mesclagem de configuração com todos os parâmetros de configuração disponíveis para o componente Gerenciador de sombras.
{
"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 de núcleo do Greengrass.
- Linux
-
/greengrass/v2
- Windows
-
C:\greengrass\v2\logs\greengrass.log
Para exibir os logs desse componente
Changelog
A tabela a seguir descreve as alterações em cada versão do componente.
|
Versão
|
Alterações
|
|
2.3.10
|
Versão atualizada para a versão 2.14.0 do Greengrass nucleus. |
|
2.3.9
|
Versão atualizada para o núcleo do Greengrass 2.13.0. |
|
2.3.8
|
- Correções de bugs e melhorias
-
|
|
2.3.7
|
- Correções de bugs e melhorias
-
|
|
2.3.6
|
- Correções de bugs e melhorias
-
|
|
2.3.5
|
Versão atualizada para o núcleo do Greengrass 2.12.0. |
|
2.3.4
|
- Correções de bugs e melhorias
-
|
|
2.3.3
|
Versão atualizada para o núcleo do Greengrass 2.11.0. |
|
2.3.2
|
- Correções de bugs e melhorias
-
|
|
2.3.1
|
- Correções de bugs e melhorias
-
-
Corrige uma condição que pode impedir a sincronização das atualizações das sombras na nuvem.
-
Corrige um problema em que as alterações na configuração de sincronização de sombras nomeadas se aplicavam somente a uma sombra.
|
|
2.3.0
|
- Correções de bugs e melhorias
-
|
|
2.2.4
|
- Correções de bugs 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 de sombras para de ouvir as atualizações de configuração se uma implantação executa RESET nos nós de configuração.
|
|
2.2.3
|
Versão atualizada para o núcleo do Greengrass 2.9.0. |
|
2.2.2
|
Versão atualizada para o núcleo do Greengrass 2.8.0. |
|
2.2.1
|
Versão atualizada para o lançamento da versão 2.7.0 do núcleo do Greengrass.
|
|
2.2.0
|
- Novos recursos
-
-
Adiciona suporte ao serviço paralelo local sobre o agente de publish/subscribe interface. You can now communicate with the local
publish/subscribe mensagens local em MQTTtópicos paralelos para obter, atualizar e excluir sombras no dispositivo principal. Esse recurso permite conectar dispositivos cliente ao serviço paralelo local usando a MQTT ponte para retransmitir mensagens sobre tópicos paralelos entre dispositivos cliente e a interface local de publicação/assinatura.
Esse atributo está disponível para a versão 2.6.0 e posterior do componente de 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 MQTTbridge.
-
Adiciona a opção direction que você pode configurar para personalizar a direção para sincronizar sombras entre o serviço de sombra local e a Nuvem AWS. Você pode configurar essa opção para reduzir a largura de banda e as conexões com a Nuvem AWS.
|
|
2.1.1
|
- Correções de bugs e melhorias
-
-
Corrige um problema em que a profundidade máxima nas reported seções desired e nas seções do documento de estado de sombra do JSON dispositivo era de 4 níveis em vez de 5 níveis.
-
Versão atualizada para o núcleo do Greengrass 2.6.0.
|
|
2.1.0
|
|
|
2.0.6
|
Essa versão contém correções de bugs e melhorias.
|
|
2.0.5
|
Versão atualizada para o núcleo do Greengrass 2.5.0.
|
|
2.0.4
|
- Correções de bugs e melhorias
-
-
Corrige um problema que fazia com que o Gerenciador de sombras excluísse versões recém-criadas de qualquer sombra que já tivesse sido excluída.
-
Atualiza a DeleteThingShadow IPC operação para incrementar a versão de sombra quando chamada.
|
|
2.0.3
|
Versão atualizada para o lançamento da versão 2.4.0 do núcleo do Greengrass.
|
|
2.0.2
|
- Correções de bugs e melhorias
-
-
Problema corrigido que fazia com que o Gerenciador de sombras não reconhecesse a propriedade delta ao sincronizar os estados das sombras do AWS IoT Core.
-
Problema corrigido 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 o lançamento da versão 2.3.0 do núcleo do Greengrass.
|
|
2.0.0
|
Versão inicial.
|
