

Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. [여기](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)에서 자세히 알아보세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 엔드포인트 검색 패턴 구현
<a name="Using-API.endpoint-discovery.describe-endpoints.implementation"></a>

 엔드포인트 검색 패턴을 구현하려면 API(쓰기 또는 쿼리)를 선택하고 **DescribeEndpoints** 요청을 생성한 다음 반환된 TTL 값(들) 기간 동안 반환된 엔드포인트를 사용합니다. 구현 절차는 아래에 설명되어 있습니다.

**참고**  
[사용 노트](#Using-API.endpoint-discovery.describe-endpoints.usage-notes)를 숙지해야 합니다.

## 구현 절차
<a name="Using-API.endpoint-discovery.describe-endpoints.implementation.procedure"></a>

1.  [https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html) 요청을 사용하여 직접적으로 호출하려는 API의 엔드포인트를 획득합니다([쓰기](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Write.html) 또는 [쿼리](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Query.html)).

   1.  아래 설명된 두 엔드포인트 중 하나를 사용하여 관심 API([쓰기](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Write.html) 또는 [쿼리](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Operations_Amazon_Timestream_Query.html))에 해당하는 [https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html)에 대한 요청을 생성합니다. 요청에 대한 입력 파라미터가 없습니다. 아래 참고 사항을 읽어야 합니다.  
*Write 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 "Host" 헤더에는 API 엔드포인트도 포함되어야 *합니다*. 헤더가 채워지지 않으면 요청이 실패합니다. 이는 모든 HTTP/1.1 요청에 대한 표준 요구 사항입니다. 1.1 이상을 지원하는 HTTP 라이브러리를 사용하는 경우 HTTP 라이브러리가 자동으로 헤더를 채웁니다.
**참고**  
*<리전>*을 요청이 이루어지는 리전의 리전 식별자로 대체합니다(예: `us-east-1`).

   1. 응답을 구문 분석하여 엔드포인트를 추출하고 TTL 값을 캐시합니다. 응답은 하나 이상의 [`Endpoint` 객체 ](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html)의 배열입니다. 각 `Endpoint` 객체에는 엔드포인트 주소(`Address`)와 해당 엔드포인트(`CachePeriodInMinutes`)의 TTL이 포함됩니다.

1.  지정된 TTL까지 엔드포인트를 캐시합니다.

1.  TTL이 만료되면 구현의 1단계에서 다시 시작하여 새 엔드포인트를 검색합니다.

## 엔드포인트 검색 패턴에 대한 사용 노트
<a name="Using-API.endpoint-discovery.describe-endpoints.usage-notes"></a>
+ **DescribeEndpoints** 작업은 Timestream LiveAnalytics 리전 엔드포인트가 인식하는 유일한 작업입니다.
+ 응답에는 Timestream LiveAnalytics API를 직접적으로 호출할 엔드포인트 목록이 포함되어 있습니다.
+  응답이 성공하면 목록에 엔드포인트가 하나 이상 있어야 합니다. 목록에 엔드포인트가 2개 이상 있는 경우 API 직접 호출에 똑같이 사용할 수 있으며 호출자는 임의로 사용할 엔드포인트를 선택할 수 있습니다.
+ 엔드포인트의 DNS 주소 외에도 목록의 각 엔드포인트는 분 단위로 지정된 엔드포인트를 사용할 수 있는 Time-to-Live(TTL)를 지정합니다.
+ 반환된 TTL 값에 지정된 시간(분) 동안 엔드포인트를 캐시하고 재사용해야 합니다. TTL이 만료되면 TTL이 만료된 후 엔드포인트가 더 이상 작동하지 않으므로 사용할 엔드포인트를 새로 고치려면 **DescribeEndpoints**에 대한 새 직접 호출을 수행해야 합니다.