다음을 통해 공유


Azure 할당량 API

할당량 API는 Azure 서비스에 대한 할당량을 보고 관리하는 데 사용할 수 있는 REST API입니다.

중요

할당량 API 일반 공급

이제 Azure 할당량 API를 일반 공급합니다. 현재 Azure 가상 머신(코어/vCPU) 및 Azure Machine Learning 서비스(전용/vCPU)를 지원합니다.

참고: 새 버전의 할당량 REST API는 Azure Quota Service Rest API에서 공개 미리 보기로 제공됩니다. Microsoft.Quota 리소스 공급자를 사용하고 Azure 가상 머신(코어/vCPU), Azure Machine Learning, Azure 네트워킹, Azure HPC Cache 및 Azure Purview 서비스를 지원합니다.

할당량은 Azure 구독의 리소스, 작업 및 항목에 대한 최대 값입니다. 각 Azure 서비스는 할당량을 정의하고 기본값을 결정합니다. 비즈니스 요구 사항에 따라 할당량 값을 늘려야 할 수 있습니다.

가장 일반적인 Microsoft Azure 제한에 대한 자세한 내용은 Azure 구독 및 서비스 제한, 할당량 및 제약 조건을 참조하세요.

할당량 API 사용

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

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

REST 작업

Azure 할당량 API를 사용하면 다음 REST 작업을 사용하여 할당량을 쉽게 조회하고 증가를 요청할 수 있습니다.

필수 구성 요소

중요

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

Microsoft 용량 리소스 공급자 등록

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

Register-AzResourceProvider -ProviderNamespace Microsoft.Capacity

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

ProviderNamespace : Microsoft.Capacity
RegistrationState : Registering
ResourceTypes     : {resources, reservationOrders, reservationOrders/reservations, listbenefits...}
Locations         : {West Europe, East US, South Central US...}

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

할당량 요청 운영자 역할

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

vCPU 할당량

할당량 API를 사용하여 다음 두 가지 유형의 vCPU 할당량에 대한 할당량을 관리할 수 있습니다.

  • 종량제 VM 및 예약 VM 인스턴스에 대한 표준 vCPU 할당량입니다.
  • 스폿 VM 에 대한 스폿 vCPU 할당량입니다.

Azure 제한 및 할당량에 대한 자세한 내용은 Azure 구독 및 서비스 제한, 할당량 및 제약 조건을 참조하세요.

Azure Machine Learning 할당량

할당량 API를 사용하여 Azure Machine Learning 작업 영역 및 컴퓨팅에 대한 할당량을 관리할 수 있습니다. 다음 사항에 대해 알아보려면 Azure Machine Learning을 사용하여 리소스에 대한 할당량 관리 및 증가 문서를 참조하세요.

  • Azure Machine Learning과 관련된 Azure 리소스에 대한 기본 한도
  • 작업 영역 수준 할당량 만들기
  • 할당량 및 한도 보기
  • 할당량 증가 다시 요청
  • 프라이빗 엔드포인트 및 DNS 할당량

영역

대부분의 할당량은 한 지역의 워크로드에만 해당됩니다. 서비스를 배포하려는 각 지역에 대해 별도의 할당량을 요청합니다. 서비스가 있는 모든 Azure 지역을 나열하려면 서비스 지역별 나열 작업을 사용합니다.

스로틀

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

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

할당량 API 오류 문제 해결

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

오류 코드 해결 방법
ContactSupport Azure Portal 새 지원 요청을 엽니다. 문제 유형 선택에서서비스 및 구독 제한(할당량)을 선택합니다. Azure 지원 REST API를 사용하여 프로그래밍 방식으로 열 수도 있습니다.
InternalServerError 내부 서버 오류. 나중에 API 호출을 다시 시도합니다.
MissingRegistration 각 구독에 대해 Microsoft.Capacity 리소스 공급자를 등록합니다. 문제 해결 지침은 리소스 공급자 등록 오류 해결을 참조하세요.
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 새 지원 요청을 엽니다. 문제 유형 선택에서서비스 및 구독 제한(할당량)을 선택합니다.

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

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

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

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