共用方式為


Capacity Reservations - Create Or Update

建立或更新容量保留的作業。 請注意,某些屬性只能在容量保留建立期間設定。 如需詳細資訊, https://aka.ms/CapacityReservation 請參閱 。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}/capacityReservations/{capacityReservationName}?api-version=2024-03-01

URI 參數

名稱 位於 必要 類型 Description
capacityReservationGroupName
path True

string

容量保留群組的名稱。

capacityReservationName
path True

string

容量保留的名稱。

resourceGroupName
path True

string

資源群組的名稱。

subscriptionId
path True

string

可唯一識別 Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶識別碼會構成每個服務呼叫 URI 的一部分。

api-version
query True

string

用戶端 API 版本。

要求本文

名稱 必要 類型 Description
location True

string

資源位置

sku True

Sku

需要保留容量之資源的 SKU。 必須設定 SKU 名稱和容量。 目前支援名為 『CapacityReservationSupported』 功能的 VM Sku 設定為 true。 如需支援的值, https://docs.microsoft.com/rest/api/compute/resourceskus/list 請參閱列出區域中的 Microsoft.Compute SKU () 。

tags

object

資源標籤

zones

string[]

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

回應

名稱 類型 Description
200 OK

CapacityReservation

確定

201 Created

CapacityReservation

建立時間

Other Status Codes

CloudError

描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
user_impersonation 模擬您的用戶帳戶

範例

Create or update a capacity reservation .

範例要求

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation?api-version=2024-03-01

{
  "location": "westus",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ]
}

範例回覆

{
  "name": "myCapacityReservation",
  "location": "westus",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ],
  "properties": {
    "platformFaultDomainCount": 3,
    "reservationId": "{GUID}",
    "provisioningState": "Creating",
    "provisioningTime": "2021-06-27T01:02:38.3138469+00:00"
  }
}
{
  "name": "myCapacityReservation",
  "location": "westus",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ],
  "properties": {
    "platformFaultDomainCount": 3,
    "reservationId": "{GUID}",
    "provisioningState": "Creating",
    "provisioningTime": "2021-06-27T01:02:38.3138469+00:00"
  }
}

定義

名稱 Description
ApiError

API 錯誤。

ApiErrorBase

API 錯誤基底。

CapacityReservation

指定容量保留的相關信息。

CapacityReservationInstanceView

容量保留的實例檢視,提供作為平臺所管理之容量保留的運行時間屬性快照集,而且可以在控制平面作業之外變更。

CapacityReservationUtilization

代表配置的資源容量保留使用率。

CloudError

來自計算服務的錯誤回應。

InnerError

內部錯誤詳細數據。

InstanceViewStatus

實例檢視狀態。

Sku

描述虛擬機擴展集 SKU。 注意:如果擴展集目前所在的硬體上不支援新的 VM SKU,您必須先解除分配擴展集中的 VM,才能修改 SKU 名稱。

StatusLevelTypes

層級程序代碼。

SubResourceReadOnly

ApiError

API 錯誤。

名稱 類型 Description
code

string

錯誤碼。

details

ApiErrorBase[]

API 錯誤詳細數據

innererror

InnerError

Api 內部錯誤

message

string

錯誤訊息。

target

string

特定錯誤的目標。

ApiErrorBase

API 錯誤基底。

名稱 類型 Description
code

string

錯誤碼。

message

string

錯誤訊息。

target

string

特定錯誤的目標。

CapacityReservation

指定容量保留的相關信息。

名稱 類型 Description
id

string

資源標識碼

location

string

資源位置

name

string

資源名稱

properties.instanceView

CapacityReservationInstanceView

容量保留實例檢視。

properties.platformFaultDomainCount

integer

指定容量保留針對要求的 VM 大小所支援的容錯網域計數值。 注意: 如果虛擬機擴展集是使用容量保留部署,則為虛擬機擴展集 (指定的容錯網域計數) 必須小於或等於此值。 API 版本下限:2022-08-01。

properties.provisioningState

string

布建狀態,只會出現在回應中。

properties.provisioningTime

string

上次更新容量保留的日期時間。

properties.reservationId

string

平台產生並指派給容量保留的唯一標識符,不會在整個資源的存留期內變更。

properties.timeCreated

string

指定建立容量保留資源的時間。 最低 api-version:2021-11-01。

properties.virtualMachinesAssociated

SubResourceReadOnly[]

與容量保留相關聯的所有虛擬機資源標識符清單。

sku

Sku

需要保留容量之資源的 SKU。 必須設定 SKU 名稱和容量。 目前支援名為 『CapacityReservationSupported』 功能的 VM Sku 設定為 true。 如需支援的值, https://docs.microsoft.com/rest/api/compute/resourceskus/list 請參閱列出區域中的 Microsoft.Compute SKU () 。

tags

object

資源標籤

type

string

資源類型

zones

string[]

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

CapacityReservationInstanceView

容量保留的實例檢視,提供作為平臺所管理之容量保留的運行時間屬性快照集,而且可以在控制平面作業之外變更。

名稱 類型 Description
statuses

InstanceViewStatus[]

資源狀態資訊。

utilizationInfo

CapacityReservationUtilization

容量保留的未使用量容量。

CapacityReservationUtilization

代表配置的資源容量保留使用率。

名稱 類型 Description
currentCapacity

integer

此值會提供已成功保留的 VM 大小目前容量,以及要向客戶計費的 VM 大小。 API 版本下限:2022-08-01。

virtualMachinesAllocated

SubResourceReadOnly[]

針對容量保留配置的所有虛擬機資源標識符清單。

CloudError

來自計算服務的錯誤回應。

名稱 類型 Description
error

ApiError

API 錯誤。

InnerError

內部錯誤詳細數據。

名稱 類型 Description
errordetail

string

內部錯誤訊息或例外狀況傾印。

exceptiontype

string

例外狀況型別。

InstanceViewStatus

實例檢視狀態。

名稱 類型 Description
code

string

狀態碼。

displayStatus

string

狀態的簡短可當地語系化標籤。

level

StatusLevelTypes

層級程序代碼。

message

string

詳細的狀態消息,包括警示和錯誤訊息。

time

string

狀態的時間。

Sku

描述虛擬機擴展集 SKU。 注意:如果擴展集目前所在的硬體上不支援新的 VM SKU,您必須先解除分配擴展集中的 VM,才能修改 SKU 名稱。

名稱 類型 Description
capacity

integer

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

name

string

SKU 名稱。

tier

string

指定擴展集中的虛擬機層。

可能的值如下:

標準

基本

StatusLevelTypes

層級程序代碼。

名稱 類型 Description
Error

string

Info

string

Warning

string

SubResourceReadOnly

名稱 類型 Description
id

string

資源標識碼