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.
Gestor en la sombra
El componente administrador de sombras (aws.greengrass.ShadowManager) habilita el servicio oculto 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. 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. Interactúa con las sombras de los dispositivos
Versiones
Este componente tiene las siguientes versiones:
Tipo
Este componente es un componente de complemento ()aws.greengrass.plugin. El núcleo de Greengrass 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.
Este componente utiliza el mismo archivo de registro que el núcleo de Greengrass. Para obtener más información, consulte Supervisar AWS IoT Greengrass registros.
Para obtener más información, consulte Tipos de componentes.
Sistema operativo
Este componente se puede instalar en los dispositivos principales que ejecutan los siguientes sistemas operativos:
Requisitos
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 en la Guía para AWS IoT desarrolladores.
Para obtener más información sobre la AWS IoT política mínima, consulte AWS IoTPolítica mínima para los dispositivos AWS IoT Greengrass V2 principales
-
Se admite que el componente shadow manager se ejecute en unVPC.
Dependencias
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 implementarlo correctamente. En esta sección se enumeran las dependencias de las versiones publicadas 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.AWS IoT Greengrass En la página de detalles del componente, busque la lista de dependencias.
- 2.3.9
-
La siguiente tabla muestra las dependencias de la versión 2.3.9 de este componente.
- 2.3.5 – 2.3.8
-
La siguiente tabla muestra las dependencias de las versiones 2.3.5 a 2.3.8 de este componente.
- 2.3.3 and 2.3.4
-
La siguiente tabla muestra las dependencias de las versiones 2.3.3 y 2.3.4 de este componente.
- 2.3.2
-
La siguiente tabla muestra las dependencias de la versión 2.3.2 de este componente.
- 2.3.0 and 2.3.1
-
La siguiente tabla muestra las dependencias de las versiones 2.3.0 y 2.3.1 de este componente.
- 2.2.3 and 2.2.4
-
La siguiente tabla muestra las dependencias de las versiones 2.2.3 y 2.2.4 de este componente.
- 2.2.2
-
La siguiente tabla muestra las dependencias de la versión 2.2.2 de este componente.
- 2.2.1
-
La siguiente tabla muestra las dependencias de la versión 2.2.1 de este componente.
- 2.1.1 and 2.2.0
-
La siguiente tabla muestra las dependencias de las versiones 2.1.1 y 2.2.0 de este componente.
- 2.0.5 - 2.1.0
-
La siguiente tabla muestra las dependencias de las versiones 2.0.5 a 2.1.0 de este componente.
- 2.0.3 and 2.0.4
-
La siguiente tabla muestra las dependencias de las versiones 2.0.3 y 2.0.4 de este componente.
- 2.0.1 and 2.0.2
-
La siguiente tabla muestra las dependencias de las versiones 2.0.1 y 2.0.2 de este componente.
- 2.0.0
-
La siguiente tabla muestra las dependencias de la versión 2.0.0 de este componente.
Para obtener más información sobre las dependencias de los componentes, consulta la referencia de recetas de componentes.
Configuración
Este componente proporciona los siguientes parámetros de configuración que puede personalizar al implementar el componente.
- 2.3.x
-
strategy-
(Opcional) La estrategia que utiliza este componente para sincronizar las sombras entre 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 el dispositivo principal 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 con AWS IoT Core el que este componente sincroniza las sombras al especificar la estrategia de periodic sincronización.
Este parámetro es obligatorio si se especifica la estrategia de periodic sincronización.
synchronize-
(Opcional) Los ajustes de sincronización que determinan cómo se sincronizan las sombras con el Nube de AWS.
Debe crear una actualización de configuración con esta propiedad para sincronizar las sombras con. Nube de AWS
Este objeto contiene la siguiente información.
coreThing-
(Opcional) Las sombras del dispositivo principal se sincronizan. 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 del dispositivo principal con el Nube de AWS. Si no quieres sincronizar la sombra clásica del dispositivo, configúrala en. false
Valor predeterminado: true
namedShadows-
(Opcional) La lista de sombras de dispositivos 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-
(Opcional) El dispositivo adicional sombrea para sincronizarlo. El uso de este parámetro de configuración facilita la especificación de documentos ocultos. Se recomienda utilizar este parámetro en lugar del shadowDocuments objeto.
Si especifica un shadowDocumentsMap objeto, no debe shadowDocuments especificarlo.
Cada objeto contiene la siguiente información:
thingName-
La configuración oculta del thingName para esta configuración de sombra.
classic-
(Opcional) Si no quieres sincronizar la clásica sombra del dispositivo con el thingName dispositivo, configúrala enfalse.
namedShadows-
La lista de sombras con nombre que quieres sincronizar. Debe especificar los nombres exactos de las sombras.
shadowDocuments-
(Opcional) La lista de sombras de dispositivos adicionales que se van a sincronizar. Le recomendamos que utilice el shadowDocumentsMap parámetro en su lugar.
Si especifica un shadowDocuments objeto, no debe shadowDocumentsMap especificarlo.
Cada objeto de esta lista contiene la siguiente información.
thingName-
Nombre del dispositivo con el que se van a sincronizar las sombras.
classic-
(Opcional) Si no quieres sincronizar la sombra clásica del dispositivo con el thingName dispositivo, configúrala enfalse.
Valor predeterminado: true
namedShadows-
(Opcional) La lista de sombras de dispositivos con nombre que deseas sincronizar. Debe especificar los nombres exactos de las sombras.
direction-
(Opcional) La dirección para sincronizar las sombras entre el servicio de sombras local y el Nube de AWS. Puede configurar esta opción para reducir el ancho de banda y las conexiones al Nube de AWS. Puede elegir entre las siguientes opciones:
-
betweenDeviceAndCloud— Sincronice las sombras entre el servicio oculto local y el Nube de AWS.
-
deviceToCloud— Envía actualizaciones de sombras desde el servicio de sombras local al Nube de AWS e ignora las actualizaciones de sombras del Nube de AWS.
-
cloudToDevice— Recibe actualizaciones ocultas del Nube de AWS servicio paralelo local y no envíes actualizaciones ocultas del servicio paralelo local al Nube de AWS.
Valor predeterminado: BETWEEN_DEVICE_AND_CLOUD
rateLimits-
(Opcional) La configuración que determina los límites de velocidad para las solicitudes de servicios paralelos.
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.
Predeterminado: 100 solicitudes por segundo
maxTotalLocalRequestsRate-
(Opcional) El número máximo de IPC solicitudes locales por segundo que se envían al dispositivo principal.
Predeterminado: 200 solicitudes por segundo
maxLocalRequestsPerSecondPerThing-
(Opcional) El número máximo de IPC solicitudes locales por segundo que se envían para cada elemento de IoT conectado.
Predeterminado: 20 solicitudes por segundo para cada cosa
Estos parámetros de límites de velocidad definen el número máximo de solicitudes por segundo para el servicio paralelo 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 del servicio AWS IoT Device Shadow API en Referencia general de Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Opcional) El tamaño máximo permitido de cada documento JSON estatal para las sombras locales.
Si aumenta este valor, también debe aumentar el límite de recursos del documento JSON estatal para las sombras de nubes. Para obtener más información, consulte los límites del servicio AWS IoT
Device Shadow API en Referencia general de Amazon Web Services.
Predeterminado: 8192 bytes
Máximo: 30720 bytes
ejemplo Ejemplo: actualización de la combinación de configuraciones
El siguiente ejemplo muestra un ejemplo de actualización de la combinación de configuraciones con todos los parámetros de configuración disponibles para el 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) 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 el dispositivo principal 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 con AWS IoT Core el que este componente sincroniza las sombras al especificar la estrategia de periodic sincronización.
Este parámetro es obligatorio si se especifica la estrategia de periodic sincronización.
synchronize-
(Opcional) Los ajustes de sincronización que determinan cómo se sincronizan las sombras con el Nube de AWS.
Debe crear una actualización de configuración con esta propiedad para sincronizar las sombras con. Nube de AWS
Este objeto contiene la siguiente información.
coreThing-
(Opcional) Las sombras del dispositivo principal se sincronizan. 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 del dispositivo principal con el Nube de AWS. Si no quieres sincronizar la sombra clásica del dispositivo, configúrala en. false
Valor predeterminado: true
namedShadows-
(Opcional) La lista de sombras de dispositivos 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-
(Opcional) El dispositivo adicional sombrea para sincronizarlo. El uso de este parámetro de configuración facilita la especificación de documentos ocultos. Se recomienda utilizar este parámetro en lugar del shadowDocuments objeto.
Si especifica un shadowDocumentsMap objeto, no debe shadowDocuments especificarlo.
Cada objeto contiene la siguiente información:
thingName-
La configuración oculta del thingName para esta configuración de sombra.
classic-
(Opcional) Si no quieres sincronizar la clásica sombra del dispositivo con el thingName dispositivo, configúrala enfalse.
namedShadows-
La lista de sombras con nombre que quieres sincronizar. Debe especificar los nombres exactos de las sombras.
shadowDocuments-
(Opcional) La lista de sombras de dispositivos adicionales que se van a sincronizar. Le recomendamos que utilice el shadowDocumentsMap parámetro en su lugar.
Si especifica un shadowDocuments objeto, no debe shadowDocumentsMap especificarlo.
Cada objeto de esta lista contiene la siguiente información.
thingName-
Nombre del dispositivo con el que se van a sincronizar las sombras.
classic-
(Opcional) Si no quieres sincronizar la sombra clásica del dispositivo con el thingName dispositivo, configúrala enfalse.
Valor predeterminado: true
namedShadows-
(Opcional) La lista de sombras de dispositivos con nombre que deseas sincronizar. Debe especificar los nombres exactos de las sombras.
direction-
(Opcional) La dirección para sincronizar las sombras entre el servicio de sombras local y el Nube de AWS. Puede configurar esta opción para reducir el ancho de banda y las conexiones al Nube de AWS. Puede elegir entre las siguientes opciones:
-
betweenDeviceAndCloud— Sincronice las sombras entre el servicio oculto local y el Nube de AWS.
-
deviceToCloud— Envía actualizaciones de sombras desde el servicio de sombras local al Nube de AWS e ignora las actualizaciones de sombras del Nube de AWS.
-
cloudToDevice— Recibe actualizaciones ocultas del Nube de AWS servicio paralelo local y no envíes actualizaciones ocultas del servicio paralelo local al Nube de AWS.
Valor predeterminado: BETWEEN_DEVICE_AND_CLOUD
rateLimits-
(Opcional) La configuración que determina los límites de velocidad para las solicitudes de servicios paralelos.
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.
Predeterminado: 100 solicitudes por segundo
maxTotalLocalRequestsRate-
(Opcional) El número máximo de IPC solicitudes locales por segundo que se envían al dispositivo principal.
Predeterminado: 200 solicitudes por segundo
maxLocalRequestsPerSecondPerThing-
(Opcional) El número máximo de IPC solicitudes locales por segundo que se envían para cada elemento de IoT conectado.
Predeterminado: 20 solicitudes por segundo para cada cosa
Estos parámetros de límites de velocidad definen el número máximo de solicitudes por segundo para el servicio paralelo 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 del servicio AWS IoT Device Shadow API en Referencia general de Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Opcional) El tamaño máximo permitido de cada documento JSON estatal para las sombras locales.
Si aumenta este valor, también debe aumentar el límite de recursos del documento JSON estatal para las sombras de nubes. Para obtener más información, consulte los límites del servicio AWS IoT
Device Shadow API en Referencia general de Amazon Web Services.
Predeterminado: 8192 bytes
Máximo: 30720 bytes
ejemplo Ejemplo: actualización de la combinación de configuraciones
El siguiente ejemplo muestra un ejemplo de actualización de la combinación de configuraciones con todos los parámetros de configuración disponibles para el 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) 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 el dispositivo principal 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 con AWS IoT Core el que este componente sincroniza las sombras al especificar la estrategia de periodic sincronización.
Este parámetro es obligatorio si se especifica la estrategia de periodic sincronización.
synchronize-
(Opcional) Los ajustes de sincronización que determinan cómo se sincronizan las sombras con el Nube de AWS.
Debe crear una actualización de configuración con esta propiedad para sincronizar las sombras con. Nube de AWS
Este objeto contiene la siguiente información.
coreThing-
(Opcional) Las sombras del dispositivo principal se sincronizan. 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 del dispositivo principal con el Nube de AWS. Si no quieres sincronizar la sombra clásica del dispositivo, configúrala en. false
Valor predeterminado: true
namedShadows-
(Opcional) La lista de sombras de dispositivos 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-
(Opcional) El dispositivo adicional sombrea para sincronizarlo. El uso de este parámetro de configuración facilita la especificación de documentos ocultos. Se recomienda utilizar este parámetro en lugar del shadowDocuments objeto.
Si especifica un shadowDocumentsMap objeto, no debe shadowDocuments especificarlo.
Cada objeto contiene la siguiente información:
thingName-
La configuración oculta del thingName para esta configuración de sombra.
classic-
(Opcional) Si no quieres sincronizar la clásica sombra del dispositivo con el thingName dispositivo, configúrala enfalse.
namedShadows-
La lista de sombras con nombre que quieres sincronizar. Debe especificar los nombres exactos de las sombras.
shadowDocuments-
(Opcional) La lista de sombras de dispositivos adicionales que se van a sincronizar. Le recomendamos que utilice el shadowDocumentsMap parámetro en su lugar.
Si especifica un shadowDocuments objeto, no debe shadowDocumentsMap especificarlo.
Cada objeto de esta lista contiene la siguiente información.
thingName-
Nombre del dispositivo con el que se van a sincronizar las sombras.
classic-
(Opcional) Si no quieres sincronizar la sombra clásica del dispositivo con el thingName dispositivo, configúrala enfalse.
Valor predeterminado: true
namedShadows-
(Opcional) La lista de sombras de dispositivos con nombre que deseas sincronizar. Debe especificar los nombres exactos de las sombras.
rateLimits-
(Opcional) La configuración que determina los límites de velocidad para las solicitudes de servicios paralelos.
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.
Predeterminado: 100 solicitudes por segundo
maxTotalLocalRequestsRate-
(Opcional) El número máximo de IPC solicitudes locales por segundo que se envían al dispositivo principal.
Predeterminado: 200 solicitudes por segundo
maxLocalRequestsPerSecondPerThing-
(Opcional) El número máximo de IPC solicitudes locales por segundo que se envían para cada elemento de IoT conectado.
Predeterminado: 20 solicitudes por segundo para cada cosa
Estos parámetros de límites de velocidad definen el número máximo de solicitudes por segundo para el servicio paralelo 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 del servicio AWS IoT Device Shadow API en Referencia general de Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Opcional) El tamaño máximo permitido de cada documento JSON estatal para las sombras locales.
Si aumenta este valor, también debe aumentar el límite de recursos del documento JSON estatal para las sombras de nubes. Para obtener más información, consulte los límites del servicio AWS IoT
Device Shadow API en Referencia general de Amazon Web Services.
Predeterminado: 8192 bytes
Máximo: 30720 bytes
ejemplo Ejemplo: actualización de la combinación de configuraciones
El siguiente ejemplo muestra un ejemplo de actualización de la combinación de configuraciones con todos los parámetros de configuración disponibles para el 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) La configuración de sincronización que determina cómo se sincronizan las sombras con el Nube de AWS.
Debe crear una actualización de configuración con esta propiedad para sincronizar las sombras con. Nube de AWS
Este objeto contiene la siguiente información.
coreThing-
(Opcional) Las sombras del dispositivo principal se sincronizan. 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 del dispositivo principal con el Nube de AWS. Si no quieres sincronizar la sombra clásica del dispositivo, configúrala en. false
Valor predeterminado: true
namedShadows-
(Opcional) La lista de sombras de dispositivos 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-
(Opcional) El dispositivo adicional sombrea para sincronizarlo. El uso de este parámetro de configuración facilita la especificación de documentos ocultos. Se recomienda utilizar este parámetro en lugar del shadowDocuments objeto.
Si especifica un shadowDocumentsMap objeto, no debe shadowDocuments especificarlo.
Cada objeto contiene la siguiente información:
thingName-
La configuración oculta del thingName para esta configuración de sombra.
classic-
(Opcional) Si no quieres sincronizar la clásica sombra del dispositivo con el thingName dispositivo, configúrala enfalse.
namedShadows-
La lista de sombras con nombre que quieres sincronizar. Debe especificar los nombres exactos de las sombras.
shadowDocuments-
(Opcional) La lista de sombras de dispositivos adicionales que se van a sincronizar. Le recomendamos que utilice el shadowDocumentsMap parámetro en su lugar.
Si especifica un shadowDocuments objeto, no debe shadowDocumentsMap especificarlo.
Cada objeto de esta lista contiene la siguiente información.
thingName-
Nombre del dispositivo con el que se van a sincronizar las sombras.
classic-
(Opcional) Si no quieres sincronizar la sombra clásica del dispositivo con el thingName dispositivo, configúrala enfalse.
Valor predeterminado: true
namedShadows-
(Opcional) La lista de sombras de dispositivos con nombre que deseas sincronizar. Debe especificar los nombres exactos de las sombras.
rateLimits-
(Opcional) La configuración que determina los límites de velocidad para las solicitudes de servicios paralelos.
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.
Predeterminado: 100 solicitudes por segundo
maxTotalLocalRequestsRate-
(Opcional) El número máximo de IPC solicitudes locales por segundo que se envían al dispositivo principal.
Predeterminado: 200 solicitudes por segundo
maxLocalRequestsPerSecondPerThing-
(Opcional) El número máximo de IPC solicitudes locales por segundo que se envían para cada elemento de IoT conectado.
Predeterminado: 20 solicitudes por segundo para cada cosa
Estos parámetros de límites de velocidad definen el número máximo de solicitudes por segundo para el servicio paralelo 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 del servicio AWS IoT Device Shadow API en Referencia general de Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Opcional) El tamaño máximo permitido de cada documento JSON estatal para las sombras locales.
Si aumenta este valor, también debe aumentar el límite de recursos del documento JSON estatal para las sombras de nubes. Para obtener más información, consulte los límites del servicio AWS IoT
Device Shadow API en Referencia general de Amazon Web Services.
Predeterminado: 8192 bytes
Máximo: 30720 bytes
ejemplo Ejemplo: actualización de la combinación de configuraciones
El siguiente ejemplo muestra un ejemplo de actualización de la combinación de configuraciones con todos los parámetros de configuración disponibles para el 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
}
Archivo de registro local
Este componente utiliza el mismo archivo de registro que el componente núcleo de Greengrass.
- Linux
-
/greengrass/v2
- Windows
-
C:\greengrass\v2\logs\greengrass.log
Para ver los registros de este componente
Registros de cambios
En la siguiente tabla se describen los cambios en cada versión del componente.
|
Versión
|
Cambios
|
|
2.3.9
|
Versión actualizada para la versión 2.13.0 de Greengrass nucleus. |
|
2.3.8
|
- Mejoras y correcciones de errores
-
|
|
2.3.7
|
- Mejoras y correcciones de errores
-
|
|
2.3.6
|
- Mejoras y correcciones de errores
-
|
|
2.3.5
|
Versión actualizada para la versión 2.12.0 de Greengrass nucleus. |
|
2.3.4
|
- Mejoras y correcciones de errores
-
|
|
2.3.3
|
Versión actualizada para la versión 2.11.0 de Greengrass nucleus. |
|
2.3.2
|
- Mejoras y correcciones de errores
-
|
|
2.3.1
|
- Mejoras y correcciones de errores
-
-
Corrige una condición que podía impedir la sincronización de las actualizaciones de Cloud Shadow.
-
Soluciona un problema por el que los cambios en la configuración de sincronización de sombras con nombre se aplicaban solo a una sombra con nombre.
|
|
2.3.0
|
- Mejoras y correcciones de errores
-
|
|
2.2.4
|
- Mejoras y correcciones de errores
-
-
Soluciona un problema por el que la validación del tamaño de la sombra no era coherente con el de la nube al actualizar el documento de sombra local.
-
Soluciona un problema por el que el administrador oculto deja de escuchar las actualizaciones de la configuración si una implementación se realiza RESET en los nodos de configuración.
|
|
2.2.3
|
Versión actualizada para la versión 2.9.0 de Greengrass nucleus. |
|
2.2.2
|
Versión actualizada para la versión 2.8.0 de Greengrass nucleus. |
|
2.2.1
|
Versión actualizada para la versión 2.7.0 de Greengrass Nucleus.
|
|
2.2.0
|
- Nuevas características
-
-
Añade compatibilidad con el servicio paralelo local a través de la interfaz local de publicación/suscripción. Ahora puedes comunicarte con el agente local de mensajes de publicación/suscripción sobre MQTTtemas ocultos para obtener, actualizar y eliminar los mensajes ocultos en el dispositivo principal. Esta función le permite conectar los dispositivos cliente al servicio paralelo local mediante el MQTT puente para retransmitir mensajes sobre temas ocultos entre los dispositivos cliente y la interfaz local de publicación/suscripción.
Esta función requiere la versión 2.6.0 o posterior del componente núcleo de Greengrass. Para conectar los dispositivos cliente al servicio paralelo local, también debe utilizar la versión 2.2.0 o posterior del componente bridge. MQTT
-
Añade la direction opción que puede configurar para personalizar la dirección de sincronización de las sombras entre el servicio oculto local y el. Nube de AWS Puede configurar esta opción para reducir el ancho de banda y las conexiones al Nube de AWS.
|
|
2.1.1
|
- Mejoras y correcciones de errores
-
-
Soluciona un problema por el que la profundidad máxima en las reported secciones desired y del documento de estado de sombra del JSON dispositivo era de 4 niveles en lugar de 5 niveles.
-
Versión actualizada para la versión 2.6.0 de Greengrass nucleus.
|
|
2.1.0
|
|
|
2.0.6
|
Esta versión contiene mejoras y correcciones de errores.
|
|
2.0.5
|
Versión actualizada para la versión 2.5.0 de Greengrass nucleus.
|
|
2.0.4
|
- Mejoras y correcciones de errores
-
-
Corrige un problema que provocaba que el administrador de sombras eliminara las versiones recién creadas de cualquier sombra que se hubiera eliminado anteriormente.
-
Actualiza la DeleteThingShadow IPC operación para incrementar la versión oculta cuando se invoca.
|
|
2.0.3
|
Versión actualizada para la versión 2.4.0 de Greengrass nucleus.
|
|
2.0.2
|
- Mejoras y correcciones de errores
-
-
Se ha corregido un error que provocaba que el administrador de sombras no reconociera la delta propiedad al sincronizar los estados de sombra desde AWS IoT Core ella.
-
Se ha corregido un problema que a veces provocaba que las solicitudes de sincronización de una sombra se fusionaran de forma incorrecta.
|
|
2.0.1
|
Versión actualizada para la versión 2.3.0 de Greengrass nucleus.
|
|
2.0.0
|
Versión inicial.
|
