Dedicated Hosts - Update
更新專用主機 。
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}/hosts/{hostName}?api-version=2024-03-01
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
host
|
path | True |
string |
專用主機群組的名稱。 |
host
|
path | True |
string |
專用主機 的名稱。 |
resource
|
path | True |
string |
資源群組的名稱。 |
subscription
|
path | True |
string |
可唯一識別 Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶識別碼會構成每個服務呼叫 URI 的一部分。 |
api-version
|
query | True |
string |
用戶端 API 版本。 |
要求本文
名稱 | 類型 | Description |
---|---|---|
properties.autoReplaceOnFailure |
boolean |
指定在發生失敗時,是否應該自動取代專用主機。 未提供時,此值預設為 『true』。 |
properties.licenseType |
指定將套用至部署在專用主機上的 VM 的軟體授權類型。 可能的值為: None、Windows_Server_Hybrid、Windows_Server_Perpetual。 默認值為: None。 |
|
properties.platformFaultDomain |
integer |
專用主機群組內專用主機的容錯網域。 |
sku |
[列出所有可用的專用主機大小以進行重設大小] (https://docs.microsoft.com/rest/api/compute/dedicated-hosts/listavailablesizes) 。 重設大小只能用來相應增加 DedicatedHost。 只需要設定名稱。 |
|
tags |
object |
資源標籤 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
確定 |
|
Other Status Codes |
描述作業失敗原因的錯誤回應。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名稱 | Description |
---|---|
user_impersonation | 模擬您的用戶帳戶 |
範例
Dedicated |
Dedicated |
Dedicated |
DedicatedHost_Update_MaximumSet_Gen
Sample Request
PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/hostGroups/aaaaaaaaa/hosts/aaaaaaaaaaaaaaaaaaaaa?api-version=2024-03-01
{
"properties": {
"platformFaultDomain": 1,
"autoReplaceOnFailure": true,
"licenseType": "Windows_Server_Hybrid",
"instanceView": {
"availableCapacity": {
"allocatableVMs": [
{
"vmSize": "aaaaaaaaaaaaaaaaaaaa",
"count": 26
}
]
},
"statuses": [
{
"code": "aaaaaaaaaaaaaaaaaaaaaaa",
"level": "Info",
"displayStatus": "aaaaaa",
"message": "a",
"time": "2021-11-30T12:58:26.522Z"
}
]
}
},
"tags": {
"key8813": "aaaaaaaaaaaaaaaaaaaaaaaaaaa"
}
}
Sample Response
{
"location": "westus",
"tags": {},
"properties": {
"platformFaultDomain": 1,
"autoReplaceOnFailure": true,
"hostId": "{GUID}",
"virtualMachines": [
{
"id": "aaaa"
}
],
"licenseType": "Windows_Server_Hybrid",
"provisioningTime": "2021-11-30T12:58:26.526Z",
"provisioningState": "aaaaaaaaaaaaaaaaaaaaaaaaa",
"instanceView": {
"assetId": "aaaaaaaaaaaaaaaa",
"availableCapacity": {
"allocatableVMs": [
{
"vmSize": "aaaaaaaaaaaaaaaaaaaa",
"count": 26
}
]
},
"statuses": [
{
"code": "aaaaaaaaaaaaaaaaaaaaaaa",
"level": "Info",
"displayStatus": "aaaaaa",
"message": "a",
"time": "2021-11-30T12:58:26.522Z"
}
]
}
},
"sku": {
"name": "DSv3-Type1",
"tier": "aaa",
"capacity": 7
},
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myDedicatedHost",
"name": "myDedicatedHost",
"type": "aaaaaaaaaaaaaaaaaaa"
}
DedicatedHost_Update_MinimumSet_Gen
Sample Request
PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/hostGroups/aa/hosts/aaaaaaaaaaaaaaaaaaaaaaaaaa?api-version=2024-03-01
{}
Sample Response
{
"location": "westus",
"sku": {}
}
DedicatedHost_Update_Resize
Sample Request
PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/hostGroups/aaaaaaaaa/hosts/aaaaaaaaaaaaaaaaaaaaa?api-version=2024-03-01
{
"sku": {
"name": "DSv3-Type1"
}
}
Sample Response
{
"location": "westus",
"tags": {},
"properties": {
"platformFaultDomain": 1,
"autoReplaceOnFailure": true,
"hostId": "{GUID}",
"virtualMachines": [
{
"id": "aaaa"
}
],
"licenseType": "Windows_Server_Hybrid",
"provisioningTime": "2021-11-30T12:58:26.526Z",
"provisioningState": "aaaaaaaaaaaaaaaaaaaaaaaaa"
},
"sku": {
"name": "DSv3-Type1",
"tier": "aaa",
"capacity": 7
},
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/HostGroups/myDedicatedHostGroup/hosts/myDedicatedHost",
"name": "myDedicatedHost",
"type": "aaaaaaaaaaaaaaaaaaa"
}
定義
名稱 | Description |
---|---|
Api |
Api 錯誤。 |
Api |
Api 錯誤基底。 |
Cloud |
計算服務的錯誤回應。 |
Dedicated |
指定專用主機的相關信息。 |
Dedicated |
代表專用主機未使用容量的特定 VM 大小。 |
Dedicated |
專用主機未使用量的容量。 |
Dedicated |
專用主機的實例檢視。 |
Dedicated |
指定將套用至部署在專用主機上的 VM 的軟體授權類型。 可能的值為: None、Windows_Server_Hybrid、Windows_Server_Perpetual。 默認值為: None。 |
Dedicated |
指定專用主機的相關信息。 只有標籤、autoReplaceOnFailure 和 licenseType 可以更新。 |
Inner |
內部錯誤詳細數據。 |
Instance |
實例檢視狀態。 |
Sku |
描述虛擬機擴展集 SKU。 注意:如果擴展集目前所在的硬體不支援新的 VM SKU,您必須先解除分配擴展集中的 VM,才能修改 SKU 名稱。 |
Status |
層級程序代碼。 |
Sub |
ApiError
Api 錯誤。
名稱 | 類型 | Description |
---|---|---|
code |
string |
錯誤碼。 |
details |
API 錯誤詳細數據 |
|
innererror |
Api 內部錯誤 |
|
message |
string |
錯誤訊息。 |
target |
string |
特定錯誤的目標。 |
ApiErrorBase
Api 錯誤基底。
名稱 | 類型 | Description |
---|---|---|
code |
string |
錯誤碼。 |
message |
string |
錯誤訊息。 |
target |
string |
特定錯誤的目標。 |
CloudError
計算服務的錯誤回應。
名稱 | 類型 | Description |
---|---|---|
error |
Api 錯誤。 |
DedicatedHost
指定專用主機的相關信息。
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源標識碼 |
location |
string |
資源位置 |
name |
string |
資源名稱 |
properties.autoReplaceOnFailure |
boolean |
指定在發生失敗時,是否應該自動取代專用主機。 未提供時,此值預設為 『true』。 |
properties.hostId |
string |
平台產生並指派給專用主機的唯一標識符。 在主機的存留期內不會變更。 |
properties.instanceView |
專用主機實例檢視。 |
|
properties.licenseType |
指定將套用至部署在專用主機上的 VM 的軟體授權類型。 可能的值為: None、Windows_Server_Hybrid、Windows_Server_Perpetual。 默認值為: None。 |
|
properties.platformFaultDomain |
integer |
專用主機群組內專用主機的容錯網域。 |
properties.provisioningState |
string |
布建狀態,只會出現在回應中。 |
properties.provisioningTime |
string |
第一次布建主機的日期。 |
properties.timeCreated |
string |
指定建立專用主機資源的時間。 API 版本下限:2021-11-01。 |
properties.virtualMachines |
專用主機中所有虛擬機的參考清單。 |
|
sku |
硬體產生和 VM 系列專用主機的 SKU。 只需要設定名稱。 列出 Microsoft.Compute SKU 以取得可能值的清單。 |
|
tags |
object |
資源標籤 |
type |
string |
資源類型 |
DedicatedHostAllocatableVM
代表專用主機未使用容量的特定 VM 大小。
名稱 | 類型 | Description |
---|---|---|
count |
number |
大小 vmSize 的 VM 數目上限,可符合專用主機的剩餘容量。 |
vmSize |
string |
VM 大小,其中表示未使用量的容量。 |
DedicatedHostAvailableCapacity
專用主機未使用量的容量。
名稱 | 類型 | Description |
---|---|---|
allocatableVMs |
專用主機的未使用量,以允許部署到專用主機的每個 VM 大小來表示。 |
DedicatedHostInstanceView
專用主機的實例檢視。
名稱 | 類型 | Description |
---|---|---|
assetId |
string |
指定專用主機所在專用實體機器的唯一標識碼。 |
availableCapacity |
專用主機的未使用量容量。 |
|
statuses |
資源狀態資訊。 |
DedicatedHostLicenseTypes
指定將套用至部署在專用主機上的 VM 的軟體授權類型。 可能的值為: None、Windows_Server_Hybrid、Windows_Server_Perpetual。 默認值為: None。
名稱 | 類型 | Description |
---|---|---|
None |
string |
|
Windows_Server_Hybrid |
string |
|
Windows_Server_Perpetual |
string |
DedicatedHostUpdate
指定專用主機的相關信息。 只有標籤、autoReplaceOnFailure 和 licenseType 可以更新。
名稱 | 類型 | Description |
---|---|---|
properties.autoReplaceOnFailure |
boolean |
指定在發生失敗時,是否應該自動取代專用主機。 未提供時,此值預設為 『true』。 |
properties.hostId |
string |
平台產生並指派給專用主機的唯一標識符。 在主機的存留期內不會變更。 |
properties.instanceView |
專用主機實例檢視。 |
|
properties.licenseType |
指定將套用至部署在專用主機上的 VM 的軟體授權類型。 可能的值為: None、Windows_Server_Hybrid、Windows_Server_Perpetual。 默認值為: None。 |
|
properties.platformFaultDomain |
integer |
專用主機群組內專用主機的容錯網域。 |
properties.provisioningState |
string |
布建狀態,只會出現在回應中。 |
properties.provisioningTime |
string |
第一次布建主機的日期。 |
properties.timeCreated |
string |
指定建立專用主機資源的時間。 API 版本下限:2021-11-01。 |
properties.virtualMachines |
專用主機中所有虛擬機的參考清單。 |
|
sku |
[列出所有可用的專用主機大小以進行重設大小] (https://docs.microsoft.com/rest/api/compute/dedicated-hosts/listavailablesizes) 。 重設大小只能用來相應增加 DedicatedHost。 只需要設定名稱。 |
|
tags |
object |
資源標籤 |
InnerError
內部錯誤詳細數據。
名稱 | 類型 | Description |
---|---|---|
errordetail |
string |
內部錯誤訊息或例外狀況傾印。 |
exceptiontype |
string |
例外狀況型別。 |
InstanceViewStatus
實例檢視狀態。
名稱 | 類型 | Description |
---|---|---|
code |
string |
狀態碼。 |
displayStatus |
string |
狀態的簡短可當地語系化標籤。 |
level |
層級程序代碼。 |
|
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 |
資源標識碼 |