實作端點探索模式 - Amazon Timestream
實作程序使用須知

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

實作端點探索模式

若要實作端點探索模式，請選擇 API (Write 或 Query)、建立 DescribeEndpoints 請求，並在傳回 TTL 值 (s) 的持續時間內使用傳回的端點。實作程序說明如下。

注意

確保您熟悉用量備註。

實作程序

  1. 使用 DescribeEndpoints請求，取得您要呼叫 (寫入或查詢) 之 API 的端點。

    1. 使用下列兩個端點之一，為 建立DescribeEndpoints對應至目標 API (Write 或 Query) 的請求。沒有請求的輸入參數。請確定您已閱讀下列備註。

      寫入SDK：
      ingest.timestream.<region>.amazonaws.com
      查詢SDK：
      query.timestream.<region>.amazonaws.com

      區域 Word CLI呼叫的範例us-east-1如下。

      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
      注意

      HTTP "Host" 標頭也必須包含 API 端點。如果未填入標頭，則請求會失敗。這是所有 HTTP/1.1 請求的標準要求。如果您使用支援 1.1 或更新版本的 HTTP 程式庫，HTTP 程式庫應該會自動為您填入標頭。

      注意

      替代 <region> 具有正在提出請求之區域的區域識別符，例如 us-east-1

    2. 剖析擷取端點 (s) 和快取 TTL 值 (s) 的回應。回應是一或多個Endpoint物件 的陣列。每個Endpoint物件都包含端點地址 (Address) 和該端點 () 的 TTLCachePeriodInMinutes。

  2. 快取端點，最多至指定的 TTL。

  3. 當 TTL 過期時，從實作的步驟 1 重新開始擷取新的端點。

端點探索模式的使用備註

  • DescribeEndpoints 動作是 Timestream Live Analytics 區域端點唯一能辨識的動作。

  • 回應包含端點清單，用於進行 Timestream Live Analytics API 呼叫。

  • 成功回應時，清單中至少應該有一個端點。如果清單中有多個端點，則其中任何端點同樣可用於 API 呼叫，而且呼叫者可以選擇隨機使用的端點。

  • 除了端點的 DNS 地址之外，清單中的每個端點都會指定允許使用以分鐘為單位指定端點的存留時間 (TTL)。

  • 端點應快取並重複使用，以傳回 TTL 值指定的時間長度 （以分鐘為單位）。在 TTL 過期後，應該對 DescribeEndpoints 進行新的呼叫，以重新整理要使用的端點，因為端點在 TTL 過期後將無法再運作。