az capacity reservation

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

管理容量保留。

命令

名稱	Description	類型	狀態
az capacity reservation create	建立容量保留。	核心	預覽版
az capacity reservation delete	刪除作業以刪除容量保留。 只有在所有相關聯的資源與容量保留區解除關聯時，才允許此作業。 如需詳細資訊， https://aka.ms/CapacityReservation 請參閱 。	核心	預覽版
az capacity reservation group	管理容量保留群組。	核心	預覽版
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 list	列出指定容量保留群組中的所有容量保留。 在回應中使用 nextLink 屬性來取得容量保留的下一頁。	核心	預覽版
az capacity reservation show	顯示容量保留。	核心	預覽版
az capacity reservation update	更新容量保留。	核心	預覽版

az capacity reservation create

預覽

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

建立容量保留。

az capacity reservation create --capacity-reservation-group
                               --capacity-reservation-name
                               --resource-group
                               --sku
                               [--capacity]
                               [--location]
                               [--no-wait]
                               [--tags]
                               [--zone]

範例

建立容量保留。

az capacity reservation create -c ReservationGroupName -n ReservationName \
    -g MyResourceGroup --sku Standard_A0

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

az capacity reservation create -c ReservationGroupName -n ReservationName -l centraluseuap \
    -g MyResourceGroup  --sku Standard_A1_v2 --capacity 5 \
        --zone 1 --tags key=val

必要參數

--capacity-reservation-group -c

容量保留群組的名稱。

--capacity-reservation-name -n

容量保留的名稱。

--resource-group -g

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

--sku -s

需要保留容量之資源的 SKU。 目前支援名為 「CapacityReservationSupported」 功能的 VM SKU 設定為 true。 如需支援的值，請參閱列出區域中 https://docs.microsoft.com/rest/api/compute/resourceskus/list 的 Microsoft.Compute SKU。

選擇性參數

--capacity

指定擴展集中的虛擬機器數目。

--location -l

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

--no-wait

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

預設值: False

--tags

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

--zone -z

要用於此容量保留的可用性區域。 區域必須是單一值，也應該是容量保留群組建立期間所指定區域清單的一部分。 如果未提供，保留僅支援非區域性部署。 如果提供，請使用此容量保留來強制執行 VM/VMSS，以位於相同的區域。

全域參數

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

預覽

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

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

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

範例

刪除容量保留。

az capacity reservation delete -c ReservationGroupName -n ReservationName -g MyResourceGroup --yes

選擇性參數

--capacity-reservation-group --capacity-reservation-group-name -c

容量保留群組的名稱。

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

容量保留的名稱。

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

預覽

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

列出指定容量保留群組中的所有容量保留。 在回應中使用 nextLink 屬性來取得容量保留的下一頁。

az capacity reservation list --capacity-reservation-group
                             --resource-group

範例

列出容量保留。

az capacity reservation list -c ReservationGroupName -g MyResourceGroup

必要參數

--capacity-reservation-group --capacity-reservation-group-name -c

容量保留群組的名稱。

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

預覽

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

顯示容量保留。

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

範例

取得容量保留。

az capacity reservation show -c ReservationGroupName -n ReservationName -g MyResourceGroup

取得包含實例檢視的容量保留。

az capacity reservation show -c ReservationGroupName -n ReservationName \
    -g MyResourceGroup --instance-view

必要參數

--capacity-reservation-group -c

容量保留群組的名稱。

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

預覽

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

更新容量保留。

az capacity reservation update --capacity-reservation-group
                               --capacity-reservation-name
                               --resource-group
                               [--capacity]
                               [--no-wait]
                               [--tags]

範例

更新容量保留。

az capacity reservation update -c ReservationGroupName -n ReservationName \
    -g MyResourceGroup --capacity 5 --tags key=val

必要參數

--capacity-reservation-group -c

容量保留群組的名稱。

--capacity-reservation-name -n

容量保留的名稱。

--resource-group -g

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

選擇性參數

--capacity

指定擴展集中的虛擬機器數目。

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

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

--verbose

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