az snapshot

  • 參考

管理受控磁碟、原生 Blob 或其他快照集的時間點複本。

命令

名稱 Description 類型 狀態
az snapshot create

建立快照集。

 核心 GA
az snapshot delete

刪除快照集。

 核心 GA
az snapshot grant-access

授與快照集的讀取許可權。

 核心 GA
az snapshot list

列出資源群組底下的快照集。

 核心 GA
az snapshot revoke-access

撤銷快照集的存取權。

 核心 GA
az snapshot show

取得快照集的相關信息。

 核心 GA
az snapshot update

更新快照集。

 核心 GA
az snapshot wait

將 CLI 置於等候狀態，直到符合條件為止。

 核心 GA

az snapshot create

建立快照集。

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]

範例

從 Blob URI 匯入來建立快照集。

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

建立空的快照集。

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

複製相同資源群組中的現有磁碟，以建立快照集。

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

從另一個資源群組中的現有磁碟建立快照集。

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

建立快照集，並將它與磁碟存取資源產生關聯。

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

必要參數

--name -n

快照集的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--accelerated-network
預覽

如果 OS 磁碟映像支援，客戶可以在 受控磁碟 或快照集上設定，以啟用加速的網路功能。

接受的值: false, true
--architecture

CPU 架構。

接受的值: Arm64, x64
--bandwidth-copy-speed

如果在快照集上設定此字段，且 createOption 是 CopyStart，則會以更快的速度複製快照集。

接受的值: Enhanced, None
--copy-start

使用深層複製程式建立快照集，只有在從來源複製所有數據之後，才會將資源建立視為完成。

接受的值: false, true
--disk-access

在磁碟上使用私人端點的磁碟存取資源名稱或標識碼。

--disk-encryption-set

用來加密磁碟的磁碟加密集名稱或標識碼。

--edge-zone

邊緣區域的名稱。

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

這是來源彈性 san 磁碟區快照集的 ARM 識別碼。

--encryption-type

加密類型。 EncryptionAtRestWithPlatformKey：磁碟會以待用 XStore 受控密鑰加密。 這是預設加密類型。 EncryptionAtRestWithCustomerKey：磁碟會以待用客戶管理的密鑰加密。

接受的值: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--for-upload

建立快照集，以便稍後透過記憶體命令上傳 Blob。 執行 「az snapshot grant-access --access-level Write」 來擷取快照集的 SAS 令牌。

接受的值: false, true
--hyper-v-generation

虛擬機的 Hypervisor 產生。 僅適用於OS磁碟。

接受的值: V1, V2
--incremental

快照集是否為累加式。 相同磁碟上的累加快照集佔用的空間小於完整快照集，而且可能會有差異。

接受的值: false, true
--location -l

位置。​​ 來自的值： az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。 如果未指定位置且未指定預設位置，則位置會自動設定為與資源群組相同的位置。

--network-access-policy

透過網路存取磁碟的原則。

接受的值: AllowAll, AllowPrivate, DenyAll
--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--public-network-access
預覽

客戶可以在 受控磁碟 或快照集上設定，以控制磁碟上的導出原則。

接受的值: Disabled, Enabled
--size-gb -z

以 GB 為單位的大小。 大小上限：4095 GB（某些預覽磁碟可能更大）。

--sku
接受的值: Premium_LRS, Standard_LRS, Standard_ZRS
預設值: Standard_LRS
--source

要從中建立磁碟/快照集的來源，包括非受控 Blob URI、受控磁碟標識碼或名稱，或快照集標識碼或名稱。

--source-storage-account-id

當來源 Blob 位於不同的訂用帳戶時使用。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az snapshot delete

刪除快照集。

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

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name --snapshot-name -n

正在建立的快照集名稱。 建立快照集之後，就無法變更名稱。 名稱的支援字元為 a-z、A-Z、0-9、_ 和 -。 最大名稱長度為80個字元。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az snapshot grant-access

授與快照集的讀取許可權。

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

範例

授與快照集的讀取許可權。 （ 自動產生 ）

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

使用指定檔案格式授與快照集的讀取許可權。

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

必要參數

--duration-in-seconds

SAS 存取到期前的秒數持續時間。

選擇性參數

--access-level

存取層級。

接受的值: Read, Write
預設值: Read
--file-format

用來在 VHDX 檔案格式快照集上要求 SAS 時指定檔案格式。

接受的值: VHD, VHDX
--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

快照集的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az snapshot list

列出資源群組底下的快照集。

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

選擇性參數

--max-items

命令輸出中要傳回的項目總數。 如果可用的專案總數超過指定的值，則會在命令的輸出中提供令牌。 若要繼續分頁，請在後續命令的自變數中 --next-token 提供令牌值。

--next-token

標記，指定要開始分頁的位置。 這是先前截斷回應中的令牌值。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az snapshot revoke-access

撤銷快照集的存取權。

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

範例

撤銷快照集的讀取許可權。

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

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name --snapshot-name -n

快照集的名稱。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az snapshot show

取得快照集的相關信息。

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

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name --snapshot-name -n

正在建立的快照集名稱。 建立快照集之後，就無法變更名稱。 名稱的支援字元為 a-z、A-Z、0-9、_ 和 -。 最大名稱長度為80個字元。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az snapshot update

更新快照集。

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]

範例

更新快照集，並將它與磁碟存取資源產生關聯。

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

更新快照集。 （ 自動產生 ）

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

選擇性參數

--accelerated-network
預覽

如果 OS 磁碟映像支援，客戶可以在 受控磁碟 或快照集上設定，以啟用加速網路功能。

接受的值: false, true
--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。 範例：--add property.listProperty <key=value, string or JSON string>。

預設值: []
--architecture

CPU 架構。

接受的值: Arm64, x64
--disk-access

在磁碟上使用私人端點的磁碟存取資源名稱或標識碼。

--disk-encryption-set

用來加密磁碟的磁碟加密集名稱或標識碼。

--encryption-type

加密類型。 EncryptionAtRestWithPlatformKey：磁碟會以待用 XStore 受控密鑰加密。 這是預設加密類型。 EncryptionAtRestWithCustomerKey：磁碟會以待用客戶管理的密鑰加密。

接受的值: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

預設值: False
--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

快照集的名稱。

--network-access-policy

透過網路存取磁碟的原則。

接受的值: AllowAll, AllowPrivate, DenyAll
--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--public-network-access
預覽

客戶可以在 受控磁碟 或快照集上設定，以控制磁碟上的導出原則。

接受的值: Disabled, Enabled
--remove

從清單中移除屬性或專案。 範例： --remove property.list <indexToRemove> 或 --remove propertyToRemove。

預設值: []
--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--set

指定要設定的屬性路徑和值，以更新物件。 範例：--set property1.property2=<value>。

預設值: []
--sku
接受的值: Premium_LRS, Standard_LRS, Standard_ZRS
--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az snapshot wait

將 CLI 置於等候狀態，直到符合條件為止。

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

選擇性參數

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False
--custom

等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False
--exists

等候資源存在。

預設值: False
--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--interval

輪詢間隔以秒為單位。

預設值: 30
--name --snapshot-name -n

正在建立的快照集名稱。 建立快照集之後，就無法變更名稱。 名稱的支援字元為 a-z、A-Z、0-9、_ 和 -。 最大名稱長度為80個字元。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--timeout

以秒為單位的等候上限。

預設值: 3600
--updated

等到 provisioningState 更新為 'Succeeded'。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。