Condividi tramite


Capacity Reservations - Create Or Update

Operazione per creare o aggiornare una prenotazione di capacità. Si noti che alcune proprietà possono essere impostate solo durante la creazione della prenotazione della capacità. Per altre informazioni, vedere https://aka.ms/CapacityReservation .

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}/capacityReservations/{capacityReservationName}?api-version=2024-03-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
capacityReservationGroupName
path True

string

Nome del gruppo di prenotazioni di capacità.

capacityReservationName
path True

string

Nome della prenotazione della capacità.

resourceGroupName
path True

string

Nome del gruppo di risorse.

subscriptionId
path True

string

Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.

api-version
query True

string

Versione dell'API client.

Corpo della richiesta

Nome Necessario Tipo Descrizione
location True

string

Posizione risorsa

sku True

Sku

SKU della risorsa per cui la capacità deve essere riservata. È necessario impostare il nome e la capacità dello SKU. Attualmente sono supportati sku vm con la funzionalità "CapacityReservationSupported" impostata su true. Per i valori supportati, vedere Elencare SKU Microsoft.Compute in un'area (https://docs.microsoft.com/rest/api/compute/resourceskus/list).

tags

object

Tag delle risorse

zones

string[]

Zona di disponibilità da usare per questa prenotazione di capacità. La zona deve essere un singolo valore e deve essere inclusa anche nell'elenco delle zone specificate durante la creazione del gruppo di prenotazioni di capacità. La zona può essere assegnata solo durante la creazione. In caso contrario, la prenotazione supporta solo distribuzioni non zonali. Se specificato, applica VM/VMSS usando questa prenotazione di capacità per trovarsi nella stessa zona.

Risposte

Nome Tipo Descrizione
200 OK

CapacityReservation

OK

201 Created

CapacityReservation

Data di creazione

Other Status Codes

CloudError

Risposta di errore che descrive perché l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Create or update a capacity reservation .

Esempio di richiesta

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation?api-version=2024-03-01

{
  "location": "westus",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ]
}

Risposta di esempio

{
  "name": "myCapacityReservation",
  "location": "westus",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ],
  "properties": {
    "platformFaultDomainCount": 3,
    "reservationId": "{GUID}",
    "provisioningState": "Creating",
    "provisioningTime": "2021-06-27T01:02:38.3138469+00:00"
  }
}
{
  "name": "myCapacityReservation",
  "location": "westus",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ],
  "properties": {
    "platformFaultDomainCount": 3,
    "reservationId": "{GUID}",
    "provisioningState": "Creating",
    "provisioningTime": "2021-06-27T01:02:38.3138469+00:00"
  }
}

Definizioni

Nome Descrizione
ApiError

Errore dell'API.

ApiErrorBase

Base di errori dell'API.

CapacityReservation

Specifica informazioni sulla prenotazione della capacità.

CapacityReservationInstanceView

Visualizzazione dell'istanza di una prenotazione di capacità che fornisce come snapshot delle proprietà di runtime della prenotazione della capacità gestita dalla piattaforma e può cambiare all'esterno delle operazioni del piano di controllo.

CapacityReservationUtilization

Rappresenta l'utilizzo della prenotazione della capacità in termini di risorse allocate.

CloudError

Risposta di errore dal servizio di calcolo.

InnerError

Dettagli dell'errore interno.

InstanceViewStatus

Stato visualizzazione istanza.

Sku

Descrive uno sku del set di scalabilità di macchine virtuali. NOTA: se il nuovo SKU della macchina virtuale non è supportato nell'hardware in cui è in corso il set di scalabilità, è necessario deallocare le macchine virtuali nel set di scalabilità prima di modificare il nome dello SKU.

StatusLevelTypes

Codice di livello.

SubResourceReadOnly

ApiError

Errore dell'API.

Nome Tipo Descrizione
code

string

Codice di errore.

details

ApiErrorBase[]

Dettagli dell'errore dell'API

innererror

InnerError

Errore interno dell'API

message

string

Messaggio di errore.

target

string

Destinazione dell'errore specifico.

ApiErrorBase

Base di errori dell'API.

Nome Tipo Descrizione
code

string

Codice di errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore specifico.

CapacityReservation

Specifica informazioni sulla prenotazione della capacità.

Nome Tipo Descrizione
id

string

ID risorsa

location

string

Posizione risorsa

name

string

Nome risorsa

properties.instanceView

CapacityReservationInstanceView

Visualizzazione Istanza di prenotazione della capacità.

properties.platformFaultDomainCount

integer

Specifica il valore del numero di domini di errore supportati dalla prenotazione della capacità per le dimensioni della macchina virtuale richiesta. Nota: Il numero di domini di errore specificato per una risorsa ,ad esempio il set di scalabilità di macchine virtuali, deve essere minore o uguale a questo valore se distribuisce usando la prenotazione della capacità. Versione minima api: 2022-08-01.

properties.provisioningState

string

Stato di provisioning, che viene visualizzato solo nella risposta.

properties.provisioningTime

string

Data di aggiornamento della prenotazione della capacità.

properties.reservationId

string

ID univoco generato e assegnato alla prenotazione della capacità dalla piattaforma che non cambia durante la durata della risorsa.

properties.timeCreated

string

Specifica il momento in cui è stata creata la risorsa di prenotazione della capacità. Versione minima api: 2021-11-01.

properties.virtualMachinesAssociated

SubResourceReadOnly[]

Elenco di tutti gli ID risorsa macchina virtuale associati alla prenotazione della capacità.

sku

Sku

SKU della risorsa per cui la capacità deve essere riservata. È necessario impostare il nome e la capacità dello SKU. Attualmente sono supportati sku vm con la funzionalità "CapacityReservationSupported" impostata su true. Per i valori supportati, vedere Elencare SKU Microsoft.Compute in un'area (https://docs.microsoft.com/rest/api/compute/resourceskus/list).

tags

object

Tag delle risorse

type

string

Tipo di risorsa

zones

string[]

Zona di disponibilità da usare per questa prenotazione di capacità. La zona deve essere un singolo valore e deve essere inclusa anche nell'elenco delle zone specificate durante la creazione del gruppo di prenotazioni di capacità. La zona può essere assegnata solo durante la creazione. In caso contrario, la prenotazione supporta solo distribuzioni non zonali. Se specificato, applica VM/VMSS usando questa prenotazione di capacità per trovarsi nella stessa zona.

CapacityReservationInstanceView

Visualizzazione dell'istanza di una prenotazione di capacità che fornisce come snapshot delle proprietà di runtime della prenotazione della capacità gestita dalla piattaforma e può cambiare all'esterno delle operazioni del piano di controllo.

Nome Tipo Descrizione
statuses

InstanceViewStatus[]

Informazioni sullo stato della risorsa.

utilizationInfo

CapacityReservationUtilization

Capacità non utilizzata della prenotazione della capacità.

CapacityReservationUtilization

Rappresenta l'utilizzo della prenotazione della capacità in termini di risorse allocate.

Nome Tipo Descrizione
currentCapacity

integer

Il valore fornisce la capacità corrente delle dimensioni della macchina virtuale riservata e per la quale il cliente riceve la fattura. Versione minima api: 2022-08-01.

virtualMachinesAllocated

SubResourceReadOnly[]

Elenco di tutti gli ID risorsa delle macchine virtuali allocati nella prenotazione della capacità.

CloudError

Risposta di errore dal servizio di calcolo.

Nome Tipo Descrizione
error

ApiError

Errore dell'API.

InnerError

Dettagli dell'errore interno.

Nome Tipo Descrizione
errordetail

string

Messaggio di errore interno o dump di eccezioni.

exceptiontype

string

Tipo di eccezione.

InstanceViewStatus

Stato visualizzazione istanza.

Nome Tipo Descrizione
code

string

Codice di stato.

displayStatus

string

Etichetta localizzabile breve per lo stato.

level

StatusLevelTypes

Codice di livello.

message

string

Messaggio di stato dettagliato, incluso per avvisi e messaggi di errore.

time

string

Ora dello stato.

Sku

Descrive uno sku del set di scalabilità di macchine virtuali. NOTA: se il nuovo SKU della macchina virtuale non è supportato nell'hardware in cui è in corso il set di scalabilità, è necessario deallocare le macchine virtuali nel set di scalabilità prima di modificare il nome dello SKU.

Nome Tipo Descrizione
capacity

integer

Specifica il numero di macchine virtuali nel set di scalabilità.

name

string

Nome sku.

tier

string

Specifica il livello di macchine virtuali in un set di scalabilità.

I valori possibili sono:

Standard

Base

StatusLevelTypes

Codice di livello.

Nome Tipo Descrizione
Error

string

Info

string

Warning

string

SubResourceReadOnly

Nome Tipo Descrizione
id

string

ID risorsa