Azure Resource Manager가 요청을 제한하는 방식 이해

이 문서에서는 Azure Resource Manager가 요청을 제한하는 방법을 설명합니다. 한도에 도달하기 전에 남아 있는 요청 수를 추적하는 방법과 한도에 도달했을 때 응답하는 방법을 보여 줍니다.

제한은 두 수준에서 발생합니다. Azure Resource Manager가 구독 및 테넌트에 대한 요청을 제한합니다. 요청이 구독 및 테넌트의 제한 한도 하에 있는 경우 Resource Manager는 리소스 공급자에게 요청을 라우팅합니다. 리소스 공급자는 해당 작업에 맞게 조정된 제한을 적용합니다.

다음 이미지에서는 요청이 사용자로부터 Azure Resource Manager 및 리소스 공급자로 진행될 때 제한이 적용되는 방식을 보여 줍니다. 이미지는 요청을 보내는 사용자의 지역에서 주체 ID 및 Azure Resource Manager 인스턴스별로 요청이 처음에 제한됨을 보여 줍니다. 요청은 시간당 제한됩니다. 요청이 리소스 공급자에 전달되면 요청은 사용자 지역의 Azure Resource Manager 인스턴스가 아닌 리소스의 지역별로 제한됩니다. 리소스 공급자 요청도 주 사용자 ID 및 시간별로 제한됩니다.

구독 및 테넌트 제한

모든 구독 수준 및 테넌트 수준 작업에는 제한이 적용됩니다. 구독 요청은 구독 내의 리소스 그룹 검색과 같이 구독 ID가 전달되는 요청입니다. 예를 들어, https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups?api-version=2022-01-01에 요청을 보내는 것은 구독 수준 작업입니다. 유효한 Azure 위치 검색 등의 테넌트 요청에는 구독 ID가 포함되지 않습니다. 예를 들어, https://management.azure.com/tenants?api-version=2022-01-01에 요청을 보내는 것은 테넌트 수준 작업입니다.

시간당 기본 제한 한도는 다음 표에 나와 있습니다.

범위	작업	제한
Subscription	reads	12000
구독	deletes	15000
구독	writes	1200
테넌트	reads	12000
테넌트	writes	1200

이러한 제한의 범위는 요청을 하는 보안 주체(사용자 또는 애플리케이션) 및 구독 ID나 테넌트 ID의 범위로 설정됩니다. 둘 이상의 보안 주체가 요청을 하는 경우 구독 또는 테넌트 전체에 적용되는 제한이 시간당 12,000개/1,200개보다 커집니다.

이러한 한도는 각 Azure Resource Manager 인스턴스에 적용됩니다. 모든 Azure 지역에 여러 인스턴스가 있으며 Azure Resource Manager가 모든 Azure 지역에 배포됩니다. 따라서 실제로 제한은 이러한 제한보다 높습니다. 사용자의 요청은 일반적으로 Azure Resource Manager의 서로 다른 인스턴스에 의해 처리됩니다.

나머지 요청은 응답 헤더 값으로 반환됩니다.

지역 제한 및 토큰 버킷 알고리즘으로 마이그레이션

Microsoft는 2024년부터 Azure 구독을 새로운 제한 아키텍처로 마이그레이션합니다. 이 변경으로 새로운 제한을 경험하게 될 것입니다. 새로운 제한은 Azure Resource Manager 인스턴스별이 아닌 지역별로 적용됩니다. 새로운 아키텍처는 토큰 버킷 알고리즘을 사용하여 API 제한을 관리합니다.

토큰 버킷은 초당 보낼 수 있는 최대 요청 수를 나타냅니다. 최대 요청 수에 도달하면 다시 채우기 속도에 따라 버킷에서 토큰을 사용할 수 있게 되는 속도가 결정됩니다.

업데이트된 한도를 통해 할당량을 새로 고치고 관리하는 것이 더 쉬워졌습니다.

새로운 한도는 다음과 같습니다.

범위	작업	버킷 크기	초당 다시 채우기 속도
구독	reads	250	25
구독	deletes	200	10
구독	writes	200	10
테넌트	reads	250	25
테넌트	deletes	200	10
테넌트	writes	200	10

구독 한도는 구독당, 서비스 주체당, 작업 유형당 적용됩니다. 각 작업 유형에 대한 개별 서비스 주체 한도의 15배에 해당하는 전역 구독 한도도 있습니다. 글로벌 한도는 모든 서비스 주체에 적용됩니다. 글로벌, 서비스 주체 또는 테넌트별 한도를 초과하면 요청이 제한됩니다.

무료 또는 체험 고객의 경우 한도가 더 작을 수 있습니다.

예를 들어, 읽기 요청에 대해 250개 토큰의 버킷 크기와 초당 25개 토큰의 다시 채우기 속도이 있다고 가정해 보겠습니다. 1초에 250개의 읽기 요청을 보내면 버킷이 비어 있고 요청이 제한됩니다. 버킷이 최대 용량인 250개 토큰에 도달할 때까지 매초 25개의 토큰이 사용 가능해집니다. 토큰은 사용 가능해지면 사용할 수 있습니다.

내 구독에서 새로운 속도 제한 환경을 사용하는지 어떻게 알 수 있나요?

구독이 새로운 제한 환경으로 마이그레이션된 후에는 응답 헤더에 시간당이 아닌 분당으로 남은 요청 수가 표시됩니다. 또한, Retry-After 값은 5분이 아닌 1분 이하를 표시합니다. 자세한 내용은 오류 코드를 참조하세요.

제한이 인스턴스별이 아닌 지역별로 변경되는 이유는 무엇인가요?

지역마다 Resource Manager 인스턴스 수가 다르기 때문에 인스턴스당 제한을 적용하면 제한 성능이 일관되지 않습니다. 지역별로 제한을 두어 일관적이고 예측 가능한 제한을 구현합니다.

새로운 속도 제한 환경이 내 제한에 어떤 영향을 미치나요?

더 많은 요청을 보낼 수 있습니다. 쓰기 요청이 30배 증가했습니다. 삭제 요청이 2.4배 증가했습니다. 읽기 요청이 7.5배 증가했습니다.

내 구독이 새로운 속도 제한 환경으로 마이그레이션되는 것을 방지할 수 있나요?

아니요. 모든 구독은 결국 마이그레이션됩니다.

리소스 공급자 제한

리소스 공급자는 자체 제한 한도를 적용합니다. 각 구독 내에서 리소스 공급자는 요청에서 리소스의 지역별로 제한합니다. Resource Manager는 Resource Manager의 인스턴스로 제한되고 각 지역에 여러 Resource Manager 인스턴스가 있기 때문에 리소스 공급자는 이전 섹션의 기본 제한보다 더 많은 요청을 받을 수 있습니다.

이 섹션에서는 광범위하게 사용되는 일부 리소스 공급자의 제한 한도에 대해 설명합니다.

스토리지 제한

다음과 같은 제한은 Azure Storage와 Azure Resource Manager를 사용하여 관리 작업을 수행하는 경우에만 적용됩니다. 제한은 요청에서 리소스의 지역별로 적용됩니다.

리소스	제한
Storage 계정 관리 작업(읽기)	5분당 800
Storage 계정 관리 작업(쓰기)	초당 10/시간당 1200
Storage 계정 관리 작업(목록)	5분당 100

네트워크 제한

Microsoft. Network 리소스 공급자는 다음과 같은 제한 한도를 적용합니다.

작업(Operation)	제한
쓰기/삭제(PUT)	5분당 1000개
읽기(GET)	5분당 10000개

이러한 일반적인 제한 외에도 Azure DNS에 대한 사용 제한을 참조하세요.

계산 제한

Microsoft Compute는 가상 머신 및 가상 머신 확장 집합 사용자에게 최적의 환경을 제공하기 위해 제한 기능을 구현합니다. 컴퓨팅 제한 한도는 VM, Virtual Machine Scale Sets 및 확장 집합 VM에 대한 제한 정책 및 한도에 대한 포괄적인 정보를 제공합니다.

Azure Resource Graph 제한

Azure Resource Graph는 해당 작업에 대한 요청 수를 제한합니다. 이 문서에서 제한에 도달했을 때 응답하는 방법 및 남은 요청을 결정하는 단계는 Resource Graph에도 적용됩니다. 그러나 Resource Graph는 자체 제한 및 재설정 비율을 설정합니다. 자세한 내용은 Resource Graph 제한 헤더를 참조하세요.

기타 리소스 공급자

기타 리소스 공급자의 제한에 대한 자세한 내용은 다음을 참조하세요.

• Azure Key Vault 제한 지침
• AKS 문제 해결
• 관리 ID

오류 코드

한도에 도달하면 HTTP 상태 코드 429 너무 많은 요청이 표시됩니다. 응답에는 Retry-After 값이 포함되며 이는 애플리케이션이 다음 요청을 보낼 때까지 대기(또는 절전)하는 시간(초)을 지정합니다. 다시 시도 값이 경과하기 전에 요청을 보내면 요청이 처리되지 않고 새 다시 시도 값이 반환됩니다.

Azure SDK를 사용하는 경우 SDK에 자동 다시 시도 구성이 있을 수 있습니다. 자세한 내용은 Azure 서비스에 대한 다시 시도 지침을 참조하세요.

일부 리소스 공급자는 429를 반환하여 임시 문제를 보고합니다. 이 문제는 요청에 의해 직접 발생하지 않는 오버로드 조건일 수 있습니다. 또는 대상 리소스 또는 종속 리소스의 상태에 대한 일시적인 오류를 나타낼 수 있습니다. 예를 들어, 네트워크 리소스 공급자는 다른 작업에 의해 대상 리소스가 잠겨 있을 때 RetryableErrorDueToAnotherOperation 오류 코드와 함께 429를 반환합니다. 오류가 제한 또는 일시적인 상태에서 발생하는지 확인하려면 응답에서 오류 세부 정보를 확인합니다.

나머지 요청

응답 헤더를 검사하여 나머지 요청 수를 확인할 수 있습니다. 읽기 요청은 나머지 읽기 요청 수에 대한 헤더의 값을 반환합니다. 쓰기 요청에는 나머지 쓰기 요청 수에 대한 값이 포함됩니다. 다음 표에서는 해당 값을 검사할 수 있는 응답 헤더를 설명합니다.

응답 헤더	설명
x-ms-ratelimit-remaining-subscription-deletes	구독 범위 삭제가 남아 있습니다. 이 값은 삭제 작업에서 반환됩니다.
x-ms-ratelimit-remaining-subscription-reads	구독에 범위가 지정된 나머지 읽기. 이 값은 읽기 작업에서 반환됩니다.
x-ms-ratelimit-remaining-subscription-writes	구독에 범위가 지정된 나머지 쓰기. 이 값은 쓰기 작업에서 반환됩니다.
x-ms-ratelimit-remaining-tenant-reads	테넌트에 범위가 지정된 나머지 읽기
x-ms-ratelimit-remaining-tenant-writes	테넌트에 범위가 지정된 나머지 쓰기
x-ms-ratelimit-remaining-subscription-resource-requests	구독에 범위가 지정된 나머지 리소스 종류 요청. 이 헤더 값은 서비스가 기본 제한을 재정의하는 경우에만 반환됩니다. Resource Manager는 구독 읽기 또는 쓰기 대신 이 값을 추가합니다.
x-ms-ratelimit-remaining-subscription-resource-entities-read	구독에 범위가 지정된 나머지 리소스 종류 컬렉션 요청. 이 헤더 값은 서비스가 기본 제한을 재정의하는 경우에만 반환됩니다. 이 값은 나머지 컬렉션 요청 수를 제공합니다(리소스 나열).
x-ms-ratelimit-remaining-tenant-resource-requests	테넌트에 범위가 지정된 나머지 리소스 종류 요청. 이 헤더는 테넌트 수준의 요청에만 추가되며, 서비스가 기본 제한을 재정의하는 경우에만 추가됩니다. Resource Manager는 테넌트 읽기 또는 쓰기 대신 이 값을 추가합니다.
x-ms-ratelimit-remaining-tenant-resource-entities-read	테넌트에 범위가 지정된 나머지 리소스 종류 컬렉션 요청. 이 헤더는 테넌트 수준의 요청에만 추가되며, 서비스가 기본 제한을 재정의하는 경우에만 추가됩니다.

리소스 공급자는 남은 요청에 대한 정보와 함께 응답 헤더를 반환할 수도 있습니다. 계산 리소스 공급자에서 반환하는 응답 헤더에 대한 자세한 내용은 통화 요금 정보 응답 헤더를 참조하세요.

헤더 값 검색

코드 또는 스크립트에서 이러한 헤더 값을 검색하는 것은 임의의 헤더 값을 검색하는 것과 같습니다.

예를 들어 C#에서는 다음 코드로 response로 명명된 HttpWebResponse 개체에서 헤더 값을 검색합니다.

response.Headers.GetValues("x-ms-ratelimit-remaining-subscription-reads").GetValue(0)

PowerShell에서는 Invoke-WebRequest 작업에서 헤더 값을 검색합니다.

$r = Invoke-WebRequest -Uri https://management.azure.com/subscriptions/{guid}/resourcegroups?api-version=2016-09-01 -Method GET -Headers $authHeaders
$r.Headers["x-ms-ratelimit-remaining-subscription-reads"]

전체 PowerShell 예제는 구독에 대한 Resource Manager 제한 확인을 참조하세요.

디버깅을 위해 남은 요청 수를 확인하려는 경우 PowerShell cmdlet에 -Debug 매개 변수를 제공할 수 있습니다.

Get-AzResourceGroup -Debug

그러면 다음 응답 값을 포함한 많은 값이 반환됩니다.

DEBUG: ============================ HTTP RESPONSE ============================

Status Code:
OK

Headers:
Pragma                        : no-cache
x-ms-ratelimit-remaining-subscription-reads: 11999

쓰기 제한을 가져오려면 쓰기 작업을 사용합니다.

New-AzResourceGroup -Name myresourcegroup -Location westus -Debug

그러면 다음 값을 포함하는 많은 값이 반환됩니다.

DEBUG: ============================ HTTP RESPONSE ============================

Status Code:
Created

Headers:
Pragma                        : no-cache
x-ms-ratelimit-remaining-subscription-writes: 1199

Azure CLI에서 더 많은 자세한 정보 표시 옵션을 사용하여 헤더 값을 검색합니다.

az group list --verbose --debug

그러면 다음 값을 포함하는 많은 값이 반환됩니다.

msrest.http_logger : Response status: 200
msrest.http_logger : Response headers:
msrest.http_logger :     'Cache-Control': 'no-cache'
msrest.http_logger :     'Pragma': 'no-cache'
msrest.http_logger :     'Content-Type': 'application/json; charset=utf-8'
msrest.http_logger :     'Content-Encoding': 'gzip'
msrest.http_logger :     'Expires': '-1'
msrest.http_logger :     'Vary': 'Accept-Encoding'
msrest.http_logger :     'x-ms-ratelimit-remaining-subscription-reads': '11998'

쓰기 제한을 가져오려면 쓰기 작업을 사용합니다.

az group create -n myresourcegroup --location westus --verbose --debug

그러면 다음 값을 포함하는 많은 값이 반환됩니다.

msrest.http_logger : Response status: 201
msrest.http_logger : Response headers:
msrest.http_logger :     'Cache-Control': 'no-cache'
msrest.http_logger :     'Pragma': 'no-cache'
msrest.http_logger :     'Content-Length': '163'
msrest.http_logger :     'Content-Type': 'application/json; charset=utf-8'
msrest.http_logger :     'Expires': '-1'
msrest.http_logger :     'x-ms-ratelimit-remaining-subscription-writes': '1199'

다음 단계

• 제한 및 할당량에 대한 자세한 내용은 Azure 구독 및 서비스 제한, 할당량 및 제약 조건을 참조하세요.
• 비동기 REST 요청 처리에 대해 알아보려면 Azure 비동기 작업 추적을 참조하세요.