Compartir a través de


az reservations

Note

This reference is part of the reservation extension for the Azure CLI (version 2.50.0 or higher). The extension will automatically install the first time you run an az reservations command. Learn more about extensions.

Este grupo de comandos está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Azure Reservations.

Comandos

Nombre Description Tipo Estado
az reservations calculate-exchange

Calcula el precio para intercambiar Reservations si no hay errores de directiva.

Extension Preview
az reservations catalog

Reservations catalog.

Extension Preview
az reservations catalog show

Obtenga el catálogo de reservas disponibles.

Extension Preview
az reservations exchange

Devuelve uno o varios Reservations a cambio de una o más compras de Reservation.

Extension Preview
az reservations list

Enumere las reservas a las que el usuario tiene acceso en el inquilino actual.

Extension Preview
az reservations reservation

Reservations reservation.

Extension Preview
az reservations reservation-order

Reservations reservation-order.

Extension Preview
az reservations reservation-order-id

Reservations reservation-order-id.

Extension Preview
az reservations reservation-order-id list

Enumere los Reservationaplicables que se aplican a esta suscripción o a un grupo de recursos de esta suscripción.

Extension Preview
az reservations reservation-order calculate

Calcule el precio para colocar un ReservationOrder.

Extension Preview
az reservations reservation-order calculate-refund

Calcule el precio para devolver Reservations si no hay errores de directiva.

Extension Preview
az reservations reservation-order change-directory

Cambie el directorio (inquilino) de ReservationOrder y todos los Reservation en él por el identificador de inquilino especificado.

Extension Preview
az reservations reservation-order list

Lista de todos los ReservationOrdera los que el usuario tiene acceso en el inquilino actual.

Extension Preview
az reservations reservation-order purchase

Cree ReservationOrder y cree un recurso en el URI especificado.

Extension Preview
az reservations reservation-order return

Devolver una reserva.

Extension Preview
az reservations reservation-order show

Obtenga los detalles del ReservationOrder.

Extension Preview
az reservations reservation-order wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

Extension Preview
az reservations reservation archive

Archivar un Reservation que está en estado cancelado o expirado y moverlo a Archived estado.

Extension Preview
az reservations reservation list

Enumera las reservas dentro de un único ReservationOrder.

Extension Preview
az reservations reservation list-available-scope

Enumera los ámbitos disponibles para Reservation.

Extension Preview
az reservations reservation list-history

Lista de todas las revisiones de la Reservation.

Extension Preview
az reservations reservation merge

Combine los Reservationespecificados en un nuevo Reservation. Los dos Reservationque se combinan deben tener las mismas propiedades.

Extension Preview
az reservations reservation show

Obtenga detalles de Reservation específicos.

Extension Preview
az reservations reservation split

Divida un Reservation en dos Reservations con la distribución de cantidad especificada.

Extension Preview
az reservations reservation unarchive

Desarchivar un Reservation lo mueve al estado que estaba antes de archivar.

Extension Preview
az reservations reservation update

Actualice los ámbitos aplicados, la renovación, el nombre, la flexibilidad de instancia del Reservation.

Extension Preview
az reservations reservation wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

Extension Preview

az reservations calculate-exchange

Vista previa

El grupo de comandos "reservations" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Calcula el precio para intercambiar Reservations si no hay errores de directiva.

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]

Ejemplos

Calculate exchange

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 opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

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

Lista de reservas que se devuelven en este intercambio. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Parameter group: Properties Arguments
--ris-to-purchase

Lista de reservas que se compran en este intercambio. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Parameter group: Properties Arguments
--sp-to-purchase

Lista de planes de ahorro que se están comprando en este intercambio. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Parameter group: Properties Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az reservations exchange

Vista previa

El grupo de comandos "reservations" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Devuelve uno o varios Reservations a cambio de una o más compras de Reservation.

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

Ejemplos

Exchange reservations

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

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

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

SessionId devuelto por CalculateExchange API.

Propiedad Valor
Parameter group: Properties Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az reservations list

Vista previa

El grupo de comandos "reservations" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumere las reservas a las que el usuario tiene acceso en el inquilino actual.

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

Ejemplos

Enumeración de reservas en el inquilino actual

az reservations list

Enumerar la reserva que tiene el estado "Error" en el inquilino actual

az reservations list --selected-state "Failed"

Enumerar todas las reservas de "VirtualMachines" en el inquilino actual

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

Enumerar la reserva y ordenar el resultado por cantidad en orden descendente

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

Parámetros opcionales

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--filter

Puede usarse para filtrar por propiedades de reserva. El filtro admite "eq", "or" y "and". Actualmente no admite 'ne', 'gt', 'le', 'ge' o 'not'. Las propiedades de reserva incluyen sku/name, properties/{appliedScopeType, archived, displayName, displayProvisioningState, effectiveDateTime, expiryDate, provisioningState, quantity, renew, reservedResourceType, term, userFriendlyAppliedScopeType, userFriendlyRenewState}.

--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token argumento de un comando posterior.

Propiedad Valor
Parameter group: Pagination Arguments
--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

Propiedad Valor
Parameter group: Pagination Arguments
--orderby

Se puede usar para ordenar el criterio por propiedades de reserva.

--selected-state

Estado de aprovisionamiento seleccionado.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False