Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. [여기](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)에서 자세히 알아보세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# API 사용
[SDK](getting-started-sdks.md) 외에도 Amazon Timestream for LiveAnalytics는 *엔드포인트 검색 패턴*을 통해 직접 REST API 액세스를 제공합니다. 엔드포인트 검색 패턴은 사용 사례와 함께 아래에 설명되어 있습니다.
## 엔드포인트 검색 패턴
Timestream Live Analytics의 SDK는 서비스 엔드포인트의 관리와 매핑을 포함하여 서비스의 아키텍처와 투명하게 연동되도록 설계되었으므로 대부분의 애플리케이션에 SDK를 사용하는 것이 좋습니다. 그러나 Timestream for LiveAnalytics REST API 엔드포인트 검색 패턴을 사용해야 하는 몇 가지 인스턴스가 있습니다.
+ [Timestream for LiveAnalytics와 함께 VPC 엔드포인트(AWS PrivateLink)](VPCEndpoints.md)를 사용하는 경우
+ 애플리케이션이 아직 SDK를 지원하지 않는 프로그래밍 언어를 사용하는 경우
+ 클라이언트 측 구현을 더 잘 제어해야 하는 경우
이 섹션에는 엔드포인트 검색 패턴의 작동 방식, 엔드포인트 검색 패턴 구현 방법 및 사용 노트에 대한 정보가 포함되어 있습니다. 자세히 알아보려면 아래 주제를 선택하세요.
**Topics**
+ [엔드포인트 검색 패턴](#Using-API.endpoint-discovery)
+ [엔드포인트 검색 패턴의 작동 방식](Using-API.endpoint-discovery.how-it-works.md)
+ [엔드포인트 검색 패턴 구현](Using-API.endpoint-discovery.describe-endpoints.implementation.md)
# 엔드포인트 검색 패턴의 작동 방식
Timestream은 더 나은 규모 조정 및 트래픽 격리 속성을 보장하기 위해 [셀룰러 아키텍처](architecture.md#cells)를 사용하여 구축됩니다. 각 고객 계정은 리전의 특정 셀에 매핑되므로 애플리케이션은 계정이 매핑된 올바른 셀별 엔드포인트를 사용해야 합니다. SDK를 사용할 때 이 매핑은 투명하게 처리되므로 셀별 엔드포인트를 관리할 필요가 없습니다. 그러나 REST API에 직접 액세스할 때는 올바른 엔드포인트를 직접 관리하고 매핑해야 합니다. *엔드포인트 검색 패턴*인 이 프로세스는 아래에 설명되어 있습니다.
1. 엔드포인트 검색 패턴은 `DescribeEndpoints` 작업에 대한 직접 호출로 시작됩니다([https://docs.aws.amazon.com/timestream/latest/developerguide/API_Reference.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Reference.html) 섹션에 설명됨).
1. 반환된 Time-to-Live(TTL) 값([https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html#timestream-Type-Endpoint-CachePeriodInMinutes.html](https://docs.aws.amazon.com/timestream/latest/developerguide/API_Endpoint.html#timestream-Type-Endpoint-CachePeriodInMinutes.html))으로 지정된 시간 동안 엔드포인트를 캐시하고 재사용해야 합니다. 그런 다음 TTL 기간 동안 Timestream LiveAnalytics API를 직접적으로 호출할 수 있습니다.
1. TTL이 만료되면 DescribeEndpoints를 새로 고쳐야 합니다(즉, 1단계에서 다시 시작).
**참고**
`DescribeEndpoints` 작업에 대한 구문, 파라미터 및 기타 사용 정보는 [API 참조](https://docs.aws.amazon.com/timestream/latest/developerguide/API_DescribeEndpoints.html)에 설명되어 있습니다. `DescribeEndpoints` 작업은 두 SDK 통해 사용할 수 있으며 각각 동일합니다.
엔드포인트 검색 패턴의 구현은 [엔드포인트 검색 패턴 구현](Using-API.endpoint-discovery.describe-endpoints.implementation.md) 섹션을 참조하세요.
# 엔드포인트 검색 패턴 구현
엔드포인트 검색 패턴을 구현하려면 API(쓰기 또는 쿼리)를 선택하고 **DescribeEndpoints** 요청을 생성한 다음 반환된 TTL 값(들) 기간 동안 반환된 엔드포인트를 사용합니다. 구현 절차는 아래에 설명되어 있습니다.
**참고**
[사용 노트](#Using-API.endpoint-discovery.describe-endpoints.usage-notes)를 숙지해야 합니다.
## 구현 절차
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..amazonaws.com
```
*SDK 쿼리:*
```
query.timestream..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단계에서 다시 시작하여 새 엔드포인트를 검색합니다.
## 엔드포인트 검색 패턴에 대한 사용 노트
+ **DescribeEndpoints** 작업은 Timestream LiveAnalytics 리전 엔드포인트가 인식하는 유일한 작업입니다.
+ 응답에는 Timestream LiveAnalytics API를 직접적으로 호출할 엔드포인트 목록이 포함되어 있습니다.
+ 응답이 성공하면 목록에 엔드포인트가 하나 이상 있어야 합니다. 목록에 엔드포인트가 2개 이상 있는 경우 API 직접 호출에 똑같이 사용할 수 있으며 호출자는 임의로 사용할 엔드포인트를 선택할 수 있습니다.
+ 엔드포인트의 DNS 주소 외에도 목록의 각 엔드포인트는 분 단위로 지정된 엔드포인트를 사용할 수 있는 Time-to-Live(TTL)를 지정합니다.
+ 반환된 TTL 값에 지정된 시간(분) 동안 엔드포인트를 캐시하고 재사용해야 합니다. TTL이 만료되면 TTL이 만료된 후 엔드포인트가 더 이상 작동하지 않으므로 사용할 엔드포인트를 새로 고치려면 **DescribeEndpoints**에 대한 새 직접 호출을 수행해야 합니다.