Compartir a través de


az reservations reservation-order

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-order . 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

Pedido de reserva de reservas.

Comandos

Nombre Description Tipo Estado
az reservations reservation-order calculate

Calcule el precio para colocar un ReservationOrder.

Extensión Vista previa
az reservations reservation-order calculate-refund

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

Extensión Vista previa
az reservations reservation-order change-directory

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

Extensión Vista previa
az reservations reservation-order list

Lista de todos los elementos a los ReservationOrderque el usuario tiene acceso en el inquilino actual.

Extensión Vista previa
az reservations reservation-order purchase

Cree ReservationOrder y cree un recurso en el URI especificado.

Extensión Vista previa
az reservations reservation-order return

Devolver una reserva.

Extensión Vista previa
az reservations reservation-order show

Obtenga los detalles de ReservationOrder.

Extensión Vista previa
az reservations reservation-order wait

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

Extensión Vista previa

az reservations reservation-order calculate

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

Calcule el precio para colocar un ReservationOrder.

az reservations reservation-order calculate [--applied-scope]
                                            [--applied-scope-property]
                                            [--applied-scope-type {ManagementGroup, Shared, Single}]
                                            [--billing-plan {Monthly, Upfront}]
                                            [--billing-scope]
                                            [--display-name]
                                            [--instance-flexibility {Off, On}]
                                            [--location]
                                            [--quantity]
                                            [--renew {0, 1, f, false, n, no, t, true, y, yes}]
                                            [--reserved-resource-type {AVS, AppService, AzureDataExplorer, AzureFiles, BlockBlob, CosmosDb, DataFactory, Databricks, DedicatedHost, ManagedDisk, MariaDb, MySql, NetAppStorage, PostgreSql, RedHat, RedHatOsa, RedisCache, SapHana, SqlAzureHybridBenefit, SqlDataWarehouse, SqlDatabases, SqlEdge, SuseLinux, VMwareCloudSimple, VirtualMachineSoftware, VirtualMachines}]
                                            [--review-date-time]
                                            [--sku]
                                            [--term {P1Y, P3Y, P5Y}]

Ejemplos

Cálculo del precio

az reservations reservation-order calculate --applied-scope-type Shared --billing-scope 50000000-aaaa-bbbb-cccc-100000000002 --display-name name1 --quantity 1 --reserved-resource-type VirtualMachines --sku Standard_B1s --term P1Y --billing-plan Monthly --location eastus

Parámetros opcionales

--applied-scope

Suscripción a la que se aplicará la ventaja. Obligatorio si --applied-scope-type es Single. No especifique si --applied-scope-type es Shared. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--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
--billing-plan

Representa los planes de facturación.

valores aceptados: Monthly, Upfront
--billing-scope

Suscripción que se cobrará por comprar reserva.

--display-name

Nombre descriptivo de la reserva.

--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
--location

Región de Azure donde reside el recurso reservado.

--quantity

Cantidad de las SKU que forman parte de la reserva.

--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
--reserved-resource-type

Tipo del recurso que se está reservando.

valores aceptados: AVS, AppService, AzureDataExplorer, AzureFiles, BlockBlob, CosmosDb, DataFactory, Databricks, DedicatedHost, ManagedDisk, MariaDb, MySql, NetAppStorage, PostgreSql, RedHat, RedHatOsa, RedisCache, SapHana, SqlAzureHybridBenefit, SqlDataWarehouse, SqlDatabases, SqlEdge, SuseLinux, VMwareCloudSimple, VirtualMachineSoftware, VirtualMachines
--review-date-time

Esta es la fecha y hora en que se debe revisar la ventaja híbrida de Azure.

--sku

Nombre de SKU para la compra.

--term

Representa el término de reserva.

valores aceptados: P1Y, P3Y, P5Y
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-order calculate-refund

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

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

az reservations reservation-order calculate-refund --reservation-order-id
                                                   [--id]
                                                   [--quantity]
                                                   [--reservation-id]
                                                   [--scope]

Ejemplos

Cálculo del reembolso

az reservations reservation-order calculate-refund --reservation-order-id 0000000-aaaa-bbbb-cccc-20000000001 --id /providers/microsoft.capacity/reservationOrders/0000000-aaaa-bbbb-cccc-20000000001 --scope Reservation --quantity 1 --reservation-id /providers/microsoft.capacity/reservationOrders/0000000-aaaa-bbbb-cccc-20000000001/reservations/50000000-aaaa-bbbb-cccc-200000000000

Parámetros requeridos

--reservation-order-id

Id. de pedido de la reserva.

Parámetros opcionales

--id

Identificador completo del pedido de reserva que se va a devolver.

--quantity

Cantidad que se va a devolver. Debe ser mayor que cero.

--reservation-id

Identificador completo de la reserva que se devuelve.

--scope

Ámbito del reembolso, por ejemplo, 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-order change-directory

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

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

az reservations reservation-order change-directory --reservation-order-id
                                                   [--destination-tenant-id]

Ejemplos

Cambio de un pedido de reserva a otro inquilino

az reservations reservation-order change-directory --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000000 --destination-tenant-id 10000000-aaaa-bbbb-cccc-200000000011

Parámetros requeridos

--reservation-order-id

Id. de pedido de la reserva.

Parámetros opcionales

--destination-tenant-id

GUID de identificador de inquilino al que se va a transferir el pedido de 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-order 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

Lista de todos los elementos a los ReservationOrderque el usuario tiene acceso en el inquilino actual.

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

Ejemplos

Lista de todos los pedidos de reserva a los que el usuario tiene acceso en el inquilino actual.

az reservations reservation-order list

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-order purchase

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

Cree ReservationOrder y cree un recurso en el URI especificado.

az reservations reservation-order purchase --reservation-order-id
                                           [--applied-scope]
                                           [--applied-scope-property]
                                           [--applied-scope-type {ManagementGroup, Shared, Single}]
                                           [--billing-plan {Monthly, Upfront}]
                                           [--billing-scope]
                                           [--display-name]
                                           [--instance-flexibility {Off, On}]
                                           [--location]
                                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                           [--quantity]
                                           [--renew {0, 1, f, false, n, no, t, true, y, yes}]
                                           [--reserved-resource-type {AVS, AppService, AzureDataExplorer, AzureFiles, BlockBlob, CosmosDb, DataFactory, Databricks, DedicatedHost, ManagedDisk, MariaDb, MySql, NetAppStorage, PostgreSql, RedHat, RedHatOsa, RedisCache, SapHana, SqlAzureHybridBenefit, SqlDataWarehouse, SqlDatabases, SqlEdge, SuseLinux, VMwareCloudSimple, VirtualMachineSoftware, VirtualMachines}]
                                           [--review-date-time]
                                           [--sku]
                                           [--term {P1Y, P3Y, P5Y}]

Ejemplos

Compra de una sola reserva de ámbito

az reservations reservation-order purchase --reservation-order-id 40000000-aaaa-bbbb-cccc-200000000005 --applied-scope-type Single --billing-scope 50000000-aaaa-bbbb-cccc-200000000005 --reserved-resource-type VirtualMachines --display-name name1 --quantity 1 --sku Standard_B1s --term P1Y --billing-plan Monthly --location eastus --applied-scope 50000000-aaaa-bbbb-cccc-200000000010

Compra de un ámbito único con reserva de grupo de recursos

az reservations reservation-order purchase --reservation-order-id 40000000-aaaa-bbbb-cccc-200000000005 --applied-scope-type Single --billing-scope 50000000-aaaa-bbbb-cccc-200000000005 --reserved-resource-type VirtualMachines --display-name testername1 --quantity 1 --sku Standard_B1s --term P1Y --billing-plan Monthly --location eastus --applied-scope '/subscriptions/50000000-aaaa-bbbb-cccc-200000000005/resourceGroups/rg1' --instance-flexibility Off

Parámetros requeridos

--reservation-order-id

Id. de pedido de la reserva.

Parámetros opcionales

--applied-scope

Suscripción a la que se aplicará la ventaja. Obligatorio si --applied-scope-type es Single. No especifique si --applied-scope-type es Shared. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--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
--billing-plan

Representa los planes de facturación.

valores aceptados: Monthly, Upfront
--billing-scope

Suscripción que se cobrará por comprar reserva.

--display-name

Nombre descriptivo de la reserva.

--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
--location

Región de Azure donde reside el recurso reservado.

--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
--quantity

Cantidad de las SKU que forman parte de la reserva.

--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
--reserved-resource-type

Tipo del recurso que se está reservando.

valores aceptados: AVS, AppService, AzureDataExplorer, AzureFiles, BlockBlob, CosmosDb, DataFactory, Databricks, DedicatedHost, ManagedDisk, MariaDb, MySql, NetAppStorage, PostgreSql, RedHat, RedHatOsa, RedisCache, SapHana, SqlAzureHybridBenefit, SqlDataWarehouse, SqlDatabases, SqlEdge, SuseLinux, VMwareCloudSimple, VirtualMachineSoftware, VirtualMachines
--review-date-time

Esta es la fecha y hora en que se debe revisar la ventaja híbrida de Azure.

--sku

Nombre de SKU para la compra.

--term

Representa el término de reserva.

valores aceptados: P1Y, P3Y, P5Y
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-order return

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

Devolver una reserva.

az reservations reservation-order return --reservation-order-id
                                         [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--quantity]
                                         [--reservation-id]
                                         [--return-reason]
                                         [--scope]
                                         [--session-id]

Ejemplos

Devolver una reserva

az reservations reservation-order return --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000000 --return-reason mockReason --scope Reservation --quantity 1 --reservation-id /providers/microsoft.capacity/reservationOrders/50000000-aaaa-bbbb-cccc-200000000000/reservations/30000000-aaaa-bbbb-cccc-200000000011 --session-id 40000000-aaaa-bbbb-cccc-200000000020

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
--quantity

Cantidad que se va a devolver. Debe ser mayor que cero.

--reservation-id

Identificador completo de la reserva que se devuelve.

--return-reason

Motivo de la devolución de la reserva.

--scope

Ámbito del reembolso, por ejemplo, Reserva.

--session-id

SessionId devuelto por CalculateRefund API.

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-order 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 los detalles de ReservationOrder.

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

Ejemplos

Obtener los detalles de un pedido de reserva

az reservations reservation-order show --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000005

Parámetros requeridos

--reservation-order-id

Id. de pedido de la reserva.

Parámetros opcionales

--expand

Se puede usar para expandir planInformation.

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-order 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-order wait --reservation-order-id
                                       [--created]
                                       [--custom]
                                       [--deleted]
                                       [--exists]
                                       [--expand]
                                       [--interval]
                                       [--timeout]
                                       [--updated]

Parámetros requeridos

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

Se puede usar para expandir planInformation.

--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.