Utilizzo dell'API di runtime Lambda per runtime personalizzati

AWS Lambda fornisce un'API HTTP per runtime personalizzati per ricevere eventi di chiamata da Lambda e inviare i dati di risposta all'interno dell'ambiente di esecuzione Lambda. Runtime Lambda In questa sezione è riportato il riferimento API per l'API di runtime Lambda.

La specifica OpenAPI per l'API runtime versione 2018-06-01 è disponibile qui: runtime-api.zip

Per creare un URL di richiesta API, i runtime ottengono l'endpoint API dalla variabile d'ambiente AWS_LAMBDA_RUNTIME_API, aggiungere la versione dell'API e aggiungere il percorso della risorsa desiderato.

curl "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/next"

Chiamata successiva

Percorso – /runtime/invocation/next

Metodo – GET

Il runtime invia questo messaggio a Lambda per richiedere un evento di chiamata. Il corpo della risposta contiene il payload della chiamata che è un documento JSON contenente i dati dell'evento dal trigger della funzione. Le intestazioni della risposta contengono dati aggiuntivi sulla chiamata.

Non impostare un timeout sulla richiesta GET in quanto la risposta potrebbe essere ritardata. Tra il momento in cui Lambda avvia il runtime e il momento in cui il runtime ha un evento da restituire, il processo di runtime potrebbe rimanere bloccato per diversi secondi.

Un ID di richiesta (Lambda-Runtime-Aws-Request-Id) identifica un evento univoco. Gli ID delle richieste sono forniti dalle fonti di eventi o generati automaticamente da Lambda al momento dell'inserimento. Utilizza l'ID della richiesta nel percorso dell'URL quando invii la risposta o l'errore.

Un ID di chiamata (Lambda-Runtime-Invocation-Id) rappresenta un singolo tentativo di chiamata per un evento. Un singolo ID di richiesta può comportare più tentativi di chiamata, ciascuno con il proprio ID di chiamata univoco. Lambda utilizza ogni ID di chiamata esattamente una volta e non lo riutilizza mai. Riattiva questo valore e chiama. /response /error L'intestazione è opzionale per la retrocompatibilità con i runtime esistenti: la sua omissione non comporta un rifiuto. Lambda rifiuta solo 400 InvalidInvocationId quando l'intestazione è presente, ma il suo valore non corrisponde alla chiamata attiva.

L'intestazione di traccia contiene l'ID di traccia, l'ID dell'elemento padre e la selezione per il campionamento. Se la richiesta viene campionata, la richiesta è stata campionata da Lambda o da un servizio upstream. Il runtime deve impostare _X_AMZN_TRACE_ID sul valore dell'intestazione. L' X-Ray SDK lo legge per ottenere gli ID e determinare se tracciare la richiesta.

Risposta all'invocazione

Percorso – /runtime/invocation/AwsRequestId/response

Metodo – POST

Una volta che la funzione è stata eseguita fino al completamento, il runtime invia una risposta di chiamata a Lambda. Per le chiamate sincrone, Lambda invia la risposta al client.

Intestazioni della richiesta

Lambda-Runtime-Invocation-Id— Restituisce il valore ricevuto da. /next Lambda rifiuta la richiesta con 400 InvalidInvocationId se il valore non corrisponde alla chiamata attiva.

REQUEST_ID=156cb537-e2d4-11e8-9b34-d36013741fb9
INVOCATION_ID=<value from Lambda-Runtime-Invocation-Id response header>
curl "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/$REQUEST_ID/response"  -d "SUCCESS" --header "Lambda-Runtime-Invocation-Id: $INVOCATION_ID"

Errore di inizializzazione

Se la funzione restituisce un errore o il runtime rileva un errore durante l'inizializzazione, il runtime utilizzerà questo metodo per segnalare l'errore a Lambda.

Percorso – /runtime/init/error

Metodo – POST

Headers

Lambda-Runtime-Function-Error-Type: il tipo di errore rilevato dal runtime. Questa intestazione è opzionale. Lambda accetta qualsiasi valore di stringa; consigliamo di utilizzare il formato<Category.Reason>, dove Category è Runtime o Function e Reason inizia con una lettera maiuscola. Ad esempio:

I valori che non corrispondono a questo modello vengono normalizzati in Runtime.Unknown oFunction.Unknown.

Parametri corpo

ErrorRequest – Informazioni sull'errore. Campo obbligatorio: no.

Questo campo è un oggetto JSON con la seguente struttura:

{
      errorMessage: string (text description of the error),
      errorType: string,
      stackTrace: array of strings
}

NB: Lambda accetta qualsiasi valore per errorType.

Nell'esempio seguente viene mostrato un messaggio di errore della funzione Lambda in cui la funzione non è stata in grado di analizzare i dati evento forniti nell'invocazione.

{
      "errorMessage" : "Error parsing event data.",
      "errorType" : "InvalidEventDataException",
      "stackTrace": [ ]
}      

ERROR="{\"errorMessage\" : \"Failed to load function.\", \"errorType\" : \"InvalidFunctionException\"}"
curl "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/init/error" -d "$ERROR" --header "Lambda-Runtime-Function-Error-Type: Unhandled"

Errore della chiamata

Se la funzione restituisce un errore o il runtime rileva un errore, il runtime utilizzerà questo metodo per segnalare l'errore a Lambda.

Percorso – /runtime/invocation/AwsRequestId/error

Metodo – POST

Headers

Lambda-Runtime-Function-Error-Type – Tipo di errore rilevato dal runtime. Campo obbligatorio: no.

L'intestazione è costituita da un valore stringa. Lambda accetta qualsiasi stringa, ma si consiglia di utilizzare il formato <categoria.motivo>. Ad esempio:

Lambda-Runtime-Invocation-Id— Restituisce il valore ricevuto da/next. Lambda rifiuta la richiesta con 400 InvalidInvocationId se il valore non corrisponde alla chiamata attiva.

Parametri corpo

ErrorRequest – Informazioni sull'errore. Campo obbligatorio: no.

Questo campo è un oggetto JSON con la seguente struttura:

{
      errorMessage: string (text description of the error),
      errorType: string,
      stackTrace: array of strings
}

NB: Lambda accetta qualsiasi valore per errorType.

Nell'esempio seguente viene mostrato un messaggio di errore della funzione Lambda in cui la funzione non è stata in grado di analizzare i dati evento forniti nell'invocazione.

{
      "errorMessage" : "Error parsing event data.",
      "errorType" : "InvalidEventDataException",
      "stackTrace": [ ]
}      

REQUEST_ID=156cb537-e2d4-11e8-9b34-d36013741fb9
ERROR="{\"errorMessage\" : \"Error parsing event data.\", \"errorType\" : \"InvalidEventDataException\"}"
curl "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/$REQUEST_ID/error" -d "$ERROR" --header "Lambda-Runtime-Function-Error-Type: Unhandled"

After-Restore (applicabile solo per SnapStart)

Percorso – /runtime/restore/next

Metodo – GET

Una volta completati gli hook pre-snapshot, il runtime chiama. GET /runtime/restore/next Si tratta di una chiamata di blocco in stile iteratore, simile a/runtime/invocation/next, che segnala a Lambda che il runtime è pronto per l'istantanea dell'ambiente di esecuzione. La richiesta si blocca finché Lambda non ripristina l'ambiente di esecuzione da un'istantanea, quindi restituisce una risposta HTTP 200 con un corpo vuoto.

Headers

Non sono richieste intestazioni.

Sintassi della richiesta

GET /2018-06-01/runtime/restore/next HTTP/1.1
Host: ${AWS_LAMBDA_RUNTIME_API}

Sintassi della risposta

HTTP/1.1 200 OK
Content-Length: 0

Errore di ripristino (applicabile solo per) SnapStart

Se un hook dopo il ripristino fallisce o il runtime rileva un errore durante il ripristino, utilizza questo metodo per segnalare l'errore a Lambda. Lambda fallisce l'invocazione in corso e distrugge l'ambiente di esecuzione.

Percorso – /runtime/restore/error

Metodo – POST

Headers

Lambda-Runtime-Function-Error-Type: il tipo di errore rilevato dal runtime. Questa intestazione è opzionale. Lambda accetta qualsiasi valore di stringa; consigliamo di utilizzare il formato<Category.Reason>, dove Category è Runtime o Function e Reason inizia con una lettera maiuscola (ad esempio,). Runtime.AfterRestoreError I valori che non corrispondono a questo modello vengono normalizzati in o. Runtime.Unknown Function.Unknown

POST /2018-06-01/runtime/restore/error HTTP/1.1
Host: ${AWS_LAMBDA_RUNTIME_API}
Lambda-Runtime-Function-Error-Type: Runtime.AfterRestoreError

HTTP/1.1 202 Accepted
Content-Type: application/json

{"status":"OK"}