Azure Quota Service API

Azure 할당량 서비스 REST API는 Azure 리소스 공급자에 대한 할당량을 보고 관리하도록 설계되었습니다.

중요

Azure Quota Service API는 공개 미리 보기입니다.

새 Azure 할당량 API 버전은 공개 미리 보기입니다. 이 API는 Microsoft.Quota 리소스 공급자를 사용하고, Azure 가상 머신(코어/vCPU), Azure Machine Learning(전용/vCPU), 네트워킹, Azure HPC Cache, Storage 및 Azure Purview 서비스를 지원합니다.

할당량은 Azure 구독의 리소스에 설정된 서비스 제한 또는 허용 한도입니다. 각 Azure 서비스는 할당량을 정의하고 기본값을 결정합니다. 가장 일반적인 Microsoft Azure 할당량에 대한 자세한 내용은 Azure 구독 및 서비스 제한, 할당량 및 제약 조건을 참조하세요.

할당량 API 사용

할당량 API를 사용하면 다음을 수행할 수 있습니다.

1. 리소스의 현재 할당량 및 사용량을 가져옵니다.
2. 모든 리소스의 현재 할당량 및 사용량 목록을 가져옵니다.
3. 리소스의 할당량을 만들거나 업데이트합니다.
4. 리소스에 대한 할당량 요청의 상태 가져옵니다.
5. 1년 동안 리소스의 모든 할당량 요청 목록을 가져옵니다.

할당량 API PUT 호출 및 scope

할당량 API PUT 요청에는 할당량 증가를 원하는 리소스 공급자의 요구 사항에 맞게 사용자 지정할 수 있는 "scope" 매개 변수가 포함되어 API 호출이 균일하게 유지되도록 합니다.

https://management.azure.com/<scope>/Microsoft.Quota/quotas/<resourceName>?api-version=2021-03-15-preview

리소스 공급자	범위
Microsoft.Compute	subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{azure location}
Microsoft.HDInsight	subscriptions/{subscriptionId}/providers/Microsoft.HDInsight/locations/{azure location}
Microsoft.MachineLearningService	subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningService/locations/{azure location}
Microsoft.Network	subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{azure location}
Microsoft.Purview	subscriptions/{subscriptionId}/providers/Microsoft.Purview/locations/{azure location}

참고: 컴퓨팅에 대한 PUT 호출의 예는 여기에서 찾을 수 있습니다.

필수 구성 요소

중요

할당량 API를 사용하려면 먼저 다음을 수행해야 합니다.

• PowerShell을 사용하여 모든 구독에 대해 Microsoft.Quota 리소스 공급자를 등록합니다.
• 할당량 작업을 수행할 모든 사용자 계정 및 애플리케이션에 할당량 요청 운영자 역할을 할당합니다.

Microsoft 할당량 리소스 공급자 등록

Microsoft 할당량 리소스 공급자를 등록하려면 아래 PowerShell 명령을 사용합니다.

Register-AzResourceProvider -ProviderNamespace Microsoft.Quota

아래 출력과 유사한 결과를 반환합니다.

ProviderNamespace : Microsoft.Quota
RegistrationState : Registering
ResourceTypes     : {usages, quotas, quotaRequests, operationsStatus...}
Locations         : {West Europe, East US, South Central US...}

Microsoft.Quota 리소스 공급자가 등록되면 가 RegistrationState 로 Registered설정됩니다. Azure 리소스 공급자 관리에 대한 자세한 내용은 Azure 리소스 공급자를 참조하세요.

스로틀

너무 많은 API 요청을 보내는 경우 모든 구독 수준 및 테넌트 수준 API 호출을 제한할 수 있습니다. API 호출이 제한되면 서버가 API 요청을 거부했음을 나타내는 오류 메시지가 표시됩니다. 시간이 경과한 후 API 호출을 다시 시도할 수 있습니다.

API 제한, 제한 문제를 해결하는 방법 및 제한을 방지하는 방법에 대한 자세한 내용은 Azure에서 제한 오류 문제 해결을 참조하세요.

할당량 요청 운영자 역할

할당량 요청 연산자는 할당량 작업에 맞게 사용자 지정된 Azure 기본 제공 역할입니다. 할당량 요청을 읽고 만들고, 할당량 요청 상태 받고, 지원 티켓을 만들 수 있는 권한을 부여합니다. 할당량 작업을 수행하는 사용자, 그룹, 서비스 주체, 관리 ID 및 애플리케이션에 이 역할을 할당합니다. 참고로 할당량 요청 운영자 역할 ID는 0e5f05e5-9ab9-446b-b98d-1e2157c94125입니다.

할당량 요청 운영자 역할은 할당량 리소스 공급자 권한을 포함하도록 확장됩니다.

할당량 API 모범 사례

1. 할당량 사용률 모니터링: Azure 할당량 API를 활용하여 할당량 사용량을 효과적으로 추적합니다. 이 API는 구독, VM 제품군 및 지역의 특정 조합에 대해 현재 사용량 및 사용 가능한 할당량에 대한 실시간 정보를 제공합니다. 할당량 증가를 고려하기 전에 할당량 사용률을 정기적으로 검사 것이 중요합니다.

2. 할당량 증가 요청: 할당량 사용률이 미리 정의된 목표를 초과하는 경우 Azure 할당량 API를 사용하여 할당량 증가 요청을 시작하여 사용률을 목표에 맞게 다시 가져옵니다. 프로세스는 간단합니다. 원하는 할당량 증가를 간략하게 설명하는 API 요청을 제출하기만 하면 됩니다. 예를 들어 "subscription1"에서 유럽 북부의 Dv2 VM 제품군 할당량에 대한 대상 사용률이 80%로 설정되고 Azure 할당량 API 모니터링이 실제 사용률이 85%인 경우 할당량 증가를 10%에서 20%로 제출합니다.

팁

리소스 사용량의 예기치 않은 급증에 대한 공진 버퍼를 제공하므로 리소스 사용량의 10%에서 20%의 할당량 증가를 요청하는 것이 좋습니다. 증가 후 새 할당량 한도에 즉시 도달하지 않도록 합니다. 이 방법은 추가 할당량을 요청하기 위해 빈번한 API 호출의 필요성을 최소화하여 승인 가능성을 높입니다.

3. 할당량 증가 다시 표시: 할당량 증가 요청을 제출하면 요청이 승인 또는 거부되었는지 여부를 나타내는 응답을 받게 됩니다. 거부 시 거부된 할당량 증가 요청의 세부 사항 및 문의 이유를 포함하여 Azure 지원 REST API를 사용하거나 Azure Portal 새 지원 요청을 사용하여 지원 요청을 로깅하여 후속 작업을 시작할 수 있습니다.

할당량 API 오류 문제 해결

할당량 API를 사용하는 동안 발생할 수 있는 오류를 해결하려면 다음 표를 사용합니다.

오류 코드	해결 방법
ContactSupport	Azure Portal 새 지원 요청을 엽니다. 문제 유형 선택에서서비스 및 구독 제한(할당량)을 선택합니다. Azure 지원 REST API를 사용하여 프로그래밍 방식으로 열 수도 있습니다.
InternalServerError	내부 서버 오류. 나중에 API 호출을 다시 시도합니다.
MissingRegistration	각 구독에 대해 Microsoft.Quota 리소스 공급자를 등록합니다. 문제 해결 지침은 리소스 공급자 등록 오류 해결을 참조하세요.
QuotaNotAvailableForResource	현재 요청된 리소스의 위치에서 할당량을 사용할 수 없습니다. Azure Portal 새 지원 요청을 엽니다. 문제 유형 선택에서서비스 및 구독 제한(할당량)을 선택합니다. Azure 지원 REST API를 사용하여 프로그래밍 방식으로 열 수도 있습니다.
QuotaReductionNotSupported	현재 할당량 한도가 요청된 할당량보다 높거나 현재 사용량이 요청된 할당량보다 높습니다. 할당량 감소는 지원되지 않습니다. 할당량을 줄일 수 없습니다.
RequestThrottled	모든 구독 수준 및 테넌트 수준 API 요청은 서비스의 전반적인 성능에 도움이 되도록 제한될 수 있습니다. 요청 수가 허용되는 최대 API 요청 속도를 초과했습니다. 나중에 다시 시도하십시오.
ResourceNotAvailableForOffer	현재 제품 유형의 위치에서 리소스를 사용할 수 없습니다. 현재 및 사용 중지된 제품 목록은 Microsoft Azure 제품 세부 정보 페이지를 참조하세요. 제품 유형을 변경하려면 Azure 구독을 다른 제품으로 변경 페이지를 참조하세요. Azure Portal 새 지원 요청을 열 수도 있습니다. 문제 유형 선택에서서비스 및 구독 제한(할당량)을 선택합니다. Azure 지원 REST API를 사용하여 프로그래밍 방식으로 열 수도 있습니다.
ResourceNotAvailableForSubscription	리소스는 현재 요청된 구독의 위치에서 사용할 수 없습니다. Azure Portal 새 지원 요청을 엽니다. 문제 유형 선택에서서비스 및 구독 제한(할당량)을 선택합니다. Azure 지원 REST API를 사용하여 프로그래밍 방식으로 열 수도 있습니다.
UnableToIncreaseQuota	요청된 구독에 대한 할당량을 늘릴 수 없습니다. Azure Portal 새 지원 요청을 엽니다. 문제 유형 선택에서서비스 및 구독 제한(할당량)을 선택합니다.
필요한 MFA	할당량 요청에는 Multi-Factor Authentication이 필요합니다. MFA 사용의 지침에 따라 테넌트/계정에 Multi-Factor Authentication을 사용하도록 설정하고 다시 시도하세요.
RequestPartiallyFulfilled	할당량 요청이 부분적으로 처리됩니다. 질문이 있으면 Azure Portal 새 지원 요청을 엽니다. 문제 유형 선택에서서비스 및 구독 제한(할당량)을 선택합니다.

다른 언어 및 인터페이스 지원

할당량 REST API는 다음 언어별 Microsoft Azure SDK에서 사용할 수 있습니다.

• .NET용 Microsoft Azure SDK: NuGet 패키지
• Java용 Microsoft Azure SDK: Java 패키지
• Python용 Microsoft Azure SDK: Py 패키지
• JavaScript용 Microsoft Azure SDK(NodeJS & Browser): JavaScript 패키지
• Go용 Microsoft Azure SDK: Go 패키지
• Microsoft Azure CLI 확장: Cli 패키지

Azure Portal 및 지원 API를 사용하여 할당량 관리

Azure를 통해 지원 티켓이라고도 하는 지원 요청을 만들고 관리할 수 있습니다. 다음과 같습니다.

• Azure Portal 사용하여 지원 티켓을 만듭니다.
• Azure 지원 티켓 REST API를 사용하여 프로그래밍 방식으로 지원 티켓을 만듭니다.