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

Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、こちらを参照してください。

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

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

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

注記

使用上の注意をよく理解するようにしてください。

実装手順

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

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

      Write SDK:
      ingest.timestream.<region>.amazonaws.com
      Query SDK:
      query.timestream.<region>.amazonaws.com

      us-east-1 リージョンの CLI 呼び出しの例を次に示します。

      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 for LiveAnalytics のリージョンエンドポイントが認識する唯一のアクションです。

  • レスポンスには、Timestream for LiveAnalytics API コールを行うエンドポイントのリストが含まれています。

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

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

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