엔드포인트 검색 패턴 구현

포커스 모드

엔드포인트 검색 패턴 구현 - Amazon Timestream

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

참고

사용 노트를 숙지해야 합니다.

구현 절차

DescribeEndpoints 요청을 사용하여 호출하려는 API의 엔드포인트를 획득합니다(쓰기 또는 쿼리).
1. 아래 설명된 두 엔드포인트 중 하나를 사용하여 관심 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 "Host" 헤더에는 API 엔드포인트도 포함되어야 합니다. 헤더가 채워지지 않으면 요청이 실패합니다. 이는 모든 HTTP/1.1 요청에 대한 표준 요구 사항입니다. 1.1 이상을 지원하는 HTTP 라이브러리를 사용하는 경우 HTTP 라이브러리가 자동으로 헤더를 채웁니다.
  
  참고
  요청이 이루어지는 리전의 리전 식별자로 <region>을 대체합니다. 예: us-east-1
2. 응답을 구문 분석하여 엔드포인트(들)를 추출하고 TTL 값(들)을 캐싱합니다. 응답은 하나 이상의 Endpoint 객체 배열입니다. 각 Endpoint 객체에는 엔드포인트 주소(Address)와 해당 엔드포인트의 TTL()이 포함됩니다CachePeriodInMinutes.
지정된 TTL까지 엔드포인트를 캐시합니다.
TTL이 만료되면 구현의 1단계에서 다시 시작하여 새 엔드포인트를 검색합니다.

엔드포인트 검색 패턴에 대한 사용 정보

DescribeEndpoints 작업은 Timestream Live Analytics 리전 엔드포인트가 인식하는 유일한 작업입니다.
응답에는 Timestream Live Analytics API를 호출할 엔드포인트 목록이 포함되어 있습니다.
응답이 성공하면 목록에 엔드포인트가 하나 이상 있어야 합니다. 목록에 엔드포인트가 두 개 이상 있는 경우 API 호출에 모두 동일하게 사용할 수 있으며 호출자는 임의로 사용할 엔드포인트를 선택할 수 있습니다.
엔드포인트의 DNS 주소 외에도 목록의 각 엔드포인트는 분 단위로 지정된 엔드포인트를 사용할 수 있는 TTL(Time to Live)을 지정합니다.
반환된 TTL 값에 지정된 시간(분) 동안 엔드포인트를 캐시하고 재사용해야 합니다. TTL이 만료되면 TTL이 만료된 후 엔드포인트가 더 이상 작동하지 않으므로 사용할 엔드포인트를 새로 고치려면 DescribeEndpoints에 대한 새 호출을 수행해야 합니다.