Partager via

az reservations reservation

  • Préversion
  • Référence

Remarque

Cette référence fait partie de l’extension de réservation pour Azure CLI (version 2.50.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande de réservation az reservations. En savoir plus sur les extensions.

Le groupe de commandes « reservations » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Réservations de réservations.

Commandes

Nom Description Type Statut
az reservations reservation archive

Archivage d’un Reservation état annulé/expiré et déplacement vers Archived l’état.

 Extension Aperçu
az reservations reservation list

Répertorier les réservations au sein d’un seul ReservationOrder.

 Extension Aperçu
az reservations reservation list-available-scope

Répertorier les étendues disponibles pour Reservation.

 Extension Aperçu
az reservations reservation list-history

Liste de toutes les révisions pour le Reservation.

 Extension Aperçu
az reservations reservation merge

Fusionnez les s spécifiés Reservationdans un nouveau Reservation. Les deux Reservationéléments qui sont fusionnés doivent avoir les mêmes propriétés.

 Extension Aperçu
az reservations reservation show

Obtenez des détails spécifiques Reservation .

 Extension Aperçu
az reservations reservation split

Fractionnez un Reservation en deux Reservations avec une distribution de quantité spécifiée.

 Extension Aperçu
az reservations reservation unarchive

Annuler l’archivage d’un Reservation déplacement vers l’état avant l’archivage.

 Extension Aperçu
az reservations reservation update

Mettez à jour les étendues appliquées, le renouvellement, le nom, la flexibilité de l’instance du Reservation.

 Extension Aperçu
az reservations reservation wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition soit remplie.

 Extension Aperçu

az reservations reservation archive

Préversion

Le groupe de commandes « reservations » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Archivage d’un Reservation état annulé/expiré et déplacement vers Archived l’état.

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

Exemples

Archivage d’une réservation

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

Paramètres obligatoires

--reservation-id

ID de l’élément de réservation.

--reservation-order-id

ID de commande de la réservation.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az reservations reservation list

Préversion

Le groupe de commandes « reservations » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Répertorier les réservations au sein d’un seul ReservationOrder.

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

Exemples

Répertorier toutes les réservations dans un ordre de réservation.

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

Paramètres obligatoires

--reservation-order-id

ID de commande de la réservation.

Paramètres facultatifs

--max-items

Nombre total d’éléments à retourner dans la sortie de la commande. Si le nombre total d’éléments disponibles est supérieur à la valeur spécifiée, un jeton est fourni dans la sortie de la commande. Pour reprendre la pagination, fournissez la valeur du jeton dans --next-token l’argument d’une commande suivante.

--next-token

Jeton pour spécifier où commencer la pagination. Il s’agit de la valeur du jeton d’une réponse tronquée précédemment.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az reservations reservation list-available-scope

Préversion

Le groupe de commandes « reservations » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Répertorier les étendues disponibles pour 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]

Exemples

Répertorier les étendues disponibles de réservation

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

Paramètres obligatoires

--reservation-id

ID de l’élément de réservation.

--reservation-order-id

ID de commande de la réservation.

Paramètres facultatifs

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--scopes

Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az reservations reservation list-history

Préversion

Le groupe de commandes « reservations » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Liste de toutes les révisions pour le Reservation.

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

Exemples

Obtenir l’historique d’une réservation.

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

Paramètres obligatoires

--reservation-id

ID de l’élément de réservation.

--reservation-order-id

ID de commande de la réservation.

Paramètres facultatifs

--max-items

Nombre total d’éléments à retourner dans la sortie de la commande. Si le nombre total d’éléments disponibles est supérieur à la valeur spécifiée, un jeton est fourni dans la sortie de la commande. Pour reprendre la pagination, fournissez la valeur du jeton dans --next-token l’argument d’une commande suivante.

--next-token

Jeton pour spécifier où commencer la pagination. Il s’agit de la valeur du jeton d’une réponse tronquée précédemment.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az reservations reservation merge

Préversion

Le groupe de commandes « reservations » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Fusionnez les s spécifiés Reservationdans un nouveau Reservation. Les deux Reservationéléments qui sont fusionnés doivent avoir les mêmes propriétés.

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

Exemples

Fusionner des réservations

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']"

Paramètres obligatoires

--reservation-order-id

ID de commande de la réservation.

Paramètres facultatifs

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--sources

Le format de l’ID de ressource doit être /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId} Support shorthand-syntax, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az reservations reservation show

Préversion

Le groupe de commandes « reservations » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Obtenez des détails spécifiques Reservation .

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

Exemples

Obtenir un détail de réservation

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

Paramètres obligatoires

--reservation-id

ID de l’élément de réservation.

--reservation-order-id

ID de commande de la réservation.

Paramètres facultatifs

--expand

La valeur prise en charge de cette requête est renewProperties.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az reservations reservation split

Préversion

Le groupe de commandes « reservations » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Fractionnez un Reservation en deux Reservations avec une distribution de quantité spécifiée.

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

Exemples

Diviser une réservation

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

Paramètres obligatoires

--reservation-order-id

ID de commande de la réservation.

Paramètres facultatifs

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--quantities

Liste des quantités dans les nouvelles réservations à créer. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--reservation-id

ID de ressource de la réservation à fractionner. Le format de l’ID de ressource doit être /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az reservations reservation unarchive

Préversion

Le groupe de commandes « reservations » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Annuler l’archivage d’un Reservation déplacement vers l’état avant l’archivage.

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

Exemples

Annuler l’archivage d’une réservation

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

Paramètres obligatoires

--reservation-id

ID de l’élément de réservation.

--reservation-order-id

ID de commande de la réservation.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az reservations reservation update

Préversion

Le groupe de commandes « reservations » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Mettez à jour les étendues appliquées, le renouvellement, le nom, la flexibilité de l’instance du 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]

Exemples

Définir la réservation sur l’étendue partagée

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

Définir le renouvellement de réservation

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

Définir la réservation sur une étendue unique

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

Définir la réservation sur un groupe de ressources à étendue unique

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

Définir la réservation sur l’étendue du groupe d’administration

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

Paramètres obligatoires

--reservation-id

ID de l’élément de réservation.

--reservation-order-id

ID de commande de la réservation.

Paramètres facultatifs

--applied-scope-property

Propriétés spécifiques au type d’étendue appliqué. Non obligatoire s’il n’est pas applicable. Obligatoire et doit fournir tenantId et managementGroupId si AppliedScopeType est ManagementGroup Support shorthand-syntax, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--applied-scope-type

Type de l’étendue appliquée.

valeurs acceptées: ManagementGroup, Shared, Single
--applied-scopes

Liste des abonnements auxquels l’avantage sera appliqué. Ne spécifiez pas si AppliedScopeType est partagé. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--instance-flexibility

L’activation de cette option applique la remise de réservation à d’autres machines virtuelles du même groupe de tailles de machine virtuelle. Spécifiez uniquement le type de ressource réservée VirtualMachines.

valeurs acceptées: Off, On
--name

Nom de la réservation.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--renew

Si cette valeur est true, vous achetez automatiquement une nouvelle réservation à la date d’expiration.

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
valeur par défaut: False
--renewal-properties

Les propriétés d’achat de renouvellement prennent en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az reservations reservation wait

Préversion

Le groupe de commandes « reservations » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition soit remplie.

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

Paramètres obligatoires

--reservation-id

ID de l’élément de réservation.

--reservation-order-id

ID de commande de la réservation.

Paramètres facultatifs

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

valeur par défaut: False
--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendez la suppression.

valeur par défaut: False
--exists

Attendez que la ressource existe.

valeur par défaut: False
--expand

La valeur prise en charge de cette requête est renewProperties.

--interval

Intervalle d’interrogation en secondes.

valeur par défaut: 30
--timeout

Délai maximal d’attente en secondes.

valeur par défaut: 3600
--updated

Attendez la mise à jour avec provisioningState sur « Réussi ».

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.