Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Administrador de sombras
<a name="shadow-manager-component"></a>

El componente administrador de sombras (`aws.greengrass.ShadowManager`) habilita el servicio de sombra local en su dispositivo principal. El servicio de sombra local permite a los componentes utilizar la comunicación entre procesos para [interactuar con las sombras locales](ipc-local-shadows.md). El componente de administrador de sombras gestiona el almacenamiento de los documentos ocultos locales y también gestiona la sincronización de los estados ocultos locales con el servicio AWS IoT Device Shadow.

Para obtener más información sobre cómo los dispositivos principales de Greengrass pueden interactuar con las sombras, consulte [Interacción con las sombras de dispositivo](interact-with-shadows.md).

**Topics**
+ [Versiones](#shadow-manager-component-versions)
+ [Tipo](#shadow-manager-component-type)
+ [Sistema operativo](#shadow-manager-component-os-support)
+ [Requisitos](#shadow-manager-component-requirements)
+ [Dependencias](#shadow-manager-component-dependencies)
+ [Configuración](#shadow-manager-component-configuration)
+ [Archivo de registro local](#shadow-manager-component-log-file)
+ [Registros de cambios](#shadow-manager-component-changelog)

## Versiones
<a name="shadow-manager-component-versions"></a>

Este componente tiene las siguientes versiones:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Tipo
<a name="shadow-manager-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Este componente es un componente de complemento (`aws.greengrass.plugin`). El [núcleo de Greengrass](greengrass-nucleus-component.md) ejecuta este componente en la misma máquina virtual Java (JVM) que el núcleo. El núcleo se reinicia al cambiar la versión de este componente en el dispositivo principal.

<a name="public-component-type-plugin-para2"></a>Este componente usa el mismo archivo de registro que el núcleo de Greengrass. Para obtener más información, consulte [Supervisión de los registros de AWS IoT Greengrass](monitor-logs.md).

<a name="public-component-type-more-information"></a>Para obtener más información, consulte [Tipos de componentes](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="shadow-manager-component-os-support"></a>

Este componente se puede instalar en los dispositivos principales que ejecutan los siguientes sistemas operativos:
+ Linux
+ Windows

## Requisitos
<a name="shadow-manager-component-requirements"></a>

Este componente tiene los siguientes requisitos:
+ (Opcional) Para sincronizar las sombras con el servicio AWS IoT Device Shadow, la AWS IoT política del dispositivo principal de Greengrass debe permitir las siguientes acciones de política AWS IoT Core clandestina:
  + `iot:GetThingShadow`
  + `iot:UpdateThingShadow`
  + `iot:DeleteThingShadow`

  Para obtener más información sobre estas AWS IoT Core políticas, consulte las [acciones AWS IoT Core políticas](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policy-actions.html) en la *Guía para AWS IoT desarrolladores*.

  Para obtener más información sobre la AWS IoT política mínima, consulte [AWS IoT Política mínima para los dispositivos AWS IoT Greengrass V2 principales](device-auth.md#greengrass-core-minimal-iot-policy)
+ Se admite la ejecución del componente administrador de sombras en una VPC.

## Dependencias
<a name="shadow-manager-component-dependencies"></a>

Al implementar un componente, AWS IoT Greengrass también despliega versiones compatibles de sus dependencias. Esto significa que debe cumplir los requisitos del componente y de todas sus dependencias para poder implementar el componente correctamente. En esta sección, se enumeran las dependencias de las [versiones publicadas](#shadow-manager-component-changelog) de este componente y las restricciones de las versiones semánticas que definen las versiones de los componentes para cada dependencia. También puede ver las dependencias de cada versión del componente en la [consola de AWS IoT Greengrass](https://console.aws.amazon.com//greengrass). En la página de detalles del componente, busque la lista de **Dependencias**.

------
#### [ 2.3.13 ]

En la siguiente tabla se enumeran las dependencias de la versión 2.3.13 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.17.0 | Flexible | 

------
#### [ 2.3.12 ]

La siguiente tabla muestra las dependencias de la versión 2.3.12 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.17.0 | Flexible | 

------
#### [ 2.3.11 ]

La siguiente tabla muestra las dependencias de la versión 2.3.11 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.16.0 | Flexible | 

------
#### [ 2.3.10 ]

La siguiente tabla muestra las dependencias de la versión 2.3.10 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.15.0 | Flexible | 

------
#### [ 2.3.9 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.3.9 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.14.0 | Flexible | 

------
#### [ 2.3.5 – 2.3.8 ]

En la siguiente tabla, se muestran las dependencias de las versiones 2.3.5 a 2.3.8 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.13.0 | Flexible | 

------
#### [ 2.3.3 and 2.3.4 ]

En la siguiente tabla, se muestran las dependencias de las versiones 2.3.3 y 2.3.4 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.12.0 | Flexible | 

------
#### [ 2.3.2 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.3.2 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.11.0 | Flexible | 

------
#### [ 2.3.0 and 2.3.1 ]

En la siguiente tabla, se muestran las dependencias de las versiones 2.3.0 y 2.3.1 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.10.0 | Flexible | 

------
#### [ 2.2.3 and 2.2.4 ]

En la siguiente tabla, se muestran las dependencias de las versiones 2.2.3 y 2.2.4 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <3.0.0 | Flexible | 

------
#### [ 2.2.2 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.2.2 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.9.0 | Flexible | 

------
#### [ 2.2.1 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.2.1 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.8.0 | Flexible | 

------
#### [ 2.1.1 and 2.2.0 ]

En la siguiente tabla, se muestran las dependencias de las versiones 2.1.1 y 2.2.0 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.7.0 | Flexible | 

------
#### [ 2.0.5 - 2.1.0 ]

En la siguiente tabla, se muestran las dependencias de las versiones 2.0.5 a 2.1.0 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.6.0 | Flexible | 

------
#### [ 2.0.3 and 2.0.4 ]

En la siguiente tabla, se muestran las dependencias de las versiones 2.0.3 y 2.0.4 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.5.0 | Flexible | 

------
#### [ 2.0.1 and 2.0.2 ]

En la siguiente tabla, se muestran las dependencias de las versiones 2.0.1 y 2.0.2 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.4.0 | Flexible | 

------
#### [ 2.0.0 ]

En la siguiente tabla, se muestran las dependencias de la versión 2.0.0 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.2.0 <2.3.0 | Flexible | 

------

Para obtener más información sobre las dependencias del componente, consulte la [referencia de receta de componentes](component-recipe-reference.md#recipe-reference-component-dependencies).

## Configuración
<a name="shadow-manager-component-configuration"></a>

Este componente ofrece los siguientes parámetros de configuración que puede personalizar cuando implemente el componente.

------
#### [ 2.3.x ]

`strategy`  <a name="shadow-manager-component-configuration-strategy"></a>
(Opcional) La estrategia que utiliza este componente para sincronizar las sombras entre y el dispositivo principal. AWS IoT Core   
Este objeto contiene la siguiente información:    
`type`  
(Opcional) El tipo de estrategia que utiliza este componente para sincronizar las sombras entre AWS IoT Core y el dispositivo principal. Puede elegir entre las siguientes opciones:  
+ `realTime`— Sincronice las sombras AWS IoT Core cada vez que se produzca una actualización de sombras.
+ `periodic`— Sincronice las sombras AWS IoT Core en un intervalo regular que especifique con el parámetro `delay` de configuración.
Valor predeterminado: `realTime`  
`delay`  
(Opcional) El intervalo en segundos en el que este componente sincroniza las sombras con AWS IoT Core, al especificar la estrategia de sincronización `periodic`.  
Este parámetro es necesario si no se especifica estrategia de sincronización `periodic`.

`synchronize`  <a name="shadow-manager-component-configuration-synchronize"></a>
<a name="shadow-manager-component-configuration-strategy-description"></a>(Opcional) Los ajustes de sincronización que determinan cómo se sincronizan las sombras con la Nube de AWS.   
Debe crear una actualización de configuración con esta propiedad para sincronizar las sombras con la Nube de AWS.
Este objeto contiene la siguiente información:    
`coreThing`  <a name="shadow-manager-component-configuration-synchronize-core-thing"></a>
(Opcional) Las sombras de dispositivo principal se van a sincronizar. Este objeto contiene la siguiente información:    
`classic`  
(Opcional) De forma predeterminada, el administrador de sombras sincroniza el estado local de la sombra clásica de su dispositivo principal con la Nube de AWS. Si no desea sincronizar la sombra de dispositivo clásica, configúrela en `false`.  
Valor predeterminado: `true`  
`namedShadows`  
(Opcional) La lista de sombras de dispositivo principales con nombre que se van a sincronizar. Debe especificar los nombres exactos de las sombras.  
El AWS IoT Greengrass servicio usa la sombra `AWSManagedGreengrassV2Deployment` denominada para administrar las implementaciones que se dirigen a dispositivos principales individuales. Esta sombra denominada está reservada para que la utilice el AWS IoT Greengrass servicio. No actualice ni elimine esta sombra con nombre.  
`shadowDocumentsMap`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents-map"></a>
(Opcional) Las sombras de dispositivo adicionales que se van a sincronizar. El uso de este parámetro de configuración facilita la especificación de documentos de sombras. Le recomendamos que utilice este parámetro en lugar del objeto `shadowDocuments`.  
Si especifica un objeto `shadowDocumentsMap`, no debe especificar `shadowDocuments`.
Cada objeto contiene la siguiente información:    
*`thingName`*  
La configuración de sombra *thingName* para esta configuración de sombra.    
`classic`  
(Opcional) Si no desea sincronizar la sombra de dispositivo clásico con el dispositivo `thingName`, configúrela en `false`.  
`namedShadows`  
La lista de sombras con nombre que desea sincronizar. Debe especificar los nombres exactos de las sombras.  
`shadowDocuments`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents"></a>
(Opcional) La lista de sombras de dispositivo adicionales que se van a sincronizar. Le recomendamos que utilice el parámetro `shadowDocumentsMap` en su lugar.  
Si especifica un objeto `shadowDocuments`, no debe especificar `shadowDocumentsMap`.
Cada objeto en la lista contiene la siguiente información.     
`thingName`  
Nombre del objeto del dispositivo para el que se sincronizan las sombras.   
`classic`  
(Opcional) Si no desea sincronizar la sombra de dispositivo clásico con el dispositivo `thingName`, configúrela en `false`.  
Valor predeterminado: `true`  
`namedShadows`  
(Opcional) La lista de sombras de dispositivo con nombre que desea sincronizar. Debe especificar los nombres exactos de las sombras.  
`direction`  
(Opcional) La dirección para sincronizar las sombras entre el servicio de sombra local y la Nube de AWS. Puede configurar esta opción para reducir el ancho de banda y las conexiones a la Nube de AWS. Puede elegir entre las siguientes opciones:  
+ `betweenDeviceAndCloud`: sincronice las sombras entre el servicio de sombra local y la Nube de AWS.
+ `deviceToCloud`— Envía actualizaciones ocultas desde el servicio paralelo local al Nube de AWS e ignora las actualizaciones ocultas del Nube de AWS.
+ `cloudToDevice`: recibe actualizaciones de sombras de la Nube de AWS y no envía actualizaciones de sombras del servicio de sombras local a la Nube de AWS.
Valor predeterminado: `BETWEEN_DEVICE_AND_CLOUD`

`rateLimits`  <a name="shadow-manager-component-configuration-rate-limits"></a>
(Opcional) La configuración que determina los límites de tasa para las solicitudes de servicios de sombra.  
Este objeto contiene la siguiente información:    
`maxOutboundSyncUpdatesPerSecond`  
(Opcional) El número máximo de solicitudes de sincronización por segundo que transmite el dispositivo.   
Valor predeterminado: 100 solicitudes por segundo  
`maxTotalLocalRequestsRate`  
(Opcional) El número máximo de solicitudes de IPC locales por segundo que se envían al dispositivo principal.   
Valor predeterminado: 200 solicitudes por segundo  
`maxLocalRequestsPerSecondPerThing`  
(Opcional) La cantidad máxima de solicitudes de IPC locales por segundo que se envían para cada objeto IoT conectado.   
Predeterminado: 20 requests/second para cada cosa
Estos parámetros de límites de tasa definen el número máximo de solicitudes por segundo para el servicio de sombra local. El número máximo de solicitudes por segundo para el servicio AWS IoT Device Shadow depende de usted Región de AWS. Para obtener más información, consulte los límites de la [API del servicio de sombra de dispositivo AWS IoT](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) en la *Referencia general de Amazon Web Services*.

`shadowDocumentSizeLimitBytes`  <a name="shadow-manager-component-configuration-shadow-document-size-limit-bytes"></a>
(Opcional) El tamaño máximo permitido de cada documento de estado JSON para las sombras locales.   
Si aumenta este valor debe incrementar también el límite de recursos del documento de estado JSON para sombras en la nube. Para obtener más información, consulte los límites de la [API del servicio de sombra de dispositivo AWS IoT](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) en la *Referencia general de Amazon Web Services*.  
Valor predeterminado: 8192 bytes  
Valor máximo: 30 720 bytes

**Example Ejemplo: actualización de la combinación de configuraciones**  
En el siguiente ejemplo, se muestra un ejemplo de actualización de la combinación de configuraciones con todos los parámetros de configuración disponibles para el componente administrador 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`  <a name="shadow-manager-component-configuration-strategy"></a>
(Opcional) La estrategia que utiliza este componente para sincronizar las sombras entre el dispositivo principal AWS IoT Core y el dispositivo principal.  
Este objeto contiene la siguiente información:    
`type`  
(Opcional) El tipo de estrategia que utiliza este componente para sincronizar las sombras entre AWS IoT Core y el dispositivo principal. Puede elegir entre las siguientes opciones:  
+ `realTime`— Sincronice las sombras AWS IoT Core cada vez que se produzca una actualización de sombras.
+ `periodic`— Sincronice las sombras AWS IoT Core en un intervalo regular que especifique con el parámetro `delay` de configuración.
Valor predeterminado: `realTime`  
`delay`  
(Opcional) El intervalo en segundos en el que este componente sincroniza las sombras con AWS IoT Core, al especificar la estrategia de sincronización `periodic`.  
Este parámetro es necesario si no se especifica estrategia de sincronización `periodic`.

`synchronize`  <a name="shadow-manager-component-configuration-synchronize"></a>
<a name="shadow-manager-component-configuration-strategy-description"></a>(Opcional) Los ajustes de sincronización que determinan cómo se sincronizan las sombras con la Nube de AWS.   
Debe crear una actualización de configuración con esta propiedad para sincronizar las sombras con la Nube de AWS.
Este objeto contiene la siguiente información:    
`coreThing`  <a name="shadow-manager-component-configuration-synchronize-core-thing"></a>
(Opcional) Las sombras de dispositivo principal se van a sincronizar. Este objeto contiene la siguiente información:    
`classic`  
(Opcional) De forma predeterminada, el administrador de sombras sincroniza el estado local de la sombra clásica de su dispositivo principal con la Nube de AWS. Si no desea sincronizar la sombra de dispositivo clásica, configúrela en `false`.  
Valor predeterminado: `true`  
`namedShadows`  
(Opcional) La lista de sombras de dispositivo principales con nombre que se van a sincronizar. Debe especificar los nombres exactos de las sombras.  
El AWS IoT Greengrass servicio usa la sombra `AWSManagedGreengrassV2Deployment` denominada para administrar las implementaciones que se dirigen a dispositivos principales individuales. Esta sombra denominada está reservada para que la utilice el AWS IoT Greengrass servicio. No actualice ni elimine esta sombra con nombre.  
`shadowDocumentsMap`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents-map"></a>
(Opcional) Las sombras de dispositivo adicionales que se van a sincronizar. El uso de este parámetro de configuración facilita la especificación de documentos de sombras. Le recomendamos que utilice este parámetro en lugar del objeto `shadowDocuments`.  
Si especifica un objeto `shadowDocumentsMap`, no debe especificar `shadowDocuments`.
Cada objeto contiene la siguiente información:    
*`thingName`*  
La configuración de sombra *thingName* para esta configuración de sombra.    
`classic`  
(Opcional) Si no desea sincronizar la sombra de dispositivo clásico con el dispositivo `thingName`, configúrela en `false`.  
`namedShadows`  
La lista de sombras con nombre que desea sincronizar. Debe especificar los nombres exactos de las sombras.  
`shadowDocuments`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents"></a>
(Opcional) La lista de sombras de dispositivo adicionales que se van a sincronizar. Le recomendamos que utilice el parámetro `shadowDocumentsMap` en su lugar.  
Si especifica un objeto `shadowDocuments`, no debe especificar `shadowDocumentsMap`.
Cada objeto en la lista contiene la siguiente información.     
`thingName`  
Nombre del objeto del dispositivo para el que se sincronizan las sombras.   
`classic`  
(Opcional) Si no desea sincronizar la sombra de dispositivo clásico con el dispositivo `thingName`, configúrela en `false`.  
Valor predeterminado: `true`  
`namedShadows`  
(Opcional) La lista de sombras de dispositivo con nombre que desea sincronizar. Debe especificar los nombres exactos de las sombras.  
`direction`  
(Opcional) La dirección para sincronizar las sombras entre el servicio de sombra local y la Nube de AWS. Puede configurar esta opción para reducir el ancho de banda y las conexiones a la Nube de AWS. Puede elegir entre las siguientes opciones:  
+ `betweenDeviceAndCloud`: sincronice las sombras entre el servicio de sombra local y la Nube de AWS.
+ `deviceToCloud`— Envía actualizaciones ocultas desde el servicio paralelo local al Nube de AWS e ignora las actualizaciones ocultas del Nube de AWS.
+ `cloudToDevice`: recibe actualizaciones de sombras de la Nube de AWS y no envía actualizaciones de sombras del servicio de sombras local a la Nube de AWS.
Valor predeterminado: `BETWEEN_DEVICE_AND_CLOUD`

`rateLimits`  <a name="shadow-manager-component-configuration-rate-limits"></a>
(Opcional) La configuración que determina los límites de tasa para las solicitudes de servicios de sombra.  
Este objeto contiene la siguiente información:    
`maxOutboundSyncUpdatesPerSecond`  
(Opcional) El número máximo de solicitudes de sincronización por segundo que transmite el dispositivo.   
Valor predeterminado: 100 solicitudes por segundo  
`maxTotalLocalRequestsRate`  
(Opcional) El número máximo de solicitudes de IPC locales por segundo que se envían al dispositivo principal.   
Valor predeterminado: 200 solicitudes por segundo  
`maxLocalRequestsPerSecondPerThing`  
(Opcional) La cantidad máxima de solicitudes de IPC locales por segundo que se envían para cada objeto IoT conectado.   
Predeterminado: 20 requests/second para cada cosa
Estos parámetros de límites de tasa definen el número máximo de solicitudes por segundo para el servicio de sombra local. El número máximo de solicitudes por segundo para el servicio AWS IoT Device Shadow depende de usted Región de AWS. Para obtener más información, consulte los límites de la [API del servicio de sombra de dispositivo AWS IoT](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) en la *Referencia general de Amazon Web Services*.

`shadowDocumentSizeLimitBytes`  <a name="shadow-manager-component-configuration-shadow-document-size-limit-bytes"></a>
(Opcional) El tamaño máximo permitido de cada documento de estado JSON para las sombras locales.   
Si aumenta este valor debe incrementar también el límite de recursos del documento de estado JSON para sombras en la nube. Para obtener más información, consulte los límites de la [API del servicio de sombra de dispositivo AWS IoT](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) en la *Referencia general de Amazon Web Services*.  
Valor predeterminado: 8192 bytes  
Valor máximo: 30 720 bytes

**Example Ejemplo: actualización de la combinación de configuraciones**  
En el siguiente ejemplo, se muestra un ejemplo de actualización de la combinación de configuraciones con todos los parámetros de configuración disponibles para el componente administrador 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`  <a name="shadow-manager-component-configuration-strategy"></a>
(Opcional) La estrategia que utiliza este componente para sincronizar las sombras entre el dispositivo principal AWS IoT Core y el dispositivo principal.  
Este objeto contiene la siguiente información:    
`type`  
(Opcional) El tipo de estrategia que utiliza este componente para sincronizar las sombras entre AWS IoT Core y el dispositivo principal. Puede elegir entre las siguientes opciones:  
+ `realTime`— Sincronice las sombras AWS IoT Core cada vez que se produzca una actualización de sombras.
+ `periodic`— Sincronice las sombras AWS IoT Core en un intervalo regular que especifique con el parámetro `delay` de configuración.
Valor predeterminado: `realTime`  
`delay`  
(Opcional) El intervalo en segundos en el que este componente sincroniza las sombras con AWS IoT Core, al especificar la estrategia de sincronización `periodic`.  
Este parámetro es necesario si no se especifica estrategia de sincronización `periodic`.

`synchronize`  <a name="shadow-manager-component-configuration-synchronize"></a>
<a name="shadow-manager-component-configuration-strategy-description"></a>(Opcional) Los ajustes de sincronización que determinan cómo se sincronizan las sombras con la Nube de AWS.   
Debe crear una actualización de configuración con esta propiedad para sincronizar las sombras con la Nube de AWS.
Este objeto contiene la siguiente información:    
`coreThing`  <a name="shadow-manager-component-configuration-synchronize-core-thing"></a>
(Opcional) Las sombras de dispositivo principal se van a sincronizar. Este objeto contiene la siguiente información:    
`classic`  
(Opcional) De forma predeterminada, el administrador de sombras sincroniza el estado local de la sombra clásica de su dispositivo principal con la Nube de AWS. Si no desea sincronizar la sombra de dispositivo clásica, configúrela en `false`.  
Valor predeterminado: `true`  
`namedShadows`  
(Opcional) La lista de sombras de dispositivo principales con nombre que se van a sincronizar. Debe especificar los nombres exactos de las sombras.  
El AWS IoT Greengrass servicio usa la sombra `AWSManagedGreengrassV2Deployment` denominada para administrar las implementaciones que se dirigen a dispositivos principales individuales. Esta sombra denominada está reservada para que la utilice el AWS IoT Greengrass servicio. No actualice ni elimine esta sombra con nombre.  
`shadowDocumentsMap`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents-map"></a>
(Opcional) Las sombras de dispositivo adicionales que se van a sincronizar. El uso de este parámetro de configuración facilita la especificación de documentos de sombras. Le recomendamos que utilice este parámetro en lugar del objeto `shadowDocuments`.  
Si especifica un objeto `shadowDocumentsMap`, no debe especificar `shadowDocuments`.
Cada objeto contiene la siguiente información:    
*`thingName`*  
La configuración de sombra *thingName* para esta configuración de sombra.    
`classic`  
(Opcional) Si no desea sincronizar la sombra de dispositivo clásico con el dispositivo `thingName`, configúrela en `false`.  
`namedShadows`  
La lista de sombras con nombre que desea sincronizar. Debe especificar los nombres exactos de las sombras.  
`shadowDocuments`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents"></a>
(Opcional) La lista de sombras de dispositivo adicionales que se van a sincronizar. Le recomendamos que utilice el parámetro `shadowDocumentsMap` en su lugar.  
Si especifica un objeto `shadowDocuments`, no debe especificar `shadowDocumentsMap`.
Cada objeto en la lista contiene la siguiente información.     
`thingName`  
Nombre del objeto del dispositivo para el que se sincronizan las sombras.   
`classic`  
(Opcional) Si no desea sincronizar la sombra de dispositivo clásico con el dispositivo `thingName`, configúrela en `false`.  
Valor predeterminado: `true`  
`namedShadows`  
(Opcional) La lista de sombras de dispositivo con nombre que desea sincronizar. Debe especificar los nombres exactos de las sombras.

`rateLimits`  <a name="shadow-manager-component-configuration-rate-limits"></a>
(Opcional) La configuración que determina los límites de tasa para las solicitudes de servicios de sombra.  
Este objeto contiene la siguiente información:    
`maxOutboundSyncUpdatesPerSecond`  
(Opcional) El número máximo de solicitudes de sincronización por segundo que transmite el dispositivo.   
Valor predeterminado: 100 solicitudes por segundo  
`maxTotalLocalRequestsRate`  
(Opcional) El número máximo de solicitudes de IPC locales por segundo que se envían al dispositivo principal.   
Valor predeterminado: 200 solicitudes por segundo  
`maxLocalRequestsPerSecondPerThing`  
(Opcional) La cantidad máxima de solicitudes de IPC locales por segundo que se envían para cada objeto IoT conectado.   
Predeterminado: 20 requests/second para cada cosa
Estos parámetros de límites de tasa definen el número máximo de solicitudes por segundo para el servicio de sombra local. El número máximo de solicitudes por segundo para el servicio AWS IoT Device Shadow depende de usted Región de AWS. Para obtener más información, consulte los límites de la [API del servicio de sombra de dispositivo AWS IoT](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) en la *Referencia general de Amazon Web Services*.

`shadowDocumentSizeLimitBytes`  <a name="shadow-manager-component-configuration-shadow-document-size-limit-bytes"></a>
(Opcional) El tamaño máximo permitido de cada documento de estado JSON para las sombras locales.   
Si aumenta este valor debe incrementar también el límite de recursos del documento de estado JSON para sombras en la nube. Para obtener más información, consulte los límites de la [API del servicio de sombra de dispositivo AWS IoT](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) en la *Referencia general de Amazon Web Services*.  
Valor predeterminado: 8192 bytes  
Valor máximo: 30 720 bytes

**Example Ejemplo: actualización de la combinación de configuraciones**  
En el siguiente ejemplo, se muestra un ejemplo de actualización de la combinación de configuraciones con todos los parámetros de configuración disponibles para el componente administrador 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`  <a name="shadow-manager-component-configuration-synchronize"></a>
<a name="shadow-manager-component-configuration-strategy-description"></a>(Opcional) Los ajustes de sincronización que determinan cómo se sincronizan las sombras con la Nube de AWS.   
Debe crear una actualización de configuración con esta propiedad para sincronizar las sombras con la Nube de AWS.
Este objeto contiene la siguiente información:    
`coreThing`  <a name="shadow-manager-component-configuration-synchronize-core-thing"></a>
(Opcional) Las sombras de dispositivo principal se van a sincronizar. Este objeto contiene la siguiente información:    
`classic`  
(Opcional) De forma predeterminada, el administrador de sombras sincroniza el estado local de la sombra clásica de su dispositivo principal con la Nube de AWS. Si no desea sincronizar la sombra de dispositivo clásica, configúrela en `false`.  
Valor predeterminado: `true`  
`namedShadows`  
(Opcional) La lista de sombras de dispositivo principales con nombre que se van a sincronizar. Debe especificar los nombres exactos de las sombras.  
El AWS IoT Greengrass servicio usa el `AWSManagedGreengrassV2Deployment` nombre shadow para administrar las implementaciones que se dirigen a dispositivos principales individuales. Esta sombra denominada está reservada para que la utilice el AWS IoT Greengrass servicio. No actualice ni elimine esta sombra con nombre.  
`shadowDocumentsMap`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents-map"></a>
(Opcional) Las sombras de dispositivo adicionales que se van a sincronizar. El uso de este parámetro de configuración facilita la especificación de documentos de sombras. Le recomendamos que utilice este parámetro en lugar del objeto `shadowDocuments`.  
Si especifica un objeto `shadowDocumentsMap`, no debe especificar `shadowDocuments`.
Cada objeto contiene la siguiente información:    
*`thingName`*  
La configuración de sombra *thingName* para esta configuración de sombra.    
`classic`  
(Opcional) Si no desea sincronizar la sombra de dispositivo clásico con el dispositivo `thingName`, configúrela en `false`.  
`namedShadows`  
La lista de sombras con nombre que desea sincronizar. Debe especificar los nombres exactos de las sombras.  
`shadowDocuments`  <a name="shadow-manager-component-configuration-synchronize-shadow-documents"></a>
(Opcional) La lista de sombras de dispositivo adicionales que se van a sincronizar. Le recomendamos que utilice el parámetro `shadowDocumentsMap` en su lugar.  
Si especifica un objeto `shadowDocuments`, no debe especificar `shadowDocumentsMap`.
Cada objeto en la lista contiene la siguiente información.     
`thingName`  
Nombre del objeto del dispositivo para el que se sincronizan las sombras.   
`classic`  
(Opcional) Si no desea sincronizar la sombra de dispositivo clásico con el dispositivo `thingName`, configúrela en `false`.  
Valor predeterminado: `true`  
`namedShadows`  
(Opcional) La lista de sombras de dispositivo con nombre que desea sincronizar. Debe especificar los nombres exactos de las sombras.

`rateLimits`  <a name="shadow-manager-component-configuration-rate-limits"></a>
(Opcional) La configuración que determina los límites de tasa para las solicitudes de servicios de sombra.  
Este objeto contiene la siguiente información:    
`maxOutboundSyncUpdatesPerSecond`  
(Opcional) El número máximo de solicitudes de sincronización por segundo que transmite el dispositivo.   
Valor predeterminado: 100 solicitudes por segundo  
`maxTotalLocalRequestsRate`  
(Opcional) El número máximo de solicitudes de IPC locales por segundo que se envían al dispositivo principal.   
Valor predeterminado: 200 solicitudes por segundo  
`maxLocalRequestsPerSecondPerThing`  
(Opcional) La cantidad máxima de solicitudes de IPC locales por segundo que se envían para cada objeto IoT conectado.   
Predeterminado: 20 requests/second para cada cosa
Estos parámetros de límites de tasa definen el número máximo de solicitudes por segundo para el servicio de sombra local. El número máximo de solicitudes por segundo para el servicio AWS IoT Device Shadow depende de usted Región de AWS. Para obtener más información, consulte los límites de la [API del servicio de sombra de dispositivo AWS IoT](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) en la *Referencia general de Amazon Web Services*.

`shadowDocumentSizeLimitBytes`  <a name="shadow-manager-component-configuration-shadow-document-size-limit-bytes"></a>
(Opcional) El tamaño máximo permitido de cada documento de estado JSON para las sombras locales.   
Si aumenta este valor debe incrementar también el límite de recursos del documento de estado JSON para sombras en la nube. Para obtener más información, consulte los límites de la [API del servicio de sombra de dispositivo AWS IoT](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) en la *Referencia general de Amazon Web Services*.  
Valor predeterminado: 8192 bytes  
Valor máximo: 30 720 bytes

**Example Ejemplo: actualización de la combinación de configuraciones**  
En el siguiente ejemplo, se muestra un ejemplo de actualización de la combinación de configuraciones con todos los parámetros de configuración disponibles para el componente administrador 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
}
```

------

## Archivo de registro local
<a name="shadow-manager-component-log-file"></a>

Este componente utiliza el mismo archivo de registro que el componente [núcleo de Greengrass](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Visualización de los registros de este componente**
+ Ejecute el siguiente comando en el dispositivo de núcleo para ver el archivo de registro de este componente en tiempo real. Sustituya `/greengrass/v2` o *C:\$1greengrass\$1v2* por la ruta a la carpeta AWS IoT Greengrass raíz.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Registros de cambios
<a name="shadow-manager-component-changelog"></a>

En la siguiente tabla, se describen los cambios en cada versión del componente.


|  Versión  |  Cambios  | 
| --- | --- | 
|  2.3.13  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.12  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.11  | Versión actualizada para el lanzamiento de la versión 2.15.0 de Greengrass nucleus. | 
|  2.3.10  | Versión actualizada para la versión 2.14.0 de Greengrass Nucleus. | 
|  2.3.9  | Versión actualizada para el lanzamiento de la versión 2.13.0 del núcleo de Greengrass. | 
|  2.3.8  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.7  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.6  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.5  | Versión actualizada para el lanzamiento de la versión 2.12.0 del núcleo de Greengrass. | 
|  2.3.4  |  <a name="changelog-shadow-manager-2.3.4"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.3.3  | Versión actualizada para el lanzamiento de la versión 2.11.0 del núcleo de Greengrass. | 
|  2.3.2  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.1  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.3.0  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.2.4  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/shadow-manager-component.html) | 
|  2.2.3  | Versión actualizada para el lanzamiento de la versión 2.9.0 del núcleo de Greengrass. | 
|  2.2.2  | Versión actualizada para el lanzamiento de la versión 2.8.0 del núcleo de Greengrass. | 
|  2.2.1  |  Versión actualizada para el lanzamiento de la versión 2.7.0 del núcleo de Greengrass.  | 
|  2.2.0  |  <a name="changelog-shadow-manager-2.2.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.1.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.0.6  |  Esta versión contiene correcciones de errores y mejoras.  | 
|  2.0.5  |  Versión actualizada para el lanzamiento de la versión 2.5.0 del núcleo de Greengrass.  | 
|  2.0.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.0.3  |  Versión actualizada para el lanzamiento de la versión 2.4.0 del núcleo de Greengrass.  | 
|  2.0.2  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/shadow-manager-component.html)  | 
|  2.0.1  |  Versión actualizada para el lanzamiento de la versión 2.3.0 del núcleo de Greengrass.  | 
|  2.0.0  |  Versión inicial.  |