Menerapkan pola penemuan titik akhir - Amazon Timestream

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

Menerapkan pola penemuan titik akhir

Untuk menerapkan pola penemuan titik akhir, pilih API (Tulis atau Kueri), buat DescribeEndpointspermintaan, dan gunakan titik akhir yang dikembalikan selama durasi TTL nilai yang dikembalikan. Prosedur implementasi dijelaskan di bawah ini.

catatan

Pastikan Anda terbiasa dengan catatan penggunaan.

Prosedur implementasi

  1. Dapatkan titik akhir untuk API Anda ingin melakukan panggilan terhadap (Tulis atau Kueri). menggunakan DescribeEndpointspermintaan.

    1. Buat permintaan DescribeEndpointsyang sesuai dengan minat (Tulis atau Kueri) menggunakan salah satu dari dua titik akhir yang dijelaskan di bawah ini. API Tidak ada parameter input untuk permintaan tersebut. Pastikan Anda membaca catatan di bawah ini.

      MenulisSDK:
      ingest.timestream.<region>.amazonaws.com
      PermintaanSDK:
      query.timestream.<region>.amazonaws.com

      Contoh CLI panggilan untuk wilayah us-east-1 berikut.

      REGION_ENDPOINT="https://query.timestream.us-east-1.amazonaws.com" REGION=us-east-1 aws timestream-write describe-endpoints \ --endpoint-url $REGION_ENDPOINT \ --region $REGION
      catatan

      Header HTTP “Host” juga harus berisi API titik akhir. Permintaan akan gagal jika header tidak diisi. Ini adalah persyaratan standar untuk semua permintaan HTTP /1.1. Jika Anda menggunakan HTTP pustaka yang mendukung 1.1 atau yang lebih baru, HTTP pustaka harus secara otomatis mengisi header untuk Anda.

      catatan

      Pengganti <region> dengan pengidentifikasi wilayah untuk wilayah tempat permintaan sedang dibuat, mis. us-east-1

    2. Parse respon untuk mengekstrak endpoint (s), dan TTL nilai cache (s). Responsnya adalah array dari satu atau lebih Endpointobjek. Setiap Endpoint objek berisi alamat titik akhir (Address) dan TTL untuk titik akhir itu (CachePeriodInMinutes).

  2. Cache titik akhir hingga yang ditentukanTTL.

  3. Ketika TTL kedaluwarsa, ambil titik akhir baru dengan memulai dari awal pada langkah 1 Implementasi.

Catatan penggunaan untuk pola penemuan titik akhir

  • DescribeEndpointsTindakan ini adalah satu-satunya tindakan yang dikenali oleh titik akhir regional Timestream Live Analytics.

  • Respons berisi daftar titik akhir untuk membuat API panggilan Timestream Live Analytics melawan.

  • Pada respons yang berhasil, setidaknya harus ada satu titik akhir dalam daftar. Jika ada lebih dari satu titik akhir dalam daftar, salah satu dari mereka sama-sama dapat digunakan untuk API panggilan, dan pemanggil dapat memilih titik akhir untuk digunakan secara acak.

  • Selain DNS alamat titik akhir, setiap titik akhir dalam daftar akan menentukan waktu untuk hidup (TTL) yang diizinkan untuk menggunakan titik akhir yang ditentukan dalam menit.

  • Titik akhir harus di-cache dan digunakan kembali untuk jumlah waktu yang ditentukan oleh TTL nilai yang dikembalikan (dalam menit). Setelah TTL kedaluwarsa, panggilan baru DescribeEndpointsharus dilakukan untuk menyegarkan titik akhir yang akan digunakan, karena titik akhir tidak akan berfungsi lagi setelah kedaluwarsaTTL.