Referensi API Telemetri Lambda - AWS Lambda
Langganan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Referensi API Telemetri Lambda

Gunakan titik akhir API Telemetri Lambda untuk berlangganan ekstensi ke aliran telemetri. Anda dapat mengambil titik akhir API Telemetri dari variabel lingkungan. AWS_LAMBDA_RUNTIME_API Untuk mengirim permintaan API, tambahkan versi API (2022-07-01/) dantelemetry/. Sebagai contoh:

http://${AWS_LAMBDA_RUNTIME_API}/2022-07-01/telemetry/

Untuk definisi OpenAPI Specification (OAS) dari versi respons langganan2022-12-13, lihat berikut ini:

Operasi API

Langganan

Untuk berlangganan aliran telemetri, ekstensi Lambda dapat mengirim permintaan API Berlangganan.

  • Jalur – /telemetry

  • Metode - PUT

  • Header

    • Content-Type: application/json

  • Minta parameter tubuh

    • SchemaVersion

      • Wajib: Ya

      • Tipe: String

      • Nilai yang valid: "2022-12-13" atau "2022-07-01"

    • tujuan — Pengaturan konfigurasi yang menentukan tujuan acara telemetri dan protokol untuk pengiriman acara.

      • Diperlukan: Ya

      • Tipe: Objek

        {
    "protocol": "HTTP",
    "URI": "http://sandbox.localdomain:8080"
}

      • Protokol — Protokol yang digunakan Lambda untuk mengirim data telemetri.

        • Wajib: Ya

        • Tipe: String

        • Nilai yang valid: "HTTP" | "TCP"

      • URI — URI untuk mengirim data telemetri ke.

        • Wajib: Ya

        • Tipe: String

      • Untuk informasi selengkapnya, lihat Menentukan protokol tujuan.

    • jenis — Jenis telemetri yang Anda inginkan untuk berlangganan ekstensi.

      • Diperlukan: Ya

      • Tipe: Array string

      • Nilai yang valid: "platform" | "function" | "extension"

    • buffering - Pengaturan konfigurasi untuk buffering acara.

      • Diperlukan: Tidak

      • Tipe: Objek

        {
   "buffering": {
        "maxItems": 1000,
        "maxBytes": 256*1024,
        "timeoutMs": 100
   }
}

      • maxItems – Jumlah maksimum peristiwa untuk buffer dalam memori.

        • Diperlukan: Tidak

        • Jenis: Integer

        • Default: 1.000

        • Minimal: 1.000

        • Maksimum: 10.000.

      • MaxBytes — Volume maksimum telemetri (dalam byte) untuk buffer dalam memori.

        • Diperlukan: Tidak

        • Jenis: Integer

        • standar: 262.144

        • Minimal: 262.144

        • Maksimal: 1.048.576

      • timeoutMs – Waktu maksimum (dalam milidetik) untuk mem-buffer batch.

        • Diperlukan: Tidak

        • Jenis: Integer

        • Default: 1.000

        • Minimal: 25

        • Maksimal: 30.000

      • Untuk informasi selengkapnya, lihat Mengkonfigurasi penggunaan memori dan buffering.

Contoh Permintaan API Berlangganan

PUT http://${AWS_LAMBDA_RUNTIME_API}/2022-07-01/telemetry HTTP/1.1
{
   "schemaVersion": "2022-12-13",
   "types": [
        "platform",
        "function",
        "extension"
   ],
   "buffering": {
        "maxItems": 1000,
        "maxBytes": 256*1024,
        "timeoutMs": 100
   },
   "destination": {
        "protocol": "HTTP",
        "URI": "http://sandbox.localdomain:8080"
   }
}

Jika permintaan Berlangganan berhasil, ekstensi menerima respons sukses HTTP 200:

HTTP/1.1 200 OK
"OK"

Jika permintaan Berlangganan gagal, ekstensi menerima respons kesalahan. Sebagai contoh:

HTTP/1.1 400 OK
{
    "errorType": "ValidationError",
    "errorMessage": "URI port is not provided; types should not be empty"
}

Berikut adalah beberapa kode respons tambahan yang dapat diterima ekstensi:

  • 200 – Permintaan berhasil diselesaikan

  • 202 – Permintaan diterima. Respons permintaan berlangganan di lingkungan pengujian lokal

  • 400 — Permintaan buruk

  • 500 – Kesalahan Layanan