Partilhar via


az reservations reservation-order

Nota

Essa referência faz parte da extensão de reserva para a CLI do Azure (versão 2.50.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az reservations reservation-order . Saiba mais sobre extensões.

O grupo de comando 'reservas' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Reservas-ordem.

Comandos

Name Description Tipo Status
az reservations reservation-order calculate

Calcule o preço para colocar um ReservationOrderarquivo .

Extensão Pré-visualizar
az reservations reservation-order calculate-refund

Calcule o preço para devolução Reservations se não houver erros de política.

Extensão Pré-visualizar
az reservations reservation-order change-directory

Altere o diretório (locatário) de e tudo Reservation sob ele para ID de ReservationOrder locatário especificado.

Extensão Pré-visualizar
az reservations reservation-order list

Lista de todos os ReservationOrders aos quais o usuário tem acesso no locatário atual.

Extensão Pré-visualizar
az reservations reservation-order purchase

Crie ReservationOrder e crie recursos sob o URI especificado.

Extensão Pré-visualizar
az reservations reservation-order return

Devolva uma reserva.

Extensão Pré-visualizar
az reservations reservation-order show

Obtenha os detalhes do ReservationOrder.

Extensão Pré-visualizar
az reservations reservation-order wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

Extensão Pré-visualizar

az reservations reservation-order calculate

Pré-visualizar

O grupo de comando 'reservas' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Calcule o preço para colocar um ReservationOrderarquivo .

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}]

Exemplos

Calcular preço

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

Parâmetros Opcionais

--applied-scope

Subscrição em que o benefício será aplicado. Obrigatório se --applied-scope-type for Single. Não especifique se --applied-scope-type é compartilhado. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--applied-scope-property

Propriedades específicas do tipo de escopo aplicado. Não obrigatório se não for aplicável. Necessário e necessário para fornecer tenantId e managementGroupId se AppliedScopeType for ManagementGroup Support shorthand-syntax, json-file e yaml-file. Tente "??" para mostrar mais.

--applied-scope-type

Tipo do Escopo Aplicado.

Valores aceites: ManagementGroup, Shared, Single
--billing-plan

Representar os planos de faturação.

Valores aceites: Monthly, Upfront
--billing-scope

Subscrição que será cobrada pela compra da Reserva.

--display-name

Nome amigável da reserva.

--instance-flexibility

Ativar isso aplicará o desconto de reserva a outras VMs no mesmo grupo de tamanho de VM. Especifique apenas para o tipo de recurso reservado VirtualMachines.

Valores aceites: Off, On
--location

A Região do Azure onde reside o recurso reservado.

--quantity

Quantidade de SKUs que fazem parte da Reserva.

--renew

Definir isso como true comprará automaticamente uma nova reserva no horário da data de validade.

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
Default value: False
--reserved-resource-type

O tipo de recurso que está sendo reservado.

Valores aceites: 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

Esta é a data e hora em que o benefício híbrido do Azure precisa ser revisado.

--sku

Nome Sku para compra.

--term

Representar o termo da Reserva.

Valores aceites: P1Y, P3Y, P5Y
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az reservations reservation-order calculate-refund

Pré-visualizar

O grupo de comando 'reservas' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Calcule o preço para devolução Reservations se não houver erros de política.

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

Exemplos

Calcular reembolso

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

Parâmetros Obrigatórios

--reservation-order-id

ID de encomenda da reserva.

Parâmetros Opcionais

--id

Identificador totalmente qualificado da ordem de reserva que está sendo devolvida.

--quantity

Quantidade a devolver. Deve ser maior que zero.

--reservation-id

Identificador totalmente qualificado da Reserva que está a ser devolvida.

--scope

O âmbito do reembolso, por exemplo, Reserva.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az reservations reservation-order change-directory

Pré-visualizar

O grupo de comando 'reservas' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Altere o diretório (locatário) de e tudo Reservation sob ele para ID de ReservationOrder locatário especificado.

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

Exemplos

Alterar uma ordem de reserva para outro inquilino

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

Parâmetros Obrigatórios

--reservation-order-id

ID de encomenda da reserva.

Parâmetros Opcionais

--destination-tenant-id

GUID do ID do locatário para o qual a ordem de reserva deve ser transferida.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az reservations reservation-order list

Pré-visualizar

O grupo de comando 'reservas' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Lista de todos os ReservationOrders aos quais o usuário tem acesso no locatário atual.

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

Exemplos

Lista de todas as ordens de reserva às quais o usuário tem acesso no locatário atual.

az reservations reservation-order list

Parâmetros Opcionais

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token no --next-token argumento de um comando subsequente.

--next-token

Token para especificar por onde começar a paginar. Este é o valor do token de uma resposta truncada anteriormente.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az reservations reservation-order purchase

Pré-visualizar

O grupo de comando 'reservas' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Crie ReservationOrder e crie recursos sob o URI especificado.

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}]

Exemplos

Compre uma reserva de escopo único

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

Comprar um escopo único com reserva de grupo de recursos

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

Parâmetros Obrigatórios

--reservation-order-id

ID de encomenda da reserva.

Parâmetros Opcionais

--applied-scope

Subscrição em que o benefício será aplicado. Obrigatório se --applied-scope-type for Single. Não especifique se --applied-scope-type é compartilhado. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--applied-scope-property

Propriedades específicas do tipo de escopo aplicado. Não obrigatório se não for aplicável. Necessário e necessário para fornecer tenantId e managementGroupId se AppliedScopeType for ManagementGroup Support shorthand-syntax, json-file e yaml-file. Tente "??" para mostrar mais.

--applied-scope-type

Tipo do Escopo Aplicado.

Valores aceites: ManagementGroup, Shared, Single
--billing-plan

Representar os planos de faturação.

Valores aceites: Monthly, Upfront
--billing-scope

Subscrição que será cobrada pela compra da Reserva.

--display-name

Nome amigável da reserva.

--instance-flexibility

Ativar isso aplicará o desconto de reserva a outras VMs no mesmo grupo de tamanho de VM. Especifique apenas para o tipo de recurso reservado VirtualMachines.

Valores aceites: Off, On
--location

A Região do Azure onde reside o recurso reservado.

--no-wait

Não espere que a operação de longa duração termine.

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--quantity

Quantidade de SKUs que fazem parte da Reserva.

--renew

Definir isso como true comprará automaticamente uma nova reserva no horário da data de validade.

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
Default value: False
--reserved-resource-type

O tipo de recurso que está sendo reservado.

Valores aceites: 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

Esta é a data e hora em que o benefício híbrido do Azure precisa ser revisado.

--sku

Nome Sku para compra.

--term

Representar o termo da Reserva.

Valores aceites: P1Y, P3Y, P5Y
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az reservations reservation-order return

Pré-visualizar

O grupo de comando 'reservas' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Devolva uma reserva.

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]

Exemplos

Devolver uma reserva

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

Parâmetros Obrigatórios

--reservation-order-id

ID de encomenda da reserva.

Parâmetros Opcionais

--no-wait

Não espere que a operação de longa duração termine.

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--quantity

Quantidade a devolver. Deve ser maior que zero.

--reservation-id

Identificador totalmente qualificado da Reserva que está a ser devolvida.

--return-reason

O motivo da devolução da reserva.

--scope

O âmbito do reembolso, por exemplo, Reserva.

--session-id

SessionId que foi retornado pela API CalculateRefund .

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az reservations reservation-order show

Pré-visualizar

O grupo de comando 'reservas' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Obtenha os detalhes do ReservationOrder.

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

Exemplos

Obter os detalhes de um pedido de reserva

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

Parâmetros Obrigatórios

--reservation-order-id

ID de encomenda da reserva.

Parâmetros Opcionais

--expand

Pode ser usado para expandir o planInformation.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az reservations reservation-order wait

Pré-visualizar

O grupo de comando 'reservas' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Coloque a CLI em um estado de espera até que uma condição seja atendida.

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

Parâmetros Obrigatórios

--reservation-order-id

ID de encomenda da reserva.

Parâmetros Opcionais

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Default value: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

Default value: False
--exists

Aguarde até que o recurso exista.

Default value: False
--expand

Pode ser usado para expandir o planInformation.

--interval

Intervalo de sondagem em segundos.

Default value: 30
--timeout

Espera máxima em segundos.

Default value: 3600
--updated

Aguarde até ser atualizado com provisioningState em 'Succeeded'.

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.