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

# Referensi API Telemetri Lambda
<a name="telemetry-api-reference"></a>

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/`) dan`telemetry/`. Contoh:

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

Untuk definisi OpenAPI Specification (OAS) dari versi respons langganan`2025-01-29`, lihat berikut ini:
+ **HTTP** — [telemetry-api-http-schema.zip](samples/events_http_schema_v2025_01_29.zip)
+ **TCP** [— telemetry-api-tcp-schema .zip](samples/events_tcp_schema_v2025_01_29.zip)

**Topics**
+ [Langganan](#telemetry-subscribe-api)

## Langganan
<a name="telemetry-subscribe-api"></a>

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 valid: `"2025-01-29"`, `"2022-12-13"`, atau `"2022-07-01"`
    + **Catatan:** Instans Terkelola Lambda memerlukan. `"2025-01-29"` Versi ini kompatibel dengan fungsi Lambda (default).
  + **tujuan** — Pengaturan konfigurasi yang menentukan tujuan acara telemetri dan protokol untuk pengiriman acara.
    + Wajib: 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"` \$1 `"TCP"`
    + **URI** — URI untuk mengirim data telemetri ke.
      + Wajib: Ya
      + Tipe: String
    + Untuk informasi selengkapnya, lihat [Menentukan protokol tujuan](telemetry-api.md#telemetry-api-destination).
  + **jenis** — Jenis telemetri yang Anda inginkan untuk berlangganan ekstensi.
    + Wajib: Ya
    + Tipe: Array string
    + Nilai yang valid: `"platform"` \$1 `"function"` \$1 `"extension"`
  + **buffering** - Pengaturan konfigurasi untuk buffering acara.
    + Wajib: Tidak
    + Tipe: Objek

      ```
      {
         "buffering": {
              "maxItems": 1000,
              "maxBytes": 256*1024,
              "timeoutMs": 100
         }
      }
      ```
    + **maxItems** – Jumlah maksimum peristiwa untuk buffer dalam memori.
      + Wajib: Tidak
      + Jenis: Integer
      + Default: 1.000
      + Minimal: 1.000
      + Maksimum: 10.000.
    + **MaxBytes** — Volume maksimum telemetri (dalam byte) untuk buffer dalam memori.
      + Wajib: Tidak
      + Jenis: Integer
      + standar: 262.144
      + Minimal: 262.144
      + Maksimal: 1.048.576
    + **timeoutMs** – Waktu maksimum (dalam milidetik) untuk mem-buffer batch.
      + Wajib: Tidak
      + Jenis: Integer
      + Default: 1.000
      + Minimal: 25
      + Maksimal: 30.000
    + Untuk informasi selengkapnya, lihat [Mengkonfigurasi penggunaan memori dan buffering](telemetry-api.md#telemetry-api-buffering).

### Contoh Permintaan API Berlangganan
<a name="telemetry-subscribe-api-example"></a>

```
PUT http://${AWS_LAMBDA_RUNTIME_API}/2022-07-01/telemetry HTTP/1.1
{
   "schemaVersion": "2025-01-29",
   "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. 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