Untuk kemampuan serupa dengan Amazon Timestream LiveAnalytics, pertimbangkan Amazon Timestream untuk InfluxDB. Ini menawarkan konsumsi data yang disederhanakan dan waktu respons kueri milidetik satu digit untuk analitik waktu nyata. Pelajari lebih lanjut [di sini](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).

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

# Menggunakan API
<a name="Using.API"></a>

 Selain itu [SDKs](getting-started-sdks.md), Amazon Timestream for LiveAnalytics menyediakan akses REST API langsung melalui pola penemuan *titik akhir*. Pola penemuan titik akhir dijelaskan di bawah ini, bersama dengan kasus penggunaannya. 

## Pola penemuan titik akhir
<a name="Using-API.endpoint-discovery"></a>

Karena Timestream Live Analytics SDKs dirancang untuk bekerja secara transparan dengan arsitektur layanan, termasuk pengelolaan dan pemetaan titik akhir layanan, disarankan agar Anda menggunakannya untuk sebagian besar aplikasi. SDKs Namun, ada beberapa contoh di mana penggunaan pola penemuan titik akhir Timestream untuk LiveAnalytics REST API diperlukan: 
+ Anda menggunakan [titik akhir VPC (AWS PrivateLink)](VPCEndpoints.md) dengan Timestream untuk LiveAnalytics
+ Aplikasi Anda menggunakan bahasa pemrograman yang belum memiliki dukungan SDK
+ Anda memerlukan kontrol yang lebih baik atas implementasi sisi klien

Bagian ini mencakup informasi tentang cara kerja pola penemuan titik akhir, cara menerapkan pola penemuan titik akhir, dan catatan penggunaan. Pilih topik di bawah ini untuk mempelajari lebih lanjut. 

**Topics**
+ [

## Pola penemuan titik akhir
](#Using-API.endpoint-discovery)
+ [

# Cara kerja pola penemuan titik akhir
](Using-API.endpoint-discovery.how-it-works.md)
+ [

# Menerapkan pola penemuan titik akhir
](Using-API.endpoint-discovery.describe-endpoints.implementation.md)

# Cara kerja pola penemuan titik akhir
<a name="Using-API.endpoint-discovery.how-it-works"></a>

 Timestream dibangun menggunakan [arsitektur seluler](architecture.md#cells) untuk memastikan properti penskalaan dan isolasi lalu lintas yang lebih baik. Karena setiap akun pelanggan dipetakan ke sel tertentu di suatu wilayah, aplikasi Anda harus menggunakan titik akhir khusus sel yang benar tempat akun Anda telah dipetakan. Saat menggunakan SDKs, pemetaan ini ditangani secara transparan untuk Anda dan Anda tidak perlu mengelola titik akhir khusus sel. Namun, saat mengakses REST API secara langsung, Anda harus mengelola dan memetakan titik akhir yang benar sendiri. Proses ini, *pola penemuan titik akhir*, dijelaskan di bawah ini: 

1.  Pola penemuan titik akhir dimulai dengan panggilan untuk `DescribeEndpoints` tindakan (dijelaskan di [https://docs.aws.amazon.com/timestream/latest/developerguide/API_Reference.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Reference.html)bagian). 

1.  Titik akhir harus di-cache dan digunakan kembali untuk jumlah waktu yang ditentukan oleh nilai yang dikembalikan time-to-live (TTL) (the). [https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html#timestream-Type-Endpoint-CachePeriodInMinutes.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html#timestream-Type-Endpoint-CachePeriodInMinutes.html) Panggilan ke Timestream Live Analytics API kemudian dapat dilakukan selama TTL. 

1.  Setelah TTL kedaluwarsa, panggilan baru DescribeEndpoints harus dilakukan untuk menyegarkan titik akhir (dengan kata lain, mulai lagi pada Langkah 1). 

**catatan**  
 Sintaks, parameter, dan informasi penggunaan lainnya untuk `DescribeEndpoints` tindakan dijelaskan dalam [Referensi API](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html). Perhatikan bahwa `DescribeEndpoints` tindakan tersedia melalui keduanya SDKs, dan identik untuk masing-masing. 

Untuk implementasi pola penemuan titik akhir, lihat[Menerapkan pola penemuan titik akhir](Using-API.endpoint-discovery.describe-endpoints.implementation.md).

# Menerapkan pola penemuan titik akhir
<a name="Using-API.endpoint-discovery.describe-endpoints.implementation"></a>

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

**catatan**  
Pastikan Anda terbiasa dengan [catatan penggunaan](#Using-API.endpoint-discovery.describe-endpoints.usage-notes).

## Prosedur implementasi
<a name="Using-API.endpoint-discovery.describe-endpoints.implementation.procedure"></a>

1.  Dapatkan titik akhir untuk API yang ingin Anda lakukan panggilan ([Tulis](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Write.html) atau [Kueri](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Query.html)). menggunakan [https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html)permintaan. 

   1.  Buat permintaan yang sesuai dengan API [https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html)yang diinginkan ([Tulis](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Write.html) atau [Kueri](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Query.html)) menggunakan salah satu dari dua titik akhir yang dijelaskan di bawah ini. Tidak ada parameter input untuk permintaan tersebut. Pastikan Anda membaca catatan di bawah ini.   
*Tulis SDK:*  

      ```
      ingest.timestream.<region>.amazonaws.com
      ```  
*Kueri SDK:*  

      ```
      query.timestream.<region>.amazonaws.com
      ```

      Contoh panggilan CLI 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 titik akhir API. Permintaan akan gagal jika header tidak diisi. Ini adalah persyaratan standar untuk semua permintaan HTTP/1.1. Jika Anda menggunakan pustaka HTTP yang mendukung 1.1 atau yang lebih baru, pustaka HTTP akan secara otomatis mengisi header untuk Anda.
**catatan**  
Gantikan *<region>* dengan pengenal wilayah untuk wilayah tempat permintaan dibuat, mis. `us-east-1`

   1. Parse respon untuk mengekstrak endpoint (s), dan cache nilai TTL (s). Responsnya adalah array dari satu atau lebih [`Endpoint`objek](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html). Setiap `Endpoint` objek berisi alamat titik akhir (`Address`) dan TTL untuk titik akhir itu (). `CachePeriodInMinutes` 

1.  Cache titik akhir hingga TTL yang ditentukan. 

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

## Catatan penggunaan untuk pola penemuan titik akhir
<a name="Using-API.endpoint-discovery.describe-endpoints.usage-notes"></a>
+ **DescribeEndpoints**Tindakan ini adalah satu-satunya tindakan yang dikenali oleh titik akhir regional Timestream Live Analytics. 
+ Respons berisi daftar titik akhir untuk membuat panggilan Timestream Live Analytics API terhadap. 
+  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 panggilan API, dan pemanggil dapat memilih titik akhir yang akan digunakan secara acak. 
+ Selain alamat DNS 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 nilai TTL yang dikembalikan (dalam menit). Setelah TTL kedaluwarsa, panggilan baru **DescribeEndpoints**harus dilakukan untuk menyegarkan titik akhir yang akan digunakan, karena titik akhir tidak akan berfungsi lagi setelah TTL kedaluwarsa.