az snapshot

  • Riferimento

Gestire copie temporizzate di dischi gestiti, BLOB nativi o altri snapshot.

Comandi

Nome Descrizione Tipo Status
az snapshot create

Creare uno snapshot.

 Memoria centrale Disponibilità generale
az snapshot delete

Eliminare uno snapshot.

 Memoria centrale Disponibilità generale
az snapshot grant-access

Concedere l'accesso in lettura a uno snapshot.

 Memoria centrale Disponibilità generale
az snapshot list

Elencare gli snapshot in un gruppo di risorse.

 Memoria centrale Disponibilità generale
az snapshot revoke-access

Revocare l'accesso a uno snapshot.

 Memoria centrale Disponibilità generale
az snapshot show

Ottenere informazioni su uno snapshot.

 Memoria centrale Disponibilità generale
az snapshot update

Aggiornare uno snapshot.

 Memoria centrale Disponibilità generale
az snapshot wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

 Memoria centrale Disponibilità generale

az snapshot create

Creare uno snapshot.

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]

Esempio

Creare uno snapshot importando da un URI DEL BLOB.

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

Creare uno snapshot vuoto.

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

Creare uno snapshot copiando un disco esistente nello stesso gruppo di risorse.

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

Creare uno snapshot da un disco esistente in un altro gruppo di risorse.

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

Creare uno snapshot e associarlo a una risorsa di accesso al disco.

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

Parametri necessari

--name -n

Nome dello snapshot.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--accelerated-network
Anteprima

I clienti possono impostare su Managed Disks o snapshot per abilitare la rete accelerata se il supporto dell'immagine del disco del sistema operativo.

Valori accettati: false, true
--architecture

Architettura della CPU.

Valori accettati: Arm64, x64
--bandwidth-copy-speed

Se questo campo è impostato su uno snapshot e createOption è CopyStart, lo snapshot verrà copiato con una velocità più rapida.

Valori accettati: Enhanced, None
--copy-start

Creare uno snapshot usando un processo di copia completa, in cui la creazione della risorsa viene considerata completa solo dopo che tutti i dati sono stati copiati dall'origine.

Valori accettati: false, true
--disk-access

Nome o ID della risorsa di accesso al disco per l'uso di endpoint privati su dischi.

--disk-encryption-set

Nome o ID del set di crittografia del disco usato per crittografare il disco.

--edge-zone

Nome della zona perimetrale.

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

Si tratta dell'ID ARM dello snapshot del volume san elastico di origine.

--encryption-type

Tipo di crittografia. EncryptionAtRestWithPlatformKey: il disco viene crittografato con la chiave gestita XStore inattivi. È il tipo di crittografia predefinito. EncryptionAtRestWithCustomerKey: il disco viene crittografato con la chiave gestita dal cliente inattivi.

Valori accettati: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--for-upload

Creare lo snapshot per caricare i BLOB in un secondo momento tramite i comandi di archiviazione. Eseguire "az snapshot grant-access --access-level Write" per recuperare il token di firma di accesso condiviso dello snapshot.

Valori accettati: false, true
--hyper-v-generation

Generazione dell'hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo.

Valori accettati: V1, V2
--incremental

Indica se uno snapshot è incrementale. Gli snapshot incrementali sullo stesso disco occupano meno spazio rispetto agli snapshot completi e possono essere diffati.

Valori accettati: false, true
--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>. Se la posizione non è specificata e non viene specificata alcuna posizione predefinita, la posizione verrà impostata automaticamente come il gruppo di risorse.

--network-access-policy

Criteri per l'accesso al disco tramite rete.

Valori accettati: AllowAll, AllowPrivate, DenyAll
--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--public-network-access
Anteprima

I clienti possono impostare su Managed Disks o snapshot per controllare i criteri di esportazione sul disco.

Valori accettati: Disabled, Enabled
--size-gb -z

Dimensioni in GB. Dimensioni massime: 4095 GB (alcuni dischi di anteprima possono essere maggiori).

--sku
Valori accettati: Premium_LRS, Standard_LRS, Standard_ZRS
Valore predefinito: Standard_LRS
--source

Origine da cui creare il disco/snapshot, inclusi l'URI blob non gestito, l'ID o il nome del disco gestito o l'ID o il nome dello snapshot.

--source-storage-account-id

Usato quando il BLOB di origine si trova in una sottoscrizione diversa.

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az snapshot delete

Eliminare uno snapshot.

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

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--name --snapshot-name -n

Nome dello snapshot da creare. Il nome non può essere modificato dopo la creazione dello snapshot. I caratteri supportati per il nome sono a-z, A-Z, 0-9, _ e -. La lunghezza massima del nome è di 80 caratteri.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az snapshot grant-access

Concedere l'accesso in lettura a uno snapshot.

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

Esempio

Concedere l'accesso in lettura a uno snapshot. (generato automaticamente)

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

Concedere l'accesso in lettura a uno snapshot specificando il formato di file.

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

Parametri necessari

--duration-in-seconds

Durata in secondi fino alla scadenza dell'accesso sas.

Parametri facoltativi

--access-level

Livello di accesso.

Valori accettati: Read, Write
Valore predefinito: Read
--file-format

Usato per specificare il formato di file quando si effettua una richiesta di firma di accesso condiviso in uno snapshot del formato di file VHDX.

Valori accettati: VHD, VHDX
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--name -n

Nome dello snapshot.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az snapshot list

Elencare gli snapshot in un gruppo di risorse.

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

Parametri facoltativi

--max-items

Numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è maggiore del valore specificato, nell'output del comando viene fornito un token. Per riprendere la paginazione, specificare il valore del token nell'argomento --next-token di un comando successivo.

--next-token

Token per specificare dove iniziare la paginazione. Si tratta del valore del token di una risposta troncata in precedenza.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az snapshot revoke-access

Revocare l'accesso a uno snapshot.

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

Esempio

Revocare l'accesso in lettura a uno snapshot.

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

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--name --snapshot-name -n

Nome dello snapshot.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az snapshot show

Ottenere informazioni su uno snapshot.

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

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--name --snapshot-name -n

Nome dello snapshot da creare. Il nome non può essere modificato dopo la creazione dello snapshot. I caratteri supportati per il nome sono a-z, A-Z, 0-9, _ e -. La lunghezza massima del nome è di 80 caratteri.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az snapshot update

Aggiornare uno snapshot.

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]

Esempio

Aggiornare uno snapshot e associarlo a una risorsa di accesso al disco.

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

Aggiornare uno snapshot. (generato automaticamente)

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

Parametri facoltativi

--accelerated-network
Anteprima

I clienti possono impostare su Managed Disks o snapshot per abilitare la rete accelerata se il supporto dell'immagine del disco del sistema operativo.

Valori accettati: false, true
--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, string or JSON string>.

Valore predefinito: []
--architecture

Architettura della CPU.

Valori accettati: Arm64, x64
--disk-access

Nome o ID della risorsa di accesso al disco per l'uso di endpoint privati su dischi.

--disk-encryption-set

Nome o ID del set di crittografia del disco usato per crittografare il disco.

--encryption-type

Tipo di crittografia. EncryptionAtRestWithPlatformKey: il disco viene crittografato con la chiave gestita XStore inattivi. È il tipo di crittografia predefinito. EncryptionAtRestWithCustomerKey: il disco viene crittografato con la chiave gestita dal cliente inattivi.

Valori accettati: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

Valore predefinito: False
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--name -n

Nome dello snapshot.

--network-access-policy

Criteri per l'accesso al disco tramite rete.

Valori accettati: AllowAll, AllowPrivate, DenyAll
--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--public-network-access
Anteprima

I clienti possono impostare su Managed Disks o snapshot per controllare i criteri di esportazione sul disco.

Valori accettati: Disabled, Enabled
--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Valore predefinito: []
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=<value>.

Valore predefinito: []
--sku
Valori accettati: Premium_LRS, Standard_LRS, Standard_ZRS
--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az snapshot wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

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

Parametri facoltativi

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

Valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

Valore predefinito: False
--exists

Attendere che la risorsa esista.

Valore predefinito: False
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--interval

Intervallo di polling in secondi.

Valore predefinito: 30
--name --snapshot-name -n

Nome dello snapshot da creare. Il nome non può essere modificato dopo la creazione dello snapshot. I caratteri supportati per il nome sono a-z, A-Z, 0-9, _ e -. La lunghezza massima del nome è di 80 caratteri.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--timeout

Attesa massima in secondi.

Valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.