Avviso di fine del supporto: il 7 ottobre 2026, AWS il supporto per. AWS IoT Greengrass Version 1 Dopo il 7 ottobre 2026, non potrai più accedere alle risorse. AWS IoT Greengrass V1 Per ulteriori informazioni, visita [Migrate](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html) from. AWS IoT Greengrass Version 1
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à.
# Chiamata dell'API locale per il controllo dello stato di salute
AWS IoT Greengrass contiene un'API HTTP locale che fornisce un'istantanea dello stato corrente dei processi di lavoro locali avviati da. AWS IoT Greengrass Questa istantanea include funzioni Lambda definite dall'utente e funzioni Lambda di sistema. Le funzioni System Lambda fanno parte del software AWS IoT Greengrass Core. Vengono eseguite come processi di lavoro locali sul dispositivo principale e gestiscono operazioni come il routing dei messaggi, la sincronizzazione degli shadow locali e il rilevamento automatico degli indirizzi IP.
L'API per il controllo dello stato di salute supporta le seguenti richieste:
+ Invia una `GET` richiesta per [ottenere informazioni sanitarie per tutti i lavoratori](#health-check-get).
+ Invia una `POST` richiesta per [ottenere informazioni sanitarie per determinati lavoratori](#health-check-post).
Le richieste vengono inviate localmente sul dispositivo e non richiedono una connessione Internet.
## Ottieni informazioni sanitarie per tutti i lavoratori
Invia una `GET` richiesta per ottenere informazioni sanitarie su tutti i lavoratori che corrono.
+ Sostituisci {{port}} con il numero di porta dell'IPC.
```
GET http://localhost:{{port}}/2016-11-01/health/workers
```
`port`
Il numero di porta dell'IPC.
Il valore può variare tra 1024 e 65535. Il valore predefinito è 8000.
Per modificare questo numero di porta, è possibile aggiornare la `ggDaemonPort` proprietà nel `config.json` file. Per ulteriori informazioni, consulta [AWS IoT Greengrass file di configurazione di base](gg-core.md#config-json).
**Richiesta di esempio**
La seguente `curl` richiesta di esempio ottiene informazioni sanitarie per tutti i lavoratori.
```
curl http://localhost:8000/2016-11-01/health/workers
```
### Risposta JSON
Questa richiesta restituisce una serie di oggetti [informativi sulla salute dei lavoratori](#health-information-objects).
**Esempio di risposta**
La seguente risposta di esempio elenca gli oggetti informativi sullo stato di salute per tutti i processi di lavoro avviati da AWS 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
Invia una `POST` richiesta per ottenere informazioni sanitarie su determinati lavoratori. Sostituisci {{port}} con il numero di porta dell'IPC. L'impostazione predefinita è 8000.
```
POST http://localhost:{{port}}/2016-11-01/health/workers
```
**Richiesta di esempio**
La seguente `curl` richiesta di esempio ottiene informazioni sanitarie per determinati lavoratori.
```
curl --data "@body.json" http://localhost:8000/2016-11-01/health/workers
```
Ecco un esempio di corpo della `body.json` 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 un `FuncArns` array.
`FuncArns`
Un elenco di Amazon Resource Names (ARN) per le funzioni Lambda che rappresentano i lavoratori target.
+ Per le funzioni Lambda definite dall'utente, specifica l'ARN della versione attualmente distribuita. Se hai aggiunto funzioni Lambda al gruppo utilizzando un alias ARN, puoi utilizzare la richiesta GET per ottenere tutti i lavoratori e quindi scegliere gli ARN per cui desideri eseguire la query.
+ Per le funzioni Lambda di sistema, specificare l'ARN della funzione Lambda corrispondente. Per ulteriori informazioni, consulta [Funzioni Lambda del sistema](#system-lambda-functions).
Tipo: Array of Strings
Lunghezza minima: 1
Lunghezza massima: il numero totale di lavoratori avviati dal dispositivo AWS IoT Greengrass principale.
### Risposta JSON
Questa richiesta restituisce un `Workers` array e un `InvalidArns` array.
`Workers`
Un elenco di oggetti informativi sanitari per i lavoratori specificati.
Tipo: serie di [oggetti informativi sanitari](#health-information-objects)
`InvalidArns`
Un elenco di ARN di funzioni non validi, inclusi gli ARN di funzioni a cui non sono associati worker.
Tipo: Array of Strings
**Esempio di risposta**
La seguente risposta di esempio elenca gli [oggetti informativi sanitari per i lavoratori](#health-information-objects) 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:
400 - Richiesta non valida
Il corpo della richiesta non è valido. Per risolvere il problema, utilizzate il seguente formato e inviate nuovamente la richiesta:
```
{"FuncArns":["{{function-1-arn}}","{{function-2-arn}}"]}
```
400 La richiesta supera il numero massimo di lavoratori
Il numero di ARN specificato nell'`FuncArns`array supera il numero di worker.
## Informazioni sulla salute dei lavoratori
Un oggetto informativo sullo stato di salute contiene le seguenti proprietà:
`FuncArn`
L'ARN della funzione Lambda del sistema che rappresenta il lavoratore.
Tipo: `string`
`WorkerId`
L'ID del lavoratore. Questa proprietà può essere utile per il debug. I `runtime.log` file e i registri delle funzioni Lambda contengono l'ID del lavoratore, quindi questa proprietà può essere particolarmente utile per eseguire il debug di una funzione Lambda su richiesta che genera più istanze.
Tipo: `string`
`ProcessId`
L'ID di processo (PID) del processo di lavoro.
Tipo: `int`
`WorkerState`
Lo stato del lavoratore.
Tipo: `string`
I seguenti sono i possibili stati del lavoratore:
`Working`
Elaborazione di un messaggio.
`Waiting`
In attesa di un messaggio. Si applica alle funzioni Lambda di lunga durata eseguite come demone o processo autonomo.
`Starting`
Spun up, inizio.
`FailedInitialization`
Inizializzazione non riuscita.
`Terminated`
Fermato dal demone Greengrass
`NotStarted`
Avvio non riuscito. Sto effettuando un altro tentativo di partenza.
`Initialized`
Inizializzato con successo.
### Funzioni Lambda del sistema
È possibile richiedere informazioni sullo stato di salute per le seguenti funzioni Lambda del sistema:
`GGCloudSpooler`
Gestisce la coda per i messaggi MQTT che hanno AWS IoT Core come origine o destinazione.
ARN: `arn:aws:lambda:::function:GGCloudSpooler:1`
`GGConnManager`
Instrada i messaggi MQTT tra i dispositivi core e client di Greengrass.
ARN: `arn:aws:lambda:::function:GGConnManager`
`GGDeviceCertificateManager`
Ascolta l' AWS IoT ombra per rilevare le modifiche agli endpoint IP del core e genera il certificato lato server utilizzato da per l'autenticazione reciproca. GGConnManager
ARN: `arn:aws:lambda:::function:GGDeviceCertificateManager`
`GGIPDetector`
Gestisce il rilevamento automatico degli indirizzi IP che consente ai dispositivi del gruppo Greengrass di scoprire il dispositivo principale Greengrass. Questo servizio non è applicabile quando gli indirizzi IP vengono forniti manualmente.
ARN: `arn:aws:lambda:::function:GGIPDetector:1`
`GGSecretManager`
Gestisce l'archiviazione sicura dei segreti locali e l'accesso tramite Lambda e connettori definiti dall'utente.
ARN: `arn:aws:lambda:::function:GGSecretManager:1`
`GGShadowService`
Gestisce le ombre locali per i dispositivi client.
ARN: `arn:aws:lambda:::function:GGShadowService`
`GGShadowSyncManager`
Sincronizza le ombre locali con quelle Cloud AWS per il dispositivo principale e i dispositivi client, se la `syncShadow` proprietà del dispositivo è impostata su. `true`
ARN: `arn:aws:lambda:::function:GGShadowSyncManager`
`GGStreamManager`
Elabora i flussi di dati localmente ed esegue esportazioni automatiche verso. Cloud AWS
ARN: `arn:aws:lambda:::function:GGStreamManager:1`
`GGTES`
Il servizio di scambio di token locale che recupera le credenziali IAM definite nel ruolo del gruppo Greengrass utilizzato dal codice locale per accedere ai servizi. AWS
ARN: `arn:aws:lambda:::function:GGTES`