az snapshot

  • Référence

Gère les copies ponctuelles des disques managés, des objets blob natifs ou d’autres captures instantanées.

Commandes

Nom Description Type Statut
az snapshot create

Créer une capture instantanée.

 Core GA
az snapshot delete

Supprime une capture instantanée.

 Core GA
az snapshot grant-access

Accordez l’accès en lecture à un instantané.

 Core GA
az snapshot list

Répertoriez les instantané sous un groupe de ressources.

 Core GA
az snapshot revoke-access

Révoquer l’accès à un instantané.

 Core GA
az snapshot show

Obtenez des informations sur un instantané.

 Core GA
az snapshot update

Mettez à jour un instantané.

 Core GA
az snapshot wait

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

 Core GA

az snapshot create

Créer une capture instantanée.

az snapshot create --name
                   --resource-group
                   [--accelerated-network {false, true}]
                   [--architecture {Arm64, x64}]
                   [--bandwidth-copy-speed {Enhanced, None}]
                   [--copy-start {false, true}]
                   [--disk-access]
                   [--disk-encryption-set]
                   [--edge-zone]
                   [--elastic-san-id]
                   [--encryption-type {EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey}]
                   [--for-upload {false, true}]
                   [--hyper-v-generation {V1, V2}]
                   [--incremental {false, true}]
                   [--location]
                   [--network-access-policy {AllowAll, AllowPrivate, DenyAll}]
                   [--no-wait]
                   [--public-network-access {Disabled, Enabled}]
                   [--size-gb]
                   [--sku {Premium_LRS, Standard_LRS, Standard_ZRS}]
                   [--source]
                   [--source-storage-account-id]
                   [--tags]

Exemples

Créez un instantané en important à partir d’un URI d’objet blob.

az snapshot create -g MyResourceGroup -n MySnapshot --source https://vhd1234.blob.core.windows.net/vhds/osdisk1234.vhd

Créez un instantané vide.

az snapshot create -g MyResourceGroup -n MySnapshot --size-gb 10

Créez un instantané en copiant un disque existant dans le même groupe de ressources.

az snapshot create -g MyResourceGroup -n MySnapshot2 --source MyDisk

Créez un instantané à partir d’un disque existant dans un autre groupe de ressources.

az snapshot create -g MyResourceGroup -n MySnapshot2 --source "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.Compute/disks/MyDisk"

Créez un instantané et associez-le à une ressource d’accès au disque.

az snapshot create -g MyResourceGroup -n MySnapshot --size-gb 10 --network-access-policy AllowPrivate --disk-access MyDiskAccessID

Paramètres obligatoires

--name -n

Nom de l’instantané.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--accelerated-network
Préversion

Les clients peuvent définir sur Disques managés ou instantanés pour activer la mise en réseau accélérée si l’image de disque du système d’exploitation prend en charge.

valeurs acceptées: false, true
--architecture

Architecture du processeur.

valeurs acceptées: Arm64, x64
--bandwidth-copy-speed

Si ce champ est défini sur un instantané et que createOption est CopyStart, le instantané sera copié à une vitesse plus rapide.

valeurs acceptées: Enhanced, None
--copy-start

Créez instantané à l’aide d’un processus de copie approfondie, où la création de la ressource est considérée comme terminée uniquement une fois que toutes les données ont été copiées à partir de la source.

valeurs acceptées: false, true
--disk-access

Nom ou ID de la ressource d’accès au disque pour l’utilisation de points de terminaison privés sur des disques.

--disk-encryption-set

Nom ou ID du jeu de chiffrement de disque utilisé pour chiffrer le disque.

--edge-zone

Nom de la zone de périphérie.

--elastic-san-id --elastic-san-resource-id

Il s’agit de l’ID ARM du volume san élastique source instantané.

--encryption-type

Type de chiffrement. EncryptionAtRestWithPlatformKey : le disque est chiffré avec la clé managée XStore au repos. Il s’agit du type de chiffrement par défaut. EncryptionAtRestWithCustomerKey : le disque est chiffré avec la clé gérée par le client au repos.

valeurs acceptées: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--for-upload

Créez le instantané pour charger des objets blob ultérieurement via des commandes de stockage. Exécutez « az instantané grant-access --access-level Write » pour récupérer le jeton SAP de instantané.

valeurs acceptées: false, true
--hyper-v-generation

Génération d’hyperviseur de la machine virtuelle. Applicable uniquement aux disques du système d’exploitation.

valeurs acceptées: V1, V2
--incremental

Indique si une instantané est incrémentielle. Les instantané incrémentielles sur le même disque occupent moins d’espace que les instantané complètes et peuvent être différentes.

valeurs acceptées: false, true
--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>. Si l’emplacement n’est pas spécifié et qu’aucun emplacement par défaut n’est spécifié, l’emplacement est automatiquement défini comme le groupe de ressources.

--network-access-policy

Stratégie d’accès au disque via le réseau.

valeurs acceptées: AllowAll, AllowPrivate, DenyAll
--no-wait

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

valeur par défaut: False
--public-network-access
Préversion

Les clients peuvent définir sur Disques managés ou instantanés pour contrôler la stratégie d’exportation sur le disque.

valeurs acceptées: Disabled, Enabled
--size-gb -z

Taille en Go. Taille maximale : 4095 Go (certains disques en préversion peuvent être plus volumineux).

--sku
valeurs acceptées: Premium_LRS, Standard_LRS, Standard_ZRS
valeur par défaut: Standard_LRS
--source

Source pour créer le disque/instantané à partir, y compris l’URI d’objet blob non managé, l’ID de disque managé ou le nom, ou instantané ID ou nom.

--source-storage-account-id

Utilisé lorsque l’objet blob source se trouve dans un autre abonnement.

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

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

Supprime une capture instantanée.

az snapshot delete [--ids]
                   [--name]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--resource-group]
                   [--subscription]

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name --snapshot-name -n

Nom de la instantané en cours de création. Le nom ne peut pas être modifié une fois le instantané créé. Les caractères pris en charge pour le nom sont a-z, A-Z, 0-9, _ et -. La longueur maximale du nom est de 80 caractères.

--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
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

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

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 snapshot grant-access

Accordez l’accès en lecture à un instantané.

az snapshot grant-access --duration-in-seconds
                         [--access-level {Read, Write}]
                         [--file-format {VHD, VHDX}]
                         [--ids]
                         [--name]
                         [--resource-group]
                         [--subscription]

Exemples

Accordez l’accès en lecture à un instantané. (généré automatiquement)

az snapshot grant-access --duration-in-seconds 3600 --name MySnapshot --resource-group MyResourceGroup

Accordez l’accès en lecture à un instantané en spécifiant le format de fichier.

az snapshot grant-access --duration-in-seconds 3600 --name MySnapshot --resource-group MyResourceGroup --file-format VHDX

Paramètres obligatoires

--duration-in-seconds

Durée en secondes jusqu’à l’expiration de l’accès SAP.

Paramètres facultatifs

--access-level

Niveau d’accès.

valeurs acceptées: Read, Write
valeur par défaut: Read
--file-format

Permet de spécifier le format de fichier lors de la demande de signature d’accès partagé sur un format de fichier VHDX instantané.

valeurs acceptées: VHD, VHDX
--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom de l’instantané.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

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

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

Répertoriez les instantané sous un groupe de ressources.

az snapshot list [--max-items]
                 [--next-token]
                 [--resource-group]

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.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

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 snapshot revoke-access

Révoquer l’accès à un instantané.

az snapshot revoke-access [--ids]
                          [--name]
                          [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                          [--resource-group]
                          [--subscription]

Exemples

Révoquez l’accès en lecture à un instantané.

az snapshot revoke-access --name MySnapshot --resource-group MyResourceGroup

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name --snapshot-name -n

Nom de l’instantané.

--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
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

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

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

Obtenez des informations sur un instantané.

az snapshot show [--ids]
                 [--name]
                 [--resource-group]
                 [--subscription]

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name --snapshot-name -n

Nom de la instantané en cours de création. Le nom ne peut pas être modifié une fois le instantané créé. Les caractères pris en charge pour le nom sont a-z, A-Z, 0-9, _ et -. La longueur maximale du nom est de 80 caractères.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

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

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

Mettez à jour un instantané.

az snapshot update [--accelerated-network {false, true}]
                   [--add]
                   [--architecture {Arm64, x64}]
                   [--disk-access]
                   [--disk-encryption-set]
                   [--encryption-type {EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey}]
                   [--force-string]
                   [--ids]
                   [--name]
                   [--network-access-policy {AllowAll, AllowPrivate, DenyAll}]
                   [--no-wait]
                   [--public-network-access {Disabled, Enabled}]
                   [--remove]
                   [--resource-group]
                   [--set]
                   [--sku {Premium_LRS, Standard_LRS, Standard_ZRS}]
                   [--subscription]

Exemples

Mettez à jour un instantané et associez-le à une ressource d’accès au disque.

az snapshot update --name MySnapshot --resource-group MyResourceGroup --network-access-policy AllowPrivate --disk-access MyDiskAccessID

Mettez à jour un instantané. (généré automatiquement)

az snapshot update --name MySnapshot --resource-group MyResourceGroup --subscription MySubscription

Paramètres facultatifs

--accelerated-network
Préversion

Les clients peuvent définir sur Disques managés ou instantanés pour activer la mise en réseau accélérée si l’image de disque du système d’exploitation prend en charge.

valeurs acceptées: false, true
--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string or JSON string>.

valeur par défaut: []
--architecture

Architecture du processeur.

valeurs acceptées: Arm64, x64
--disk-access

Nom ou ID de la ressource d’accès au disque pour l’utilisation de points de terminaison privés sur des disques.

--disk-encryption-set

Nom ou ID du jeu de chiffrement de disque utilisé pour chiffrer le disque.

--encryption-type

Type de chiffrement. EncryptionAtRestWithPlatformKey : le disque est chiffré avec la clé managée XStore au repos. Il s’agit du type de chiffrement par défaut. EncryptionAtRestWithCustomerKey : le disque est chiffré avec la clé gérée par le client au repos.

valeurs acceptées: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--force-string

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

valeur par défaut: False
--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom de l’instantané.

--network-access-policy

Stratégie d’accès au disque via le réseau.

valeurs acceptées: AllowAll, AllowPrivate, DenyAll
--no-wait

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

valeur par défaut: False
--public-network-access
Préversion

Les clients peuvent définir sur Disques managés ou instantanés pour contrôler la stratégie d’exportation sur le disque.

valeurs acceptées: Disabled, Enabled
--remove

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list <indexToRemove> OR --remove propertyToRemove.

valeur par défaut: []
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=<value>.

valeur par défaut: []
--sku
valeurs acceptées: Premium_LRS, Standard_LRS, Standard_ZRS
--subscription

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

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

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

az snapshot wait [--created]
                 [--custom]
                 [--deleted]
                 [--exists]
                 [--ids]
                 [--interval]
                 [--name]
                 [--resource-group]
                 [--subscription]
                 [--timeout]
                 [--updated]

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

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--interval

Intervalle d’interrogation en secondes.

valeur par défaut: 30
--name --snapshot-name -n

Nom de la instantané en cours de création. Le nom ne peut pas être modifié une fois le instantané créé. Les caractères pris en charge pour le nom sont a-z, A-Z, 0-9, _ et -. La longueur maximale du nom est de 80 caractères.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

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

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