엔드포인트 검색 패턴 구현 - Amazon Timestream
구현 절차사용 노트

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

엔드포인트 검색 패턴 구현

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

참고

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

구현 절차

  1. 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 '호스트' 헤더에는 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 리전 엔드포인트가 인식하는 유일한 작업입니다.

  • 응답에는 Timestream Live Analytics API를 호출할 엔드포인트 목록이 포함되어 있습니다.

  • 응답이 성공하면 목록에 엔드포인트가 하나 이상 있어야 합니다. 목록에 엔드포인트가 두 개 이상 있는 경우 둘 중 하나는 API 호출에 동일하게 사용할 수 있으며 호출자는 임의로 사용할 엔드포인트를 선택할 수 있습니다.

  • 엔드포인트의 DNS 주소 외에도 목록의 각 엔드포인트는 분 단위로 지정된 엔드포인트를 사용할 수 있는 라이브 시간(TTL)을 지정합니다.

  • 반환된 TTL 값(분)에 지정된 시간 동안 엔드포인트를 캐시하고 재사용해야 합니다. TTL가 만료되면 DescribeEndpoints가 만료된 후에는 엔드포인트가 더 이상 작동하지 않으므로 사용할 엔드포인트를 새로 고치기 위해 TTL를 새로 호출해야 합니다.