az reservations reservation

Versão Prévia
Referência

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 . 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

Reservas de reserva.

Comandos

Nome	Description	Tipo	Status
az reservations reservation archive	Arquivar um `Reservation` que está no estado cancelado/expirado e movê-lo para o `Archived` estado.	Extensão	Versão Prévia
az reservations reservation list	Listar reservas dentro de um único `ReservationOrder`.	Extensão	Versão Prévia
az reservations reservation list-available-scope	Listar escopos disponíveis para `Reservation`o .	Extensão	Versão Prévia
az reservations reservation list-history	Lista de todas as revisões para o `Reservation`.	Extensão	Versão Prévia
az reservations reservation merge	Mescle os s especificados `Reservation`em um novo `Reservation`arquivo . Os dois `Reservation`s que estão sendo mesclados devem ter as mesmas propriedades.	Extensão	Versão Prévia
az reservations reservation show	Obtenha detalhes específicos `Reservation` .	Extensão	Versão Prévia
az reservations reservation split	Divida a `Reservation` em dois `Reservation`s com distribuição de quantidade especificada.	Extensão	Versão Prévia
az reservations reservation unarchive	Desarquivar um `Reservation` move-o para o estado em que estava antes de arquivar.	Extensão	Versão Prévia
az reservations reservation update	Atualize os escopos aplicados, a renovação, o nome, a flexibilidade de instância do `Reservation`.	Extensão	Versão Prévia
az reservations reservation 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 archive

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

Arquivar um Reservation que está no estado cancelado/expirado e movê-lo para o Archived estado.

az reservations reservation archive --reservation-id
                                    --reservation-order-id

Exemplos

Arquivando uma reserva

az reservations reservation archive --reservation-order-id 40000000-aaaa-bbbb-cccc-20000000000 --reservation-id 50000000-aaaa-bbbb-cccc-200000000000

Parâmetros Exigidos

--reservation-id

ID do item de reserva.

--reservation-order-id

ID do pedido da 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 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

Listar reservas dentro de um único ReservationOrder.

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

Exemplos

Liste todas as reservas dentro de uma ordem de reserva.

az reservations reservation list --reservation-order-id 50000000-aaaa-bbbb-cccc-100000000002

Parâmetros Exigidos

--reservation-order-id

ID do pedido da reserva.

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 list-available-scope

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

Listar escopos disponíveis para Reservationo .

az reservations reservation list-available-scope --reservation-id
                                                 --reservation-order-id
                                                 [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                 [--scopes]

Exemplos

Listar escopos disponíveis de reserva

az reservations reservation list-available-scope --reservation-order-id 40000000-aaaa-bbbb-cccc-20000000000 --reservation-id 30000000-aaaa-bbbb-cccc-20000000000 --scopes ['/subscriptions/60000000-aaaa-bbbb-cccc-20000000000']

Parâmetros Exigidos

--reservation-id

ID do item de reserva.

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

--scopes

Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

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 list-history

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 todas as revisões para o Reservation.

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

Exemplos

Obtenha o histórico de uma reserva.

az reservations reservation list-history --reservation-id 50000000-aaaa-bbbb-cccc-100000000002 --reservation-order-id 10000000-aaaa-bbbb-cccc-100000000005

Parâmetros Exigidos

--reservation-id

ID do item de reserva.

--reservation-order-id

ID do pedido da reserva.

Parâmetros Opcionais

--max-items

--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 merge

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

Mescle os s especificados Reservationem um novo Reservationarquivo . Os dois Reservations que estão sendo mesclados devem ter as mesmas propriedades.

az reservations reservation merge --reservation-order-id
                                  [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                  [--sources]

Exemplos

Mesclar reservas

az reservations reservation merge --reservation-order-id 10000000-aaaa-bbbb-cccc-100000000005 --sources "['/providers/Microsoft.Capacity/reservationOrders/10000000-aaaa-bbbb-cccc-100000000005/reservations/30000000-aaaa-bbbb-cccc-100000000002','/providers/Microsoft.Capacity/reservationOrders/10000000-aaaa-bbbb-cccc-100000000005/reservations/30000000-aaaa-bbbb-cccc-100000000004']"

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

--sources

O formato do ID do recurso deve ser /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId} Suporte a sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

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 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 detalhes específicos Reservation .

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

Exemplos

Obter um detalhe da reserva

az reservations reservation show --reservation-id 40000000-aaaa-bbbb-cccc-100000000001 --reservation-order-id 10000000-aaaa-bbbb-cccc-200000000001

Parâmetros Exigidos

--reservation-id

ID do item de reserva.

--reservation-order-id

ID do pedido da reserva.

Parâmetros Opcionais

--expand

O valor suportado desta consulta é renewProperties.

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 split

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

Divida a Reservation em dois Reservations com distribuição de quantidade especificada.

az reservations reservation split --reservation-order-id
                                  [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                  [--quantities]
                                  [--reservation-id]

Exemplos

Dividir uma reserva

az reservations reservation split --quantities "[2,8]" --reservation-id /providers/Microsoft.Capacity/reservationOrders/30000000-aaaa-bbbb-cccc-100000000004/reservations/40000000-aaaa-bbbb-cccc-100000000001 --reservation-order-id 30000000-aaaa-bbbb-cccc-100000000004

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

--quantities

Lista das quantidades nas novas reservas a serem criadas. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--reservation-id

ID do recurso da reserva a ser dividida. O formato da ID do recurso deve ser /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.

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 unarchive

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

Desarquivar um Reservation move-o para o estado em que estava antes de arquivar.

az reservations reservation unarchive --reservation-id
                                      --reservation-order-id

Exemplos

Desarquivando uma reserva

az reservations reservation unarchive --reservation-order-id 40000000-aaaa-bbbb-cccc-20000000000 --reservation-id 50000000-aaaa-bbbb-cccc-200000000000

Parâmetros Exigidos

--reservation-id

ID do item de reserva.

--reservation-order-id

ID do pedido da 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 update

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

Atualize os escopos aplicados, a renovação, o nome, a flexibilidade de instância do Reservation.

az reservations reservation update --reservation-id
                                   --reservation-order-id
                                   [--applied-scope-property]
                                   [--applied-scope-type {ManagementGroup, Shared, Single}]
                                   [--applied-scopes]
                                   [--instance-flexibility {Off, On}]
                                   [--name]
                                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--renew {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--renewal-properties]

Exemplos

Definir reserva como escopo compartilhado

az reservations reservation update --applied-scope-type Shared --reservation-id 10000000-aaaa-bbbb-cccc-200000000001 --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000005

Definir renovação de reserva

az reservations reservation update --reservation-id 10000000-aaaa-bbbb-cccc-200000000001 --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000005 --renew true

Definir reserva como escopo único

az reservations reservation update --reservation-id 10000000-aaaa-bbbb-cccc-200000000001 --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000005 --applied-scope-type Single --applied-scopes ['/subscriptions/50000000-aaaa-bbbb-cccc-200000000009']

Definir reserva para grupo de recursos de escopo único

az reservations reservation update --reservation-id 10000000-aaaa-bbbb-cccc-200000000001 --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000005 --applied-scope-type Single --applied-scopes ['/subscriptions/50000000-aaaa-bbbb-cccc-200000000009/resourceGroups/mock_resource_group_name']

Definir reserva para escopo do grupo de gerenciamento

az reservations reservation update --reservation-id 10000000-aaaa-bbbb-cccc-200000000001 --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000005 --applied-scope-type ManagementGroup --applied-scope-property '{management-group-id:/providers/Microsoft.Management/managementGroups/mock_management_group_name,tenant-id:50000000-aaaa-bbbb-cccc-200000000008}'

Parâmetros Exigidos

--reservation-id

ID do item de reserva.

--reservation-order-id

ID do pedido da reserva.

Parâmetros Opcionais

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

--applied-scopes

Lista das inscrições que o benefício será aplicado. Não especifique se AppliedScopeType é compartilhado. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

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

--name

Nome da Reserva.

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

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

--renewal-properties

Propriedades de compra de renovação Suporte a sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

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 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 wait --reservation-id
                                 --reservation-order-id
                                 [--created]
                                 [--custom]
                                 [--deleted]
                                 [--exists]
                                 [--expand]
                                 [--interval]
                                 [--timeout]
                                 [--updated]

Parâmetros Exigidos

--reservation-id

ID do item de reserva.

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

O valor suportado desta consulta é renewProperties.

--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.

Compartilhar via

az reservations reservation

Comandos

az reservations reservation archive

Exemplos

Parâmetros Exigidos

az reservations reservation list

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az reservations reservation list-available-scope

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az reservations reservation list-history

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az reservations reservation merge

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az reservations reservation show

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az reservations reservation split

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az reservations reservation unarchive

Exemplos

Parâmetros Exigidos

az reservations reservation update

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az reservations reservation wait

Parâmetros Exigidos

Parâmetros Opcionais

Recursos adicionais