API를 직접 호출하여 구성 검색

애플리케이션은 먼저 세션 API 작업을 사용하여 구성 세션을 설정하여 구성 데이터를 검색합니다StartConfiguration. 그러면 세션 클라이언트가 GetLatest구성을 주기적으로 호출하여 사용 가능한 최신 데이터를 확인하고 검색합니다.

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

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

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

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

중요

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

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

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

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

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

중요

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

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

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

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

구성 예제 검색

다음 AWS CLI 예제는 데이터 StartConfigurationSession 및 GetLatestConfiguration API 작업을 사용하여 구성 AWS AppConfig 데이터를 검색하는 방법을 보여줍니다. 첫 번째 명령은 구성 세션을 시작합니다. 이 호출에는 AWS AppConfig 애플리케이션, 환경 및 구성 프로필의 ID (또는 이름) 가 포함됩니다. API는 구성 데이터를 가져오는 데 사용된 InitialConfigurationToken을 반환합니다.

aws appconfigdata start-configuration-session \
    --application-identifier application_name_or_ID \
    --environment-identifier environment_name_or_ID \
    --configuration-profile-identifier configuration_profile_name_or_ID 

시스템은 다음과 같은 형식의 정보로 응답합니다.

{
   "InitialConfigurationToken": initial configuration token
}

세션을 시작한 후 InitialConfiguration토큰을 사용하여 GetLatest구성을 호출하여 구성 데이터를 가져옵니다. 구성 데이터가 mydata.json 파일에 저장됩니다.

aws appconfigdata get-latest-configuration \
    --configuration-token initial configuration token mydata.json

GetLatestConfiguration을 처음 호출할 때는 StartConfigurationSession에서 확보한 ConfigurationToken을 사용합니다. 다음 정보가 반환됩니다.

{
    "NextPollConfigurationToken" : next configuration token,
    "ContentType" : content type of configuration,
    "NextPollIntervalInSeconds" : 60
}  

GetLatestConfiguration에 대한 후속 호출은 이전 응답의 NextPollConfigurationToken을 제공해야 합니다.

aws appconfigdata get-latest-configuration \
    --configuration-token next configuration token mydata.json

중요

GetLatestConfiguration API 작업에 대한 다음과 같은 중요 세부 정보에 주의하십시오.

• GetLatestConfiguration 응답에는 구성 데이터를 보여주는 Configuration 섹션이 포함됩니다. 이 Configuration 섹션은 시스템에서 새 구성 데이터 또는 업데이트된 구성 데이터를 찾은 경우에만 나타납니다. 시스템에서 새 구성 데이터나 업데이트된 구성 데이터를 찾지 못하면 해당 Configuration 데이터는 비어 있습니다.

• 모든 ConfigurationToken 응답에서 새 GetLatestConfiguration을 받습니다.

• 예산, 구성 배포의 예상 빈도, 구성할 대상 수를 기준으로 GetLatestConfiguration API 직접 호출의 폴링 빈도를 조정하는 것이 좋습니다.