AWS IoT Greengrass Version 1 è entrato nella fase di estensione della vita utile il 30 giugno 2023. Per ulteriori informazioni, consulta la politica AWS IoT Greengrass V1 di manutenzione. Dopo questa data, AWS IoT Greengrass V1 non rilascerà aggiornamenti che forniscano funzionalità, miglioramenti, correzioni di bug o patch di sicurezza. I dispositivi che funzionano AWS IoT Greengrass V1 non subiranno interruzioni e continueranno a funzionare e a connettersi al cloud. Ti consigliamo vivamente di eseguire la migrazione a AWS IoT Greengrass Version 2, che aggiunge nuove importanti funzionalità e supporto per piattaforme aggiuntive.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Chiamare l'API di controllo dello stato locale

AWS IoT Greengrasscontiene un'API HTTP locale che fornisce un'istantanea dello stato corrente dei processi di lavoro locali avviati daAWS IoT Greengrass. Questa istantanea include funzioni Lambda definite dall'utente e funzioni Lambda di sistema. Le funzioni di System Lambda fanno parte delAWS IoT GreengrassSoftware Core. Funzionano come processi di lavoro locale sul dispositivo core e gestiscono operazioni quali instradamento di messaggi, sincronizzazione shadow locale e rilevamento automatico dell'indirizzo IP.

L'API del controllo dello stato supporta le seguenti richieste:

Le richieste vengono inviate localmente sul dispositivo e non richiedono una connessione Internet.

Ottieni informazioni sanitarie per tutti i lavoratori

Inviare una richiestaGETrichiesta di ottenere informazioni sanitarie su tutti i lavoratori in corsa.

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

Richiesta di esempio

L'esempio seguentecurlrequest ottiene informazioni sanitarie per tutti i lavoratori.

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

Risposta JSON

Questa richiesta restituisce un array diinformazioni sulla salute dei lavoratoriobjects.

Risposta di esempio

La seguente risposta di esempio elenca gli oggetti di informazioni sullo stato per tutti i processi di lavoro avviati daAWS 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"
    },
    ...
]

Ottieni informazioni sanitarie su determinati lavoratori

Inviare una richiestaPOSTrichiesta di ottenere informazioni sanitarie su determinati lavoratori. Replace (Sostituisci)portocon il numero di porta dell'IPC. Il valore di default è 8000.

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

Richiesta di esempio

L'esempio seguentecurlrequest ottiene informazioni sanitarie per i lavoratori specificati.

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

Ecco un esempio:body.jsoncorpo della richiesta:

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

Il corpo della richiesta contiene unFuncArnsmatrice.

Risposta JSON

Questa richiesta restituisce unWorkersmatrice e unInvalidArnsmatrice.

Risposta di esempio

I seguenti elenchi di risposte di esempiooggetti di informazione sanitariaper i lavoratori specificati.

{ 
    "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"
    ]
}

Questa richiesta restituisce i seguenti errori:

Informazioni sulla salute dei lavoratori

Un oggetto di informazioni sulla salute include le seguenti proprietà:

Funzioni System Lambda

È possibile richiedere informazioni sanitarie per le seguenti funzioni Lambda del sistema: