쿠키 기본 설정 선택

당사는 사이트와 서비스를 제공하는 데 필요한 필수 쿠키 및 유사한 도구를 사용합니다. 고객이 사이트를 어떻게 사용하는지 파악하고 개선할 수 있도록 성능 쿠키를 사용해 익명의 통계를 수집합니다. 필수 쿠키는 비활성화할 수 없지만 '사용자 지정' 또는 ‘거부’를 클릭하여 성능 쿠키를 거부할 수 있습니다.

사용자가 동의하는 경우 AWS와 승인된 제3자도 쿠키를 사용하여 유용한 사이트 기능을 제공하고, 사용자의 기본 설정을 기억하고, 관련 광고를 비롯한 관련 콘텐츠를 표시합니다. 필수가 아닌 모든 쿠키를 수락하거나 거부하려면 ‘수락’ 또는 ‘거부’를 클릭하세요. 더 자세한 내용을 선택하려면 ‘사용자 정의’를 클릭하세요.

재시도 동작 - AWS SDKs 및 도구

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

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

재시도 동작

참고

설정 페이지의 레이아웃을 이해하거나 다음에 나오는 Support AWS SDKs 및 도구 테이블을 해석하는 데 도움이 필요하면 섹션을 참조하세요이 안내서의 설정 페이지 이해.

재시도 동작에는 SDK가 AWS 서비스에 보내진 요청으로 인한 장애 복구를 시도하는 방법에 대한 설정이 포함됩니다.

다음을 사용하여 이 기능을 구성하십시오.

retry_mode - 공유 AWS config 파일 설정
AWS_RETRY_MODE - 환경 변수
aws.retryMode - JVM 시스템 속성: Java/Kotlin만 해당

SDK 또는 개발자 도구의 재시도 방법을 지정합니다.

기본값:이 값은 SDK에 따라 다릅니다. 특정 SDK 가이드 또는 SDK의 코드 기반에서 기본를 확인합니다retry_mode.

유효한 값:

  • standard – (권장) AWS SDKs. 이 모드에는 재시도되는 표준 오류 세트가 포함되며, 가용성과 안정성을 극대화하기 위해 재시도 횟수를 자동으로 조정합니다. 이 모드는 다중 테넌트 애플리케이션에서 사용하기에 안전합니다. 명시적으로 max_attempts으로 구성되어 있지 않으면 이 모드의 기본 최대 시도 횟수는 3회입니다.

  • adaptive - 표준 모드의 기능과 자동 클라이언트 측 속도 제한을 포함하는 특수 사용 사례에만 적합한 재시도 모드입니다. 이 재시도 모드는 애플리케이션 테넌트를 격리하기 위해 주의하지 않는 한 다중 테넌트 애플리케이션에는 권장되지 않습니다. 자세한 내용은 standard 및 adaptive 재시도 모드 선택 섹션을 참조하세요. 이 모드는 실험적이며 향후 동작이 변경될 수 있습니다.

  • legacy - (권장되지 않음) SDK에 고유합니다(특정 SDK 가이드 또는 SDK의 코드 기반 확인).

max_attempts - 공유 AWS config 파일 설정
AWS_MAX_ATTEMPTS - 환경 변수
aws.maxAttempts - JVM 시스템 속성: Java/Kotlin만 해당

요청에 대한 최대 시도 횟수를 지정합니다.

기본값: 이 값이 지정되지 않은 경우 기본값은 retry_mode 설정 값에 따라 달라집니다.

  • retry_modelegacy 인 경우— 사용자 SDK 고유의 기본값을 사용합니다(사용자 고유 SDK 설명서 또는 max_attempts 기본 SDK의 코드베이스를 확인하십시오).

  • retry_modestandard인 경우 — 세 번 시도합니다.

  • retry_modeadaptive인 경우 — 세 번 시도합니다.

유효한 값: 0보다 큰 숫자.

standardadaptive 재시도 모드 선택

사용에 더 적합하다고 확신하지 않는 한 standard 재시도 모드를 사용하는 것이 좋습니다adaptive.

참고

adaptive 모드는 백엔드 서비스가 요청을 제한할 수 있는 범위를 기반으로 클라이언트를 풀링하고 있다고 가정합니다. 이렇게 하지 않으면 두 리소스에 동일한 클라이언트를 사용하는 경우 한 리소스의 조절로 인해 관련 없는 리소스에 대한 요청이 지연될 수 있습니다.

표준 적응형
애플리케이션 사용 사례: 모두. 애플리케이션 사용 사례:
  1. 지연 시간에 민감하지 않습니다.

  2. 클라이언트는 단일 리소스에만 액세스하거나 액세스 중인 서비스 리소스별로 클라이언트를 별도로 풀링하는 로직을 제공합니다.

중단 중에 SDK가 재시도되지 않도록 회로 차단을 지원합니다. 중단 중에 SDK가 재시도되지 않도록 회로 차단을 지원합니다.
장애 발생 시 지터링된 지수 백오프를 사용합니다. 동적 백오프 기간을 사용하여 지연 시간 증가의 가능성 대신 실패한 요청 수를 최소화하려고 시도합니다.
첫 번째 요청 시도를 지연하지 않고 재시도만 합니다. 초기 요청 시도를 제한하거나 지연할 수 있습니다.

adaptive 모드를 사용하기로 선택한 경우 애플리케이션은 제한될 수 있는 각 리소스에 대해 설계된 클라이언트를 구성해야 합니다. 이 경우 리소스는 각 리소스에 대한 생각보다 더 미세하게 조정됩니다 AWS 서비스.는 요청을 제한하는 데 사용하는 추가 차원을 가질 AWS 서비스 수 있습니다. Amazon DynamoDB 서비스를 예로 들어 보겠습니다. DynamoDB는 액세스 중인 테이블 AWS 리전 과 함께를 사용하여 요청을 제한합니다. 즉, 코드가 액세스하는 테이블 하나가 다른 테이블보다 더 제한될 수 있습니다. 코드가 동일한 클라이언트를 사용하여 모든 테이블에 액세스하고 해당 테이블 중 하나에 대한 요청이 제한되는 경우 적응 재시도 모드는 모든 테이블에 대한 요청 속도를 줄입니다. 코드는 Region-and-table 페어당 하나의 클라이언트를 갖도록 설계되어야 합니다. adaptive 모드를 사용할 때 예기치 않은 지연 시간이 발생하는 경우 사용 중인 서비스에 대한 특정 AWS 설명서 가이드를 참조하세요.

재시도 모드 구현 세부 정보

AWS SDKs는 토큰 버킷을 사용하여 요청을 재시도할지 여부와 (adaptive재시도 모드의 경우) 요청을 얼마나 빨리 보내야 하는지 결정합니다. SDK는 재시도 토큰 버킷과 요청 속도 토큰 버킷이라는 두 개의 토큰 버킷을 사용합니다.

  • 재시도 토큰 버킷은 중단 중에 업스트림 및 다운스트림 서비스를 보호하기 위해 SDK가 재시도를 일시적으로 비활성화해야 하는지 여부를 결정하는 데 사용됩니다. 재시도를 시도하기 전에 버킷에서 토큰을 획득하고 요청이 성공하면 토큰이 버킷으로 반환됩니다. 재시도를 시도할 때 버킷이 비어 있는 경우 SDK는 요청을 재시도하지 않습니다.

  • 요청 속도 토큰 버킷은 요청을 보낼 속도를 결정하는 데 adaptive 재시도 모드에서만 사용됩니다. 토큰은 요청이 전송되기 전에 버킷에서 획득되며, 서비스에서 반환되는 제한 응답에 따라 동적으로 결정된 속도로 버킷에 반환됩니다.

다음은 standard 모드와 adaptive 모드 모두에 대한 고급 의사코드입니다.

MakeSDKRequest() { attempts = 0 loop { GetSendToken() response = SendHTTPRequest() RequestBookkeeping(response) if not Retryable(response) return response attempts += 1 if attempts >= MAX_ATTEMPTS: return response if not HasRetryQuota(response) return response delay = ExponentialBackoff(attempts) sleep(delay) } }

다음은 의사코드에 사용되는 구성 요소에 대한 자세한 내용입니다.

GetSendToken:

이 단계는 adaptive 재시도 모드에서만 사용됩니다. 이 단계에서는 요청 속도 토큰 버킷에서 토큰을 가져옵니다. 토큰을 사용할 수 없는 경우 토큰을 사용할 수 있을 때까지 기다립니다. SDK에 대기하는 대신 요청에 실패할 수 있는 구성 옵션이 있을 수 있습니다. 버킷의 토큰은 클라이언트가 수신한 제한 응답 수에 따라 동적으로 결정되는 속도로 다시 채워집니다.

SendHTTPRequest:

이 단계에서는 요청을에 보냅니다 AWS. AWS SDKs HTTP 요청을 할 때 연결 풀을 사용하여 기존 연결을 재사용하는 HTTP 라이브러리를 사용합니다. 일반적으로 제한 오류로 인해 요청이 실패한 경우 연결이 재사용되지만 일시적인 오류로 인해 요청이 실패한 경우에는 연결이 재사용되지 않습니다.

RequestBookkeeping:

요청이 성공하면 토큰이 토큰 버킷에 추가됩니다. adaptive 재시도 모드의 경우에만 수신된 응답 유형에 따라 요청 속도 토큰 버킷의 채우기 속도가 업데이트됩니다.

Retryable:

이 단계에서는 다음을 기반으로 응답을 재시도할 수 있는지 여부를 결정합니다.

  • HTTP 상태 코드 .

  • 서비스에서 반환된 오류 코드입니다.

  • 연결 오류로, 서비스로부터 HTTP 응답을 받지 못한 SDK에서 수신한 모든 오류로 정의됩니다.

일시적 오류(HTTP 상태 코드 400, 408, 500, 502, 503, 504)와 조절 오류(HTTP 상태 코드 400, 403, 429, 502, 503, 509)는 모두 재시도될 수 있습니다. SDK 재시도 동작은 서비스의 오류 코드 또는 서비스의 기타 데이터와 조합하여 결정됩니다.

MAX_ATTEMPTS:

설정에 의해 재정의retry_mode되지 않는 한, 최대 시도의 기본 횟수는 max_attempts 설정에 의해 설정됩니다.

HasRetryQuota

이 단계에서는 재시도 토큰 버킷에서 토큰을 가져옵니다. 재시도 토큰 버킷이 비어 있으면 요청이 재시도되지 않습니다.

ExponentialBackoff

재시도할 수 있는 오류의 경우 잘린 지수 백오프를 사용하여 재시도 지연을 계산합니다. SDK는 지터가 있는 잘린 이진 지수 백오프를 사용합니다. 다음 알고리즘은 요청에 대한 응답의 절전 시간(초)이 어떻게 정의되는지 보여줍니다. i

seconds_to_sleep_i = min(b*r^i, MAX_BACKOFF)

위 알고리즘에는 다음 값이 적용됩니다.

b = random number within the range of: 0 <= b <= 1

r = 2

대부분의 SDK용 MAX_BACKOFF = 20 seconds. 사용자 특정 SDK 가이드 또는 소스 코드를 참조하여 확인합니다.

AWS SDKs 도구 지원

다음 SDK는 이 주제에서 설명하는 기능 및 설정을 지원합니다. 모든 일부 예외가 기록됩니다. 모든 JVM 시스템 속성 설정은 AWS SDK for Java 및 AWS SDK for Kotlin 에서만 지원됩니다.

SDK 지원 참고 또는 추가 정보
AWS CLI v2
SDK for C++
SDK for Go V2 (1.x)
SDK for Go 1.x (V1) 아니요
SDK for Java 2.x
SDK for Java 1.x JVM 시스템 속성: com.amazonaws.sdk.maxAttempts 대신를 사용하고 aws.maxAttempts대신 com.amazonaws.sdk.retryMode를 사용합니다aws.retryMode.
SDK for JavaScript 3.x
SDK for JavaScript 2.x 아니요 최대 재시도 횟수, 지터가 있는 지수 백오프, 재시도 백오프를 위한 사용자 지정 방법 옵션을 지원합니다.
SDK for Kotlin
SDK for .NET 3.x
SDK for PHP 3.x
SDK for Python (Boto3)
SDK for Ruby 3.x
SDK for Rust
SDK for Swift
PowerShell용 도구
프라이버시사이트 이용 약관쿠키 기본 설정
© 2025, Amazon Web Services, Inc. 또는 계열사. All rights reserved.