기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Handle AWS Cloud Map DiscoverInstances API 요청 제한
AWS Cloud Map 는 리전별로 각 AWS 계정에 대한 [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) API 요청을 제한합니다. 조절은 서비스의 성능을 개선하고 모든 AWS Cloud Map 고객에게 공정한 사용을 제공하는 데 도움이 됩니다. 제한을 사용하면 AWS Cloud Map [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) API에 대한 호출이 허용되는 최대 [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) API 요청 할당량을 초과하지 않습니다. 다음 소스 중 하나에서 시작된 [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) API 호출에는 요청 할당량이 적용됩니다.
+ 타사 애플리케이션
+ 명령줄 도구
+ AWS Cloud Map 콘솔
API 제한 할당량을 초과하면 `RequestLimitExceeded` 오류 코드가 표시됩니다. 자세한 내용은 [요청 속도 제한](#throttling-rate-based) 단원을 참조하십시오.
## 제한 적용 방법
AWS Cloud Map 는 [토큰 버킷 알고리즘](https://en.wikipedia.org/wiki/Token_bucket)을 사용하여 API 제한을 구현합니다. 이 알고리즘을 사용하면 계정에 특정 수의 *토큰*을 보관하는 *버킷*이 있습니다. 버킷의 토큰 수는 지정된 초당 제한 할당량을 나타냅니다. 단일 리전에는 버킷이 하나 있으며 이는 해당 리전의 모든 엔드포인트에 적용됩니다.
### 요청 속도 제한
제한은 수행할 수 있는 [DiscoverInstances API 요청](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) 수를 제한합니다. 각 요청은 버킷에서 하나의 토큰을 제거합니다. 예를 들어 [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) API 작업의 버킷 크기는 토큰 2,000개이므로 매초 최대 2,000개의 [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) 요청을 할 수 있습니다. 매초 요청이 2,000개를 초과하면 병목 현상이 발생하고 해당 초 내에 나머지 요청은 실패합니다.
버킷은 설정된 속도로 자동으로 다시 채워집니다. 버킷 용량이 부족하면 버킷 용량에 도달할 때까지 매초마다 정해진 수의 토큰이 다시 추가됩니다. 다시 채우기 토큰이 도착했을 때 버킷 용량이 다 차면 해당 토큰은 폐기됩니다. [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) API 작업의 버킷 크기는 토큰 2,000개이고 다시 채우기 속도는 초당 1,000개 토큰입니다. 1초에 2,000건의 [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) API 요청을 하면 버킷의 즉시 토큰이 0개로 줄어듭니다. 그러면 최대 용량 2,000개에 도달할 때까지 매초마다 최대 1,000개의 토큰이 버킷에 다시 채워집니다.
버킷에 추가된 토큰은 그대로 사용할 수 있습니다. API를 요청하기 전에 버킷이 최대 용량이 될 때까지 기다릴 필요가 없습니다. 1초에 2,000건의 [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) API 요청을 수행하여 버킷을 고갈시킨 경우에도 필요한 기간 동안 계속 매초마다 최대 1,000건의 [DiscoverInstances](https://docs.aws.amazon.com/cloud-map/latest/api/API_DiscoverInstances.html) API 요청을 할 수 있습니다. 즉, 다시 채우기 토큰이 버킷에 추가되면 즉시 사용할 수 있습니다. 버킷은 초당 API 요청 횟수가 다시 채우기 속도보다 적은 경우에만 최대 용량까지 다시 채워지기 시작합니다.
### 재시도 또는 일괄 처리
API 요청이 실패하는 경우 애플리케이션에서 요청을 재시도해야 할 수 있습니다. API 요청 수를 줄이려면 연속적인 요청 사이에 적절한 절전 간격을 사용하세요. 최상의 결과를 얻으려면 절전 시간 간격을 늘리거나 가변적으로 사용합니다.
### 휴면 간격 계산
API 요청을 폴링하거나 재시도해야 하는 경우 지수 백오프 알고리즘을 사용하여 API 호출 간 절전 시간 간격을 계산하는 것이 좋습니다. 연속적인 오류 응답에 대한 재시도 사이의 대기 시간을 점진적으로 늘리면 실패한 요청 수를 줄일 수 있습니다. 이 알고리즘의 자세한 내용과 구현 예제는 SDK 및 도구 참조 안내서의 [재시도 동작을](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html) 참조하세요. *AWS SDKs *
## API 제한 할당량 조정
AWS 계정에 대한 API 제한 할당량 증가를 요청할 수 있습니다. 할당량 조정을 요청하려면 [AWS Support Center](https://console.aws.amazon.com/support/home#/)에 문의하세요.