Dela via

Api för Azure-kvot

  • Artikel

Kvot-API:et är ett REST-API som du kan använda för att visa och hantera kvoter för Azure-tjänster.

Viktigt

Allmän tillgänglighet för kvot-API

Azure Quota API är nu allmänt tillgängligt. Det stöder för närvarande virtuella Azure-datorer (kärnor/vCPU) och Azure Machine Learning-tjänster (dedikerade/vCPU:er).

Observera: En ny version av kvot-REST-API:et finns i offentlig förhandsversion i Rest-API:et för Azure Quota Service. Den använder Microsoft.Quota-resursprovidern och har stöd för azure-virtuella datorer (kärnor/vCPU), Azure Machine Learning, Azure-nätverk, Azure HPC Cache- och Azure Purview-tjänster.

Kvoter är de högsta värdena för resurser, åtgärder och objekt i din Azure-prenumeration. Varje Azure-tjänst definierar sina kvoter och fastställer dess standardvärden. Beroende på dina affärsbehov kan du behöva öka dina kvotvärden.

Mer information om de vanligaste Microsoft Azure-gränserna finns i Begränsningar, kvoter och begränsningar för Azure-prenumerationer och tjänster.

Använda kvot-API

Med kvot-API:et kan du:

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

REST-åtgärder

Azure Quota API gör det enkelt att slå upp dina kvoter och begära ökningar med hjälp av dessa REST-åtgärder:

Förutsättningar

Viktigt

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

Registrera Microsoft Capacity-resursprovidern

Om du vill registrera Microsoft Capacity-resursprovidern använder du det här PowerShell-kommandot:

Register-AzResourceProvider -ProviderNamespace Microsoft.Capacity

Den returnerar resultat som liknar dessa utdata:

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

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

Rollen Operator för kvotbegäran

Rollen Operatör 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.

vCPU-kvoter

Du kan använda kvot-API för att hantera kvoter för dessa två typer av vCPU-kvoter:

  • Standard-vCPU-kvot för virtuella datorer med betala per användning och reserverade VM-instanser.
  • VCPU-kvot för oanvänd kapacitet för virtuella datorer med oanvänd kapacitet .

Mer information om Gränser och kvoter för Azure finns i Azure-prenumerations- och tjänstgränser, kvoter och begränsningar.

Azure Machine Learning-kvoter

Du kan använda kvot-API för att hantera kvoter för Azure Machine Learning-arbetsytor och beräkning. Läs artikeln Hantera och öka kvoter för resurser med Azure Machine Learning för att lära dig mer om:

  • Standardgränser för Azure-resurser som är relaterade till Azure Machine Learning.
  • Skapa kvoter på arbetsytenivå.
  • Visa dina kvoter och gränser.
  • Begär kvotökningar.
  • Privata slutpunkter och DNS-kvoter.

Regioner

De flesta kvoter är specifika för en arbetsbelastning i en region. Begär separata kvoter för varje region där du vill distribuera en tjänst. Om du vill visa en lista över alla Azure-regioner där tjänsten finns använder du åtgärden Lista efter tjänstregioner .

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.

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 resursprovidern Microsoft.Capacity 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).

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:

  • Microsoft Azure SDK för .NET: NuGet-paket
  • Microsoft Azure SDK för Python: Py-paket
  • Microsoft Azure SDK för JavaScript (NodeJS & Browser): js-paket
  • Microsoft Azure SDK för Go: Go-paket

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: