az snapshot

  • Referens

Hantera kopior från tidpunkt av hanterade diskar, interna blobar eller andra ögonblicksbilder.

Kommandon

Name Description Typ Status
az snapshot create

Skapa en ögonblicksbild.

 Kärna Allmän tillgänglighet
az snapshot delete

Ta bort en ögonblicksbild.

 Kärna Allmän tillgänglighet
az snapshot grant-access

Bevilja läsbehörighet till en ögonblicksbild.

 Kärna Allmän tillgänglighet
az snapshot list

Lista ögonblicksbilder under en resursgrupp.

 Kärna Allmän tillgänglighet
az snapshot revoke-access

Återkalla åtkomsten till en ögonblicksbild.

 Kärna Allmän tillgänglighet
az snapshot show

Hämta information om en ögonblicksbild.

 Kärna Allmän tillgänglighet
az snapshot update

Uppdatera en ögonblicksbild.

 Kärna Allmän tillgänglighet
az snapshot wait

Placera CLI i vänteläge tills ett villkor uppfylls.

 Kärna Allmän tillgänglighet

az snapshot create

Skapa en ögonblicksbild.

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]

Exempel

Skapa en ögonblicksbild genom att importera från en blob-URI.

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

Skapa en tom ögonblicksbild.

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

Skapa en ögonblicksbild genom att kopiera en befintlig disk i samma resursgrupp.

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

Skapa en ögonblicksbild från en befintlig disk i en annan resursgrupp.

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

Skapa en ögonblicksbild och associera den med en diskåtkomstresurs.

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

Obligatoriska parametrar

--name -n

Namnet på ögonblicksbilden.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--accelerated-network
Förhandsgranskning

Kunder kan ställa in på Hanterade diskar eller ögonblicksbilder för att aktivera det accelererade nätverket om operativsystemdiskavbildningen stöder det.

accepterade värden: false, true
--architecture

CPU-arkitektur.

accepterade värden: Arm64, x64
--bandwidth-copy-speed

Om det här fältet anges på en ögonblicksbild och createOption är CopyStart kopieras ögonblicksbilden snabbare.

accepterade värden: Enhanced, None
--copy-start

Skapa en ögonblicksbild med hjälp av en djupkopieringsprocess, där resursskapandet anses vara slutfört först när alla data har kopierats från källan.

accepterade värden: false, true
--disk-access

Namn eller ID för diskåtkomstresursen för användning av privata slutpunkter på diskar.

--disk-encryption-set

Namn eller ID för diskkrypteringsuppsättning som används för att kryptera disken.

--edge-zone

Namnet på gränszonen.

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

Det här är ARM-ID:t för ögonblicksbilden av den elastiska volymen för källan.

--encryption-type

Krypteringstyp. EncryptionAtRestWithPlatformKey: Disken krypteras med XStore-hanterad nyckel i vila. Det är standardkrypteringstypen. EncryptionAtRestWithCustomerKey: Disken krypteras med kundhanterad nyckel i vila.

accepterade värden: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--for-upload

Skapa ögonblicksbilden för att ladda upp blobar senare via lagringskommandon. Kör "az snapshot grant-access --access-level Write" för att hämta ögonblicksbildens SAS-token.

accepterade värden: false, true
--hyper-v-generation

Hypervisor-genereringen av den virtuella datorn. Gäller endast os-diskar.

accepterade värden: V1, V2
--incremental

Om en ögonblicksbild är inkrementell. Inkrementella ögonblicksbilder på samma disk upptar mindre utrymme än fullständiga ögonblicksbilder och kan avgränsas.

accepterade värden: false, true
--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>. Om platsen inte har angetts och ingen standardplats har angetts anges platsen automatiskt på samma sätt som resursgruppen.

--network-access-policy

Princip för åtkomst till disken via nätverk.

accepterade värden: AllowAll, AllowPrivate, DenyAll
--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
--public-network-access
Förhandsgranskning

Kunder kan ställa in på Hanterade diskar eller ögonblicksbilder för att styra exportprincipen på disken.

accepterade värden: Disabled, Enabled
--size-gb -z

Storlek i GB. Maxstorlek: 4 095 GB (vissa förhandsgranskningsdiskar kan vara större).

--sku
accepterade värden: Premium_LRS, Standard_LRS, Standard_ZRS
standardvärde: Standard_LRS
--source

Källa för att skapa disken/ögonblicksbilden från, inklusive ohanterad blob-URI, hanterat disk-ID eller namn eller ögonblicksbilds-ID eller namn.

--source-storage-account-id

Används när källbloben finns i en annan prenumeration.

--tags

Blankstegsavgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az snapshot delete

Ta bort en ögonblicksbild.

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

Valfria parametrar

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--name --snapshot-name -n

Namnet på ögonblicksbilden som skapas. Det går inte att ändra namnet när ögonblicksbilden har skapats. Tecken som stöds för namnet är a-z, A-Z, 0-9, _ och -. Den maximala namnlängden är 80 tecken.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

accepterade värden: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az snapshot grant-access

Bevilja läsbehörighet till en ögonblicksbild.

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

Exempel

Bevilja läsbehörighet till en ögonblicksbild. (automatiskt genererad)

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

Bevilja läsbehörighet till en ögonblicksbild med att ange filformatet.

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

Obligatoriska parametrar

--duration-in-seconds

Tidsåtgång i sekunder tills SAS-åtkomsten upphör att gälla.

Valfria parametrar

--access-level

Åtkomstnivå.

accepterade värden: Read, Write
standardvärde: Read
--file-format

Används för att ange filformatet när du begär SAS på en ögonblicksbild av VHDX-filformatet.

accepterade värden: VHD, VHDX
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--name -n

Namnet på ögonblicksbilden.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az snapshot list

Lista ögonblicksbilder under en resursgrupp.

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

Valfria parametrar

--max-items

Totalt antal objekt som ska returneras i kommandots utdata. Om det totala antalet tillgängliga objekt är mer än det angivna värdet anges en token i kommandots utdata. Om du vill återuppta sidnumreringen anger du tokenvärdet i --next-token argumentet för ett efterföljande kommando.

--next-token

Token för att ange var sidnumrering ska börja. Detta är tokenvärdet från ett tidigare trunkerat svar.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az snapshot revoke-access

Återkalla åtkomsten till en ögonblicksbild.

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

Exempel

Återkalla läsbehörighet till en ögonblicksbild.

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

Valfria parametrar

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--name --snapshot-name -n

Namnet på ögonblicksbilden.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

accepterade värden: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az snapshot show

Hämta information om en ögonblicksbild.

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

Valfria parametrar

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--name --snapshot-name -n

Namnet på ögonblicksbilden som skapas. Det går inte att ändra namnet när ögonblicksbilden har skapats. Tecken som stöds för namnet är a-z, A-Z, 0-9, _ och -. Den maximala namnlängden är 80 tecken.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az snapshot update

Uppdatera en ögonblicksbild.

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]

Exempel

Uppdatera en ögonblicksbild och associera den med en diskåtkomstresurs.

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

Uppdatera en ögonblicksbild. (automatiskt genererad)

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

Valfria parametrar

--accelerated-network
Förhandsgranskning

Kunder kan ställa in på Hanterade diskar eller ögonblicksbilder för att aktivera det accelererade nätverket om operativsystemdiskavbildningen stöder det.

accepterade värden: false, true
--add

Lägg till ett objekt i en lista över objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string or JSON string>.

standardvärde: []
--architecture

CPU-arkitektur.

accepterade värden: Arm64, x64
--disk-access

Namn eller ID för diskåtkomstresursen för användning av privata slutpunkter på diskar.

--disk-encryption-set

Namn eller ID för diskkrypteringsuppsättning som används för att kryptera disken.

--encryption-type

Krypteringstyp. EncryptionAtRestWithPlatformKey: Disken krypteras med XStore-hanterad nyckel i vila. Det är standardkrypteringstypen. EncryptionAtRestWithCustomerKey: Disken krypteras med kundhanterad nyckel i vila.

accepterade värden: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--force-string

När du använder "set" eller "add" bevarar du strängliteraler i stället för att försöka konvertera till JSON.

standardvärde: False
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--name -n

Namnet på ögonblicksbilden.

--network-access-policy

Princip för åtkomst till disken via nätverk.

accepterade värden: AllowAll, AllowPrivate, DenyAll
--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
--public-network-access
Förhandsgranskning

Kunder kan ställa in på Hanterade diskar eller ögonblicksbilder för att styra exportprincipen på disken.

accepterade värden: Disabled, Enabled
--remove

Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list <indexToRemove> ELLER --remove propertyToRemove.

standardvärde: []
--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=<value>.

standardvärde: []
--sku
accepterade värden: Premium_LRS, Standard_LRS, Standard_ZRS
--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az snapshot wait

Placera CLI i vänteläge tills ett villkor uppfylls.

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

Valfria parametrar

--created

Vänta tills du har skapat med "provisioningState" på "Lyckades".

standardvärde: False
--custom

Vänta tills villkoret uppfyller en anpassad JMESPath-fråga. T.ex. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Vänta tills den har tagits bort.

standardvärde: False
--exists

Vänta tills resursen finns.

standardvärde: False
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--interval

Avsökningsintervall i sekunder.

standardvärde: 30
--name --snapshot-name -n

Namnet på ögonblicksbilden som skapas. Det går inte att ändra namnet när ögonblicksbilden har skapats. Tecken som stöds för namnet är a-z, A-Z, 0-9, _ och -. Den maximala namnlängden är 80 tecken.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--timeout

Maximal väntetid i sekunder.

standardvärde: 3600
--updated

Vänta tills det har uppdaterats med provisioningState på Lyckades.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.