你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az sql instance-pool

预览
参考

此命令组处于预览状态，正在开发中。参考和支持级别： https://aka.ms/CLI_refstatus

管理实例池。

命令

名称	说明	类型	Status
az sql instance-pool create	创建实例池。	核心	预览
az sql instance-pool delete	删除实例池。	核心	预览
az sql instance-pool list	列出可用的实例池。	核心	预览
az sql instance-pool show	获取实例池的详细信息。	核心	预览
az sql instance-pool update	更新实例池。	核心	预览
az sql instance-pool wait	等待实例池达到所需状态。	核心	预览

az sql instance-pool create

编辑

预览

命令组“sql 实例池”处于预览状态，正在开发中。参考和支持级别： https://aka.ms/CLI_refstatus

创建实例池。

az sql instance-pool create --capacity
                            --edition
                            --family
                            --location
                            --name
                            --resource-group
                            --subnet
                            [--license-type {BasePrice, LicenseIncluded}]
                            [--maint-config-id]
                            [--no-wait]
                            [--tags]
                            [--vnet-name]

示例

创建实例池的示例（最后包括 --no-wait 以获取异步体验）

az sql instance-pool create -g resource_group_name -n instance_pool_name -l location --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} --license-type LicenseIncluded --capacity 8 -e GeneralPurpose -f Gen5 -m SQL_{Region}_{MaintenanceConfigName} --no-wait

使用子网名称和 vnet-name 创建实例池的示例

az sql instance-pool create --license-type LicenseIncluded -l northcentralus -n myinstancepool -c 8 -e GeneralPurpose -f Gen5 -g billingPools --subnet mysubnetname --vnet-name myvnetname

必需参数

--capacity -c

vcore 中实例池的容量。

--edition --tier -e

SKU 的版本组件。允许的值：GeneralPurpose。

--family -f

SKU 的计算生成组件。允许的值：Gen5。

--location -l

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

--name -n

实例池名称。

--resource-group -g

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

--subnet

允许访问实例池的子网的名称或 ID。如果提供了子网名称，则必须提供 --vnet-name。

可选参数

--license-type

要应用于此实例池的许可证类型。

接受的值: BasePrice, LicenseIncluded

--maint-config-id -m

将维护配置分配给此托管实例。

--no-wait

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

默认值: False

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

--vnet-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 sql instance-pool delete

编辑

预览

命令组“sql 实例池”处于预览状态，正在开发中。参考和支持级别： https://aka.ms/CLI_refstatus

删除实例池。

az sql instance-pool delete --name
                            --resource-group
                            [--no-wait]
                            [--yes]

示例

删除实例池

az sql instance-pool delete -g mygroup -n myinstancepool --yes

必需参数

--name -n

实例池名称。

--resource-group -g

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

可选参数

--no-wait

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

默认值: False

--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 sql instance-pool list

编辑

预览

命令组“sql 实例池”处于预览状态，正在开发中。参考和支持级别： https://aka.ms/CLI_refstatus

列出可用的实例池。

az sql instance-pool list [--resource-group]

示例

列出当前订阅中的所有实例池。

az sql instance-pool list

列出资源组中的所有实例池。

az sql instance-pool list -g mygroup

可选参数

--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 sql instance-pool show

编辑

预览

命令组“sql 实例池”处于预览状态，正在开发中。参考和支持级别： https://aka.ms/CLI_refstatus

获取实例池的详细信息。

az sql instance-pool show --name
                          --resource-group

示例

获取实例池的详细信息

az sql instance-pool show -g mygroup -n myinstancepool

必需参数

--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 sql instance-pool update

编辑

预览

命令组“sql 实例池”处于预览状态，正在开发中。参考和支持级别： https://aka.ms/CLI_refstatus

更新实例池。

az sql instance-pool update --name
                            --resource-group
                            [--add]
                            [--capacity]
                            [--edition]
                            [--family]
                            [--force-string]
                            [--license-type {BasePrice, LicenseIncluded}]
                            [--maint-config-id]
                            [--no-wait]
                            [--remove]
                            [--set]
                            [--tags]

示例

使用新标记更新实例池（如果有多个标记，请确保它们是分隔的空间）

az sql instance-pool update -n myinstancepool -g mygroup --tags mykey1=myvalue1 mykey2=myvalue2 --license-type LicenseIncluded --capacity 8 -e GeneralPurpose -f Gen5 -m SQL_{Region}_{MaintenanceConfigName}

清除分配给实例池的标记

az sql instance-pool update -n myinstancepool -g mygroup --tags ""

必需参数

--name -n

实例池名称。

--resource-group -g

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

可选参数

--add

通过指定路径和键值对将对象添加到对象列表。示例：--add property.listProperty <key=value, string or JSON string>。

默认值: []

--capacity -c

vcore 中实例池的容量。

--edition --tier -e

SKU 的版本组件。允许的值包括：GeneralPurpose、BusinessCritical。

--family -f

SKU 的计算生成组件。允许的值包括：Gen4、Gen5。

--force-string

使用“set”或“add”时，保留字符串文本，而不是尝试转换为 JSON。

默认值: False

--license-type

要应用于此实例池的许可证类型。

接受的值: BasePrice, LicenseIncluded

--maint-config-id -m

将维护配置分配给此托管实例。

--no-wait

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

默认值: False

--remove

从列表中删除属性或元素。示例： --remove property.list <indexToRemove> OR --remove propertyToRemove.

默认值: []

--set

通过指定要设置的属性路径和值来更新对象。示例：--set property1.property2=<value>。

默认值: []

--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 sql instance-pool wait

编辑

预览

命令组“sql 实例池”处于预览状态，正在开发中。参考和支持级别： https://aka.ms/CLI_refstatus

等待实例池达到所需状态。

az sql instance-pool wait --name
                          --resource-group
                          [--created]
                          [--custom]
                          [--deleted]
                          [--exists]
                          [--interval]
                          [--timeout]
                          [--updated]

示例

等到创建实例池。

az sql instance-pool wait -n myinstancepool -g mygroup --created

必需参数

--name -n

实例池名称。

--resource-group -g

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

可选参数

--created

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

默认值: False

--custom

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

--deleted

等到删除为止。

默认值: False

--exists

等待资源存在。

默认值: False

--interval

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

默认值: 30

--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 sql instance-pool

命令

az sql instance-pool create

示例

必需参数

可选参数

az sql instance-pool delete

示例

必需参数

可选参数

az sql instance-pool list

示例

可选参数

az sql instance-pool show

示例

必需参数

az sql instance-pool update

示例

必需参数

可选参数

az sql instance-pool wait

示例

必需参数

可选参数

其他资源