az snapshot

  • Reference

Spravujte kopie spravovaných disků, nativních objektů blob nebo jiných snímků k určitému bodu v čase.

Příkazy

Name Description Typ Stav
az snapshot create

Vytvořte snímek.

 Základ GA
az snapshot delete

Odstraňte snímek.

 Základ GA
az snapshot grant-access

Udělte snímku přístup ke čtení.

 Základ GA
az snapshot list

Vypisujte snímky ve skupině prostředků.

 Základ GA
az snapshot revoke-access

Odvolá přístup k snímku.

 Základ GA
az snapshot show

Získejte informace o snímku.

 Základ GA
az snapshot update

Aktualizujte snímek.

 Základ GA
az snapshot wait

Umístěte rozhraní příkazového řádku do stavu čekání, dokud není splněna podmínka.

 Základ GA

az snapshot create

Vytvořte snímek.

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]

Příklady

Vytvoření snímku importem z identifikátoru URI objektu blob

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

Vytvořte prázdný snímek.

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

Vytvořte snímek zkopírováním existujícího disku ve stejné skupině prostředků.

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

Vytvořte snímek z existujícího disku v jiné skupině prostředků.

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

Vytvořte snímek a přidružte ho k prostředku přístupu k disku.

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

Povinné parametry

--name -n

Název snímku.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

--accelerated-network
Preview

Zákazníci můžou nastavit Spravované disky nebo snímky, aby povolili akcelerované síťové služby, pokud podporuje image disku s operačním systémem.

Přípustné hodnoty: false, true
--architecture

Architektura procesoru.

Přípustné hodnoty: Arm64, x64
--bandwidth-copy-speed

Pokud je toto pole nastavené na snímku a createOption je CopyStart, snímek se zkopíruje rychleji.

Přípustné hodnoty: Enhanced, None
--copy-start

Vytvoření snímku pomocí procesu hloubkové kopie, kde se vytvoření prostředku považuje za dokončené až po zkopírování všech dat ze zdroje.

Přípustné hodnoty: false, true
--disk-access

Název nebo ID prostředku přístupu k disku pro použití privátních koncových bodů na discích

--disk-encryption-set

Název nebo ID sady šifrování disku, která se používá k šifrování disku.

--edge-zone

Název hraniční zóny.

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

Toto je ID ARM zdrojového snímku elastického san svazku.

--encryption-type

Typ šifrování. EncryptionAtRestWithPlatformKey: Disk se zašifruje neaktivním spravovaným klíčem XStore. Jedná se o výchozí typ šifrování. EncryptionAtRestWithCustomerKey: Disk je šifrovaný pomocí neaktivního klíče spravovaného zákazníkem.

Přípustné hodnoty: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--for-upload

Vytvořte snímek pro pozdější nahrání objektů blob prostřednictvím příkazů úložiště. Spuštěním příkazu az snapshot grant-access --access-level Write načtěte token SAS snímku.

Přípustné hodnoty: false, true
--hyper-v-generation

Generace hypervisoru virtuálního počítače. Platí jenom pro disky s operačním systémem.

Přípustné hodnoty: V1, V2
--incremental

Určuje, jestli je snímek přírůstkový. Přírůstkové snímky na stejném disku zabírají méně místa než úplné snímky a dají se oddábit.

Přípustné hodnoty: false, true
--location -l

Umístění. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location> Pokud není zadané umístění a není zadáno žádné výchozí umístění, umístění se automaticky nastaví stejně jako skupina prostředků.

--network-access-policy

Zásady pro přístup k disku přes síť

Přípustné hodnoty: AllowAll, AllowPrivate, DenyAll
--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
--public-network-access
Preview

Zákazníci můžou nastavit Spravované disky nebo snímky a řídit zásady exportu na disku.

Přípustné hodnoty: Disabled, Enabled
--size-gb -z

Velikost v GB Maximální velikost: 4095 GB (některé disky Preview můžou být větší).

--sku
Přípustné hodnoty: Premium_LRS, Standard_LRS, Standard_ZRS
Default value: Standard_LRS
--source

Zdroj pro vytvoření disku nebo snímku, včetně nespravovaného identifikátoru URI objektu blob, ID spravovaného disku nebo názvu nebo ID snímku nebo názvu.

--source-storage-account-id

Používá se, když je zdrojový objekt blob v jiném předplatném.

--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. K vymazání existujících značek použijte "".

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az snapshot delete

Odstraňte snímek.

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

Volitelné parametry

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--name --snapshot-name -n

Název vytvořeného snímku. Název nelze po vytvoření snímku změnit. Podporované znaky pro název jsou a-z, A-Z, 0-9, _ a -. Maximální délka názvu je 80 znaků.

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Přípustné hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az snapshot grant-access

Udělte snímku přístup ke čtení.

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

Příklady

Udělte snímku přístup ke čtení. (automaticky vygenerováno)

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

Udělte snímku přístup pro čtení s určením formátu souboru.

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

Povinné parametry

--duration-in-seconds

Doba trvání v sekundách, dokud nevyprší platnost přístupu SAS.

Volitelné parametry

--access-level

Úroveň přístupu

Přípustné hodnoty: Read, Write
Default value: Read
--file-format

Používá se k určení formátu souboru při vytváření požadavku SAS na snímku formátu souboru VHDX.

Přípustné hodnoty: VHD, VHDX
--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--name -n

Název snímku.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az snapshot list

Vypisujte snímky ve skupině prostředků.

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

Volitelné parametry

--max-items

Celkový počet položek, které se mají vrátit ve výstupu příkazu Pokud je celkový počet dostupných položek větší než zadaná hodnota, zobrazí se ve výstupu příkazu token. Chcete-li obnovit stránkování, zadejte hodnotu tokenu v --next-token argumentu následného příkazu.

--next-token

Token určující, kde se má stránkování spustit. Toto je hodnota tokenu z dříve zkrácené odpovědi.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az snapshot revoke-access

Odvolá přístup k snímku.

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

Příklady

Odvolat přístup pro čtení ke snímku

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

Volitelné parametry

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--name --snapshot-name -n

Název snímku.

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Přípustné hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az snapshot show

Získejte informace o snímku.

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

Volitelné parametry

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--name --snapshot-name -n

Název vytvořeného snímku. Název nelze po vytvoření snímku změnit. Podporované znaky pro název jsou a-z, A-Z, 0-9, _ a -. Maximální délka názvu je 80 znaků.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az snapshot update

Aktualizujte snímek.

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]

Příklady

Aktualizujte snímek a přidružte ho k prostředku přístupu k disku.

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

Aktualizujte snímek. (automaticky vygenerováno)

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

Volitelné parametry

--accelerated-network
Preview

Zákazníci můžou nastavit Spravované disky nebo snímky, aby povolili akcelerované síťové služby, pokud podporuje image disku s operačním systémem.

Přípustné hodnoty: false, true
--add

Přidejte objekt do seznamu objektů zadáním párů cest a klíč-hodnota. Příklad: --add property.listProperty <key=value, string or JSON string>.

Default value: []
--architecture

Architektura procesoru.

Přípustné hodnoty: Arm64, x64
--disk-access

Název nebo ID prostředku přístupu k disku pro použití privátních koncových bodů na discích

--disk-encryption-set

Název nebo ID sady šifrování disku, která se používá k šifrování disku.

--encryption-type

Typ šifrování. EncryptionAtRestWithPlatformKey: Disk se zašifruje neaktivním spravovaným klíčem XStore. Jedná se o výchozí typ šifrování. EncryptionAtRestWithCustomerKey: Disk je šifrovaný pomocí neaktivního klíče spravovaného zákazníkem.

Přípustné hodnoty: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--force-string

Při použití set nebo add zachovávejte řetězcové literály místo pokusu o převod na JSON.

Default value: False
--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--name -n

Název snímku.

--network-access-policy

Zásady pro přístup k disku přes síť

Přípustné hodnoty: AllowAll, AllowPrivate, DenyAll
--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
--public-network-access
Preview

Zákazníci můžou nastavit Spravované disky nebo snímky a řídit zásady exportu na disku.

Přípustné hodnoty: Disabled, Enabled
--remove

Odeberte vlastnost nebo prvek ze seznamu. Příklad: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Default value: []
--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--set

Aktualizujte objekt zadáním cesty vlastnosti a hodnoty, která se má nastavit. Příklad: --set property1.property2=<value>.

Default value: []
--sku
Přípustné hodnoty: Premium_LRS, Standard_LRS, Standard_ZRS
--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az snapshot wait

Umístěte rozhraní příkazového řádku do stavu čekání, dokud není splněna podmínka.

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

Volitelné parametry

--created

Počkejte na vytvoření s 'provisioningState' v 'Succeeded'.

Default value: False
--custom

Počkejte, až podmínka splňuje vlastní dotaz JMESPath. Například provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Počkejte na odstranění.

Default value: False
--exists

Počkejte, až prostředek existuje.

Default value: False
--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--interval

Interval dotazování v sekundách

Default value: 30
--name --snapshot-name -n

Název vytvořeného snímku. Název nelze po vytvoření snímku změnit. Podporované znaky pro název jsou a-z, A-Z, 0-9, _ a -. Maximální délka názvu je 80 znaků.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--timeout

Maximální čekání v sekundách.

Default value: 3600
--updated

Počkejte, dokud se neaktualizuje stav zřizování ve stavu Úspěch.

Default value: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.