エンドポイント検出パターンの実装 - Amazon Timestream
実装手順使用に関する注意事項

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

エンドポイント検出パターンの実装

エンドポイント検出パターンを実装するには、API (書き込みまたはクエリ) を選択し、DescribeEndpoints リクエストを作成し、返された TTL 値 (複数可) の期間中、返されたエンドポイントを使用します。実装手順を以下に示します。

注記

使用上の注意事項をよく理解してください。

実装手順

  1. DescribeEndpoints リクエストを使用して、呼び出しを行う API (書き込みまたはクエリ) のエンドポイントを取得します。

    1. 以下で説明する 2 つのエンドポイントのいずれかを使用して、対象API (書き込みまたはクエリ) DescribeEndpoints に対応する のリクエストを作成します。リクエストの入力パラメータはありません。以下の注意事項を必ずお読みください。

      SDKの書き込み：
      ingest.timestream.<region>.amazonaws.com
      クエリSDK：
      query.timestream.<region>.amazonaws.com

      リージョンの 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 の「ホスト」ヘッダーには、API エンドポイントも含める必要があります。ヘッダーが入力されていない場合、リクエストは失敗します。これは、すべての HTTP/1.1 リクエストの標準要件です。1.1 以降をサポートする HTTP ライブラリを使用する場合、HTTP ライブラリによって ヘッダーが自動的に入力されます。

      注記

      置換 <region> リクエストが行われているリージョンのリージョン識別子。例: us-east-1

    2. レスポンスを解析してエンドポイント (複数可) を抽出し、TTL 値をキャッシュします (複数可）。レスポンスは、1 つ以上のEndpointオブジェクト の配列です。各Endpointオブジェクトには、エンドポイントアドレス (Address) とそのエンドポイントの TTL () が含まれていますCachePeriodInMinutes。

  2. エンドポイントを指定されたTTLまでキャッシュします。

  3. TTL の有効期限が切れたら、実装のステップ 1 から開始して新しいエンドポイントを取得します。

エンドポイント検出パターンの使用上の注意

  • DescribeEndpoints アクションは、Timestream Live Analytics リージョンエンドポイントが認識する唯一のアクションです。

  • レスポンスには、Timestream Live Analytics API 呼び出しの対象となるエンドポイントのリストが含まれています。

  • 応答が成功すると、リストに少なくとも 1 つのエンドポイントが存在する必要があります。リストに複数のエンドポイントがある場合、それらのいずれかは API 呼び出しに等しく使用でき、呼び出し元はランダムに使用するエンドポイントを選択できます。

  • エンドポイントの DNS アドレスに加えて、リスト内の各エンドポイントは、数分で指定されたエンドポイントの使用が許可される有効期限 (TTL) を指定します。

  • エンドポイントはキャッシュされ、返された TTL 値で指定された時間 (分単位) 再利用される必要があります。TTL の有効期限が切れるとDescribeEndpoints への新しい呼び出しを実行して、エンドポイントを更新する必要があります。これは、TTL の有効期限が切れるとエンドポイントが機能しなくなるためです。