Azure Quota Service API

  • Artykuł

Interfejs API REST usługi Azure Quota Service jest przeznaczony do wyświetlania limitów przydziału dla dostawców zasobów platformy Azure i zarządzania nimi.

Ważne

Interfejs API usługi Azure Quota Service to publiczna wersja zapoznawcza

Nowa wersja interfejsu API limitu przydziału platformy Azure to publiczna wersja zapoznawcza. Ten interfejs API używa dostawcy zasobów Microsoft.Quota, obsługuje maszyny wirtualne platformy Azure (rdzenie/procesory wirtualne), usługę Azure Machine Learning (dedykowane/wirtualne procesory), sieć, platformę Azure HPC Cache, usługę Storage i usługę Azure Purview.

Limit przydziału to limit usługi lub dodatek ustawiony dla zasobu w ramach subskrypcji platformy Azure. Każda usługa platformy Azure definiuje swoje przydziały i określa wartości domyślne. Aby uzyskać więcej informacji na temat najbardziej typowych limitów przydziałów platformy Microsoft Azure, zobacz Limity subskrypcji i usług platformy Azure, limity przydziału i ograniczenia.

Korzystanie z interfejsów API limitu przydziału

Za pomocą interfejsu API przydziału można wykonywać następujące czynności:

  1. Pobierz bieżące przydziały i użycie zasobu.
  2. Pobierz listę bieżących przydziałów i użycia wszystkich zasobów.
  3. Tworzenie lub aktualizowanie przydziałów zasobu.
  4. Uzyskaj stan żądań przydziału dla zasobu.
  5. Pobieranie listy wszystkich żądań przydziału zasobu przez jeden rok

Wywołanie i zakres put interfejsu API limitu przydziału

Żądanie PUT interfejsu API przydziału zawiera parametr "zakres", który można dostosować do wymagań dostawców zasobów poszukujących zwiększenia limitu przydziału, zapewniając, że wywołanie interfejsu API pozostaje jednolite.

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

Uwaga: przykład wywołania PUT dla obliczeń można znaleźć tutaj.

Wymagania wstępne

Ważne

Aby można było użyć interfejsu API limitu przydziału, musisz:

Rejestrowanie dostawcy zasobów limitu przydziału firmy Microsoft

Aby zarejestrować dostawcę zasobów limitu przydziału firmy Microsoft, użyj poniższego polecenia programu PowerShell:

Register-AzResourceProvider -ProviderNamespace Microsoft.Quota

Zwraca wyniki podobne do poniższych danych wyjściowych:

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

Po zarejestrowaniu RegistrationState dostawcy zasobów Microsoft.Quota zostanie ustawiona wartość Registered. Aby uzyskać więcej informacji na temat zarządzania dostawcami zasobów platformy Azure, zobacz Dostawcy zasobów platformy Azure.

Ograniczanie przepływności

Każde wywołania interfejsu API na poziomie subskrypcji i na poziomie dzierżawy mogą być ograniczane, jeśli wysyłasz zbyt wiele żądań interfejsu API. Jeśli wywołanie interfejsu API jest ograniczone, zostanie wyświetlony komunikat o błędzie informujący, że serwer odrzucił żądanie interfejsu API. Po upływie pewnego czasu możesz ponowić próbę wywołania interfejsu API.

Aby uzyskać szczegółowe informacje na temat ograniczania przepływności interfejsu API, sposobu rozwiązywania problemów z ograniczaniem przepustowości oraz sposobu unikania ograniczania przepustowości, zobacz Rozwiązywanie problemów z błędami ograniczania przepustowości na platformie Azure.

Rola operatora żądania przydziału

Operator żądania przydziału jest wbudowaną rolą platformy Azure dostosowaną do operacji przydziału. Udziela uprawnień do odczytu i tworzenia żądań przydziału, uzyskiwania stanu żądania przydziału i tworzenia biletów pomocy technicznej. Przypisz tę rolę do użytkowników, grup, jednostek usługi, tożsamości zarządzanych i aplikacji, które wykonują operacje przydziału. W przypadku odwołania identyfikator roli Operator żądania przydziału to 0e5f05e5-9ab9-446b-b98d-1e2157c94125.

Rola Operator żądania przydziału jest rozszerzona, aby uwzględnić uprawnienia dostawcy zasobów przydziału.

Najlepsze rozwiązania dotyczące interfejsów API limitu przydziału

  1. Monitorowanie wykorzystania limitu przydziału: Użyj interfejsu API limitu przydziału platformy Azure, aby efektywnie śledzić użycie limitu przydziału. Ten interfejs API zawiera informacje w czasie rzeczywistym dotyczące bieżącego użycia i dostępnego limitu przydziału dla określonej kombinacji subskrypcji, rodziny maszyn wirtualnych i regionu. Ważne jest, aby regularnie sprawdzać wykorzystanie limitu przydziału przed rozważeniem zwiększenia limitu przydziału.

  2. Żądanie zwiększenia limitu przydziału: Jeśli użycie limitu przydziału przekroczy wstępnie zdefiniowany cel, zainicjuj żądanie zwiększenia limitu przydziału przy użyciu interfejsu API limitu przydziału platformy Azure, aby przywrócić wykorzystanie zgodnie z twoimi celami. Proces jest prosty — po prostu prześlij żądanie interfejsu API, które określa żądany wzrost limitu przydziału. Jeśli na przykład docelowe wykorzystanie limitu przydziału rodziny maszyn wirtualnych Dv2 w Europie Północnej, w obszarze "subscription1", wynosi 80%, a monitorowanie interfejsu API limitu przydziału platformy Azure wskazuje rzeczywiste wykorzystanie wynoszące 85%, prześlij wzrost limitu przydziału wynoszącego 10% do 20%.

Porada

Zaleca się zażądanie zwiększenia limitu przydziału do 10% do 20% utlization zasobu, ponieważ zapewnia bufor resonalble dla nieoczekiwanych skoków użycia zasobów, zapewniając, że nie zostanie natychmiast osiągnięty nowy limit przydziału po wzroście. Takie podejście minimalizuje potrzebę częstych wywołań interfejsu API w celu żądania dodatkowego limitu przydziału, co zwiększa szanse na zatwierdzenie.

  1. Zwiększenie limitu przydziału: Po przesłaniu żądania zwiększenia limitu przydziału otrzymasz odpowiedź wskazującą, czy żądanie zostało zatwierdzone, czy odrzucone. W przypadku odrzucenia możesz zainicjować kontynuację, rejestrując wniosek o pomoc techniczną przy użyciu interfejsu API REST pomocy technicznej platformy Azure lub korzystając z nowego żądania pomocy technicznej w Azure Portal, w tym specyfiki żądania odmowy zwiększenia limitu przydziału i przyczyny zapytania.

Rozwiązywanie problemów z błędami interfejsu API przydziału

Poniższe tabele umożliwiają rozwiązywanie problemów z błędami, które mogą wystąpić podczas korzystania z interfejsu API przydziału.

Kod błędu Jak rozwiązać ten problem
ContactSupport Otwórz nowe żądanie pomocy technicznej w Azure Portal. W obszarze Wybierz typ problemu wybierz pozycję Limity usług i subskrypcji (limity przydziału). Możesz również otworzyć go programowo przy użyciu interfejsu API REST pomocy technicznej platformy Azure.
InternalServerError Wewnętrzny błąd serwera. Ponów próbę wywołania interfejsu API później.
MissingRegistration Zarejestruj dostawcę zasobów Microsoft.Quota dla każdej z Twoich subskrypcji. Aby uzyskać wskazówki dotyczące rozwiązywania problemów, zobacz Rozwiązywanie błędów dotyczących rejestracji dostawcy zasobów.
QuotaNotAvailableForResource Limit przydziału jest obecnie niedostępny w lokalizacji żądanego zasobu. Otwórz nowe żądanie pomocy technicznej w Azure Portal. W obszarze Wybierz typ problemu wybierz pozycję Limity usług i subskrypcji (limity przydziału). Możesz również otworzyć go programowo przy użyciu interfejsu API REST pomocy technicznej platformy Azure.
QuotaReductionNotSupported Bieżący limit przydziału jest wyższy niż żądany limit przydziału lub bieżące użycie jest wyższe niż żądany limit przydziału. Zmniejszenie limitów przydziału nie jest obsługiwane. Nie można zmniejszyć limitu przydziału.
RequestThrottled Wszystkie żądania interfejsu API na poziomie subskrypcji i na poziomie dzierżawy mogą być ograniczane, aby ułatwić ogólną wydajność usługi. Liczba żądań przekroczyła maksymalną dozwoloną szybkość żądań interfejsu API. Spróbuj ponownie później.
ResourceNotAvailableForOffer Zasób jest obecnie niedostępny w lokalizacji typu oferty. Aby uzyskać listę bieżących i wycofanych ofert, zobacz stronę Szczegóły oferty platformy Microsoft Azure . Aby zmienić typ oferty, zobacz stronę Zmienianie subskrypcji platformy Azure na inną ofertę . Możesz również otworzyć nowy wniosek o pomoc techniczną w Azure Portal. W obszarze Wybierz typ problemu wybierz pozycję Limity usług i subskrypcji (limity przydziału). Możesz również otworzyć go programowo przy użyciu interfejsu API REST pomocy technicznej platformy Azure.
ResourceNotAvailableForSubscription Zasób jest obecnie niedostępny w lokalizacji żądanej subskrypcji. Otwórz nowy wniosek o pomoc techniczną w Azure Portal. W obszarze Wybierz typ problemu wybierz pozycję Limity usługi i subskrypcji (limity przydziału). Można go również otworzyć programowo przy użyciu interfejsu API REST pomocy technicznej platformy Azure.
UnableToIncreaseQuota Nie można zwiększyć limitów przydziału dla żądanych subskrypcji. Otwórz nowy wniosek o pomoc techniczną w Azure Portal. W obszarze Wybierz typ problemu wybierz pozycję Limity usługi i subskrypcji (limity przydziału).
Wymagane uwierzytelnianie wieloskładnikowe Żądania limitów przydziału wymagają usługi Multi-Factor Authentication. Włącz usługę Multi-Factor Authentication dla dzierżawy/konta, postępując zgodnie z instrukcjami w temacie Włączanie uwierzytelniania wieloskładnikowego i spróbuj ponownie
RequestPartiallyFulfilled Żądanie limitu przydziału jest częściowo spełnione. W przypadku jakichkolwiek pytań otwórz nowe żądanie pomocy technicznej w Azure Portal. W obszarze Wybierz typ problemu wybierz pozycję Limity usługi i subskrypcji (limity przydziału)

Pomoc techniczna w innych językach i interfejsach

Interfejs API REST limitu przydziału jest dostępny w następujących zestawach SDK platformy Microsoft Azure specyficznych dla języka:

Zarządzanie limitami przydziałów przy użyciu interfejsu API Azure Portal i pomocy technicznej

Platforma Azure umożliwia tworzenie żądań pomocy technicznej i zarządzanie nimi, nazywanych również biletami pomocy technicznej. Możesz: