Condividi tramite


API per l'automazione delle prenotazioni di Azure

Usare le API di Azure per ottenere informazioni per l'organizzazione a livello di codice sulle prenotazioni di software o servizi di Azure.

Trovare piani di prenotazione da acquistare

Usare l'API Raccomandazioni di prenotazione per ottenere consigli su quale piano di prenotazione acquistare in base all'utilizzo della propria organizzazione. Per altre informazioni, vedere Raccomandazioni per la prenotazione.

È anche possibile analizzare l'utilizzo delle risorse usando l'API per il consumo per dettagli sull'uso. Per altre informazioni, vedere Usage Details - List For Billing Period By Billing Account (Dettagli sull'uso - Elenco per periodo di fatturazione in base all'account di fatturazione). Le risorse di Azure che si usano regolarmente sono in genere la scelta ottimale per una prenotazione.

Acquistare una prenotazione

È possibile acquistare prenotazioni di Azure e piani software a livello di codice con le API REST. Per altre informazioni, vedere l'API Ordine di prenotazione - Acquisto.

Ecco una richiesta di esempio per l'acquisto tramite l'API REST:

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

Testo della richiesta:

{
 "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"
    }
  }
}

È possibile acquistare una prenotazione anche nel portale di Azure. Per altre informazioni, vedere gli articoli seguenti:

Piani di servizio:

Piani software:

Ottenere le prenotazioni

I clienti di Azure che dispongono di un Contratto Enterprise (clienti EA) possono ottenere le prenotazioni acquistate dall'organizzazione usando Transazioni di prenotazione - Elenco. Per altre sottoscrizioni, ottenere l'elenco delle prenotazioni acquistate e le autorizzazioni a visualizzarle usando l'elenco degli ordini di prenotazione delle API. Per impostazione predefinita, il proprietario dell'account o l'utente che ha acquistato la prenotazione dispone delle autorizzazioni per visualizzare la prenotazione.

Visualizzare l'utilizzo della prenotazione

I clienti con contratto Enterprise possono visualizzare a livello di codice come vengono usate le prenotazioni all'interno dell'organizzazione. Per altre informazioni, vedere Transazioni di prenotazione - Elenco. Per altre sottoscrizioni, usare l'API per i riepiloghi delle prenotazioni - Elenco per ordine di prenotazione e prenotazione.

Se si ritiene che le prenotazioni dell'organizzazione siano sottoutilizzate:

Concedere l'accesso alle prenotazioni

Ottenere l'elenco di tutte le prenotazioni a cui un utente può accedere usando l'API Reservation - Operation - List. Per consentire l'accesso a una prenotazione a livello di codice, vedere uno degli articoli seguenti:

Dividere o unire una prenotazione

Dopo aver acquistato più di un'istanza di risorsa all'interno di una prenotazione, è possibile assegnare le istanze all'interno di tale prenotazione a sottoscrizioni diverse. È possibile modificare l'ambito della prenotazione in modo che sia applicabile a tutte le sottoscrizioni all'interno dello stesso contesto di fatturazione. Tuttavia, per motivi di gestione dei costi o di definizione del budget, è possibile mantenere l'ambito come "sottoscrizione singola" e assegnare le istanze di prenotazione a una sottoscrizione specifica.

Per dividere una prenotazione, usare l'API Reservation - Split. È anche possibile dividere una prenotazione tramite PowerShell. Per altre informazioni, vedere Gestire le prenotazioni - Dividere una prenotazione singola in due prenotazioni.

Per unire due prenotazioni in una prenotazione, usare l'API Reservation - Merge.

Modificare l'ambito di una prenotazione

L'ambito di una prenotazione può essere una singola sottoscrizione, un singolo gruppo di risorse o tutte le sottoscrizioni nel contesto di fatturazione. Se si imposta l'ambito su una singola sottoscrizione o un singolo gruppo di risorse, la prenotazione corrisponde alle risorse in esecuzione nella sottoscrizione selezionata. Se si elimina o si sposta la sottoscrizione o il gruppo di risorse, la prenotazione non verrà utilizzata. Se si imposta l'ambito su un ambito condiviso, Azure individua la prenotazione corrispondente relativa alle risorse in esecuzione in tutte le sottoscrizioni all'interno del contesto di fatturazione. Il contesto di fatturazione dipende dalla sottoscrizione usata per acquistare la prenotazione. È possibile selezionare l'ambito al momento dell'acquisto o modificarlo in qualsiasi momento dopo l'acquisto. Per altre informazioni, vedere Gestire le prenotazioni - Modificare l'ambito.

Per modificare l'ambito a livello di codice, usare l'API Reservation - Update.