Partilhar via


az reservations

Note

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 . Saiba mais sobre extensões.

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

Reservas do Azure.

Comandos

Name Description Tipo Status
az reservations calculate-exchange

Calcula o preço para 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 reservas disponíveis.

Extension Preview
az reservations exchange

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

Reservas reservas.

Extension Preview
az reservations reservation-order

Reservas-ordem.

Extension Preview
az reservations reservation-order-id

Reservas reserva-ordem-id.

Extension Preview
az reservations reservation-order-id list

Liste os Reservationaplicáveis a esta assinatura ou a um grupo de recursos sob esta assinatura.

Extension Preview
az reservations reservation-order calculate

Calcule 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 ID de locatário especificado.

Extension Preview
az reservations reservation-order list

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

Extension Preview
az reservations reservation-order purchase

Crie ReservationOrder e crie recurso no URI especificado.

Extension Preview
az reservations reservation-order return

Devolva 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á no estado cancelado/expirado e movê-lo para Archived estado.

Extension Preview
az reservations reservation list

Listar reservas dentro de 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 para o Reservation.

Extension Preview
az reservations reservation merge

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

Extension Preview
az reservations reservation show

Obtenha detalhes Reservation específicos.

Extension Preview
az reservations reservation split

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

Extension Preview
az reservations reservation unarchive

Desarquivar um Reservation move-o para o estado em que se encontrava antes do arquivamento.

Extension Preview
az reservations reservation update

Atualize os escopos aplicados, renovação, nome, flexibilidade de 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

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

Calcula o preço para 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 tornar-se necessários para que o comando seja executado com êxito.

--no-wait

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

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

Lista de reservas que estão sendo devolvidas nesta troca. Suporta sintaxe taquigráfica, json-file 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. Suporta sintaxe taquigráfica, json-file 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 bolsa. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az reservations exchange

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

Devolve um 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 de câmbio

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 tornar-se necessários para que o comando seja executado com êxito.

--no-wait

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

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

SessionId que foi retornado pela API do CalculateExchange.

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

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

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 sob o locatário atual

az reservations list

Reserva de lista que tem o estado "Falha" sob o locatário atual

az reservations list --selected-state "Failed"

Listar todas as reservas de "VirtualMachines" sob o locatário atual

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

Listar reservas 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 tornar-se necessários para que o comando seja executado com êxito.

--filter

Pode ser usado para filtrar por propriedades de reserva. O filtro suporta 'eq', 'or' e 'and'. Atualmente, não suporta 'ne', 'gt', 'le', 'ge' ou 'not'. As propriedades de reserva incluem sku/name, properties/{appliedScopeType, archived, displayName, displayProvisioningState, effectiveDateTime, expiryDate, 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 por onde começar a paginar. Este é o valor de 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False