Condividi tramite

az reservations reservation-order

  • Anteprima
  • Riferimento

Nota

Questo riferimento fa parte dell'estensione per la prenotazione per l'interfaccia della riga di comando di Azure (versione 2.50.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az reservations reservation-order . Altre informazioni sulle estensioni.

Il gruppo di comandi 'reservations' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Ordine di prenotazione prenotazioni.

Comandi

Nome Descrizione Tipo Status
az reservations reservation-order calculate

Calcolare il prezzo per l'inserimento di un oggetto ReservationOrder.

 Estensione Anteprima
az reservations reservation-order calculate-refund

Calcolare il prezzo per la restituzione Reservations se non sono presenti errori di criteri.

 Estensione Anteprima
az reservations reservation-order change-directory

Modificare la directory (tenant) di ReservationOrder e tutte in Reservation esso in base all'ID tenant specificato.

 Estensione Anteprima
az reservations reservation-order list

Elenco di tutti gli ReservationOrderelementi a cui l'utente ha accesso nel tenant corrente.

 Estensione Anteprima
az reservations reservation-order purchase

Creare ReservationOrder e creare una risorsa con l'URI specificato.

 Estensione Anteprima
az reservations reservation-order return

Restituire una prenotazione.

 Estensione Anteprima
az reservations reservation-order show

Ottenere i dettagli di ReservationOrder.

 Estensione Anteprima
az reservations reservation-order wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

 Estensione Anteprima

az reservations reservation-order calculate

Anteprima

Il gruppo di comandi 'reservations' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Calcolare il prezzo per l'inserimento di un oggetto ReservationOrder.

az reservations reservation-order calculate [--applied-scope]
                                            [--applied-scope-property]
                                            [--applied-scope-type {ManagementGroup, Shared, Single}]
                                            [--billing-plan {Monthly, Upfront}]
                                            [--billing-scope]
                                            [--display-name]
                                            [--instance-flexibility {Off, On}]
                                            [--location]
                                            [--quantity]
                                            [--renew {0, 1, f, false, n, no, t, true, y, yes}]
                                            [--reserved-resource-type {AVS, AppService, AzureDataExplorer, AzureFiles, BlockBlob, CosmosDb, DataFactory, Databricks, DedicatedHost, ManagedDisk, MariaDb, MySql, NetAppStorage, PostgreSql, RedHat, RedHatOsa, RedisCache, SapHana, SqlAzureHybridBenefit, SqlDataWarehouse, SqlDatabases, SqlEdge, SuseLinux, VMwareCloudSimple, VirtualMachineSoftware, VirtualMachines}]
                                            [--review-date-time]
                                            [--sku]
                                            [--term {P1Y, P3Y, P5Y}]

Esempio

Calcolare il prezzo

az reservations reservation-order calculate --applied-scope-type Shared --billing-scope 50000000-aaaa-bbbb-cccc-100000000002 --display-name name1 --quantity 1 --reserved-resource-type VirtualMachines --sku Standard_B1s --term P1Y --billing-plan Monthly --location eastus

Parametri facoltativi

--applied-scope

Sottoscrizione a cui verrà applicato il vantaggio. Obbligatorio se --applied-scope-type è Single. Non specificare se --applied-scope-type è Condiviso. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--applied-scope-property

Proprietà specifiche del tipo di ambito applicato. Non obbligatorio se non applicabile. Obbligatorio e necessario specificare tenantId e managementGroupId se AppliedScopeType è ManagementGroup Support shorthand-syntax, json-file e yaml-file. Prova "??" per mostrare di più.

--applied-scope-type

Tipo dell'ambito applicato.

Valori accettati: ManagementGroup, Shared, Single
--billing-plan

Rappresenta i piani di fatturazione.

Valori accettati: Monthly, Upfront
--billing-scope

Sottoscrizione che verrà addebitata per l'acquisto della prenotazione.

--display-name

Nome descrittivo della prenotazione.

--instance-flexibility

L'attivazione di questa opzione applicherà lo sconto per la prenotazione ad altre macchine virtuali nello stesso gruppo di dimensioni della macchina virtuale. Specificare solo per il tipo di risorsa riservata VirtualMachines.

Valori accettati: Off, On
--location

Area di Azure in cui risiede la risorsa riservata.

--quantity

Quantità degli SKU che fanno parte della prenotazione.

--renew

L'impostazione di questa proprietà su true acquisterà automaticamente una nuova prenotazione all'ora di scadenza.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
Valore predefinito: False
--reserved-resource-type

Tipo della risorsa riservata.

Valori accettati: AVS, AppService, AzureDataExplorer, AzureFiles, BlockBlob, CosmosDb, DataFactory, Databricks, DedicatedHost, ManagedDisk, MariaDb, MySql, NetAppStorage, PostgreSql, RedHat, RedHatOsa, RedisCache, SapHana, SqlAzureHybridBenefit, SqlDataWarehouse, SqlDatabases, SqlEdge, SuseLinux, VMwareCloudSimple, VirtualMachineSoftware, VirtualMachines
--review-date-time

Questo è l'ora in cui è necessario esaminare il vantaggio Azure Hybrid.

--sku

Nome sku per l'acquisto.

--term

Rappresenta il termine di Prenotazione.

Valori accettati: P1Y, P3Y, P5Y
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az reservations reservation-order calculate-refund

Anteprima

Il gruppo di comandi 'reservations' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Calcolare il prezzo per la restituzione Reservations se non sono presenti errori di criteri.

az reservations reservation-order calculate-refund --reservation-order-id
                                                   [--id]
                                                   [--quantity]
                                                   [--reservation-id]
                                                   [--scope]

Esempio

Calcolare il rimborso

az reservations reservation-order calculate-refund --reservation-order-id 0000000-aaaa-bbbb-cccc-20000000001 --id /providers/microsoft.capacity/reservationOrders/0000000-aaaa-bbbb-cccc-20000000001 --scope Reservation --quantity 1 --reservation-id /providers/microsoft.capacity/reservationOrders/0000000-aaaa-bbbb-cccc-20000000001/reservations/50000000-aaaa-bbbb-cccc-200000000000

Parametri necessari

--reservation-order-id

ID ordine della prenotazione.

Parametri facoltativi

--id

Identificatore completo dell'ordine di prenotazione restituito.

--quantity

Quantità da restituire. Deve essere maggiore di zero.

--reservation-id

Identificatore completo della prenotazione restituita.

--scope

Ambito del rimborso, ad esempio Prenotazione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az reservations reservation-order change-directory

Anteprima

Il gruppo di comandi 'reservations' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Modificare la directory (tenant) di ReservationOrder e tutte in Reservation esso in base all'ID tenant specificato.

az reservations reservation-order change-directory --reservation-order-id
                                                   [--destination-tenant-id]

Esempio

Modificare un ordine di prenotazione in un altro tenant

az reservations reservation-order change-directory --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000000 --destination-tenant-id 10000000-aaaa-bbbb-cccc-200000000011

Parametri necessari

--reservation-order-id

ID ordine della prenotazione.

Parametri facoltativi

--destination-tenant-id

GUID ID tenant a cui deve essere trasferito l'ordine di prenotazione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az reservations reservation-order list

Anteprima

Il gruppo di comandi 'reservations' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Elenco di tutti gli ReservationOrderelementi a cui l'utente ha accesso nel tenant corrente.

az reservations reservation-order list [--max-items]
                                       [--next-token]

Esempio

Elenco di tutti gli ordini di prenotazione a cui l'utente ha accesso nel tenant corrente.

az reservations reservation-order list

Parametri facoltativi

--max-items

Numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è maggiore del valore specificato, nell'output del comando viene fornito un token. Per riprendere la paginazione, specificare il valore del token nell'argomento --next-token di un comando successivo.

--next-token

Token per specificare dove iniziare la paginazione. Si tratta del valore del token di una risposta troncata in precedenza.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az reservations reservation-order purchase

Anteprima

Il gruppo di comandi 'reservations' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Creare ReservationOrder e creare una risorsa con l'URI specificato.

az reservations reservation-order purchase --reservation-order-id
                                           [--applied-scope]
                                           [--applied-scope-property]
                                           [--applied-scope-type {ManagementGroup, Shared, Single}]
                                           [--billing-plan {Monthly, Upfront}]
                                           [--billing-scope]
                                           [--display-name]
                                           [--instance-flexibility {Off, On}]
                                           [--location]
                                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                           [--quantity]
                                           [--renew {0, 1, f, false, n, no, t, true, y, yes}]
                                           [--reserved-resource-type {AVS, AppService, AzureDataExplorer, AzureFiles, BlockBlob, CosmosDb, DataFactory, Databricks, DedicatedHost, ManagedDisk, MariaDb, MySql, NetAppStorage, PostgreSql, RedHat, RedHatOsa, RedisCache, SapHana, SqlAzureHybridBenefit, SqlDataWarehouse, SqlDatabases, SqlEdge, SuseLinux, VMwareCloudSimple, VirtualMachineSoftware, VirtualMachines}]
                                           [--review-date-time]
                                           [--sku]
                                           [--term {P1Y, P3Y, P5Y}]

Esempio

Acquistare una singola prenotazione con ambito

az reservations reservation-order purchase --reservation-order-id 40000000-aaaa-bbbb-cccc-200000000005 --applied-scope-type Single --billing-scope 50000000-aaaa-bbbb-cccc-200000000005 --reserved-resource-type VirtualMachines --display-name name1 --quantity 1 --sku Standard_B1s --term P1Y --billing-plan Monthly --location eastus --applied-scope 50000000-aaaa-bbbb-cccc-200000000010

Acquistare un ambito singolo con prenotazione del gruppo di risorse

az reservations reservation-order purchase --reservation-order-id 40000000-aaaa-bbbb-cccc-200000000005 --applied-scope-type Single --billing-scope 50000000-aaaa-bbbb-cccc-200000000005 --reserved-resource-type VirtualMachines --display-name testername1 --quantity 1 --sku Standard_B1s --term P1Y --billing-plan Monthly --location eastus --applied-scope '/subscriptions/50000000-aaaa-bbbb-cccc-200000000005/resourceGroups/rg1' --instance-flexibility Off

Parametri necessari

--reservation-order-id

ID ordine della prenotazione.

Parametri facoltativi

--applied-scope

Sottoscrizione a cui verrà applicato il vantaggio. Obbligatorio se --applied-scope-type è Single. Non specificare se --applied-scope-type è Condiviso. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--applied-scope-property

Proprietà specifiche del tipo di ambito applicato. Non obbligatorio se non applicabile. Obbligatorio e necessario specificare tenantId e managementGroupId se AppliedScopeType è ManagementGroup Support shorthand-syntax, json-file e yaml-file. Prova "??" per mostrare di più.

--applied-scope-type

Tipo dell'ambito applicato.

Valori accettati: ManagementGroup, Shared, Single
--billing-plan

Rappresenta i piani di fatturazione.

Valori accettati: Monthly, Upfront
--billing-scope

Sottoscrizione che verrà addebitata per l'acquisto della prenotazione.

--display-name

Nome descrittivo della prenotazione.

--instance-flexibility

L'attivazione di questa opzione applicherà lo sconto per la prenotazione ad altre macchine virtuali nello stesso gruppo di dimensioni della macchina virtuale. Specificare solo per il tipo di risorsa riservata VirtualMachines.

Valori accettati: Off, On
--location

Area di Azure in cui risiede la risorsa riservata.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--quantity

Quantità degli SKU che fanno parte della prenotazione.

--renew

L'impostazione di questa proprietà su true acquisterà automaticamente una nuova prenotazione all'ora di scadenza.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
Valore predefinito: False
--reserved-resource-type

Tipo della risorsa riservata.

Valori accettati: AVS, AppService, AzureDataExplorer, AzureFiles, BlockBlob, CosmosDb, DataFactory, Databricks, DedicatedHost, ManagedDisk, MariaDb, MySql, NetAppStorage, PostgreSql, RedHat, RedHatOsa, RedisCache, SapHana, SqlAzureHybridBenefit, SqlDataWarehouse, SqlDatabases, SqlEdge, SuseLinux, VMwareCloudSimple, VirtualMachineSoftware, VirtualMachines
--review-date-time

Questo è l'ora in cui è necessario esaminare il vantaggio Azure Hybrid.

--sku

Nome sku per l'acquisto.

--term

Rappresenta il termine di Prenotazione.

Valori accettati: P1Y, P3Y, P5Y
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az reservations reservation-order return

Anteprima

Il gruppo di comandi 'reservations' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Restituire una prenotazione.

az reservations reservation-order return --reservation-order-id
                                         [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--quantity]
                                         [--reservation-id]
                                         [--return-reason]
                                         [--scope]
                                         [--session-id]

Esempio

Restituire una prenotazione

az reservations reservation-order return --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000000 --return-reason mockReason --scope Reservation --quantity 1 --reservation-id /providers/microsoft.capacity/reservationOrders/50000000-aaaa-bbbb-cccc-200000000000/reservations/30000000-aaaa-bbbb-cccc-200000000011 --session-id 40000000-aaaa-bbbb-cccc-200000000020

Parametri necessari

--reservation-order-id

ID ordine della prenotazione.

Parametri facoltativi

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--quantity

Quantità da restituire. Deve essere maggiore di zero.

--reservation-id

Identificatore completo della prenotazione restituita.

--return-reason

Motivo della restituzione della prenotazione.

--scope

Ambito del rimborso, ad esempio Prenotazione.

--session-id

SessionId restituito dall'API CalculateRefund.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az reservations reservation-order show

Anteprima

Il gruppo di comandi 'reservations' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Ottenere i dettagli di ReservationOrder.

az reservations reservation-order show --reservation-order-id
                                       [--expand]

Esempio

Ottenere i dettagli di un ordine di prenotazione

az reservations reservation-order show --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000005

Parametri necessari

--reservation-order-id

ID ordine della prenotazione.

Parametri facoltativi

--expand

Può essere usato per espandere il pianoInformation.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az reservations reservation-order wait

Anteprima

Il gruppo di comandi 'reservations' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

az reservations reservation-order wait --reservation-order-id
                                       [--created]
                                       [--custom]
                                       [--deleted]
                                       [--exists]
                                       [--expand]
                                       [--interval]
                                       [--timeout]
                                       [--updated]

Parametri necessari

--reservation-order-id

ID ordine della prenotazione.

Parametri facoltativi

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

Valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

Valore predefinito: False
--exists

Attendere che la risorsa esista.

Valore predefinito: False
--expand

Può essere usato per espandere il pianoInformation.

--interval

Intervallo di polling in secondi.

Valore predefinito: 30
--timeout

Attesa massima in secondi.

Valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.