Delen via

Azure Quota-API

  • Artikel

De Quota-API is een REST API die u kunt gebruiken om quota voor Azure-services weer te geven en te beheren.

Belangrijk

Algemene beschikbaarheid van quota-API

Azure Quota-API is nu algemeen beschikbaar. Het ondersteunt momenteel virtuele Azure-machines (cores/vCPU) en Azure Machine Learning-services (toegewezen/vCPU's).

Opmerking: Een nieuwe versie van Quota REST API is in openbare preview, op Azure Quota Service REST API. Het maakt gebruik van de resourceprovider Microsoft.Quota en ondersteunt virtuele Azure-machines (kernen/vCPU), Azure Machine Learning, Azure-netwerken, Azure HPC Cache en Azure Purview-services.

Quota zijn de maximumwaarden voor resources, acties en items in uw Azure-abonnement. Elke Azure-service definieert de quota en de standaardwaarden. Afhankelijk van de behoeften van uw bedrijf moet u mogelijk uw quotumwaarden verhogen.

Zie Azure-abonnements- en servicelimieten, quota en beperkingen voor meer informatie over de meest voorkomende Limieten voor Microsoft Azure.

Quota-API gebruiken

Met quota-API kunt u het volgende doen:

  • Haal de huidige quota en het gebruik van een resource op.
  • Haal een lijst op met de huidige quota en het gebruik van alle resources.
  • Quota van een resource maken of bijwerken.
  • De status van quotumaanvragen voor een resource ophalen.
  • Haal de lijst op met alle quotumaanvragen van een resource voor één jaar.

REST-bewerkingen

Met de Azure Quota-API kunt u eenvoudig uw quota opzoeken en verhogingen aanvragen met behulp van deze REST-bewerkingen:

Vereisten

Belangrijk

Voordat u Quota-API kunt gebruiken, moet u het volgende doen:

De Microsoft Capacity-resourceprovider registreren

Gebruik deze PowerShell-opdracht om de Microsoft Capacity-resourceprovider te registreren:

Register-AzResourceProvider -ProviderNamespace Microsoft.Capacity

Er worden resultaten geretourneerd die vergelijkbaar zijn met deze uitvoer:

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

Zodra de resourceprovider Microsoft.Capacity is geregistreerd, wordt de RegistrationState ingesteld op Registered. Zie Azure-resourceproviders voor meer informatie over het beheren van Azure-resourceproviders.

Rol quotumaanvraagoperator

De rol Operator voor quotumaanvragen is een ingebouwde Azure-rol die is aangepast voor quotumbewerkingen. Het verleent machtigingen voor het lezen en maken van quotumaanvragen, het ophalen van de status van een quotumaanvraag en het maken van ondersteuningstickets. Wijs deze rol toe aan gebruikers, groepen, service-principals, beheerde identiteiten en toepassingen die quotumbewerkingen uitvoeren. Ter referentie is de rol-id van de operator voor quotumaanvragen 0e5f05e5-9ab9-446b-b98d-1e2157c94125.

vCPU-quota

U kunt quota-API gebruiken om quota te beheren voor deze twee typen vCPU-quota:

  • Standaard vCPU-quotum voor betalen per gebruik-VM's en gereserveerde VM-instanties.
  • Spot vCPU-quotum voor spot-VM's.

Zie Azure-abonnements- en servicelimieten, quota en beperkingen voor meer informatie over Azure-limieten en -quota.

Azure Machine Learning-quota

U kunt Quota-API gebruiken voor het beheren van quota voor Azure Machine Learning-werkruimten en berekeningen. Lees het artikel Quota voor resources beheren en verhogen met Azure Machine Learning voor meer informatie over:

  • Standaardlimieten voor Azure-resources met betrekking tot Azure Machine Learning.
  • Quota op werkruimteniveau maken.
  • Uw quota en limieten weergeven.
  • Quotumverhoging aanvragen.
  • Privé-eindpunt- en DNS-quota.

Regio's

De meeste quota zijn specifiek voor een workload in een bepaalde regio. Vraag afzonderlijke quota aan voor elke regio waar u een service wilt implementeren. Als u alle Azure-regio's wilt weergeven waarin de service bestaat, gebruikt u de bewerking Lijst op serviceregio's .

Beperking

Elke API-aanroep op abonnementsniveau en op tenantniveau kan worden beperkt als u te veel API-aanvragen verzendt. Als uw API-aanroep wordt beperkt, krijgt u een foutbericht waarin staat dat de server de API-aanvraag heeft afgewezen. U kunt de API-aanroep opnieuw proberen nadat enige tijd is verstreken.

Zie Problemen met beperkingsfouten in Azure oplossen voor meer informatie over API-beperking, het oplossen van beperkingsproblemen en het voorkomen van beperking.

Problemen met quota-API-fouten oplossen

Gebruik de volgende tabellen om fouten op te lossen die kunnen optreden tijdens het gebruik van quota-API.

Foutcode Hoe het op te lossen
ContactSupport Open een nieuwe ondersteuningsaanvraag in de Azure Portal. Kies onder Selecteer een probleemtypede optie Service- en abonnementslimieten (quota). U kunt deze ook programmatisch openen met behulp van de Azure Support REST API.
InternalServerError Interne serverfout. Voer de API-aanroep later opnieuw uit.
MissingRegistration Registreer de resourceprovider Microsoft.Capacity voor elk van uw abonnementen. Zie Fouten oplossen voor de registratie van resourceproviders voor hulp bij het oplossen van problemen.
QuotaNotAvailableForResource Het quotum is momenteel niet beschikbaar op de locatie voor de aangevraagde resource. Open een nieuwe ondersteuningsaanvraag in de Azure Portal. Kies onder Selecteer een probleemtypede optie Service- en abonnementslimieten (quota). U kunt deze ook programmatisch openen met behulp van de Azure Support REST API.
QuotaReductionNotSupported De huidige quotumlimiet is hoger dan het aangevraagde quotum of het huidige gebruik is hoger dan het aangevraagde quotum. Het verlagen van quota wordt niet ondersteund. Het quotum kan niet worden verlaagd.
Aanvraag beperkt Elke API-aanvragen op abonnementsniveau en op tenantniveau kunnen worden beperkt om te helpen bij de algehele prestaties van de service. Het aantal aanvragen heeft de maximaal toegestane API-aanvraagsnelheid overschreden. Probeer het later opnieuw.
ResourceNotAvailableForOffer De resource is momenteel niet beschikbaar op de locatie voor het aanbiedingstype. Zie de pagina Microsoft Azure-aanbiedingsgegevens voor de lijst met huidige en buiten gebruik gestelde aanbiedingen. Als u uw aanbiedingstype wilt wijzigen, raadpleegt u de pagina Uw Azure-abonnement wijzigen in een andere aanbieding . U kunt ook een nieuwe ondersteuningsaanvraag openen in de Azure Portal. Kies onder Selecteer een probleemtypede optie Service- en abonnementslimieten (quota). U kunt deze ook programmatisch openen met behulp van de Azure Support REST API.
ResourceNotAvailableForSubscription De resource is momenteel niet beschikbaar op de locatie voor het aangevraagde abonnement. Open een nieuwe ondersteuningsaanvraag in de Azure Portal. Kies onder Selecteer een probleemtypede optie Service- en abonnementslimieten (quota). U kunt deze ook programmatisch openen met behulp van de Azure Support REST API.
UnableToIncreaseQuota Kan de quota voor de aangevraagde abonnementen niet verhogen. Open een nieuwe ondersteuningsaanvraag in de Azure Portal. Kies onder Selecteer een probleemtypede optie Service- en abonnementslimieten (quota).

Ondersteuning in andere talen en interfaces

De QUOTA REST API is beschikbaar in de volgende taalspecifieke Microsoft Azure SDK's:

Azure Portal en ondersteunings-API gebruiken om quota te beheren

Met Azure kunt u ondersteuningsaanvragen maken en beheren, ook wel ondersteuningstickets genoemd. U kunt: