직접 호출하여 구성 검색 APIs - AWS AppConfig

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

직접 호출하여 구성 검색 APIs

애플리케이션은 먼저 StartConfigurationSession API 작업을 사용하여 구성 세션을 설정하여 구성 데이터를 검색합니다. 그런 다음 세션의 클라이언트는 GetLatestConfiguration에 정기적으로 전화를 걸어 사용 가능한 최신 데이터를 확인하고 검색합니다.

StartConfigurationSession이 호출되면 코드에서 다음 정보를 보냅니다.

  • 세션이 추적하는 AWS AppConfig 애플리케이션, 환경 및 구성 프로파일의 식별자(ID 또는 이름)입니다.

  • (선택 사항) 세션 클라이언트가 GetLatestConfiguration 호출 사이에 대기해야 하는 최소 시간입니다.

이에 대한 응답InitialConfigurationToken으로 는 세션의 클라이언트에 제공되고 해당 세션에 GetLatestConfiguration 대해 처음 호출할 때 사용할 를 AWS AppConfig 제공합니다.

중요

이 토큰은 GetLatestConfiguration을 처음 호출할 때 한 번만 사용해야 합니다. 이후에 GetLatestConfiguration을 호출할 때마다 GetLatestConfiguration응답 (NextPollConfigurationToken)의 새 토큰을 사용해야 합니다. 긴 폴링 사용 사례를 지원하기 위해 토큰은 최대 24시간 동안 유효합니다. GetLatestConfiguration 호출에서 만료된 토큰을 사용하는 경우 시스템은 BadRequestException을 반환합니다.

GetLatestConfiguration를 호출하면 클라이언트 코드는 가장 최근의 ConfigurationToken 값을 보내고 이에 대한 응답으로 수신합니다.

  • NextPollConfigurationToken: 다음에 GetLatestConfiguration 호출 시 사용할 ConfigurationToken 값입니다.

  • NextPollIntervalInSeconds: 클라이언트가 GetLatestConfiguration에 다음 호출을 하기 전에 기다려야 하는 시간.

  • 구성: 세션에 사용할 최신 데이터. 클라이언트에 이미 최신 버전의 구성이 있는 경우 비어 있을 수 있습니다.

중요

다음 중요 정보를 기록해 둡니다.

  • 는 애플리케이션, 환경, 구성 프로필 및 클라이언트당 한 번만 호출하여 서비스와 세션을 설정해야 StartConfigurationSession API 합니다. 이는 일반적으로 애플리케이션을 시작할 때 또는 구성을 처음 검색하기 직전에 수행됩니다.

  • KmsKeyIdentifier를 사용하여 구성을 배포하는 경우 구성 수신 요청에 kms:Decrypt 호출 권한이 포함되어야 합니다. 자세한 내용은 AWS Key Management Service API 참조 의 암호 해독을 참조하세요.

  • 이전에 구성 데이터인 를 검색하는 데 사용된 API 작업은 더 GetConfiguration이상 사용되지 않습니다. GetConfiguration API 작업은 암호화된 구성을 지원하지 않습니다.