Dela via


API:er för Azure-reservationsautomation

Använd Azure-API:er för att programmatiskt hämta information för din organisation angående reservationer för Azure-tjänster eller programvara.

Hitta reservationsplaner att köpa

Använd API:et för reservationsrekommendationer för att få rekommendationer om vilka reservationsplaner som du bör köpa utifrån organisationens användning. Mer information finns i Reservationsrekommendationer.

Du kan även analysera din resursanvändning med hjälp av användningsinformationen från förbruknings-API:et. Mer information finns i Användningsinformation – Lista över faktureringsperiod per faktureringskonto. De Azure-resurser som du använder konsekvent är vanligtvis den bästa kandidaten för en reservation.

Köpa en reservation

Du kan köpa Azure-reservationer och programvaruplaner programmatiskt med hjälp av REST-API:er. Mer information finns i Reservationsbeställning – API för inköp.

Här är ett exempel på en köpbegäran med hjälp av REST API:

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

Begärandetext:

{
 "sku": {
    "name": "standard_D1"
  },
 "location": "westus",
 "properties": {
    "reservedResourceType": "VirtualMachines",
    "billingScopeId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
    "term": "P1Y",
    "quantity": "1",
    "displayName": "TestReservationOrder",
    "appliedScopes": null,
    "appliedScopeType": "Shared",
    "reservedResourceProperties": {
      "instanceFlexibility": "On"
    }
  }
}

Du kan även köpa en reservation i Azure-portalen. Mer information finns i följande artiklar:

Tjänstplaner:

Programvaruplaner:

Hämta reservationer

Om du är Azure-kund med en företagsavtal (EA-kund) kan du få de reservationer som din organisation har köpt med hjälp av listan Reservationstransaktioner – . För andra prenumerationer hämtar du listan över reservationer som du har köpt och har behörighet att visa med hjälp av API:et för reservationsbeställning – lista. Som standard har kontoägaren eller den person som köpte reservationen behörighet att visa reservationen.

Se reservationsanvändning

Om du är EA-kund kan du programmatiskt visa hur organisationens reservationer används. Mer information finns i Reservationstransaktioner – lista. För andra prenumerationer använder du API:et för reservationssammanfattningar – lista per reservationsbeställning och reservation.

Gör så här om du märker att organisationens reservationer underutnyttjas:

Ge åtkomst till reservationer

Hämta listan över alla reservationer som en användare har åtkomst till med hjälp av API:et för reservation – åtgärd – lista. Information om hur du ger åtkomst till en reservation programmatiskt finns i följande artiklar:

Dela eller sammanslå reservation

När du har köpt fler än en resursinstans i en reservation vill du kanske tilldela instanserna i den reservationen till olika prenumerationer. Du kan ändra reservationsomfånget så att det gäller för alla prenumerationer inom samma faktureringskontext. Men för kostnadshantering eller budgetering vill du kanske behålla omfånget som ”enstaka prenumeration” och tilldela reservationsinstanser till en specifik prenumeration.

Du delar en reservation med hjälp av API:et Reservation – dela. Du kan även dela en reservation med hjälp av PowerShell. Mer information finns i Hantera reservationer – dela upp en reservation i två reservationer.

Om du vill sammanslå två reservationer till en reservation använder du API:et Reservation – sammanslå.

Ändra omfång för en reservation

Omfånget för en reservation kan vara en enskild prenumeration, en enskild resursgrupp eller alla prenumerationer i din faktureringskontext. Om du anger omfånget till en enskild prenumeration eller en enskild resursgrupp matchas reservationen till resurser som körs i den valda prenumerationen. Om du tar bort eller flyttar prenumerationen eller resursgruppen används inte reservationen. Om du anger omfånget till delat matchar Azure reservationen till resurser som körs i alla prenumerationer i faktureringskontexten. Faktureringskontexten är beroende av den prenumeration som du använde för att köpa reservationen. Du kan välja omfånget vid inköpstillfället eller ändra det när som helst efter köpet. Mer information finns i Hantera reservationer – ändra omfånget.

Om du vill ändra omfånget programmatiskt använder du API:et Reservation – uppdatera.