Partager via

az snapshot

  • Référence

Gérez des copies ponctuelles de disques managés, d’objets blob natifs ou d’autres instantanés.

Commandes

Nom Description Type État
az snapshot create

Créez un instantané.

 Noyau GA
az snapshot delete

Supprimez un instantané.

 Noyau GA
az snapshot grant-access

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

 Noyau GA
az snapshot list

Répertorier les instantanés sous un groupe de ressources.

 Noyau GA
az snapshot revoke-access

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

 Noyau GA
az snapshot show

Obtenez des informations sur un instantané.

 Noyau GA
az snapshot update

Mettez à jour un instantané.

 Noyau GA
az snapshot wait

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

 Noyau GA

az snapshot create

Créez un instantané.

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 à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

--accelerated-network
Préversion

Les clients peuvent définir sur des disques managés ou des 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, l’instantané est copié à une vitesse plus rapide.

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

Créez un 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 de l’instantané de volume san élastique source.

--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 l’instantané pour charger des objets blob ultérieurement via des commandes de stockage. Exécutez « az snapshot grant-access --access-level Write » pour récupérer le jeton SAP de l’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 un instantané est incrémentiel. Les instantanés incrémentiels sur le même disque occupent moins d’espace que les instantanés complets et peuvent être différents.

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

Emplacement. Valeurs de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de 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

N’attendez pas 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 des disques managés ou des 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/capture instantanée à partir de, y compris l’URI d’objet blob non managé, l’ID de disque managé ou le nom, ou l’ID ou le nom d’instantané.

--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 la détail de journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.

az snapshot delete

Supprimez un instantané.

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 l’espace). 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é en cours de création. Le nom ne peut pas être modifié après la création de l’instantané. 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

N’attendez pas 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 à l’aide de az configure --defaults group=<name>.

--subscription

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

Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez la détail de journalisation. Utilisez --debug pour les 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 {Read, Write}]
                         [--file-format {VHD, VHDX}]
                         [--ids]
                         [--name]
                         [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                         [--resource-group]
                         [--subscription]

Exemples

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

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 --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 instantané de format de fichier VHDX.

Valeurs acceptées: VHD, VHDX
--ids

Un ou plusieurs ID de ressource (délimités par l’espace). 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é en cours de création. Le nom ne peut pas être modifié après la création de l’instantané. 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

N’attendez pas 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 à l’aide de az configure --defaults group=<name>.

--subscription

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

Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.

az snapshot list

Répertorier les instantanés 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 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 à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.

az snapshot revoke-access

Révoquez 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 l’espace). 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

N’attendez pas 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 à l’aide de az configure --defaults group=<name>.

--subscription

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

Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez la détail de journalisation. Utilisez --debug pour les 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 l’espace). 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é en cours de création. Le nom ne peut pas être modifié après la création de l’instantané. 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 à l’aide de az configure --defaults group=<name>.

--subscription

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

Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.

az snapshot update

Mettez à jour un instantané.

az snapshot update [--accelerated-network {0, 1, f, false, n, no, t, true, y, yes}]
                   [--add]
                   [--architecture {Arm64, x64}]
                   [--disk-access]
                   [--disk-encryption-set]
                   [--encryption-type {EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey}]
                   [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                   [--ids]
                   [--name]
                   [--network-access-policy {AllowAll, AllowPrivate, DenyAll}]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--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é.

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

Paramètres facultatifs

--accelerated-network
Préversion

Les clients peuvent définir sur des disques managés ou des 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: 0, 1, f, false, n, no, t, true, y, yes
--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>.

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

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.

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

Un ou plusieurs ID de ressource (délimités par l’espace). 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é en cours de création. Le nom ne peut pas être modifié après la création de l’instantané. 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.

--network-access-policy

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

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

N’attendez pas la fin de l’opération de longue durée.

Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--public-network-access
Préversion

Stratégie de contrôle de l’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.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de 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>.

--sku

Nom de la référence 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 à l’aide de az account set -s NAME_OR_ID.

Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez la détail de journalisation. Utilisez --debug pour les 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 l’espace). 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 l’instantané en cours de création. Le nom ne peut pas être modifié après la création de l’instantané. 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 à l’aide de az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de 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 la détail de journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.