az sql instance-pool

預覽
參考

此命令群組處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

管理實例集區。

命令

名稱	Description	類型	狀態
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 instance-pool' 處於預覽狀態，且正在開發中。參考和支援層級： 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

虛擬核心中實例集區的容量。

--edition --tier -e

SKU 版本元件。允許的值：GeneralPurpose。

--family -f

SKU 的計算產生元件。允許的值：Gen5。

--location -l

位置。來自的值： az account list-locations。您可以使用 az configure --defaults location=<location> 設定預設位置。

--name -n

實例集區名稱。

--resource-group -g

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

--subnet

允許存取實例集區之子網的名稱或標識碼。如果提供子網名稱，則必須提供 --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

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

--verbose

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

az sql instance-pool delete

編輯

預覽

命令群組 'sql instance-pool' 處於預覽狀態，且正在開發中。參考和支援層級： 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

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

--verbose

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

az sql instance-pool list

編輯

預覽

命令群組 'sql instance-pool' 處於預覽狀態，且正在開發中。參考和支援層級： 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

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

--verbose

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

az sql instance-pool show

編輯

預覽

命令群組 'sql instance-pool' 處於預覽狀態，且正在開發中。參考和支援層級： 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

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

--verbose

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

az sql instance-pool update

編輯

預覽

命令群組 'sql instance-pool' 處於預覽狀態，且正在開發中。參考和支援層級： 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

虛擬核心中實例集區的容量。

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

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

--verbose

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

az sql instance-pool wait

編輯

預覽

命令群組 'sql instance-pool' 處於預覽狀態，且正在開發中。參考和支援層級： 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

訂用帳戶的名稱或標識碼。您可以使用來設定預設訂用 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

範例

必要參數

選擇性參數

其他資源