Compartilhar via


az reservations

Note

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

Esse grupo de comandos está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Reservas do Azure.

Comandos

Nome Description Tipo Status
az reservations calculate-exchange

Calcula o preço da troca de Reservations se não houver erros de política.

Extension Preview
az reservations catalog

Catálogo de reservas.

Extension Preview
az reservations catalog show

Obter catálogo de reserva disponível.

Extension Preview
az reservations exchange

Retorna uma ou mais Reservations em troca de uma ou mais compras Reservation.

Extension Preview
az reservations list

Liste as reservas às quais o usuário tem acesso no locatário atual.

Extension Preview
az reservations reservation

Reserva de reservas.

Extension Preview
az reservations reservation-order

Ordem de reserva de reservas.

Extension Preview
az reservations reservation-order-id

Reservations reservation-order-id.

Extension Preview
az reservations reservation-order-id list

Listar Reservationaplicáveis que são aplicadas a esta assinatura ou a um grupo de recursos nesta assinatura.

Extension Preview
az reservations reservation-order calculate

Calcular o preço para colocar um ReservationOrder.

Extension Preview
az reservations reservation-order calculate-refund

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

Extension Preview
az reservations reservation-order change-directory

Altere o diretório (locatário) de ReservationOrder e todos os Reservation sob ele para a ID de locatário especificada.

Extension Preview
az reservations reservation-order list

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

Extension Preview
az reservations reservation-order purchase

Crie ReservationOrder e crie um recurso no URI especificado.

Extension Preview
az reservations reservation-order return

Retornar uma reserva.

Extension Preview
az reservations reservation-order show

Obtenha os detalhes do ReservationOrder.

Extension Preview
az reservations reservation-order wait

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

Extension Preview
az reservations reservation archive

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

Extension Preview
az reservations reservation list

Listar reservas em um único ReservationOrder.

Extension Preview
az reservations reservation list-available-scope

Listar escopos disponíveis para Reservation.

Extension Preview
az reservations reservation list-history

Lista de todas as revisões do Reservation.

Extension Preview
az reservations reservation merge

Mesclar os Reservationespecificados em um novo Reservation. Os dois Reservationque estão sendo mesclados devem ter as mesmas propriedades.

Extension Preview
az reservations reservation show

Obtenha detalhes específicos do Reservation.

Extension Preview
az reservations reservation split

Divida um Reservation em dois Reservationcom a distribuição de quantidade especificada.

Extension Preview
az reservations reservation unarchive

Desarquivar um Reservation move-o para o estado que era antes do arquivamento.

Extension Preview
az reservations reservation update

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

Extension Preview
az reservations reservation wait

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

Extension Preview

az reservations calculate-exchange

Versão Prévia

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

Calcula o preço da troca de Reservations se não houver erros de política.

az reservations calculate-exchange [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--ris-to-exchange]
                                   [--ris-to-purchase]
                                   [--sp-to-purchase]

Exemplos

Calcular troca

az reservations calculate-exchange --ris-to-exchange "[{reservation-id:/providers/microsoft.capacity/reservationOrders/40000000-aaaa-bbbb-cccc-200000000012/reservations/51000000-aaaa-bbbb-cccc-200000000012,quantity:1},{reservation-id:/providers/microsoft.capacity/reservationOrders/90000000-aaaa-bbbb-cccc-200000000012/reservations/36000000-aaaa-bbbb-cccc-200000000012,quantity:1}]" --ris-to-purchase "[{reserved-resource-type:VirtualMachines,applied-scope-type:Shared,billing-scope:12350000-aaaa-bbbb-cccc-200000000012,display-name:exchangeTest1,quantity:1,sku:Standard_B1s,term:P1Y,billing-plan:Monthly,location:eastus},{reserved-resource-type:VirtualMachines,applied-scope-type:Shared,billing-scope:12350000-aaaa-bbbb-cccc-200000000012,display-name:exchangeTest2,quantity:1,sku:Standard_B1s,term:P1Y,billing-plan:Monthly,location:eastus}]"

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-wait

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

Propriedade Valor
Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--ris-to-exchange

Lista de reservas que estão sendo retornadas nesta troca. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--ris-to-purchase

Lista de reservas que estão sendo compradas nesta troca. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--sp-to-purchase

Lista de planos de poupança que estão sendo comprados nesta troca. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az reservations exchange

Versão Prévia

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

Retorna uma ou mais Reservations em troca de uma ou mais compras Reservation.

az reservations exchange [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                         [--session-id]

Exemplos

Reservas do Exchange

az reservations exchange --session-id 40000000-aaaa-bbbb-cccc-200000000012

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-wait

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

Propriedade Valor
Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--session-id

SessionId que foi retornado pela API CalculateExchange.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az reservations list

Versão Prévia

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

Liste as reservas às quais o usuário tem acesso no locatário atual.

az reservations list [--filter]
                     [--max-items]
                     [--next-token]
                     [--orderby]
                     [--selected-state]

Exemplos

Listar reservas no locatário atual

az reservations list

Listar a reserva que tem o estado "Falha" no locatário atual

az reservations list --selected-state "Failed"

Listar todas as reservas "VirtualMachines" no locatário atual

az az reservations list --filter "properties/reservedResourceType eq 'VirtualMachines'"

Listar a reserva e ordenar o resultado por quantidade em ordem decrescente

az reservations list --orderby 'properties/quantity desc'

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--filter

Pode ser usado para filtrar por propriedades de reserva. O filtro dá suporte a 'eq', 'or' e 'and'. Atualmente, ele não dá suporte a 'ne', 'gt', 'le', 'ge' ou 'not'. As propriedades de reserva incluem sku/name, properties/{appliedScopeType, archived, displayName, displayProvisioningState, effectiveDateTime, expirayDate, provisioningState, quantity, renew, reservedResourceType, term, userFriendlyAppliedScopeType, userFriendlyRenewState}.

--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 em --next-token argumento de um comando subsequente.

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--next-token

Token para especificar onde iniciar a paginação. Esse é o valor do token de uma resposta truncada anteriormente.

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--orderby

Pode ser usado para classificar a ordem por propriedades de reserva.

--selected-state

O estado de provisionamento selecionado.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False