实现端点发现模式 - Amazon Timestream
实施程序使用说明

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

实现端点发现模式

要实现端点发现模式，请选择一个API（写入或查询），创建DescribeEndpoints请求，然后在返回TTL值的持续时间内使用返回的端点。实施过程如下所述。

注意

请确保您熟悉使用说明。

实施程序

  1. 使用DescribeEndpoints请求获取API您要对其进行调用（写入或查询）的终端节点。

    1. 使用下面描述DescribeEndpoints的两个端点之一创建与感兴趣的（写入或查询）相对应的请求。API该请求没有输入参数。请务必阅读以下注意事项。

      写下SDK：
      ingest.timestream.<region>.amazonaws.com
      查询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值。响应是一个或多个Endpoint对象的数组。每个Endpoint对象都包含一个端点地址 (Address) 和该端点TTL的 (CachePeriodInMinutes)。

  2. 将终端节点缓存到指定值TTL。

  3. TTL过期后，从实现的第 1 步重新开始检索新的端点。

端点发现模式的使用说明

  • 该DescribeEndpoints操作是 Timestream Live Analytics 区域端点识别的唯一操作。

  • 该响应包含用于API调用 Timestream Live Analytics 的端点列表。

  • 成功响应后，列表中应至少有一个端点。如果列表中有多个端点，则其中任何一个都同样可用于API呼叫，并且呼叫者可以随机选择要使用的端点。

  • 除了终端节点DNS的地址外，列表中的每个端点还将指定允许使用以分钟为单位的终端节点的生存时间 (TTL)。

  • 端点应在返回TTL值指定的时间内缓存并重复使用（以分钟为单位）。TTL过期后，DescribeEndpoints应重新调用以刷新要使用的终端节点，因为终端节点在过期后将不再起作用。TTL