az reservations reservation

Nota:

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 reservation . Obtenga más información sobre las extensiones.

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

Reserva de reservas.

Comandos

Nombre	Description	Tipo	Estado
az reservations reservation archive	Archivado de un objeto Reservation que está en estado cancelado o expirado y muévalo al Archived estado.	Extensión	Vista previa
az reservations reservation list	Enumera las reservas dentro de un único ReservationOrder.	Extensión	Vista previa
az reservations reservation list-available-scope	Enumera los ámbitos disponibles para Reservation.	Extensión	Vista previa
az reservations reservation list-history	Lista de todas las revisiones de .Reservation	Extensión	Vista previa
az reservations reservation merge	Combine los elementos especificados Reservationen un nuevo Reservation. Los dos Reservationque se combinan deben tener las mismas propiedades.	Extensión	Vista previa
az reservations reservation show	Obtenga detalles específicos Reservation .	Extensión	Vista previa
az reservations reservation split	Divida un objeto Reservation en dos Reservations con la distribución de cantidad especificada.	Extensión	Vista previa
az reservations reservation unarchive	Desarchivar un Reservation lo mueve al estado que estaba antes de archivar.	Extensión	Vista previa
az reservations reservation update	Actualice los ámbitos aplicados, renovación, nombre, flexibilidad de instancia de Reservation.	Extensión	Vista previa
az reservations reservation wait	Coloque la CLI en un estado de espera hasta que se cumpla una condición.	Extensión	Vista previa

az reservations reservation archive

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

Archivado de un objeto Reservation que está en estado cancelado o expirado y muévalo al Archived estado.

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

Ejemplos

Archivado de una reserva

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

Parámetros requeridos

--reservation-id

Identificador del elemento de reserva.

--reservation-order-id

Id. de pedido de la reserva.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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

Enumera las reservas dentro de un único ReservationOrder.

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

Ejemplos

Enumera todas las reservas dentro de un pedido de reserva.

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

Parámetros requeridos

--reservation-order-id

Id. de pedido de la reserva.

Parámetros opcionales

--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 el argumento de un comando posterior.

--next-token

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

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az reservations reservation list-available-scope

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

Enumera los ámbitos disponibles para Reservation.

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

Ejemplos

Enumerar ámbitos disponibles 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 requeridos

--reservation-id

Identificador del elemento de reserva.

--reservation-order-id

Id. de pedido de la reserva.

Parámetros opcionales

--no-wait

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

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes

--scopes

Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az reservations reservation list-history

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

Lista de todas las revisiones de .Reservation

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

Ejemplos

Obtenga el historial de una reserva.

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

Parámetros requeridos

--reservation-id

Identificador del elemento de reserva.

--reservation-order-id

Id. de pedido de la reserva.

Parámetros opcionales

--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 el argumento de un comando posterior.

--next-token

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

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az reservations reservation merge

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

Combine los elementos especificados Reservationen un nuevo Reservation. Los dos Reservationque se combinan deben tener las mismas propiedades.

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

Ejemplos

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

--reservation-order-id

Id. de pedido de la reserva.

Parámetros opcionales

--no-wait

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

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes

--sources

El formato del identificador de recurso debe ser /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId} Compatibilidad con la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az reservations reservation show

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

Obtenga detalles específicos Reservation .

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

Ejemplos

Obtención de un detalle de reserva

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

Parámetros requeridos

--reservation-id

Identificador del elemento de reserva.

--reservation-order-id

Id. de pedido de la reserva.

Parámetros opcionales

--expand

El valor admitido de esta consulta es renewProperties.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az reservations reservation split

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

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

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

Ejemplos

División de una 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 requeridos

--reservation-order-id

Id. de pedido de la reserva.

Parámetros opcionales

--no-wait

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

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes

--quantities

Lista de las cantidades de las nuevas reservas que se van a crear. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--reservation-id

Identificador de recurso de la reserva que se va a dividir. El formato del identificador de recurso debe ser /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az reservations reservation unarchive

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

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

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

Ejemplos

Desarchivar una reserva

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

Parámetros requeridos

--reservation-id

Identificador del elemento de reserva.

--reservation-order-id

Id. de pedido de la reserva.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az reservations reservation update

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

Actualice los ámbitos aplicados, renovación, nombre, flexibilidad de instancia de 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]

Ejemplos

Establecer la reserva en ámbito compartido

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

Establecimiento de la renovación de reservas

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

Establecer la reserva en Ámbito ú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']

Establecimiento de la reserva en Grupo de recursos de ámbito ú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']

Establecimiento de la reserva en el ámbito del grupo de administración

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 requeridos

--reservation-id

Identificador del elemento de reserva.

--reservation-order-id

Id. de pedido de la reserva.

Parámetros opcionales

--applied-scope-property

Propiedades específicas del tipo de ámbito aplicado. No es necesario si no es aplicable. Obligatorio y necesario proporcionar tenantId y managementGroupId si AppliedScopeType es ManagementGroup Support shorthand-syntax, json-file y yaml-file. Intenta "??" para mostrar más.

--applied-scope-type

Tipo del ámbito aplicado.

valores aceptados: ManagementGroup, Shared, Single

--applied-scopes

Lista de las suscripciones a las que se aplicará la ventaja. No especifique si AppliedScopeType es Shared. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--instance-flexibility

Al activar esto, se aplicará el descuento de reserva a otras máquinas virtuales del mismo grupo de tamaño de máquina virtual. Especifique solo el tipo de recurso reservado VirtualMachines.

valores aceptados: Off, On

--name

Nombre de la reserva.

--no-wait

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

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes

--renew

Si se establece en true, se adquirirá automáticamente una nueva reserva en la fecha de expiración.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes

valor predeterminado: False

--renewal-properties

Propiedades de compra de renovación Admiten la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az reservations reservation wait

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

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

az reservations reservation wait --reservation-id
                                 --reservation-order-id
                                 [--created]
                                 [--custom]
                                 [--deleted]
                                 [--exists]
                                 [--expand]
                                 [--interval]
                                 [--timeout]
                                 [--updated]

Parámetros requeridos

--reservation-id

Identificador del elemento de reserva.

--reservation-order-id

Id. de pedido de la reserva.

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

valor predeterminado: False

--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

valor predeterminado: False

--exists

Espere hasta que exista el recurso.

valor predeterminado: False

--expand

El valor admitido de esta consulta es renewProperties.

--interval

Intervalo de sondeo en segundos.

valor predeterminado: 30

--timeout

Espera máxima en segundos.

valor predeterminado: 3600

--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

valor predeterminado: False

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.