Dela via

Azure Quota Service API

  • Artikel

REST-API:et för Azure Quota Service är utformat för att visa och hantera kvoter för Azure-resursprovidrar.

Viktigt

Azure Quota Service-API:et är en offentlig förhandsversion

En ny Version av Azure Quota API är en offentlig förhandsversion. Det här API:et använder Microsoft.Quota Resource Provider, stöder virtuella Azure-datorer (kärnor/vCPU), Azure Machine Learning (dedikerade/vCPU:er), nätverk, Azure HPC Cache, Storage och Azure Purview-tjänster.

En kvot är tjänstgränsen eller ersättningen som angetts för en resurs i din Azure-prenumeration. Varje Azure-tjänst definierar sina kvoter och fastställer dess standardvärden. Mer information om de vanligaste Microsoft Azure-kvoterna finns i Azure-prenumerations- och tjänstgränser, kvoter och begränsningar.

Använda kvot-API:er

Med kvot-API:et kan du:

  1. Hämta aktuella kvoter och användningar för en resurs.
  2. Hämta en lista över aktuella kvoter och användningar av alla resurser.
  3. Skapa eller uppdatera kvoter för en resurs.
  4. Hämta status för kvotbegäranden för en resurs.
  5. Hämta listan över alla kvotbegäranden för en resurs i ett år

Kvot-API PUT-anrop och omfång

Put-begäran för kvot-API innehåller en parameter för "omfång" som kan anpassas efter kraven för resursprovidrar som söker en kvotökning, vilket säkerställer att API-anropet förblir enhetligt.

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

Obs! Exempel på PUT-anrop för beräkning finns här.

Förutsättningar

Viktigt

Innan du kan använda kvot-API:et måste du:

Registrera Microsoft Quota-resursprovidern

Om du vill registrera Microsoft Quota-resursprovidern använder du följande PowerShell-kommando:

Register-AzResourceProvider -ProviderNamespace Microsoft.Quota

Den returnerar resultat som liknar nedanstående utdata:

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

När resursprovidern Microsoft.Quota har registrerats anges den RegistrationState till Registered. Mer information om hur du hanterar Azure-resursprovidrar finns i Azure-resursprovidrar.

Begränsning

Alla API-anrop på prenumerationsnivå och klientnivå kan begränsas om du skickar för många API-begäranden. Om DITT API-anrop begränsas får du ett felmeddelande om att servern avvisade API-begäran. Du kan försöka igen med API-anropet efter att en viss tid har gått.

Mer information om API-begränsning, hur du felsöker begränsningsproblem och hur du undviker att begränsas finns i Felsöka begränsningsfel i Azure.

Operatorroll för kvotbegäran

Operatorn för kvotbegäran är en inbyggd Azure-roll som är anpassad för kvotåtgärder. Den ger behörighet att läsa och skapa kvotbegäranden, hämta status för kvotbegäran och skapa supportärenden. Tilldela den här rollen till användare, grupper, tjänstens huvudnamn, hanterade identiteter och program som utför kvotåtgärder. Som referens är roll-ID för kvotbegäran 0e5f05e5-9ab9-446b-b98d-1e2157c94125.

Rollen Operatör för kvotbegäran utökas till att omfatta behörigheter för kvotresursprovider.

Metodtips för kvot-API:er

  1. Övervaka kvotanvändning: Använd Azure-kvot-API:et för att spåra din kvotanvändning effektivt. Det här API:et innehåller realtidsinformation om din aktuella användning och den tillgängliga kvoten för en specifik kombination av prenumeration, VM-familj och region. Det är viktigt att regelbundet kontrollera kvotanvändningen innan du överväger en kvotökning.

  2. Begär kvotökning: Om din kvotanvändning överskrider det fördefinierade målet initierar du en begäran om kvotökning med hjälp av Azure-kvot-API:et för att få din användning tillbaka i linje med dina mål. Processen är enkel – skicka bara en API-begäran som beskriver den önskade kvotökningen. Om till exempel målanvändningen för Dv2 VM-familjekvoten i Europa, norra, under "subscription1" anges till 80 %, och din Azure-kvot-API-övervakning anger ett faktiskt utnyttjande på 85 %, skickar du en kvotökning på 10 % till 20 %.

Tips

Det är lämpligt att begära en kvotökning på 10 % till 20 % av resursanvändningen eftersom den ger en resonalbel buffert för oväntade toppar i resursanvändningen, vilket säkerställer att du inte omedelbart når din nya kvotgräns efter en ökning . Den här metoden minimerar behovet av frekventa API-anrop för att begära ytterligare kvot, vilket förbättrar dina chanser till godkännande.

  1. Kvotökningsstakt: När du skickar en begäran om kvotökning får du ett svar som anger om din begäran har godkänts eller avvisats. I händelse av avvisande kan du initiera en uppföljning genom att logga en supportbegäran med hjälp av REST-API:et för Azure Support eller med hjälp av en ny supportbegäran i Azure Portal, inklusive detaljerna i begäran om nekad kvotökning och orsaken till din förfrågan.

Felsöka kvot-API-fel

Använd följande tabeller för att felsöka fel som kan uppstå när du använder kvot-API:et.

Felkod Så här löser du det
KontaktaSupport Öppna en ny supportbegäran i Azure Portal. Under Välj en problemtyp väljer du Tjänst- och prenumerationsgränser (kvoter). Du kan också öppna den programmatiskt med hjälp av REST-API:et för Azure Support.
InternalServerError Internt serverfel. Försök igen med API-anropet senare.
MissingRegistration Registrera Microsoft.Quota-resursprovidern för var och en av dina prenumerationer. Felsökningsvägledning finns i Lösa fel för registrering av resursprovider.
QuotaNotAvailableForResource Kvoten är för närvarande inte tillgänglig på platsen för den begärda resursen. Öppna en ny supportbegäran i Azure Portal. Under Välj en problemtyp väljer du Tjänst- och prenumerationsgränser (kvoter). Du kan också öppna den programmatiskt med hjälp av REST-API:et för Azure Support.
QuotaReductionNotSupported Den aktuella kvotgränsen är högre än den begärda kvoten eller så är den aktuella användningen högre än den begärda kvoten. Det går inte att minska kvoterna. Kvoten kan inte minskas.
RequestThrottled Alla API-begäranden på prenumerationsnivå och klientnivå kan begränsas för att hjälpa till med tjänstens övergripande prestanda. Antalet begäranden överskred den högsta tillåtna API-begärandefrekvensen. Försök igen senare.
ResourceNotAvailableForOffer Resursen är för närvarande inte tillgänglig på platsen för erbjudandetypen. Listan över aktuella och tillbakadragna erbjudanden finns på sidan Microsoft Azure-erbjudandeinformation . Information om hur du ändrar erbjudandetyp finns på sidan Ändra din Azure-prenumeration till ett annat erbjudande . Du kan också öppna en ny supportbegäran i Azure Portal. Under Välj en problemtyp väljer du Tjänst- och prenumerationsgränser (kvoter). Du kan också öppna den programmatiskt med hjälp av REST-API:et för Azure Support.
ResourceNotAvailableForSubscription Resursen är för närvarande inte tillgänglig på platsen för den begärda prenumerationen. Öppna en ny supportbegäran i Azure Portal. Under Välj en problemtyp väljer du Tjänst- och prenumerationsgränser (kvoter).. Du kan också öppna den programmatiskt med hjälp av REST-API:et för Azure Support.
UnableToIncreaseQuota Det går inte att öka kvoterna för de begärda prenumerationerna. Öppna en ny supportbegäran i Azure Portal. Under Välj en problemtyp väljer du Tjänst- och prenumerationsgränser (kvoter)..
MFA krävs Kvotbegäranden behöver Multi-Factor Authentication. Aktivera Multi-Factor Authentication för din klientorganisation/ditt konto genom att följa anvisningarna i aktivera MFA och försök igen
RequestPartiallyFulfilled Kvotbegäran uppfylls delvis. Om du har frågor öppnar du en ny supportbegäran i Azure Portal. Under Välj en problemtyp väljer du Tjänst- och prenumerationsgränser (kvoter)

Support på andra språk och för andra gränssnitt

REST-API:et för kvoter är tillgängligt i följande språkspecifika Microsoft Azure-SDK:er:

Använda Azure Portal och support-API för att hantera kvoter

Med Azure kan du skapa och hantera supportförfrågningar, även kallade supportärenden. Du kan: