Azure Quota Service-API

  • Artikel

De AZURE Quota Service REST API is ontworpen voor het weergeven en beheren van quota voor Azure-resourceproviders.

Belangrijk

Azure Quota Service-API is openbare preview

Een nieuwe versie van de Azure Quota-API is openbare preview. Deze API maakt gebruik van Microsoft.Quota Resource Provider, ondersteunt virtuele Azure-machines (kernen/vCPU), Azure Machine Learning (toegewezen/vCPU's), netwerken, Azure HPC Cache, Storage en Azure Purview-services.

Een quotum is de servicelimiet of toelage die is ingesteld voor een resource in uw Azure-abonnement. Elke Azure-service definieert de quota en de standaardwaarden. Zie Limieten, quota en beperkingen voor Azure-abonnementen en -services voor meer informatie over de meest voorkomende Microsoft Azure-quota.

Quota-API's gebruiken

Met quota-API kunt u het volgende doen:

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

Put-aanroep en bereik van quotum-API

De PUT-aanvraag voor quota-API bevat een bereikparameter die kan worden aangepast aan de vereisten van resourceproviders die een quotumverhoging willen, zodat de API-aanroep uniform blijft.

https://management.azure.com/<scope>/Microsoft.Quota/quotas/<resourceName>?api-version=2021-03-15-preview
Resourceprovider Bereik
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}

Opmerking: hier vindt u een voorbeeld van een PUT-aanroep voor rekenkracht.

Vereisten

Belangrijk

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

De Microsoft Quota-resourceprovider registreren

Gebruik de onderstaande PowerShell-opdracht om de Microsoft Quota-resourceprovider te registreren:

Register-AzResourceProvider -ProviderNamespace Microsoft.Quota

Er worden resultaten geretourneerd die vergelijkbaar zijn met de onderstaande uitvoer:

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

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

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.

Rol quotumaanvraagoperator

De quotumaanvraagoperator 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.

De rol Quotumaanvraagoperator wordt uitgebreid met machtigingen voor quotumresourceproviders.

Best practices voor quotum-API's

  1. Quotum-gebruik bewaken: Gebruik de Azure-quotum-API om uw quotumgebruik effectief bij te houden. Deze API biedt realtime informatie over uw huidige gebruik en het beschikbare quotum voor een specifieke combinatie van abonnement, VM-familie en regio. Het is van cruciaal belang dat u regelmatig uw quotumgebruik controleert voordat u een quotumverhoging overweegt.

  2. Verhoging van quotum aanvragen: Als uw quotumgebruik het vooraf gedefinieerde doel overschrijdt, start u een aanvraag voor quotumverhoging met behulp van de Azure-quotum-API om uw gebruik weer in overeenstemming te brengen met uw doelstellingen. Het proces is eenvoudig: dien gewoon een API-aanvraag in met een overzicht van de gewenste quotumverhoging. Als bijvoorbeeld het doelgebruik voor het quotum van de Dv2-VM-familie in Europa - noord, onder 'abonnement1', is ingesteld op 80%, en uw Azure-quotum-API-bewaking een werkelijk gebruik van 85% aangeeft, dient u een quotumverhoging in van 10% tot 20%.

Tip

Het is raadzaam om een quotumverhoging van 10% tot 20% van de resource-utlization aan te vragen, omdat dit een resonalble buffer biedt voor onverwachte pieken in het resourcegebruik, zodat u niet onmiddellijk uw nieuwe quotumlimiet bereikt na een verhoging . Deze aanpak minimaliseert de noodzaak van frequente API-aanroepen om extra quotum aan te vragen, waardoor uw kansen op goedkeuring worden verbeterd.

  1. Quotumverhoging respnose: Wanneer u een aanvraag voor quotumverhoging indient, ontvangt u een antwoord waarin wordt aangegeven of uw aanvraag is goedgekeurd of afgewezen. In het geval van afwijzing kunt u een follow-up starten door een ondersteuningsaanvraag te registreren met behulp van de Azure Support REST API of met behulp van een nieuwe ondersteuningsaanvraag in de Azure Portal, inclusief de details van de aanvraag voor geweigerde quotumverhoging en de reden voor uw aanvraag.

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.Quota 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).
MFA vereist Voor quotumaanvragen is Multi-Factor Authentication vereist. Schakel Multi-Factor Authentication in voor uw tenant/account door de instructies in MFA inschakelen te volgen en probeer het opnieuw
Aanvraag gedeeltelijk voltooid Aan de aanvraag voor het quotum is gedeeltelijk voldaan. Open voor eventuele vragen 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:

Quota beheren met behulp van Azure Portal en ondersteunings-API

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