az reservations reservation-order

Observação

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 comandos 'reservas' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Reserva de reservas.

Comandos

Nome Description Tipo Status
az reservations reservation-order calculate

Calcule o preço para colocar um ReservationOrderarquivo .

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

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

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

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

Extensão Versão Prévia
az reservations reservation-order list

Lista de todos ReservationOrderos s aos quais o usuário tem acesso no locatário atual.

Extensão Versão Prévia
az reservations reservation-order purchase

Crie ReservationOrder e crie recursos sob o URI especificado.

Extensão Versão Prévia
az reservations reservation-order return

Devolver uma reserva.

Extensão Versão Prévia
az reservations reservation-order show

Obtenha os detalhes do ReservationOrder.

Extensão Versão Prévia
az reservations reservation-order wait

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

Extensão Versão Prévia

az reservations reservation-order calculate

Versão Prévia

O grupo de comandos 'reservas' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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

Assinatura que o benefício será aplicado. Obrigatório se --applied-scope-type for Single. Não especifique se --applied-scope-type é Compartilhado. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--applied-scope-property

Propriedades específicas para o tipo de escopo aplicado. Não obrigatório se não aplicável. Necessário e necessário 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 aceitos: ManagementGroup, Shared, Single
--billing-plan

Representar os planos de faturamento.

valores aceitos: Monthly, Upfront
--billing-scope

Assinatura 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 somente para o tipo de recurso reservado VirtualMachines.

valores aceitos: 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 na data de expiração, hora.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
valor padrão: False
--reserved-resource-type

O tipo do recurso que está sendo reservado.

valores aceitos: 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-hora em que o benefício híbrido do Azure precisa ser revisado.

--sku

Nome do Sku para compra.

--term

Representar o termo de Reserva.

valores aceitos: P1Y, P3Y, P5Y
Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az reservations reservation-order calculate-refund

Versão Prévia

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

Calcule o preço da 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 Exigidos

--reservation-order-id

ID do pedido da reserva.

Parâmetros Opcionais

--id

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

--quantity

Quantidade a ser devolvida. Deve ser maior que zero.

--reservation-id

Identificador totalmente qualificado da Reserva que está sendo devolvida.

--scope

O escopo do reembolso, por exemplo, Reserva.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az reservations reservation-order change-directory

Versão Prévia

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

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

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

Exemplos

Alterar uma ordem de reserva para outro locatário

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

Parâmetros Exigidos

--reservation-order-id

ID do pedido da reserva.

Parâmetros Opcionais

--destination-tenant-id

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az reservations reservation-order list

Versão Prévia

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

Lista de todos ReservationOrderos s 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 onde iniciar a paginação. Esse é o valor de token de uma resposta truncada anteriormente.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az reservations reservation-order purchase

Versão Prévia

O grupo de comandos 'reservas' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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 Exigidos

--reservation-order-id

ID do pedido da reserva.

Parâmetros Opcionais

--applied-scope

Assinatura que o benefício será aplicado. Obrigatório se --applied-scope-type for Single. Não especifique se --applied-scope-type é Compartilhado. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--applied-scope-property

Propriedades específicas para o tipo de escopo aplicado. Não obrigatório se não aplicável. Necessário e necessário 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 aceitos: ManagementGroup, Shared, Single
--billing-plan

Representar os planos de faturamento.

valores aceitos: Monthly, Upfront
--billing-scope

Assinatura 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 somente para o tipo de recurso reservado VirtualMachines.

valores aceitos: Off, On
--location

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

--no-wait

Não aguarde a conclusão da operação de execução longa.

valores aceitos: 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 na data de expiração, hora.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
valor padrão: False
--reserved-resource-type

O tipo do recurso que está sendo reservado.

valores aceitos: 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-hora em que o benefício híbrido do Azure precisa ser revisado.

--sku

Nome do Sku para compra.

--term

Representar o termo de Reserva.

valores aceitos: P1Y, P3Y, P5Y
Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az reservations reservation-order return

Versão Prévia

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

Devolver 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 Exigidos

--reservation-order-id

ID do pedido da reserva.

Parâmetros Opcionais

--no-wait

Não aguarde a conclusão da operação de execução longa.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--quantity

Quantidade a ser devolvida. Deve ser maior que zero.

--reservation-id

Identificador totalmente qualificado da Reserva que está sendo devolvida.

--return-reason

O motivo da devolução da reserva.

--scope

O escopo do reembolso, por exemplo, Reserva.

--session-id

SessionId que foi retornado pela API CalculateRestitui.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az reservations reservation-order show

Versão Prévia

O grupo de comandos 'reservas' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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 Exigidos

--reservation-order-id

ID do pedido da reserva.

Parâmetros Opcionais

--expand

Pode ser usado para expandir o plano.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az reservations reservation-order wait

Versão Prévia

O grupo de comandos 'reservas' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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 Exigidos

--reservation-order-id

ID do pedido da reserva.

Parâmetros Opcionais

--created

Aguarde até criar com 'provisioningState' em 'Succeeded'.

valor padrão: 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.

valor padrão: False
--exists

Aguarde até que o recurso exista.

valor padrão: False
--expand

Pode ser usado para expandir o plano.

--interval

Intervalo de sondagem em segundos.

valor padrão: 30
--timeout

Espera máxima em segundos.

valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.