az disk-pool

参考

注释

此参考是 Azure CLI（版本 2.15.0 或更高版本）磁盘池 扩展的一部分。该扩展会在首次运行 az disk-pool 命令时自动安装。了解更多关于扩展的相关信息。

管理 Azure 磁盘池。

命令

名称	说明	类型	Status
az disk-pool create	创建磁盘池。此创建作可能需要 15 分钟才能完成。这是预期的服务行为。	扩展	GA
az disk-pool delete	删除磁盘池;附加磁盘不受影响。此删除作可能需要 10 分钟才能完成。这是预期的服务行为。	扩展	GA
az disk-pool iscsi-target	使用磁盘池管理 iSCSI 目标。	扩展	GA
az disk-pool iscsi-target create	创建 iSCSI 目标。	扩展	GA
az disk-pool iscsi-target delete	删除 iSCSI 目标。	扩展	GA
az disk-pool iscsi-target list	获取磁盘池中的 iSCSI 目标。	扩展	GA
az disk-pool iscsi-target show	获取 iSCSI 目标。	扩展	GA
az disk-pool iscsi-target update	更新 iSCSI 目标。	扩展	GA
az disk-pool iscsi-target wait	将 CLI 置于等待状态，直到满足磁盘池 iscsi-target 的条件。	扩展	GA
az disk-pool list	获取资源组中的 DiskPools 列表。获取订阅中磁盘池的列表。	扩展	GA
az disk-pool list-outbound-network-dependency-endpoint	获取磁盘池的所有出站依赖项的网络终结点。	扩展	GA
az disk-pool list-skus	列出 Azure 位置中的可用 StoragePool 资源和 SKU。	扩展	GA
az disk-pool list-zones	列出 Azure 位置中的可用磁盘池 SKU。	扩展	GA
az disk-pool redeploy	重新部署一次替换基础虚拟机主机。此作可能需要 10-15 分钟才能完成。这是预期的服务行为。	扩展	GA
az disk-pool show	获取磁盘池。	扩展	GA
az disk-pool start	启动磁盘池的作。此启动作可能需要 10 分钟才能完成。这是预期的服务行为。	扩展	GA
az disk-pool stop	关闭磁盘池并释放计算资源。不会为此磁盘池使用的计算资源付费。此作可能需要 10 分钟才能完成。这是预期的服务行为。	扩展	GA
az disk-pool update	更新磁盘池。	扩展	GA
az disk-pool wait	将 CLI 置于等待状态，直到满足磁盘池的条件。	扩展	GA

az disk-pool create

创建磁盘池。此创建作可能需要 15 分钟才能完成。这是预期的服务行为。

az disk-pool create --disk-pool-name --name
                    --resource-group
                    --sku
                    --subnet-id
                    [--additional-capabilities]
                    [--availability-zones]
                    [--disks]
                    [--___location]
                    [--managed-by]
                    [--managed-by-extended]
                    [--no-wait]
                    [--tags]

示例

创建或更新磁盘池

az disk-pool create --___location "westus" --availability-zones "1" --disks "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vm-name_DataDisk_0" --disks "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vm-name_DataDisk_1" --subnet-id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet" --sku name="Basic_V1" tier="Basic" --tags key="value" --name "myDiskPool" --resource-group "myResourceGroup"

必需参数

--disk-pool-name --name -n

磁盘池的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

--sku

确定磁盘池的 SKU。

用法：--sku name=XX tier=XX

名称：必需。 Sku 名称层：Sku 层。

--subnet-id

磁盘池子网的 Azure 资源 ID。

可选参数

--additional-capabilities -a

磁盘池的其他功能列表。

--availability-zones

磁盘池资源的逻辑区域;示例：[“1”]。

--disks

要附加到磁盘池的 Azure 托管磁盘列表。

此参数的顺序是特定的自定义。用法：--disks id-value

id：必需。托管磁盘的唯一 Azure 资源 ID。

可以使用多个 --disks 参数指定多个作。

--___location -l

Location。 az account list-locations 中的值。可以使用 az configure --defaults ___location=<___location> 配置默认位置。

--managed-by

Azure 资源 ID。指示此资源是否由另一个 Azure 资源管理。

--managed-by-extended

管理此资源的 Azure 资源 ID 的列表。

--no-wait

不等待长时间运行的操作完成。

默认值: False

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

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

az disk-pool delete

删除磁盘池;附加磁盘不受影响。此删除作可能需要 10 分钟才能完成。这是预期的服务行为。

az disk-pool delete [--disk-pool-name --name]
                    [--ids]
                    [--no-wait]
                    [--resource-group]
                    [--subscription]
                    [--yes]

示例

删除磁盘池

az disk-pool delete --name "myDiskPool" --resource-group "myResourceGroup"

可选参数

--disk-pool-name --name -n

磁盘池的名称。

--ids

一个或多个资源 ID（以空格分隔）。它应该是包含“Resource Id”参数的所有信息的完整资源 ID。应提供 --ids 或其他“Resource Id”参数。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

--subscription

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

az disk-pool list

获取资源组中的 DiskPools 列表。获取订阅中磁盘池的列表。

az disk-pool list [--resource-group]

示例

列出磁盘池

az disk-pool list --resource-group "myResourceGroup"

按订阅列出磁盘池

az disk-pool list

可选参数

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

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

az disk-pool list-outbound-network-dependency-endpoint

获取磁盘池的所有出站依赖项的网络终结点。

az disk-pool list-outbound-network-dependency-endpoint --disk-pool-name --name
                                                       --resource-group

示例

获取磁盘池出站网络依赖项

az disk-pool list-outbound-network-dependency-endpoint --name "SampleAse" --resource-group "Sample-WestUSResourceGroup"

必需参数

--disk-pool-name --name -n

磁盘池的名称。

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

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

az disk-pool list-skus

列出 Azure 位置中的可用 StoragePool 资源和 SKU。

az disk-pool list-skus --___location

示例

列出磁盘池 SKU

az disk-pool list-skus --___location "eastus"

必需参数

--___location -l

Location。 az account list-locations 中的值。可以使用 az configure --defaults ___location=<___location> 配置默认位置。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

az disk-pool list-zones

列出 Azure 位置中的可用磁盘池 SKU。

az disk-pool list-zones --___location

示例

列出磁盘池区域

az disk-pool list-zones --___location "eastus"

必需参数

--___location -l

Location。 az account list-locations 中的值。可以使用 az configure --defaults ___location=<___location> 配置默认位置。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

az disk-pool redeploy

重新部署一次替换基础虚拟机主机。此作可能需要 10-15 分钟才能完成。这是预期的服务行为。

az disk-pool redeploy [--disk-pool-name --name]
                      [--ids]
                      [--no-wait]
                      [--resource-group]
                      [--subscription]

示例

重新部署磁盘池

az disk-pool redeploy --name "myDiskPool" --resource-group "myResourceGroup"

可选参数

--disk-pool-name --name -n

磁盘池的名称。

--ids

一个或多个资源 ID（以空格分隔）。它应该是包含“Resource Id”参数的所有信息的完整资源 ID。应提供 --ids 或其他“Resource Id”参数。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

--subscription

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

az disk-pool show

获取磁盘池。

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

示例

获取磁盘池

az disk-pool show --name "myDiskPool" --resource-group "myResourceGroup"

可选参数

--disk-pool-name --name -n

磁盘池的名称。

--ids

一个或多个资源 ID（以空格分隔）。它应该是包含“Resource Id”参数的所有信息的完整资源 ID。应提供 --ids 或其他“Resource Id”参数。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

--subscription

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

az disk-pool start

启动磁盘池的作。此启动作可能需要 10 分钟才能完成。这是预期的服务行为。

az disk-pool start [--disk-pool-name --name]
                   [--ids]
                   [--no-wait]
                   [--resource-group]
                   [--subscription]

示例

启动磁盘池

az disk-pool start --name "myDiskPool" --resource-group "myResourceGroup"

可选参数

--disk-pool-name --name -n

磁盘池的名称。

--ids

一个或多个资源 ID（以空格分隔）。它应该是包含“Resource Id”参数的所有信息的完整资源 ID。应提供 --ids 或其他“Resource Id”参数。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

--subscription

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

az disk-pool stop

关闭磁盘池并释放计算资源。不会为此磁盘池使用的计算资源付费。此作可能需要 10 分钟才能完成。这是预期的服务行为。

az disk-pool stop [--disk-pool-name --name]
                  [--ids]
                  [--no-wait]
                  [--resource-group]
                  [--subscription]

示例

解除分配磁盘池

az disk-pool stop --name "myDiskPool" --resource-group "myResourceGroup"

可选参数

--disk-pool-name --name -n

磁盘池的名称。

--ids

一个或多个资源 ID（以空格分隔）。它应该是包含“Resource Id”参数的所有信息的完整资源 ID。应提供 --ids 或其他“Resource Id”参数。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

--subscription

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

az disk-pool update

更新磁盘池。

az disk-pool update [--disk-pool-name --name]
                    [--disks]
                    [--ids]
                    [--managed-by]
                    [--managed-by-extended]
                    [--no-wait]
                    [--resource-group]
                    [--sku]
                    [--subscription]
                    [--tags]

示例

更新磁盘池

az disk-pool update --name "myDiskPool" --disks "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vm-name_DataDisk_0" --disks "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vm-name_DataDisk_1" --sku name="Basic_B1" tier="Basic" --tags key="value" --resource-group "myResourceGroup"

可选参数

--disk-pool-name --name -n

磁盘池的名称。

--disks

要附加到磁盘池的 Azure 托管磁盘列表。

此参数的顺序是特定的自定义。用法：--disks id-value

id：必需。托管磁盘的唯一 Azure 资源 ID。

可以使用多个 --disks 参数指定多个作。

--ids

一个或多个资源 ID（以空格分隔）。它应该是包含“Resource Id”参数的所有信息的完整资源 ID。应提供 --ids 或其他“Resource Id”参数。

--managed-by

Azure 资源 ID。指示此资源是否由另一个 Azure 资源管理。

--managed-by-extended

管理此资源的 Azure 资源 ID 的列表。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

--sku

确定磁盘池的 SKU。

用法：--sku name=XX tier=XX

名称：必需。 Sku 名称层：Sku 层。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

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

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

az disk-pool wait

将 CLI 置于等待状态，直到满足磁盘池的条件。

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

示例

暂停执行下一行 CLI 脚本，直到成功创建磁盘池。

az disk-pool wait --name "myDiskPool" --resource-group "myResourceGroup" --created

暂停执行下一行 CLI 脚本，直到磁盘池成功更新。

az disk-pool wait --name "myDiskPool" --resource-group "myResourceGroup" --updated

暂停执行下一行 CLI 脚本，直到磁盘池成功删除。

az disk-pool wait --name "myDiskPool" --resource-group "myResourceGroup" --deleted

可选参数

--created

等待在“Succeeded”中使用“provisioningState”创建。

默认值: False

--custom

等待条件满足自定义 JMESPath 查询。例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到删除为止。

默认值: False

--disk-pool-name --name -n

磁盘池的名称。

--exists

等待资源存在。

默认值: False

--ids

一个或多个资源 ID（以空格分隔）。它应该是包含“Resource Id”参数的所有信息的完整资源 ID。应提供 --ids 或其他“Resource Id”参数。

--interval

轮询间隔（以秒为单位）。

默认值: 30

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

--subscription

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

通过

az disk-pool

命令

az disk-pool create

示例

必需参数

可选参数

az disk-pool delete

示例

可选参数

az disk-pool list

示例

可选参数

az disk-pool list-outbound-network-dependency-endpoint

示例

必需参数

az disk-pool list-skus

示例

必需参数

az disk-pool list-zones

示例

必需参数

az disk-pool redeploy

示例

可选参数

az disk-pool show

示例

可选参数

az disk-pool start

示例

可选参数

az disk-pool stop

示例

可选参数

az disk-pool update

示例

可选参数

az disk-pool wait

示例

可选参数