

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

# AWS Cloud Map 서비스 할당량
<a name="cloud-map-limits"></a>

AWS Cloud Map 리소스에는 다음과 같은 계정 수준 서비스 할당량이 적용됩니다. 나열된 각 할당량은 AWS Cloud Map 리소스를 생성하는 각 AWS 리전에 적용됩니다.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/cloud-map/latest/dg/cloud-map-limits.html)

**\$1** 사용자가 네임스페이스를 생성하면 Amazon Route 53 호스팅 영역이 자동으로 생성됩니다. 이 호스팅 영역은 AWS 계정으로 생성할 수 있는 호스팅 영역 수의 할당량에 포함됩니다. 자세한 내용은 *Amazon Route 53 개발자 안내서*의 [호스팅 영역에 대한 할당량](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DNSLimitations.html#limits-api-entities-hosted-zones)을 참조하세요.

**\$1\$1** AWS Cloud Map 의 DNS 네임스페이스 인스턴스를 늘리려면 호스팅 영역 Route 53 한도당 레코드 수를 늘려야 하며, 이 경우 추가 요금이 발생합니다.

# AWS Cloud Map 서비스 할당량 관리
<a name="service-quotas-manage"></a>

AWS Cloud Map 는 중앙 위치에서 할당량을 보고 관리할 수 있는 AWS 서비스인 Service Quotas와 통합되었습니다. 자세한 내용은 *Service Quotas 사용 설명서*의 [Service Quotas는 무엇입니까?](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html)를 참조하세요.

Service Quotas를 사용하면 AWS Cloud Map 서비스 할당량의 값을 쉽게 찾을 수 있습니다.

------
#### [ AWS Management Console ]

**를 사용하여 AWS Cloud Map 서비스 할당량을 보려면 AWS Management Console**

1. [https://console.aws.amazon.com/servicequotas/](https://console.aws.amazon.com/servicequotas/)에서 Service Quotas 콘솔을 엽니다.

1. 탐색 창에서 **AWS 서비스**를 선택합니다.

1. **AWS 서비스** 목록에서 **AWS Cloud Map**를 검색하여 선택합니다.

1. 서비스 할당량 목록에서 서비스 할당량 이름 AWS Cloud Map, 적용된 값(사용 가능한 경우), AWS 기본 할당량 및 할당량 값을 조정할 수 있는지 여부를 확인할 수 있습니다.

   설명과 같은 서비스 할당량에 대한 추가 정보를 보려면 할당량 이름을 선택하여 할당량 세부 정보를 가져옵니다.

1. (선택 사항) 할당량 증가를 요청하려면 늘릴 할당량을 선택하고 **계정 수준에서 증가 요청을** 선택합니다.

를 사용하여 서비스 할당량에 대해 자세히 알아보려면 [Service Quotas 사용 설명서를](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html) AWS Management Console 참조하세요.

------
#### [ AWS CLI ]

**를 사용하여 AWS Cloud Map 서비스 할당량을 보려면 AWS CLI**  
다음 명령을 실행하여 기본 할당 AWS Cloud Map 량을 확인합니다.

```
aws service-quotas list-aws-default-service-quotas \
    --query 'Quotas[*].{Adjustable:Adjustable,Name:QuotaName,Value:Value,Code:QuotaCode}' \
    --service-code AWSCloudMap \
    --output table
```

다음 명령을 실행하여 적용된 할당 AWS Cloud Map 량을 확인합니다.

```
aws service-quotas list-service-quotas \
    --service-code AWSCloudMap
```

를 사용한 서비스 할당량 작업에 대한 자세한 내용은 [Service Quotas AWS CLI 명령](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/#cli-aws-service-quotas) AWS CLI참조를 참조하세요. 할당량 증가를 요청하려면 [AWS CLI 명령 참조](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/#cli-aws-service-quotas)에서 [https://docs.aws.amazon.com/cli/latest/reference/service-quotas/request-service-quota-increase.html](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/request-service-quota-increase.html) 명령을 참조하세요.

------

# Handle AWS Cloud Map DiscoverInstances API 요청 제한
<a name="throttling"></a>

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) 단원을 참조하십시오.

## 제한 적용 방법
<a name="throttling-how"></a>

AWS Cloud Map 는 [토큰 버킷 알고리즘](https://en.wikipedia.org/wiki/Token_bucket)을 사용하여 API 제한을 구현합니다. 이 알고리즘을 사용하면 계정에 특정 수의 *토큰*을 보관하는 *버킷*이 있습니다. 버킷의 토큰 수는 지정된 초당 제한 할당량을 나타냅니다. 단일 리전에는 버킷이 하나 있으며 이는 해당 리전의 모든 엔드포인트에 적용됩니다.

### 요청 속도 제한
<a name="throttling-rate-based"></a>

제한은 수행할 수 있는 [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 요청 횟수가 다시 채우기 속도보다 적은 경우에만 최대 용량까지 다시 채워지기 시작합니다.

### 재시도 또는 일괄 처리
<a name="retries"></a>

API 요청이 실패하는 경우 애플리케이션에서 요청을 재시도해야 할 수 있습니다. API 요청 수를 줄이려면 연속적인 요청 사이에 적절한 절전 간격을 사용하세요. 최상의 결과를 얻으려면 절전 시간 간격을 늘리거나 가변적으로 사용합니다.

### 휴면 간격 계산
<a name="calculate_delay_interval"></a>

API 요청을 폴링하거나 재시도해야 하는 경우 지수 백오프 알고리즘을 사용하여 API 호출 간 절전 시간 간격을 계산하는 것이 좋습니다. 연속적인 오류 응답에 대한 재시도 사이의 대기 시간을 점진적으로 늘리면 실패한 요청 수를 줄일 수 있습니다. 이 알고리즘의 자세한 내용과 구현 예제는 SDK 및 도구 참조 안내서의 [재시도 동작을](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html) 참조하세요. *AWS SDKs *

## API 제한 할당량 조정
<a name="throttling-increase"></a>

 AWS 계정에 대한 API 제한 할당량 증가를 요청할 수 있습니다. 할당량 조정을 요청하려면 [AWS Support Center](https://console.aws.amazon.com/support/home#/)에 문의하세요.