View a markdown version of this page

Amazon Route 53 API 요청에 대한 제한 - Amazon Route 53
제한 적용 방법요청 속도 토큰 버킷 크기 및 리필 속도처리량 제한 변경API 스로틀링 모니터링재시도 및 지수 백오프제한 증가 요청API 제한 모범 사례

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

Amazon Route 53 API 요청에 대한 제한

중요

Amazon Route 53에서 API 제한 동작을 업데이트했습니다. 업데이트에는 초당 요청 수 제한 증가 및 변경 기반 제한 도입이 포함됩니다. 이 페이지에서는 업데이트된 제한에 대해 자세히 설명합니다.

Amazon Route 53는 계정별로 API 요청을 제한하여 서비스 안정성을 유지하고 모든 고객에게 공정한 사용을 보장합니다. Route 53는 두 개의 독립적인 제한을 적용합니다.

  • 요청 속도: 초당 API 요청 수입니다.

  • 변경 처리량: DNS 데이터를 수정하는 API 작업 전반에 걸쳐 집계된 초당 개별 DNS 레코드 변경 횟수입니다.

제한에 따라 요청을 제한할 수 있습니다. 요청이 제한되면 Amazon Route 53는 HTTP 400 오류(Bad request)를 반환합니다. 또한 응답 헤더에는 값이 Throttling인 Code 요소와 값이 Rate exceeded인 Message 요소가 포함되어 있습니다.

제한 적용 방법

Amazon Route 53는 토큰 버킷 알고리즘을 사용합니다. 각 제한에는 최대 토큰 수를 포함하는 버킷이 있습니다. 각 요청(요청 속도 제한) 또는 각 변경(변경 처리량 제한)은 해당 버킷에서 토큰을 제거합니다. 버킷은 최대 용량까지 매초 고정 속도로 리필됩니다. 버킷이 이미 가득 찼을 때 리필 토큰이 도착하면 Route 53는 토큰을 폐기합니다.

두 값은 각 버킷을 설명합니다.

  • 버킷 최대 용량은 버스트입니다. 버킷이 가득 차면 Route 53가 한 번에 흡수할 수 있는 요청 또는 변경 사항 수입니다.

  • 버킷 리필 속도는 지속적인 속도입니다. 즉, 초당 요청 또는 변경 횟수를 무기한으로 유지할 수 있습니다.

리필 토큰을 추가할 때 사용할 수 있습니다. 버킷이 완전히 리필될 때까지 기다릴 필요가 없습니다.

요청 속도 토큰 버킷 크기 및 리필 속도

Route 53는 두 가지 수준에서 요청 속도 제한을 적용합니다.

  • 계정 수준: 계정의 모든 Amazon Route 53 API 요청은 하나의 버킷에서 가져옵니다.

  • 계정 및 작업 수준: 각 API 작업에는 자체 버킷도 있습니다.

요청은 두 버킷 모두에서 토큰을 소비하며 두 버킷 중 하나가 비어 있으면 제한됩니다. 다음 작업에는 기본 요청 속도 제한이 다릅니다.

API 작업당 요청 속도 제한
API 작업 버킷 최대 용량 버킷 다시 채우기 속도
모든 Amazon Route 53 API 작업 결합(계정 수준) 50 10
아래에 나열되지 않은 단일 API 작업(작업당 기본값) 50 10
AssociateVPCWithHostedZone 20 5
ChangeCidrCollection 40 5
CreateCidrCollection 40 5
CreateHealthCheck 50 0.5
CreateHostedZone 40 2
CreateReusableDelegationSet 40 2
CreateTrafficPolicyInstance 1 1
DeleteCidrCollection 40 5
DeleteHealthCheck 15 3
DeleteHostedZone 40 5
DeleteReusableDelegationSet 40 5
DeleteTrafficPolicyInstance 1 1
DisassociateVPCFromHostedZone 10 5
GetHealthCheckLastFailureReason 4 1
GetHealthCheckStatus 4 1
UpdateHealthCheck 50 5
UpdateTrafficPolicyInstance 1 1

Amazon Route 53 API 작업의 전체 목록은 Amazon Route 53 API 참조의 작업을 참조하세요. Amazon Route 53

CreateHealthCheck 요청

AWS 계정당 2초 마다 CreateHealthCheck 요청을 하나씩 제출할 수 있습니다. 이는 이전 표에 표시된 초당 0.5개 요청의 리필 속도에 해당합니다.

처리량 제한 변경

요청 속도 제한 외에도 DNS 데이터를 수정하는 API 작업에는 변경 처리량 제한이 적용됩니다. 이 제한은 요청 수가 아닌 요청의 DNS 레코드 변경 횟수에 따라 고갈되는 별도의 토큰 버킷을 사용합니다. 변경 처리량은 API 작업이 AWS 계정아닌에 따라 제한됩니다. 다음 모든 작업은 최대 용량이 1,500회 변경(버스트)이고 초당 100회 변경(지속)으로 리필되는 버킷 하나에서 가져옵니다.

변경 사항은 다음과 같이 계산됩니다.

작업당 사용된 토큰
연산 사용된 토큰
ChangeResourceRecordSets 당 1CREATE, 당 1DELETE, 당 2 UPSERT
AssociateVPCWithHostedZone 2
DisassociateVPCFromHostedZone 2
CreateHostedZone 2
DeleteHostedZone 2

다른 모든 Amazon Route 53 API 작업은 변경 처리량 토큰을 사용하지 않으며 요청 속도에 의해서만 제한됩니다.

예: 1,000개의 토큰을 사용하는 1,000개의 변경 사항(버스트)이 포함된 단일 요청을 제출할 수 있습니다. 버스트 후 버킷은 초당 100개의 토큰으로 리필됩니다. 초당 100개의 변경 사항을 계속 제출하면 해당 속도를 무기한 유지할 수 있습니다. 초당 500개의 변경 사항을 유지하려고 하면 버킷이 고갈되고 후속 요청은 다시 채워질 때까지 제한됩니다.

API 스로틀링 모니터링

애플리케이션 로그에서 HTTP 400 응답을 관찰하거나 CloudWatch 지표를 통해 API 사용량을 추적하여 Amazon Route 53 API 사용량을 모니터링할 수 있습니다. 제한 오류가 발생하면 요청이 이전 섹션에 설명된 제한 중 하나를 초과하는 것입니다.

재시도 및 지수 백오프

API 요청을 폴링하거나 재시도할 때는 지수 백오프 알고리즘을 사용하여 요청 간의 절전 간격을 계산하는 것이 좋습니다. 지수 백오프는 연속 오류 응답을 위해 재시도 간에 점진적으로 더 긴 대기 시간을 사용합니다. 최대 지연 간격과 최대 재시도 횟수를 구현하고 연속 충돌을 방지하기 위해 지터(무작위 지연)를 추가하는 것이 좋습니다. 자세한 내용은 AWS Builders' Library의 Timeouts, reries, and backoff with jitter를 참조하세요.

각 AWS SDK는 제한에 대한 응답으로 클라이언트 측 요청 속도를 조정하는 적응형 재시도 모드를 포함하여 자동 재시도 로직을 구현합니다. 이러한 제한에 정기적으로 접근하는 워크로드의 경우 적응형 재시도를 활성화하는 것이 좋습니다. 자세한 정보는AWS SDK 및 도구 참조 설명서의 재시도 동작을 참조하세요.

제한 증가 요청

AWS Support를 통해 API 요청 속도 또는 변경 처리량 한도 증가를 요청할 수 있습니다. 증가를 요청하려면:

  • AWS 지원 센터를 엽니다.

  • 사례를 생성하고 서비스 한도 증가를 선택합니다.

  • 제한 유형에서 Route 53을 선택합니다.

  • 현재 사용량과 필요한 한도를 입력합니다.

API 제한 모범 사례

  • 배치 크기 대비 밸런스 요청 속도: 요청 속도 제한으로 인해 병목 현상이 발생하는 경우 요청당 더 많은 변경 사항을 전송합니다. 변경 처리량 제한으로 인해 병목 현상이 발생하는 경우 총 변경 속도를 줄이세요. 매우 작거나 매우 큰 배치는 자체적으로 최적이 아닙니다.

  • 원자성에 일괄 처리 사용: 단일 ChangeResourceRecordSets 요청의 모든 변경 사항은 원자적으로 적용되므로 성공하거나 함께 실패합니다.

  • 시간 경과에 따른 변경 분산: 큰 배치를 동시에 제출하는 대신 몇 초에 걸쳐 변경 사항을 균등하게 분산합니다.

  • 지속적인 처리량이 아닌 간헐적인 급증을 위해 버스트를 사용합니다. 버스트 용량은 합법적인 트래픽 급증을 수용하지만 지속적인 운영 상한은 아닙니다.

  • 지수 백오프로 재시도: HTTP 400 응답을 수신하면 시도할 때마다 증가하는 지연 후 재시도합니다( 참조재시도 및 지수 백오프).

  • 요청 한도 증가 사전 예방: 워크로드 증가를 예상하는 경우 한도에 도달하기 전에 증가를 요청합니다( 참조제한 증가 요청).

더 광범위한 Amazon Route 53 지침은 섹션을 참조하세요Amazon Route 53 모범 사례.