Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Gestionnaire d'ombres
Le composant Shadow Manager (aws.greengrass.ShadowManager) active le service d'ombre local sur votre appareil principal. Le service d'ombre local permet aux composants d'utiliser la communication interprocessus pour interagir avec les ombres locales. Le composant Shadow Manager gère le stockage des documents fantômes locaux et gère également la synchronisation des états fantômes locaux avec le service AWS IoT Device Shadow.
Pour plus d'informations sur la manière dont les appareils principaux de Greengrass peuvent interagir avec les ombres, consultezInteragissez avec les ombres de l'appareil.
Versions
Les versions de ce composant sont les suivantes :
Type
Ce composant est un composant de plug-in (aws.greengrass.plugin). Le noyau Greengrass exécute ce composant dans la même machine virtuelle Java (JVM) que le noyau. Le noyau redémarre lorsque vous modifiez la version de ce composant sur le périphérique principal.
Ce composant utilise le même fichier journal que le noyau Greengrass. Pour de plus amples informations, veuillez consulter AWS IoT Greengrass Journaux de surveillance.
Pour de plus amples informations, veuillez consulter Types de composant.
Système d’exploitation
Ce composant peut être installé sur les appareils principaux qui exécutent les systèmes d'exploitation suivants :
Exigences
Ce composant répond aux exigences suivantes :
-
(Facultatif) Pour synchroniser les ombres avec le service AWS IoT Device Shadow, la AWS IoT politique de l'appareil principal Greengrass doit autoriser les actions de stratégie AWS IoT Core fantôme suivantes :
-
iot:GetThingShadow
-
iot:UpdateThingShadow
-
iot:DeleteThingShadow
Pour plus d'informations sur ces AWS IoT Core politiques, consultez les actions AWS IoT Core stratégiques dans le Guide du AWS IoT développeur.
Pour plus d'informations sur la AWS IoT politique minimale, voir AWS IoT Politique minimale pour les appareils AWS IoT Greengrass V2 principaux
-
Le composant Shadow Manager est pris en charge pour fonctionner dans un VPC.
Dépendances
Lorsque vous déployez un composant, déploie AWS IoT Greengrass également des versions compatibles de ses dépendances. Cela signifie que vous devez répondre aux exigences relatives au composant et à toutes ses dépendances pour pouvoir le déployer avec succès. Cette section répertorie les dépendances pour les versions publiées de ce composant et les contraintes de version sémantiques qui définissent les versions des composants pour chaque dépendance. Vous pouvez également consulter les dépendances pour chaque version du composant dans la AWS IoT Greengrass console. Sur la page des détails des composants, recherchez la liste des dépendances.
- 2.3.13
-
Le tableau suivant répertorie les dépendances pour la version 2.3.13 de ce composant.
| Dépendance |
Versions compatibles |
Type de dépendance |
| Noyau Greengrass |
> = 2,5,0 < 2,17,0 |
Flexible |
- 2.3.12
-
Le tableau suivant répertorie les dépendances pour la version 2.3.12 de ce composant.
| Dépendance |
Versions compatibles |
Type de dépendance |
| Noyau Greengrass |
> = 2,5,0 < 2,17,0 |
Flexible |
- 2.3.11
-
Le tableau suivant répertorie les dépendances pour la version 2.3.11 de ce composant.
| Dépendance |
Versions compatibles |
Type de dépendance |
| Noyau Greengrass |
> = 2,5,0 < 2,16,0 |
Flexible |
- 2.3.10
-
Le tableau suivant répertorie les dépendances pour la version 2.3.10 de ce composant.
| Dépendance |
Versions compatibles |
Type de dépendance |
| Noyau Greengrass |
> = 2,5,0 < 2,15,0 |
Flexible |
- 2.3.9
-
Le tableau suivant répertorie les dépendances pour la version 2.3.9 de ce composant.
| Dépendance |
Versions compatibles |
Type de dépendance |
| Noyau Greengrass |
> = 2,5,0 < 2,14,0 |
Flexible |
- 2.3.5 – 2.3.8
-
Le tableau suivant répertorie les dépendances pour les versions 2.3.5 à 2.3.8 de ce composant.
| Dépendance |
Versions compatibles |
Type de dépendance |
| Noyau Greengrass |
> = 2,5,0 < 2,13,0 |
Flexible |
- 2.3.3 and 2.3.4
-
Le tableau suivant répertorie les dépendances pour les versions 2.3.3 et 2.3.4 de ce composant.
| Dépendance |
Versions compatibles |
Type de dépendance |
| Noyau Greengrass |
> = 2,5,0 < 2,12,0 |
Flexible |
- 2.3.2
-
Le tableau suivant répertorie les dépendances pour la version 2.3.2 de ce composant.
| Dépendance |
Versions compatibles |
Type de dépendance |
| Noyau Greengrass |
>=2,5,0 <2,11,0 |
Flexible |
- 2.3.0 and 2.3.1
-
Le tableau suivant répertorie les dépendances pour les versions 2.3.0 et 2.3.1 de ce composant.
| Dépendance |
Versions compatibles |
Type de dépendance |
| Noyau Greengrass |
> = 2,5,0 < 2,10,0 |
Flexible |
- 2.2.3 and 2.2.4
-
Le tableau suivant répertorie les dépendances pour les versions 2.2.3 et 2.2.4 de ce composant.
| Dépendance |
Versions compatibles |
Type de dépendance |
| Noyau Greengrass |
> = 2,2,0 < 3,0,0 |
Flexible |
- 2.2.2
-
Le tableau suivant répertorie les dépendances pour la version 2.2.2 de ce composant.
| Dépendance |
Versions compatibles |
Type de dépendance |
| Noyau Greengrass |
> = 2,2,0 < 2,9,0 |
Flexible |
- 2.2.1
-
Le tableau suivant répertorie les dépendances pour la version 2.2.1 de ce composant.
| Dépendance |
Versions compatibles |
Type de dépendance |
| Noyau Greengrass |
> = 2,2,0 < 2,8,0 |
Flexible |
- 2.1.1 and 2.2.0
-
Le tableau suivant répertorie les dépendances pour les versions 2.1.1 et 2.2.0 de ce composant.
| Dépendance |
Versions compatibles |
Type de dépendance |
| Noyau Greengrass |
> = 2,2,0 < 2,7,0 |
Flexible |
- 2.0.5 - 2.1.0
-
Le tableau suivant répertorie les dépendances pour les versions 2.0.5 à 2.1.0 de ce composant.
| Dépendance |
Versions compatibles |
Type de dépendance |
| Noyau Greengrass |
> = 2,2,0 < 2,6,0 |
Flexible |
- 2.0.3 and 2.0.4
-
Le tableau suivant répertorie les dépendances pour les versions 2.0.3 et 2.0.4 de ce composant.
| Dépendance |
Versions compatibles |
Type de dépendance |
| Noyau Greengrass |
> = 2,2,0 < 2,5,0 |
Flexible |
- 2.0.1 and 2.0.2
-
Le tableau suivant répertorie les dépendances pour les versions 2.0.1 et 2.0.2 de ce composant.
| Dépendance |
Versions compatibles |
Type de dépendance |
| Noyau Greengrass |
> = 2,2,0 < 2,4,0 |
Flexible |
- 2.0.0
-
Le tableau suivant répertorie les dépendances pour la version 2.0.0 de ce composant.
| Dépendance |
Versions compatibles |
Type de dépendance |
| Noyau Greengrass |
> = 2,2,0 < 2,3,0 |
Flexible |
Pour plus d'informations sur les dépendances des composants, consultez la référence des recettes des composants.
Configuration
Ce composant fournit les paramètres de configuration suivants que vous pouvez personnaliser lorsque vous déployez le composant.
- 2.3.x
-
strategy-
(Facultatif) Stratégie utilisée par ce composant pour synchroniser les ombres entre AWS IoT Core et le périphérique principal.
Cet objet contient les informations suivantes.
type-
(Facultatif) Type de stratégie utilisé par ce composant pour synchroniser les ombres entre AWS IoT Core et le périphérique principal. Sélectionnez l’une des options suivantes :
-
realTime— Synchronisez les ombres à AWS IoT Core chaque fois qu'une mise à jour des ombres se produit.
-
periodic— Synchronisez les ombres AWS IoT Core selon un intervalle régulier que vous spécifiez à l'aide du paramètre delay de configuration.
Valeur par défaut : realTime
delay-
(Facultatif) Intervalle en secondes avec AWS IoT Core lequel ce composant synchronise les ombres lorsque vous spécifiez la stratégie de periodic synchronisation.
Ce paramètre est obligatoire si vous spécifiez la stratégie de periodic synchronisation.
synchronize-
(Facultatif) Les paramètres de synchronisation qui déterminent la manière dont les ombres sont synchronisées avec. AWS Cloud
Vous devez créer une mise à jour de configuration avec cette propriété pour synchroniser les ombres avec AWS Cloud.
Cet objet contient les informations suivantes.
coreThing-
(Facultatif) Les ombres du périphérique principal à synchroniser. Cet objet contient les informations suivantes.
classic-
(Facultatif) Par défaut, le gestionnaire d'ombres synchronise l'état local de l'ombre classique de votre appareil principal avec le AWS Cloud. Si vous ne souhaitez pas synchroniser l'ombre classique de l'appareil, réglez-la surfalse.
Valeur par défaut : true
namedShadows-
(Facultatif) La liste des ombres des périphériques principaux nommés à synchroniser. Vous devez spécifier le nom exact des ombres.
Le AWS IoT Greengrass service utilise l'ombre AWSManagedGreengrassV2Deployment nommée pour gérer les déploiements qui ciblent des périphériques principaux individuels. Cette ombre nommée est réservée à l'usage du AWS IoT Greengrass service. Ne mettez pas à jour ni ne supprimez cette ombre nommée.
shadowDocumentsMap-
(Facultatif) Les ombres supplémentaires de l'appareil à synchroniser. L'utilisation de ce paramètre de configuration facilite la spécification de documents fictifs. Nous vous recommandons d'utiliser ce paramètre à la place de l'shadowDocumentsobjet.
Si vous spécifiez un shadowDocumentsMap objet, vous ne devez pas spécifier d'shadowDocumentsobjet.
Chaque objet contient les informations suivantes :
thingName-
La configuration d'ombre thingName pour cette configuration d'ombre.
classic-
(Facultatif) Si vous ne souhaitez pas synchroniser l'ombre classique de l'thingNameappareil, réglez-la surfalse.
namedShadows-
La liste des ombres nommées que vous souhaitez synchroniser. Vous devez spécifier le nom exact des ombres.
shadowDocuments-
(Facultatif) La liste des ombres supplémentaires de l'appareil à synchroniser. Nous vous recommandons d'utiliser le shadowDocumentsMap paramètre à la place.
Si vous spécifiez un shadowDocuments objet, vous ne devez pas spécifier d'shadowDocumentsMapobjet.
Chaque objet de cette liste contient les informations suivantes.
thingName-
Nom de l'appareil pour lequel synchroniser les ombres.
classic-
(Facultatif) Si vous ne souhaitez pas synchroniser l'ombre classique de l'thingNameappareil, réglez-la surfalse.
Valeur par défaut : true
namedShadows-
(Facultatif) La liste des ombres nommées de l'appareil que vous souhaitez synchroniser. Vous devez spécifier le nom exact des ombres.
direction-
(Facultatif) La direction de synchronisation des ombres entre le service d'ombres local et le AWS Cloud. Vous pouvez configurer cette option pour réduire la bande passante et les connexions au AWS Cloud. Sélectionnez l’une des options suivantes :
-
betweenDeviceAndCloud— Synchronisez les ombres entre le service d'ombres local et le AWS Cloud.
-
deviceToCloud— Envoyez les mises à jour instantanées depuis le service parallèle local au AWS Cloud, et ignorez les mises à jour instantanées provenant du AWS Cloud.
-
cloudToDevice— Recevez des mises à jour instantanées depuis le AWS Cloud, et n'envoyez pas de mises à jour instantanées depuis le service parallèle local vers le AWS Cloud.
Valeur par défaut : BETWEEN_DEVICE_AND_CLOUD
rateLimits-
(Facultatif) Les paramètres qui déterminent les limites de débit pour les demandes de service parallèle.
Cet objet contient les informations suivantes.
maxOutboundSyncUpdatesPerSecond-
(Facultatif) Le nombre maximum de demandes de synchronisation transmises par seconde par l'appareil.
Par défaut : 100 requests/second
maxTotalLocalRequestsRate-
(Facultatif) Le nombre maximum de demandes IPC locales par seconde envoyées au périphérique principal.
Par défaut : 200 requests/second
maxLocalRequestsPerSecondPerThing-
(Facultatif) Le nombre maximum de requêtes IPC locales par seconde envoyées pour chaque objet IoT connecté.
Par défaut : 20 requests/second pour chaque élément
Ces paramètres de limites de débit définissent le nombre maximum de demandes par seconde pour le service parallèle local. Le nombre maximum de requêtes par seconde pour le service AWS IoT Device Shadow dépend de votre Région AWS. Pour plus d'informations, consultez les limites de l'API AWS IoT Device Shadow Service dans le Référence générale d'Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Facultatif) Taille maximale autorisée de chaque document d'état JSON pour les ombres locales.
Si vous augmentez cette valeur, vous devez également augmenter la limite de ressources pour le document d'état JSON pour les ombres des nuages. Pour plus d'informations, consultez les limites de l'API AWS IoT
Device Shadow Service dans le Référence générale d'Amazon Web Services.
Par défaut : 8192 octets
Maximum : 30 720 octets
Exemple Exemple : fusion de configuration et mise à jour
L'exemple suivant montre un exemple de mise à jour de fusion de configuration avec tous les paramètres de configuration disponibles pour le composant 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-
(Facultatif) Stratégie utilisée par ce composant pour synchroniser les ombres entre AWS IoT Core et le périphérique principal.
Cet objet contient les informations suivantes.
type-
(Facultatif) Type de stratégie utilisé par ce composant pour synchroniser les ombres entre AWS IoT Core et le périphérique principal. Sélectionnez l’une des options suivantes :
-
realTime— Synchronisez les ombres à AWS IoT Core chaque fois qu'une mise à jour des ombres se produit.
-
periodic— Synchronisez les ombres AWS IoT Core selon un intervalle régulier que vous spécifiez à l'aide du paramètre delay de configuration.
Valeur par défaut : realTime
delay-
(Facultatif) Intervalle en secondes avec AWS IoT Core lequel ce composant synchronise les ombres lorsque vous spécifiez la stratégie de periodic synchronisation.
Ce paramètre est obligatoire si vous spécifiez la stratégie de periodic synchronisation.
synchronize-
(Facultatif) Les paramètres de synchronisation qui déterminent la manière dont les ombres sont synchronisées avec. AWS Cloud
Vous devez créer une mise à jour de configuration avec cette propriété pour synchroniser les ombres avec AWS Cloud.
Cet objet contient les informations suivantes.
coreThing-
(Facultatif) Les ombres du périphérique principal à synchroniser. Cet objet contient les informations suivantes.
classic-
(Facultatif) Par défaut, le gestionnaire d'ombres synchronise l'état local de l'ombre classique de votre appareil principal avec le AWS Cloud. Si vous ne souhaitez pas synchroniser l'ombre classique de l'appareil, réglez-la surfalse.
Valeur par défaut : true
namedShadows-
(Facultatif) La liste des ombres des périphériques principaux nommés à synchroniser. Vous devez spécifier le nom exact des ombres.
Le AWS IoT Greengrass service utilise l'ombre AWSManagedGreengrassV2Deployment nommée pour gérer les déploiements qui ciblent des périphériques principaux individuels. Cette ombre nommée est réservée à l'usage du AWS IoT Greengrass service. Ne mettez pas à jour ni ne supprimez cette ombre nommée.
shadowDocumentsMap-
(Facultatif) Les ombres supplémentaires de l'appareil à synchroniser. L'utilisation de ce paramètre de configuration facilite la spécification de documents fictifs. Nous vous recommandons d'utiliser ce paramètre à la place de l'shadowDocumentsobjet.
Si vous spécifiez un shadowDocumentsMap objet, vous ne devez pas spécifier d'shadowDocumentsobjet.
Chaque objet contient les informations suivantes :
thingName-
La configuration d'ombre thingName pour cette configuration d'ombre.
classic-
(Facultatif) Si vous ne souhaitez pas synchroniser l'ombre classique de l'thingNameappareil, réglez-la surfalse.
namedShadows-
La liste des ombres nommées que vous souhaitez synchroniser. Vous devez spécifier le nom exact des ombres.
shadowDocuments-
(Facultatif) La liste des ombres supplémentaires de l'appareil à synchroniser. Nous vous recommandons d'utiliser le shadowDocumentsMap paramètre à la place.
Si vous spécifiez un shadowDocuments objet, vous ne devez pas spécifier d'shadowDocumentsMapobjet.
Chaque objet de cette liste contient les informations suivantes.
thingName-
Nom de l'appareil pour lequel synchroniser les ombres.
classic-
(Facultatif) Si vous ne souhaitez pas synchroniser l'ombre classique de l'thingNameappareil, réglez-la surfalse.
Valeur par défaut : true
namedShadows-
(Facultatif) La liste des ombres nommées de l'appareil que vous souhaitez synchroniser. Vous devez spécifier le nom exact des ombres.
direction-
(Facultatif) La direction de synchronisation des ombres entre le service d'ombres local et le AWS Cloud. Vous pouvez configurer cette option pour réduire la bande passante et les connexions au AWS Cloud. Sélectionnez l’une des options suivantes :
-
betweenDeviceAndCloud— Synchronisez les ombres entre le service d'ombres local et le AWS Cloud.
-
deviceToCloud— Envoyez les mises à jour instantanées depuis le service parallèle local au AWS Cloud, et ignorez les mises à jour instantanées provenant du AWS Cloud.
-
cloudToDevice— Recevez des mises à jour instantanées depuis le AWS Cloud, et n'envoyez pas de mises à jour instantanées depuis le service parallèle local vers le AWS Cloud.
Valeur par défaut : BETWEEN_DEVICE_AND_CLOUD
rateLimits-
(Facultatif) Les paramètres qui déterminent les limites de débit pour les demandes de service parallèle.
Cet objet contient les informations suivantes.
maxOutboundSyncUpdatesPerSecond-
(Facultatif) Le nombre maximum de demandes de synchronisation transmises par seconde par l'appareil.
Par défaut : 100 requests/second
maxTotalLocalRequestsRate-
(Facultatif) Le nombre maximum de demandes IPC locales par seconde envoyées au périphérique principal.
Par défaut : 200 requests/second
maxLocalRequestsPerSecondPerThing-
(Facultatif) Le nombre maximum de requêtes IPC locales par seconde envoyées pour chaque objet IoT connecté.
Par défaut : 20 requests/second pour chaque élément
Ces paramètres de limites de débit définissent le nombre maximum de demandes par seconde pour le service parallèle local. Le nombre maximum de requêtes par seconde pour le service AWS IoT Device Shadow dépend de votre Région AWS. Pour plus d'informations, consultez les limites de l'API AWS IoT Device Shadow Service dans le Référence générale d'Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Facultatif) Taille maximale autorisée de chaque document d'état JSON pour les ombres locales.
Si vous augmentez cette valeur, vous devez également augmenter la limite de ressources pour le document d'état JSON pour les ombres des nuages. Pour plus d'informations, consultez les limites de l'API AWS IoT
Device Shadow Service dans le Référence générale d'Amazon Web Services.
Par défaut : 8192 octets
Maximum : 30 720 octets
Exemple Exemple : fusion de configuration et mise à jour
L'exemple suivant montre un exemple de mise à jour de fusion de configuration avec tous les paramètres de configuration disponibles pour le composant 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-
(Facultatif) Stratégie utilisée par ce composant pour synchroniser les ombres entre AWS IoT Core et le périphérique principal.
Cet objet contient les informations suivantes.
type-
(Facultatif) Type de stratégie utilisé par ce composant pour synchroniser les ombres entre AWS IoT Core et le périphérique principal. Sélectionnez l’une des options suivantes :
-
realTime— Synchronisez les ombres à AWS IoT Core chaque fois qu'une mise à jour des ombres se produit.
-
periodic— Synchronisez les ombres AWS IoT Core selon un intervalle régulier que vous spécifiez à l'aide du paramètre delay de configuration.
Valeur par défaut : realTime
delay-
(Facultatif) Intervalle en secondes avec AWS IoT Core lequel ce composant synchronise les ombres lorsque vous spécifiez la stratégie de periodic synchronisation.
Ce paramètre est obligatoire si vous spécifiez la stratégie de periodic synchronisation.
synchronize-
(Facultatif) Les paramètres de synchronisation qui déterminent la manière dont les ombres sont synchronisées avec. AWS Cloud
Vous devez créer une mise à jour de configuration avec cette propriété pour synchroniser les ombres avec AWS Cloud.
Cet objet contient les informations suivantes.
coreThing-
(Facultatif) Les ombres du périphérique principal à synchroniser. Cet objet contient les informations suivantes.
classic-
(Facultatif) Par défaut, le gestionnaire d'ombres synchronise l'état local de l'ombre classique de votre appareil principal avec le AWS Cloud. Si vous ne souhaitez pas synchroniser l'ombre classique de l'appareil, réglez-la surfalse.
Valeur par défaut : true
namedShadows-
(Facultatif) La liste des ombres des périphériques principaux nommés à synchroniser. Vous devez spécifier le nom exact des ombres.
Le AWS IoT Greengrass service utilise l'ombre AWSManagedGreengrassV2Deployment nommée pour gérer les déploiements qui ciblent des périphériques principaux individuels. Cette ombre nommée est réservée à l'usage du AWS IoT Greengrass service. Ne mettez pas à jour ni ne supprimez cette ombre nommée.
shadowDocumentsMap-
(Facultatif) Les ombres supplémentaires de l'appareil à synchroniser. L'utilisation de ce paramètre de configuration facilite la spécification de documents fictifs. Nous vous recommandons d'utiliser ce paramètre à la place de l'shadowDocumentsobjet.
Si vous spécifiez un shadowDocumentsMap objet, vous ne devez pas spécifier d'shadowDocumentsobjet.
Chaque objet contient les informations suivantes :
thingName-
La configuration d'ombre thingName pour cette configuration d'ombre.
classic-
(Facultatif) Si vous ne souhaitez pas synchroniser l'ombre classique de l'thingNameappareil, réglez-la surfalse.
namedShadows-
La liste des ombres nommées que vous souhaitez synchroniser. Vous devez spécifier le nom exact des ombres.
shadowDocuments-
(Facultatif) La liste des ombres supplémentaires de l'appareil à synchroniser. Nous vous recommandons d'utiliser le shadowDocumentsMap paramètre à la place.
Si vous spécifiez un shadowDocuments objet, vous ne devez pas spécifier d'shadowDocumentsMapobjet.
Chaque objet de cette liste contient les informations suivantes.
thingName-
Nom de l'appareil pour lequel synchroniser les ombres.
classic-
(Facultatif) Si vous ne souhaitez pas synchroniser l'ombre classique de l'thingNameappareil, réglez-la surfalse.
Valeur par défaut : true
namedShadows-
(Facultatif) La liste des ombres nommées de l'appareil que vous souhaitez synchroniser. Vous devez spécifier le nom exact des ombres.
rateLimits-
(Facultatif) Les paramètres qui déterminent les limites de débit pour les demandes de service parallèle.
Cet objet contient les informations suivantes.
maxOutboundSyncUpdatesPerSecond-
(Facultatif) Le nombre maximum de demandes de synchronisation transmises par seconde par l'appareil.
Par défaut : 100 requests/second
maxTotalLocalRequestsRate-
(Facultatif) Le nombre maximum de demandes IPC locales par seconde envoyées au périphérique principal.
Par défaut : 200 requests/second
maxLocalRequestsPerSecondPerThing-
(Facultatif) Le nombre maximum de requêtes IPC locales par seconde envoyées pour chaque objet IoT connecté.
Par défaut : 20 requests/second pour chaque élément
Ces paramètres de limites de débit définissent le nombre maximum de demandes par seconde pour le service parallèle local. Le nombre maximum de requêtes par seconde pour le service AWS IoT Device Shadow dépend de votre Région AWS. Pour plus d'informations, consultez les limites de l'API AWS IoT Device Shadow Service dans le Référence générale d'Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Facultatif) Taille maximale autorisée de chaque document d'état JSON pour les ombres locales.
Si vous augmentez cette valeur, vous devez également augmenter la limite de ressources pour le document d'état JSON pour les ombres des nuages. Pour plus d'informations, consultez les limites de l'API AWS IoT
Device Shadow Service dans le Référence générale d'Amazon Web Services.
Par défaut : 8192 octets
Maximum : 30 720 octets
Exemple Exemple : fusion de configuration et mise à jour
L'exemple suivant montre un exemple de mise à jour de fusion de configuration avec tous les paramètres de configuration disponibles pour le composant 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-
(Facultatif) Les paramètres de synchronisation qui déterminent la manière dont les ombres sont synchronisées avec. AWS Cloud
Vous devez créer une mise à jour de configuration avec cette propriété pour synchroniser les ombres avec AWS Cloud.
Cet objet contient les informations suivantes.
coreThing-
(Facultatif) Les ombres du périphérique principal à synchroniser. Cet objet contient les informations suivantes.
classic-
(Facultatif) Par défaut, le gestionnaire d'ombres synchronise l'état local de l'ombre classique de votre appareil principal avec le AWS Cloud. Si vous ne souhaitez pas synchroniser l'ombre classique de l'appareil, réglez-la surfalse.
Valeur par défaut : true
namedShadows-
(Facultatif) La liste des ombres des périphériques principaux nommés à synchroniser. Vous devez spécifier le nom exact des ombres.
Le AWS IoT Greengrass service utilise l'ombre AWSManagedGreengrassV2Deployment nommée pour gérer les déploiements qui ciblent des périphériques principaux individuels. Cette ombre nommée est réservée à l'usage du AWS IoT Greengrass service. Ne mettez pas à jour ni ne supprimez cette ombre nommée.
shadowDocumentsMap-
(Facultatif) Les ombres supplémentaires de l'appareil à synchroniser. L'utilisation de ce paramètre de configuration facilite la spécification de documents fictifs. Nous vous recommandons d'utiliser ce paramètre à la place de l'shadowDocumentsobjet.
Si vous spécifiez un shadowDocumentsMap objet, vous ne devez pas spécifier d'shadowDocumentsobjet.
Chaque objet contient les informations suivantes :
thingName-
La configuration d'ombre thingName pour cette configuration d'ombre.
classic-
(Facultatif) Si vous ne souhaitez pas synchroniser l'ombre classique de l'thingNameappareil, réglez-la surfalse.
namedShadows-
La liste des ombres nommées que vous souhaitez synchroniser. Vous devez spécifier le nom exact des ombres.
shadowDocuments-
(Facultatif) La liste des ombres supplémentaires de l'appareil à synchroniser. Nous vous recommandons d'utiliser le shadowDocumentsMap paramètre à la place.
Si vous spécifiez un shadowDocuments objet, vous ne devez pas spécifier d'shadowDocumentsMapobjet.
Chaque objet de cette liste contient les informations suivantes.
thingName-
Nom de l'appareil pour lequel synchroniser les ombres.
classic-
(Facultatif) Si vous ne souhaitez pas synchroniser l'ombre classique de l'thingNameappareil, réglez-la surfalse.
Valeur par défaut : true
namedShadows-
(Facultatif) La liste des ombres nommées de l'appareil que vous souhaitez synchroniser. Vous devez spécifier le nom exact des ombres.
rateLimits-
(Facultatif) Les paramètres qui déterminent les limites de débit pour les demandes de service parallèle.
Cet objet contient les informations suivantes.
maxOutboundSyncUpdatesPerSecond-
(Facultatif) Le nombre maximum de demandes de synchronisation transmises par seconde par l'appareil.
Par défaut : 100 requests/second
maxTotalLocalRequestsRate-
(Facultatif) Le nombre maximum de demandes IPC locales par seconde envoyées au périphérique principal.
Par défaut : 200 requests/second
maxLocalRequestsPerSecondPerThing-
(Facultatif) Le nombre maximum de requêtes IPC locales par seconde envoyées pour chaque objet IoT connecté.
Par défaut : 20 requests/second pour chaque élément
Ces paramètres de limites de débit définissent le nombre maximum de demandes par seconde pour le service parallèle local. Le nombre maximum de requêtes par seconde pour le service AWS IoT Device Shadow dépend de votre Région AWS. Pour plus d'informations, consultez les limites de l'API AWS IoT Device Shadow Service dans le Référence générale d'Amazon Web Services.
shadowDocumentSizeLimitBytes-
(Facultatif) Taille maximale autorisée de chaque document d'état JSON pour les ombres locales.
Si vous augmentez cette valeur, vous devez également augmenter la limite de ressources pour le document d'état JSON pour les ombres des nuages. Pour plus d'informations, consultez les limites de l'API AWS IoT
Device Shadow Service dans le Référence générale d'Amazon Web Services.
Par défaut : 8192 octets
Maximum : 30 720 octets
Exemple Exemple : fusion de configuration et mise à jour
L'exemple suivant montre un exemple de mise à jour de fusion de configuration avec tous les paramètres de configuration disponibles pour le composant 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
}
Fichier journal local
Ce composant utilise le même fichier journal que le composant Greengrass Nucleus.
- Linux
-
/greengrass/v2
- Windows
-
C:\greengrass\v2\logs\greengrass.log
Pour afficher les journaux de ce composant
Journal des modifications
Le tableau suivant décrit les modifications apportées à chaque version du composant.
|
Version
|
Modifications
|
|
2.3.15
|
- Corrections de bugs et améliorations
-
-
Résout un problème qui pouvait empêcher le gestionnaire fictif de fonctionner après une panne de courant endommageait sa base de données locale.
-
Valide l'intégrité de la base de données locale au démarrage et recrée la base de données lorsqu'elle détecte une corruption.
|
|
2.3.14
|
Met à jour la version du composant pour la version 2.17.0 de Greengrass Nucleus.
|
|
2.3.13
|
- Corrections de bugs et améliorations
-
-
Résout un problème en raison duquel les mises à jour des ombres locales échouaient par intermittence à se synchroniser avec le cloud, même lorsque la configuration de la direction de synchronisation le permettait.
-
Correctifs de bogues mineurs et améliorations.
|
|
2.3.12
|
- Corrections de bugs et améliorations
-
|
|
2.3.11
|
Version mise à jour pour la version 2.15.0 de Greengrass Nucleus. |
|
2,3.10
|
Version mise à jour pour la version 2.14.0 de Greengrass Nucleus. |
|
2.3.9
|
Version mise à jour pour la version 2.13.0 de Greengrass Nucleus. |
|
2.3.8
|
- Corrections de bugs et améliorations
-
|
|
2.3.7
|
- Corrections de bugs et améliorations
-
|
|
2.3.6
|
- Corrections de bugs et améliorations
-
|
|
2.3.5
|
Version mise à jour pour la version 2.12.0 de Greengrass Nucleus. |
|
2.3.4
|
- Corrections de bugs et améliorations
-
|
|
2.3.3
|
Version mise à jour pour la version 2.11.0 de Greengrass Nucleus. |
|
2.3.2
|
- Corrections de bugs et améliorations
-
|
|
2.3.1
|
- Corrections de bugs et améliorations
-
-
Corrige un problème susceptible d'empêcher la synchronisation des mises à jour de Cloud Shadow.
-
Résout un problème en raison duquel les modifications apportées à la configuration de synchronisation des ombres nommées ne s'appliquent qu'à une seule ombre nommée.
|
|
2.3.0
|
- Corrections de bugs et améliorations
-
|
|
2.2.4
|
- Corrections de bugs et améliorations
-
-
Résout un problème en raison duquel la validation de la taille de l'ombre n'était pas cohérente avec celle du cloud lors de la mise à jour du document fictif local.
-
Résout un problème en raison duquel le gestionnaire fantôme cesse d'écouter les mises à jour de configuration si un déploiement effectue une RESET opération sur les nœuds de configuration.
|
|
2.2.3
|
Version mise à jour pour la version 2.9.0 de Greengrass Nucleus. |
|
2.2.2
|
Version mise à jour pour la version 2.8.0 de Greengrass Nucleus. |
|
2.2.1
|
Version mise à jour pour la version 2.7.0 de Greengrass Nucleus.
|
|
2.2.0
|
- Nouvelles fonctionnalités
-
-
Ajoute la prise en charge du service parallèle local via l' publish/subscribe interface locale. Vous pouvez désormais communiquer avec le courtier de publish/subscribe messages local sur les sujets MQTT fictifs pour obtenir, mettre à jour et supprimer des ombres sur le périphérique principal. Cette fonctionnalité vous permet de connecter des appareils clients au service fantôme local en utilisant le pont MQTT pour relayer des messages sur des sujets parallèles entre les appareils clients et l' publish/subscribeinterface locale.
Cette fonctionnalité nécessite la version 2.6.0 ou une version ultérieure du composant Greengrass nucleus. Pour connecter les appareils clients au service fantôme local, vous devez également utiliser la version 2.2.0 ou ultérieure du composant MQTT Bridge.
-
Ajoute l'directionoption que vous pouvez configurer pour personnaliser la direction de synchronisation des ombres entre le service d'ombres local et le AWS Cloud. Vous pouvez configurer cette option pour réduire la bande passante et les connexions au AWS Cloud.
|
|
2.1.1
|
- Corrections de bugs et améliorations
-
-
Résout un problème selon lequel la profondeur maximale des reported sections desired et du document d'état fictif du périphérique JSON était de 4 niveaux au lieu de 5 niveaux.
-
Version mise à jour pour la version 2.6.0 de Greengrass Nucleus.
|
|
2.1.0
|
- Nouvelles fonctionnalités
-
|
|
2.0.6
|
Cette version contient des corrections de bugs et des améliorations.
|
|
2.0.5
|
Version mise à jour pour la version 2.5.0 de Greengrass Nucleus.
|
|
2.0.4
|
- Corrections de bugs et améliorations
-
-
Résout un problème en raison duquel le gestionnaire d'ombres supprimait les versions nouvellement créées de toute ombre précédemment supprimée.
-
Met à jour l'opération DeleteThingShadow IPC pour incrémenter la version fantôme lorsqu'elle est appelée.
|
|
2.0.3
|
Version mise à jour pour la version 2.4.0 de Greengrass Nucleus.
|
|
2.0.2
|
- Corrections de bugs et améliorations
-
-
Correction d'un problème qui empêchait le gestionnaire d'ombres de reconnaître la delta propriété lors de la synchronisation des états fantômes à partir de AWS IoT Core.
-
Correction d'un problème qui entraînait parfois la fusion incorrecte des demandes de synchronisation pour une ombre.
|
|
2.0.1
|
Version mise à jour pour la version 2.3.0 de Greengrass Nucleus.
|
|
2.0.0
|
Première version.
|
