az disk

管理 Azure 受控磁碟。

Azure 虛擬機器 使用磁碟作為儲存作業系統、應用程式和數據的位置。 所有 Azure 虛擬機至少有兩個磁碟:操作系統磁碟和暫存磁碟。 操作系統磁碟是從映像建立,而且操作系統磁碟和映像實際上是儲存在 Azure 記憶體帳戶中的虛擬硬碟 (VHD)。 虛擬機也可以有一或多個數據磁碟,這些磁碟也會儲存為 VHD。 Azure 非受控數據磁碟的大小上限為 4095 GB。 若要使用大於 4095 GB 的磁碟,請使用 Azure 受控磁碟

命令

名稱 Description 類型 狀態
az disk create

建立受控磁碟。

核心 GA
az disk delete

刪除受控磁碟。

核心 GA
az disk grant-access

授與資源對受控磁碟的存取權。

核心 GA
az disk list

列出受控磁碟。

核心 GA
az disk revoke-access

撤銷資源對受控磁碟的讀取許可權。

核心 GA
az disk show

取得磁碟的相關信息。

核心 GA
az disk update

更新受控磁碟。

核心 GA
az disk wait

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

核心 GA

az disk create

建立受控磁碟。

az disk create --name
               --resource-group
               [--accelerated-network {false, true}]
               [--architecture {Arm64, x64}]
               [--data-access-auth-mode {AzureActiveDirectory, None}]
               [--disk-access]
               [--disk-encryption-set]
               [--disk-iops-read-only]
               [--disk-iops-read-write]
               [--disk-mbps-read-only]
               [--disk-mbps-read-write]
               [--edge-zone]
               [--enable-bursting {false, true}]
               [--encryption-type {EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey}]
               [--gallery-image-reference]
               [--gallery-image-reference-lun]
               [--hyper-v-generation {V1, V2}]
               [--image-reference]
               [--image-reference-lun]
               [--location]
               [--logical-sector-size]
               [--max-shares]
               [--network-access-policy {AllowAll, AllowPrivate, DenyAll}]
               [--no-wait]
               [--optimized-for-frequent-attach {false, true}]
               [--os-type {Linux, Windows}]
               [--performance-plus {false, true}]
               [--public-network-access {Disabled, Enabled}]
               [--secure-vm-disk-encryption-set]
               [--security-data-uri]
               [--security-type {ConfidentialVM_DiskEncryptedWithCustomerKey, ConfidentialVM_DiskEncryptedWithPlatformKey, ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey, Standard, TrustedLaunch}]
               [--size-gb]
               [--sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
               [--source]
               [--source-storage-account-id]
               [--support-hibernation {false, true}]
               [--tags]
               [--tier]
               [--upload-size-bytes]
               [--upload-type {Upload, UploadWithSecurityData}]
               [--zone]

範例

從 Blob URI 匯入來建立受控磁碟。

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

建立空的受控磁碟。

az disk create -g MyResourceGroup -n MyDisk --size-gb 10

建立已啟用高載的空白受控磁碟。

az disk create -g MyResourceGroup -n MyDisk --size-gb 1024 --location centraluseuap --enable-bursting

藉由複製現有的磁碟或快照集來建立受控磁碟。

az disk create -g MyResourceGroup -n MyDisk2 --source MyDisk

在「美國東部 2」區域中的可用性區域中建立磁碟

az disk create -g MyResourceGroup -n MyDisk --size-gb 10 --location eastus2 --zone 1

從映像建立磁碟。

az disk create -g MyResourceGroup -n MyDisk --image-reference Canonical:0001-com-ubuntu-server-jammy:22_04-lts-gen2:latest

從計算資源庫映像版本的 OS 磁碟建立磁碟

az disk create -g MyResourceGroup -n MyDisk --gallery-image-reference /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Compute/galleries/myGallery/images/myImage/versions/1.0.0

從計算資源庫映像中最新版本的OS磁碟建立磁碟

az disk create -g MyResourceGroup -n MyDisk --gallery-image-reference /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Compute/galleries/myGallery/images/myImage

從共享資源庫映像版本的OS磁碟建立磁碟

az disk create -g MyResourceGroup -n MyDisk --gallery-image-reference /SharedGalleries/sharedGalleryUniqueName/Images/imageName/Versions/1.0.0

從社群資源庫映像版本的OS磁碟建立磁碟

az disk create -g MyResourceGroup -n MyDisk --gallery-image-reference /CommunityGalleries/communityGalleryPublicGalleryName/Images/imageName/Versions/1.0.0

從資源庫映像的數據磁碟建立磁碟

az disk create -g MyResourceGroup -n MyDisk --gallery-image-reference /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Compute/galleries/myGallery/images/myImage/versions/1.0.0 --gallery-image-reference-lun 0

建立具有 IOPS 總數和輸送量總計 (MBps) 限制的磁碟。

az disk create -g MyResourceGroup -n MyDisk --size-gb 10 --sku UltraSSD_LRS --disk-iops-read-only 200 --disk-mbps-read-only 30

建立磁碟,並指定可以同時連結至磁碟的 VM 數目上限。

az disk create -g MyResourceGroup -n MyDisk --size-gb 256 --max-shares 2 -l centraluseuap

建立磁碟,並將它與磁碟存取資源產生關聯。

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

從 VM 客體狀態 VHD 的 Blob URI 建立磁碟。

az disk create -g MyResourceGroup -n MyDisk --size-gb 10 --security-data-uri GuestStateDiskVhdUri --security-type TrustedLaunch --hyper-v-generation V2

建立用於上傳 Blob 的標準磁碟。

az disk create -g MyResourceGroup -n MyDisk --upload-size-bytes 20972032 --upload-type Upload

建立 OS 磁碟,以上傳 VM 客體狀態。

az disk create -g MyResourceGroup -n MyDisk --upload-size-bytes 20972032 --upload-type UploadWithSecurityData --security-type TrustedLaunch --hyper-v-generation V2

必要參數

--name -n

受控磁碟的名稱。

--resource-group -g

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

選擇性參數

--accelerated-network
預覽

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

接受的值: false, true
--architecture

CPU 架構。

接受的值: Arm64, x64
--data-access-auth-mode

在匯出或上傳至磁碟或快照集時,指定驗證模式。

接受的值: AzureActiveDirectory, None
--disk-access

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

--disk-encryption-set

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

--disk-iops-read-only

所有裝載共用磁碟作為 ReadOnly 的 VM 所允許的 IOPS 總數。 一個作業可以在 4k 到 256k 個字節之間傳輸。

--disk-iops-read-write

此磁碟允許的 IOPS 數目。 僅適用於 UltraSSD 磁碟的可設定。 一個作業可以在 4k 到 256k 個字節之間傳輸。

--disk-mbps-read-only

所有裝載共用磁碟作為 ReadOnly 的 VM 所允許的總輸送量 (MBps)。 MBps 表示每秒數百萬個字節 - MB 會使用 ISO 表示法,其乘冪為 10。

--disk-mbps-read-write

此磁碟允許的頻寬。 僅適用於 UltraSSD 磁碟的可設定。 MBps 表示每秒數百萬個字節,且 ISO 表示法為 10。

--edge-zone

邊緣區域的名稱。

--enable-bursting

在磁碟布建的效能目標之外,啟用隨選高載。 依預設會停用隨選高載,不適用於 Ultra 磁碟。

接受的值: false, true
--encryption-type

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

接受的值: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--gallery-image-reference

要從中建立磁碟的計算、共用或社群資源庫映像版本的標識碼。 如需有效格式的詳細資訊,請參閱說明範例。

--gallery-image-reference-lun

如果磁碟是從映射的數據磁碟建立的,這是一個索引,指出映射中要使用的數據磁碟。 針對OS磁碟,此欄位為 null。

--hyper-v-generation

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

接受的值: V1, V2
--image-reference

要從中建立磁碟的映射標識符或 URN (publisher:offer:sku:version) 。

--image-reference-lun

如果磁碟是從映射的數據磁碟建立的,這是一個索引,指出映射中要使用的數據磁碟。 針對OS磁碟,此欄位為 null。

--location -l

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

--logical-sector-size

Ultra 磁碟的邏輯扇區大小,以位元組為單位。 支援的值為 512 ad 4096。 4096 是預設值。

--max-shares

可以同時連結至磁碟的 VM 數目上限。 大於一個值表示可以同時掛接在多個 VM 上的磁碟。

--network-access-policy

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

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

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

預設值: False
--optimized-for-frequent-attach

將此屬性設定為 true 可藉由從一部虛擬機中斷連結並連結至另一部虛擬機,來改善經常(每天超過 5 次)的數據磁碟可靠性和效能。 不應該針對未中斷連結和經常連結的磁碟設定此屬性,因為它會導致磁碟與虛擬機的容錯網域不一致。

接受的值: false, true
--os-type

磁碟的操作系統類型。

接受的值: Linux, Windows
--performance-plus

將此旗標設定為 true,以提升所部署磁碟的效能目標。 此旗標只能在磁碟建立時間上設定,而且在啟用之後無法停用。

接受的值: false, true
--public-network-access
預覽

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

接受的值: Disabled, Enabled
--secure-vm-disk-encryption-set

以 ConfidentialVmEncryptedWithCustomerKey 加密類型建立的磁碟加密集名稱或識別碼。

--security-data-uri

請指定要匯入 VM 客體狀態的 VHD Blob URI。

--security-type

VM 的安全性類型。 僅適用於OS磁碟。

接受的值: ConfidentialVM_DiskEncryptedWithCustomerKey, ConfidentialVM_DiskEncryptedWithPlatformKey, ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey, Standard, TrustedLaunch
--size-gb -z

以 GB 為單位的大小。 大小上限:4095 GB(某些預覽磁碟可能更大)。

--sku

基礎記憶體 SKU。

接受的值: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS
預設值: Premium_LRS
--source

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

--source-storage-account-id

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

--support-hibernation

指出磁碟上的OS支援休眠。

接受的值: false, true
--tags

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

--tier

磁碟的效能層級(例如 P4、S10)如下所述: https://azure.microsoft.com/pricing/details/managed-disks/。 不適用於 Ultra 磁碟。

--upload-size-bytes

上傳內容的大小(以位元組為單位),包括 VHD 頁尾。 最小值:20972032。 最大值:35183298347520。 如果指定了 --upload-type,則需要此參數。

--upload-type

建立上傳案例的磁碟。 「上傳」僅適用於標準磁碟上傳。 'UploadWithSecurityData' 適用於OS磁碟上傳以及 VM 客體狀態。 請注意,「UploadWithSecurityData」對於數據磁碟上傳無效,它目前只能用於OS磁碟上傳。

接受的值: Upload, UploadWithSecurityData
--zone

要在其中布建資源的可用性區域。

全域參數
--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 disk delete

刪除受控磁碟。

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

範例

刪除受控磁碟。

az disk delete --name MyManagedDisk --resource-group MyResourceGroup

選擇性參數

--disk-name --name -n

要建立之受控磁碟的名稱。 建立磁碟之後,就無法變更名稱。 名稱的支援字元為 a-z、A-Z、0-9、_ 和 -。 最大名稱長度為 80 個字元。

--ids

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

--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帳戶。

--yes -y

不提示確認。

預設值: 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 來取得完整偵錯記錄。

az disk grant-access

授與資源對受控磁碟的存取權。

az disk grant-access --duration-in-seconds
                     [--access-level {Read, Write}]
                     [--ids]
                     [--name]
                     [--resource-group]
                     [--secure-vm-guest-state-sas]
                     [--subscription]

範例

授與資源對受控磁碟的讀取許可權。 ( 自動產生 )

az disk grant-access --access-level Read --duration-in-seconds 3600 --name MyManagedDisk --resource-group MyResourceGroup

授與磁碟的資源讀取許可權,以產生存取 SAS 和安全性資料存取 SAS

az disk grant-access --access-level Read --duration-in-seconds 3600 --name MyDisk --resource-group MyResourceGroup --secure-vm-guest-state-sas

必要參數

--duration-in-seconds

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

選擇性參數

--access-level

存取層級。

接受的值: Read, Write
預設值: Read
--ids

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

--name -n

受控磁碟的名稱。

--resource-group -g

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

--secure-vm-guest-state-sas -s

在具有 VM 客體狀態的受控磁碟上取得 SAS。 當磁碟的 create 選項為 'secureOSUpload' 時,預設會使用它。

--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 disk list

列出受控磁碟。

az disk 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 disk revoke-access

撤銷資源對受控磁碟的讀取許可權。

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

範例

撤銷資源對受控磁碟的讀取許可權。

az disk revoke-access --ids $id

撤銷資源對受控磁碟的讀取許可權。

az disk revoke-access --name MyManagedDisk --resource-group MyResourceGroup

選擇性參數

--disk-name --name -n

要建立之受控磁碟的名稱。 建立磁碟之後,就無法變更名稱。 名稱的支援字元為 a-z、A-Z、0-9、_ 和 -。 最大名稱長度為 80 個字元。

--ids

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

--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 disk show

取得磁碟的相關信息。

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

選擇性參數

--disk-name --name -n

要建立之受控磁碟的名稱。 建立磁碟之後,就無法變更名稱。 名稱的支援字元為 a-z、A-Z、0-9、_ 和 -。 最大名稱長度為 80 個字元。

--ids

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

--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 disk update

更新受控磁碟。

az disk update [--accelerated-network {false, true}]
               [--add]
               [--architecture {Arm64, x64}]
               [--data-access-auth-mode {AzureActiveDirectory, None}]
               [--disk-access]
               [--disk-encryption-set]
               [--disk-iops-read-only]
               [--disk-iops-read-write]
               [--disk-mbps-read-only]
               [--disk-mbps-read-write]
               [--enable-bursting {false, true}]
               [--encryption-type {EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey}]
               [--force-string]
               [--ids]
               [--max-shares]
               [--name]
               [--network-access-policy {AllowAll, AllowPrivate, DenyAll}]
               [--no-wait]
               [--public-network-access {Disabled, Enabled}]
               [--remove]
               [--resource-group]
               [--set]
               [--size-gb]
               [--sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
               [--subscription]

範例

更新受控磁碟,並將它與磁碟存取資源產生關聯。

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

更新受控磁碟。 ( 自動產生 )

az disk update --name MyManagedDisk --resource-group MyResourceGroup --size-gb 20

選擇性參數

--accelerated-network
預覽

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

接受的值: false, true
--add

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

預設值: []
--architecture

CPU 架構。

接受的值: Arm64, x64
--data-access-auth-mode

在匯出或上傳至磁碟或快照集時,指定驗證模式。

接受的值: AzureActiveDirectory, None
--disk-access

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

--disk-encryption-set

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

--disk-iops-read-only

所有裝載共用磁碟作為 ReadOnly 的 VM 所允許的 IOPS 總數。 一個作業可以在 4k 到 256k 個字節之間傳輸。

--disk-iops-read-write

此磁碟允許的 IOPS 數目。 僅適用於 UltraSSD 磁碟的可設定。 一個作業可以在 4k 到 256k 個字節之間傳輸。

--disk-mbps-read-only

所有裝載共用磁碟作為 ReadOnly 的 VM 所允許的總輸送量 (MBps)。 MBps 表示每秒數百萬個字節 - MB 會使用 ISO 表示法,其乘冪為 10。

--disk-mbps-read-write

此磁碟允許的頻寬。 僅適用於 UltraSSD 磁碟的可設定。 MBps 表示每秒數百萬個字節,且 ISO 表示法為 10。

--enable-bursting

在磁碟布建的效能目標之外,啟用隨選高載。 依預設會停用隨選高載,不適用於 Ultra 磁碟。

接受的值: false, true
--encryption-type

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

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

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

預設值: False
--ids

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

--max-shares

可以同時連結至磁碟的 VM 數目上限。 大於一個值表示可以同時掛接在多個 VM 上的磁碟。

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

預設值: []
--size-gb -z

以 GB 為單位的大小。 大小上限:4095 GB(某些預覽磁碟可能更大)。

--sku

基礎記憶體 SKU。

接受的值: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS
--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 disk wait

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

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

選擇性參數

--created

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

預設值: False
--custom

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

--deleted

等到刪除為止。

預設值: False
--disk-name --name -n

要建立之受控磁碟的名稱。 建立磁碟之後,就無法變更名稱。 名稱的支援字元為 a-z、A-Z、0-9、_ 和 -。 最大名稱長度為 80 個字元。

--exists

等候資源存在。

預設值: False
--ids

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

--interval

輪詢間隔以秒為單位。

預設值: 30
--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 來取得完整偵錯記錄。