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á.

# Interaja com as sombras do dispositivo
<a name="interact-with-shadows"></a>

Os principais dispositivos do Greengrass podem interagir com as [sombras do dispositivo do AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-device-shadows.html) usando componentes. Uma *sombra* é um documento JSON que armazena as informações de estado atuais ou desejadas de uma coisa do AWS IoT. As sombras podem disponibilizar o estado de um dispositivo para outros AWS IoT Greengrass componentes, independentemente de o dispositivo estar conectado ao AWS IoT ou não. Cada dispositivo do AWS IoT tem sua própria sombra clássica sem nome. Também é possível criar várias sombras nomeadas para cada dispositivo. 

Dispositivos e serviços podem criar, atualizar e excluir sombras de nuvem usando o MQTT e os [tópicos MQTT reservados](https://docs.aws.amazon.com/iot/latest/developerguide/reserved-topics.html#reserved-topics-shadow), o HTTP usando a [API REST Device Shadow](https://docs.aws.amazon.com/iot/latest/developerguide/device-shadow-rest-api.html), e o [AWS CLI para AWS IoT](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/index.html).

O componente de [gerenciamento de sombras](shadow-manager-component.md) permite que seus componentes do Greengrass criem, atualizem e excluam sombras locais usando o [serviço paralelo local e os tópicos paralelos locais](ipc-local-shadows.md) de publicação/assinatura. O gerenciador de sombras também gerencia o armazenamento desses documentos paralelos locais em seu dispositivo principal e gerencia a sincronização das informações do estado da sombra com as sombras da nuvem.

Você também pode usar o componente gerenciador de sombras para gerenciar sombras locais para [dispositivos cliente](interact-with-local-iot-devices.md) que se conectam ao dispositivo principal. Para permitir que o shadow manager gerencie as sombras do dispositivo cliente, você configura o [componente de ponte MQTT](mqtt-bridge-component.md) para retransmitir mensagens entre o agente MQTT local e o serviço local de publicação/assinatura. Para obter mais informações, consulte [Interagir e sincronizar as sombras do dispositivo cliente](work-with-client-device-shadows.md).

Para obter mais informações sobre conceitos de sombra do dispositivo do AWS IoT, consulte [Serviço de sombra do dispositivo do AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-device-shadows.html) no *Guia do desenvolvedor do AWS IoT*.

**Topics**
+ [Interaja com sombras em componentes](interact-with-shadows-in-components.md)
+ [Sincronize sombras do dispositivo local com AWS IoT Core](sync-shadows-with-iot-core.md)