Interfejsy API na potrzeby automatyzacji rezerwacji platformy Azure

  • Artykuł

Używając interfejsów API platformy Azure, można programowo uzyskiwać informacje dotyczące rezerwacji oprogramowania lub usług platformy Azure dla organizacji.

Wyszukiwanie planów rezerwacji do zakupu

Za pomocą interfejsu API rekomendacji rezerwacji możesz uzyskiwać rekomendacje dotyczące zakupu planu rezerwacji na podstawie użycia w organizacji. Aby uzyskać więcej informacji, zobacz Zalecenia dotyczące rezerwacji.

Możesz również analizować użycie zasobów za pomocą szczegółów użycia interfejsu API zużycia. Aby uzyskać więcej informacji, zobacz Usage Details - List For Billing Period By Billing Account (Lista użycia — lista dla okresu rozliczeniowego według konta rozliczeniowego). Zasoby platformy Azure, z których stale korzystasz, są zwykle najlepszym kandydatem do rezerwacji.

Kupowanie rezerwacji

Możesz kupować rezerwacje platformy Azure i plany oprogramowania programowo za pomocą interfejsów API REST. Aby dowiedzieć się więcej, zobacz Reservation Order - Purchase API (Zamówienie rezerwacji — interfejs API zakupu).

Oto przykładowe żądanie zakupu przy użyciu interfejsu API REST:

PUT https://management.azure.com/providers/Microsoft.Capacity/reservationOrders/<GUID>?api-version=2019-04-01

Treść żądania:

{
 "sku": {
    "name": "standard_D1"
  },
 "location": "westus",
 "properties": {
    "reservedResourceType": "VirtualMachines",
    "billingScopeId": "/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83",
    "term": "P1Y",
    "quantity": "1",
    "displayName": "TestReservationOrder",
    "appliedScopes": null,
    "appliedScopeType": "Shared",
    "reservedResourceProperties": {
      "instanceFlexibility": "On"
    }
  }
}

Rezerwację można również kupić w witrynie Azure Portal. Aby uzyskać więcej informacji zobacz następujące artykuły:

Plany usługi:

Plany oprogramowania:

Pobieranie rezerwacji

Jeśli jesteś klientem platformy Azure z klientem Enterprise Agreement (klient z umową EA), możesz uzyskać rezerwacje zakupione przez organizację przy użyciu listy Transakcje rezerwacji — lista. W przypadku innych subskrypcji możesz uzyskać listę zakupionych rezerwacji, w przypadku których masz uprawnienia do wyświetlania, korzystając z interfejsu API Zamówienie rezerwacji — lista. Domyślnie właściciel konta lub osoba, która zakupiła rezerwację, ma uprawnienia do wyświetlania rezerwacji.

Wyświetlanie użycia rezerwacji

Jeśli jesteś klientem z umową EA, możesz programowo zobaczyć, w jaki sposób rezerwacje są używane w organizacji. Aby uzyskać więcej informacji, zobacz Transakcje rezerwacji — lista. W przypadku innych subskrypcji użyj interfejsu API Podsumowania rezerwacji — lista według zamówienia rezerwacji i rezerwacji.

Jeśli okaże się, że rezerwacje w organizacji są używane w niewystarczającym stopniu:

Udzielanie dostępu do rezerwacji

Pobierz listę wszystkich rezerwacji, do których użytkownik ma dostęp, przy użyciu interfejsu API Rezerwacja — operacja — lista. Aby programowo przyznać prawa dostępu do rezerwacji, zobacz jeden z następujących artykułów:

Dzielenie lub scalanie rezerwacji

Po zakupieniu więcej niż jednego wystąpienia zasobu w ramach rezerwacji możesz zdecydować się na przypisanie wystąpień w ramach tej rezerwacji do różnych subskrypcji. Zakres rezerwacji można zmienić tak, aby dotyczył wszystkich subskrypcji w ramach tego samego kontekstu rozliczeń. Jednak dla celów związanych z zarządzaniem kosztami lub budżetowaniem można zachować zakres jako „pojedyncza subskrypcja” i przypisać wystąpienia rezerwacji do określonej subskrypcji.

Aby podzielić rezerwację, użyj interfejsu API Reservation - Split (Rezerwacja — dzielenie). Rezerwację można także podzielić przy użyciu programu PowerShell. Aby uzyskać więcej informacji, zobacz temat Zarządzanie rezerwacjami — dzielenie rezerwacji na dwie rezerwacje.

Aby scalić dwie rezerwacje w jedną rezerwację, użyj interfejsu API Rezerwacja — scalanie.

Zmienianie zakresu rezerwacji

Zakresem rezerwacji może być pojedyncza subskrypcja, pojedyncza grupa zasobów lub wszystkie subskrypcje w kontekście rozliczeń. Jeśli ustawisz zakres na pojedynczą subskrypcję lub pojedynczą grupę zasobów, rezerwacja zostanie dopasowana do uruchomionych zasobów w wybranej subskrypcji. Jeśli usuniesz lub przeniesiesz subskrypcję albo grupę zasobów, rezerwacja nie zostanie wykorzystana. Jeśli ustawisz zakres jako udostępniony, platforma Azure dopasuje rezerwację do zasobów, które działają we wszystkich subskrypcjach w kontekście rozliczeń. Kontekst rozliczeń zależy od subskrypcji użytej do zakupu rezerwacji. Możesz wybrać zakres podczas dokonywania zakupu lub zmienić go w dowolnym momencie po zakupie. Aby uzyskać więcej informacji, zobacz Zarządzanie rezerwacjami — zmienianie zakresu.

Aby programowo zmienić zakres, użyj interfejsu API Rezerwacja — aktualizacja.

Dowiedz się więcej