Interfejs API limitu przydziału platformy Azure

  • Artykuł

Interfejs API limitu przydziału to interfejs API REST, którego można użyć do wyświetlania limitów przydziału dla usług platformy Azure i zarządzania nimi.

Ważne

Ogólna dostępność interfejsu API limitu przydziału

Interfejs API limitu przydziału platformy Azure jest teraz ogólnie dostępny. Obecnie obsługuje ona maszyny wirtualne platformy Azure (rdzenie/procesory wirtualne) i usługi Azure Machine Learning (dedykowane/procesory wirtualne).

Uwaga: Nowa wersja interfejsu API REST limitu przydziału jest dostępna w publicznej wersji zapoznawczej w interfejsie API REST usługi Azure Quota Service. Korzysta z dostawcy zasobów Microsoft.Quota i obsługuje maszyny wirtualne platformy Azure (rdzenie/procesory wirtualne), usługę Azure Machine Learning, sieć platformy Azure, usługi Azure HPC Cache i Azure Purview.

Limity przydziału to maksymalne wartości zasobów, akcji i elementów w subskrypcji platformy Azure. Każda usługa platformy Azure definiuje limity przydziału i określa wartości domyślne. W zależności od potrzeb biznesowych może być konieczne zwiększenie wartości limitu przydziału.

Aby uzyskać więcej informacji na temat najbardziej typowych limitów platformy Microsoft Azure, zobacz Azure subscription and service limits, quotas, and constraints (Limity, limity przydziału i ograniczenia usługi platformy Azure).

Korzystanie z interfejsu API limitu przydziału

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

  • Pobierz bieżące przydziały i użycie zasobu.
  • Pobierz listę bieżących przydziałów i użycia wszystkich zasobów.
  • Tworzenie lub aktualizowanie przydziałów zasobu.
  • Pobieranie stanu żądań przydziału dla zasobu.
  • Pobierz listę wszystkich żądań przydziału zasobu przez jeden rok.

Operacje REST

Interfejs API limitu przydziału platformy Azure ułatwia wyszukiwanie limitów przydziału i zwiększanie żądań przy użyciu następujących operacji REST:

Wymagania wstępne

Ważne

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

Rejestrowanie dostawcy zasobów pojemności firmy Microsoft

Aby zarejestrować dostawcę zasobów pojemności firmy Microsoft, użyj następującego polecenia programu PowerShell:

Register-AzResourceProvider -ProviderNamespace Microsoft.Capacity

Zwraca wyniki podobne do tych danych wyjściowych:

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

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

Rola operatora żądania przydziału

Rola 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ę użytkownikom, grupom, jednostkom usługi, tożsamościom zarządzanym i aplikacjom, które wykonują operacje przydziału. Dla celów referencyjnych identyfikator roli Operator żądania przydziału to 0e5f05e5-9ab9-446b-b98d-1e2157c94125.

Limity przydziału procesorów wirtualnych

Za pomocą interfejsu API limitów przydziału można zarządzać limitami przydziałów dla tych dwóch typów przydziałów procesorów wirtualnych:

  • Standardowy limit przydziału procesorów wirtualnych dla maszyn wirtualnych z płatnością zgodnie z rzeczywistym użyciem i wystąpień zarezerwowanych maszyn wirtualnych.
  • Limit przydziału procesorów wirtualnych typu spot dla maszyn wirtualnych typu spot .

Aby dowiedzieć się więcej na temat limitów i przydziałów platformy Azure, zobacz Limity, przydziały i ograniczenia subskrypcji i usług platformy Azure.

Limity przydziału usługi Azure Machine Learning

Interfejs API limitów przydziału umożliwia zarządzanie limitami przydziałów dla obszarów roboczych i zasobów obliczeniowych usługi Azure Machine Learning. Przeczytaj artykuł Manage and increase quotas for resources with Azure Machine Learning (Zarządzanie limitami przydziału zasobów i zwiększanie ich za pomocą usługi Azure Machine Learning ), aby dowiedzieć się więcej o następujących tematach:

  • Domyślne limity zasobów platformy Azure związanych z usługą Azure Machine Learning.
  • Tworzenie przydziałów na poziomie obszaru roboczego.
  • Wyświetlanie limitów przydziału i limitów.
  • Żądanie zwiększenia limitu przydziału.
  • Prywatny punkt końcowy i limity przydziału DNS.

Regiony

Większość przydziałów jest specyficzna dla obciążenia w dowolnym regionie. Zażądaj oddzielnych przydziałów dla każdego regionu, w którym chcesz wdrożyć usługę. Aby wyświetlić listę wszystkich regionów platformy Azure, w których istnieje usługa, użyj operacji Wyświetl według regionów usługi.

Ograniczanie przepływności

Każde wywołania interfejsu API na poziomie subskrypcji i na poziomie dzierżawy można ograniczyć, 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. Możesz ponowić próbę wywołania interfejsu API po upływie pewnego czasu.

Aby uzyskać szczegółowe informacje na temat ograniczania przepustowoś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.

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

Skorzystaj z poniższych tabel, aby rozwiązać problemy z błędami, które mogą wystąpić podczas korzystania z interfejsu API limitu przydziału.

Kod błędu Jak rozwiązać ten problem
ContactSupport 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.
InternalServerError Wewnętrzny błąd serwera. Ponów próbę wywołania interfejsu API później.
MissingRegistration Zarejestruj dostawcę zasobów Microsoft.Capacity dla każdej 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 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.
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. Ograniczanie limitów przydziału nie jest obsługiwane. Nie można zmniejszyć limitu przydziału.
RequestThrottled Każde żą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ą liczbę żą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ą. Możesz również otworzyć 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.
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żesz również otworzyć go 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 nowe żądanie pomocy technicznej w Azure Portal. W obszarze Wybierz typ problemu wybierz pozycję Limity usług 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:

  • Zestaw Microsoft Azure SDK dla platformy .NET: pakiet NuGet
  • Zestaw Microsoft Azure SDK dla języka Python: pakiet Py
  • Zestaw Microsoft Azure SDK dla języka JavaScript (NodeJS & Browser): pakiet js
  • Zestaw Microsoft Azure SDK dla języka Go: pakiet Go

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

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