Compartir a través de


az reservations

Note

Esta referencia forma parte de la extensión de reserva para la CLI de Azure (versión 2.50.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az reservations . Obtenga más información sobre las extensiones.

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

Reservas de Azure.

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

Catálogo de reservas.

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

Reserva de reservas.

Extension Preview
az reservations reservation-order

Pedido de reserva de reservas.

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

Cálculo del intercambio

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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
Grupo de parámetros: 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
Grupo de parámetros: 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
Grupo de parámetros: 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

Formato de salida.

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

Reservas de Exchange

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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
Grupo de parámetros: 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

Formato de salida.

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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
Grupo de parámetros: 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
Grupo de parámetros: 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

Formato de salida.

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