AWS IoT Greengrass Version 1 est entré dans la phase de durée de vie prolongée le 30 juin 2023. Pour plus d'informations, consultez la politique de AWS IoT Greengrass V1 maintenance. Après cette date, AWS IoT Greengrass V1 ne publiera pas de mises à jour fournissant des fonctionnalités, des améliorations, des corrections de bogues ou des correctifs de sécurité. Les appareils qui fonctionnent AWS IoT Greengrass V1 sous tension ne seront pas perturbés et continueront à fonctionner et à se connecter au cloud. Nous vous recommandons vivement de migrer vers AWS IoT Greengrass Version 2, qui ajoute de nouvelles fonctionnalités importantes et prend en charge des plateformes supplémentaires.

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.

Appel de l'API de contrôle de santé locale

AWS IoT Greengrasscontient une API HTTP locale qui fournit un instantané de l'état actuel des processus de travail locaux démarrés parAWS IoT Greengrass. Cet instantané inclut des fonctions Lambda définies par l'utilisateur et des fonctions Lambda système. Les fonctions Lambda du système font partie de laAWS IoT GreengrassLogiciel Core. Ils s'exécutent comme des processus de travail local sur l'appareil principal et gèrent les opérations telles que le routage des messages, la synchronisation du shadow local et la détection automatique d'adresse IP automatique.

L'API de contrôle de santé prend en charge les demandes suivantes :

Les demandes sont envoyées localement sur l'appareil et ne nécessitent pas de connexion Internet.

Obtenir des informations de santé pour tous les travailleurs

Envoyez une demandeGETdemande pour obtenir des informations de santé sur tous les travailleurs en cours d'exécution.

GET http://localhost:port/2016-11-01/health/workers

Exemple de demande

L'exemple suivantcurlrequest obtient des informations de santé pour tous les travailleurs.

curl http://localhost:8000/2016-11-01/health/workers

Réponse JSON

Cette demande renvoie un tableau deRenseignements personnels sur la santéobjets.

Exemple de réponse

L'exemple de réponse suivant répertorie les objets d'informations d'intégrité pour tous les processus de travail qui ont été démarrés parAWS IoT Greengrass.

[
    {
      "FuncArn": "arn:aws:lambda:::function:GGShadowService:1",
      "WorkerId" : "65515053-2f70-43dc-7cc0-1712bEXAMPLE",
      "ProcessId": "1234",
      "WorkerState": "Waiting"
    },
    {
      "FuncArn": "arn:aws:lambda:::function:GGSecretManager:1",
      "WorkerId": "a9916cc2-1b4d-4f0e-4b12-b1872EXAMPLE",
      "ProcessId": "9798",
      "WorkerState": "Waiting"
    },
    {
      "FuncArn": "arn:aws:lambda:us-west-2:123456789012:function:my-lambda-function:3",
      "WorkerId": "2e6f785e-66a5-42c9-67df-42073EXAMPLE",
      "ProcessId": "11837",
      "WorkerState": "Waiting"
    },
    ...
]

Obtenir des informations sur la santé de certains travailleurs

Envoyez une demandePOSTdemande d'obtenir des informations sur la santé de certains travailleurs. Remplacezportavec le numéro de port de l'IPC. La valeur par défaut est 8 000.

POST http://localhost:port/2016-11-01/health/workers

Exemple de demande

L'exemple suivantcurlrequest obtient des informations de santé pour des travailleurs spécifiques.

curl --data "@body.json" http://localhost:8000/2016-11-01/health/workers

Voici un exemplebody.jsoncorps de la demande :

{
    "FuncArns": [
        "arn:aws:lambda:::function:GGShadowService:1",
        "arn:aws:lambda:us-west-2:123456789012:function:my-lambda-function:3"
    ]
}

Le corps de la demande contient unFuncArnstableau.

Réponse JSON

Cette demande renvoie unWorkerstableau et unInvalidArnstableau.

Exemple de réponse

Les exemples de listes de réponses suivantsobjets sur la santépour les travailleurs spécifiés.

{ 
    "Workers": [
        {
            "FuncArn": "arn:aws:lambda:::function:GGShadowService:1",
            "WorkerId" : "65515053-2f70-43dc-7cc0-1712bEXAMPLE",
            "ProcessId": "1234",
            "WorkerState": "Waiting"
        },
        {
            "FuncArn": "arn:aws:lambda:us-west-2:123456789012:function:my-lambda-function:3",
            "WorkerId": "2e6f785e-66a5-42c9-67df-42073ESAMPLE",
            "ProcessId": "11837",
            "WorkerState": "Waiting"
        }
    ],
    "InvalidArns" : [
        "some-malformed-arn", 
        "arn:aws:lambda:us-west-2:123456789012:function:some-unknown-function:1"
    ]
}

Cette demande renvoie les erreurs suivantes :

Renseignements personnels sur la santé

Un objet d'information sur la santé contient les propriétés suivantes :

Fonctions Lambda du système

Vous pouvez demander des informations d'intégrité pour les fonctions Lambda système suivantes :