az capacity reservation group

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

管理容量保留群組。

命令

名稱	Description	類型	狀態
az capacity reservation group create	建立容量保留群組。	核心	預覽​​
az capacity reservation group delete	刪除作業以刪除容量保留群組。 只有在所有相關聯的資源都與保留群組解除關聯，且保留群組下的所有容量保留也已刪除時，才允許此作業。 如需詳細資訊， https://aka.ms/CapacityReservation 請參閱 。	核心	預覽​​
az capacity reservation group list	列出容量保留群組。	核心	預覽​​
az capacity reservation group show	顯示容量保留群組。	核心	預覽​​
az capacity reservation group update	更新容量保留群組。	核心	預覽​​

az capacity reservation group create

預覽

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

建立容量保留群組。

az capacity reservation group create --capacity-reservation-group
                                     --resource-group
                                     [--location]
                                     [--sharing-profile]
                                     [--tags]
                                     [--zones]

範例

建立容量保留群組。

az capacity reservation group create -n ReservationGroupName -g MyResourceGroup

建立具有特定區域的容量保留群組。

az capacity reservation group create -n ReservationGroupName -l centraluseuap \
    -g MyResourceGroup --tags key=val --zones 1 2

必要參數

--capacity-reservation-group -n

容量保留群組的名稱。

--resource-group -g

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

選擇性參數

--location -l

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

--sharing-profile

以空格分隔的訂用帳戶資源標識碼或無任何標識碼。 指定設定，以針對容量保留群組資源啟用跨訂用帳戶共用。 將它指定為不共用。

--tags

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

--zones -z

可用性區域 用於此容量保留群組。 如果未提供，群組僅支持區域中的區域資源。 如果提供，則會強制群組中的每個容量保留區位於其中一個區域。

全域參數

--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 capacity reservation group delete

預覽

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

刪除作業以刪除容量保留群組。 只有在所有相關聯的資源都與保留群組解除關聯，且保留群組下的所有容量保留也已刪除時，才允許此作業。 如需詳細資訊， https://aka.ms/CapacityReservation 請參閱 。

az capacity reservation group delete [--capacity-reservation-group]
                                     [--ids]
                                     [--resource-group]
                                     [--subscription]
                                     [--yes]

範例

刪除容量保留群組。

az capacity reservation group delete -n ReservationGroupName -g MyResourceGroup --yes

選擇性參數

--capacity-reservation-group --capacity-reservation-group-name -n

容量保留群組的名稱。

--ids

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

--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 capacity reservation group list

預覽

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

列出容量保留群組。

az capacity reservation group list [--max-items]
                                   [--next-token]
                                   [--resource-group]
                                   [--resource-ids-only {All, CreatedInSubscription, SharedWithSubscription}]
                                   [--vm-instance {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--vmss-instance {0, 1, f, false, n, no, t, true, y, yes}]

範例

列出容量保留群組

az capacity reservation group list -g rg

列出包含 VM 實例和 VMSS 實例的容量保留群組，這些實例與容量保留群組相關聯

az capacity reservation group list -g rg --vm-instance --vmss-instance

選擇性參數

--max-items

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

--next-token

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

--resource-group -g

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

--resource-ids-only

擷取容量保留群組資源標識碼的查詢選項。 'CreatedInSubscription' 會針對訂用帳戶中建立的所有容量保留群組資源啟用擷取資源標識符。 'SharedWithSubscription' 會針對與訂用帳戶共用的所有容量保留群組資源啟用擷取資源標識符。 'All' 會針對與訂用帳戶共用的所有容量保留群組資源，啟用擷取資源標識符，並在訂用帳戶中建立。

接受的值: All, CreatedInSubscription, SharedWithSubscription

--vm-instance

擷取與回應中容量保留群組相關聯的虛擬機實例。

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

--vmss-instance

擷取回應中與容量保留群組相關聯的 ScaleSet VM 實例。

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

全域參數

--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 capacity reservation group show

預覽

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

顯示容量保留群組。

az capacity reservation group show --capacity-reservation-group
                                   --resource-group
                                   [--instance-view]

範例

取得容量保留群組。

az capacity reservation group show -n ReservationGroupName -g MyResourceGroup

取得容量保留群組，其中包含容量保留群組下容量保留的實例檢視

az capacity reservation group show -n ReservationGroupName -g MyResourceGroup --instance-view

必要參數

--capacity-reservation-group -n

容量保留群組的名稱。

--resource-group -g

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

選擇性參數

--instance-view -i

擷取容量保留群組下容量保留的實例檢視清單，這是平臺所管理容量保留的運行時間屬性快照集，而且可以在控制平面作業之外變更。

全域參數

--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 capacity reservation group update

預覽

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

更新容量保留群組。

az capacity reservation group update --capacity-reservation-group
                                     --resource-group
                                     [--sharing-profile]
                                     [--tags]

範例

更新容量保留群組。

az capacity reservation group update -n ReservationGroupName -g MyResourceGroup --tags key=val

必要參數

--capacity-reservation-group -n

容量保留群組的名稱。

--resource-group -g

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

選擇性參數

--sharing-profile

以空格分隔的訂用帳戶資源標識碼或無任何標識碼。 指定設定，以針對容量保留群組資源啟用跨訂用帳戶共用。 將它指定為不共用。

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