Menggunakan API runtime Lambda untuk runtime khusus

AWS Lambda menyediakan HTTP API untuk runtime khusus untuk menerima peristiwa pemanggilan dari Lambda dan mengirim data respons kembali dalam lingkungan eksekusi Lamb da. Bagian ini berisi referensi API untuk Lambda runtime API.

Spesifikasi OpenAPI untuk versi API runtime 2018-06-01 tersedia di runtime-api.zip

Untuk membuat URL permintaan API, runtime mendapatkan titik akhir API dari variabel lingkungan AWS_LAMBDA_RUNTIME_API, menambahkan versi API, dan menambahkan jalur sumber daya yang diinginkan.

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

Invokasi berikutnya

Jalur – /runtime/invocation/next

Metode – GET

Runtime mengirimkan pesan ini ke Lambda untuk meminta peristiwa invokasi. Isi respons berisi muatan dari invokasi, yang merupakan dokumen JSON yang berisi data kejadian dari pemicu fungsi. Header respons berisi data tambahan tentang invokasi.

Jangan atur waktu habis permintaan GET karena respons dapat tertunda. Antara saat Lambda mem-bootstrap runtime dan ketika runtime memiliki peristiwa untuk dikembalikan, proses runtime mungkin dibekukan selama beberapa detik.

ID permintaan (Lambda-Runtime-Aws-Request-Id) mengidentifikasi peristiwa unik. ID permintaan disediakan oleh sumber peristiwa atau dibuat secara otomatis oleh Lambda saat dicerna. Gunakan ID permintaan di jalur URL saat mengirim respons atau kesalahan.

ID pemanggilan (Lambda-Runtime-Invocation-Id) mewakili upaya pemanggilan tunggal untuk suatu peristiwa. ID permintaan tunggal dapat menghasilkan beberapa upaya pemanggilan, masing-masing dengan ID pemanggilan uniknya sendiri. Lambda menggunakan setiap ID pemanggilan tepat sekali dan tidak pernah menggunakannya kembali. Mengemakan nilai ini kembali /response dan men /error elepon. Header bersifat opsional untuk kompatibilitas mundur dengan runtime yang ada—menghilangkannya tidak memicu penolakan. Lambda hanya menolak 400 InvalidInvocationId saat header ada tetapi nilainya tidak cocok dengan pemanggilan aktif.

Header pelacakan berisi ID jejak, ID induk, dan keputusan penyampelan. Jika permintaan diambil sampelnya, permintaan diambil sampelnya oleh Lambda atau layanan hulu. Waktu pengoperasian harus menetapkan _X_AMZN_TRACE_ID dengan nilai header. X-Ray SDK membaca ini untuk mendapatkan ID dan menentukan apakah akan melacak permintaan.

Respons invokasi

Jalur – /runtime/invocation/AwsRequestId/response

Metode – POST

Setelah fungsi selesai dijalankan, runtime mengirimkan respon invokasi untuk Lambda. Untuk invokasi sinkron, Lambda mengirimkan respons ke klien.

Minta header

Lambda-Runtime-Invocation-Id— Gema kembali nilai yang diterima dari/next. Lambda menolak permintaan 400 InvalidInvocationId jika nilainya tidak cocok dengan pemanggilan aktif.

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"

Kesalahan inisialisasi

Jika fungsi mengembalikan kesalahan atau runtime mengalami kesalahan saat inisialisasi, runtime menggunakan metode ini untuk melaporkan kesalahan ke Lambda.

Jalur – /runtime/init/error

Metode – POST

Header

Lambda-Runtime-Function-Error-Type- Jenis kesalahan yang ditemui runtime. Header ini opsional. Lambda menerima nilai string apa pun; kami sarankan menggunakan format<Category.Reason>, di mana Kategori adalah Runtime atau Function dan Alasan dimulai dengan huruf besar. Contoh:

Nilai yang tidak cocok dengan pola ini dinormalisasi ke Runtime.Unknown atauFunction.Unknown.

Parameter tubuh

ErrorRequest – Informasi tentang kesalahan. Wajib: tidak.

Bidang ini adalah objek JSON dengan struktur berikut:

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

Perhatikan bahwa Lambda menerima nilai apa pun untuk errorType.

Contoh berikut menunjukkan pesan kesalahan fungsi Lambda ketika fungsi tidak dapat mengurai data peristiwa yang disediakan dalam invokasi.

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

Kesalahan invokasi

Jika fungsi mengembalikan kesalahan atau runtime mengalami kesalahan, runtime menggunakan metode ini untuk melaporkan kesalahan ke Lambda.

Jalur – /runtime/invocation/AwsRequestId/error

Metode – POST

Header

Lambda-Runtime-Function-Error-Type- Jenis kesalahan yang ditemui runtime. Wajib: tidak.

Header ini terdiri dari nilai string. Lambda menerima string apa pun, tetapi kami merekomendasikan format <category.reason>. Contoh:

Lambda-Runtime-Invocation-Id— Gema kembali nilai yang diterima dari/next. Lambda menolak permintaan 400 InvalidInvocationId jika nilainya tidak cocok dengan pemanggilan aktif.

Parameter tubuh

ErrorRequest – Informasi tentang kesalahan. Wajib: tidak.

Bidang ini adalah objek JSON dengan struktur berikut:

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

Perhatikan bahwa Lambda menerima nilai apa pun untuk errorType.

Contoh berikut menunjukkan pesan kesalahan fungsi Lambda ketika fungsi tidak dapat mengurai data peristiwa yang disediakan dalam invokasi.

{
      "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 (hanya berlaku untuk SnapStart)

Jalur – /runtime/restore/next

Metode – GET

Setelah kait pra-snapshot selesai, runtime memang GET /runtime/restore/next gil. Ini adalah panggilan pemblokiran gaya iterator, mirip dengan/runtime/invocation/next, yang memberi sinyal ke Lambda bahwa runtime siap untuk lingkungan eksekusi untuk di-snapshot. Permintaan memblokir hingga Lambda mengembalikan lingkungan eksekusi dari snapshot, kemudian mengembalikan respons HTTP 200 dengan tubuh kosong.

Header

Tidak ada header yang diperlukan.

Sintaksis Permintaan

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

Sintaksis Respons

HTTP/1.1 200 OK
Content-Length: 0

Kesalahan pemulihan (hanya berlaku untuk SnapStart)

Jika hook setelah pemulihan gagal atau runtime mengalami kesalahan selama pemulihan, runtime menggunakan metode ini untuk melaporkan kesalahan ke Lambda. Lambda gagal dalam pemanggilan dalam penerbangan dan meruntuhkan lingkungan eksekusi.

Jalur – /runtime/restore/error

Metode – POST

Header

Lambda-Runtime-Function-Error-Type- Jenis kesalahan yang ditemui runtime. Header ini opsional. Lambda menerima nilai string apa pun; kami sarankan menggunakan format<Category.Reason>, di mana Kategori adalah Runtime atau Function dan Alasan dimulai dengan huruf besar (misalnya,Runtime.AfterRestoreError). Nilai yang tidak cocok dengan pola ini dinormalisasi ke Runtime.Unknown atauFunction.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"}