你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

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

名称 必需 类型 说明
hostGroupName
path True

string

专用主机组的名称。

hostName
path True

string

专用主机 的名称。

resourceGroupName
path True

string

资源组的名称。

subscriptionId
path True

string

唯一标识 Microsoft Azure 订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。

api-version
query True

string

客户端 API 版本。

请求正文

名称 类型 说明
properties.autoReplaceOnFailure

boolean

指定在发生故障时是否应自动替换专用主机。 如果未提供该值,则该值默认为“true”。

properties.licenseType

DedicatedHostLicenseTypes

指定将应用于部署在专用主机上的 VM 的软件许可证类型。 可能的值为: None、Windows_Server_Hybrid、Windows_Server_Perpetual。 默认值为: None。

properties.platformFaultDomain

integer

专用主机组中专用主机的容错域。

sku

Sku

[列出所有可用于调整大小的专用主机大小] (https://docs.microsoft.com/rest/api/compute/dedicated-hosts/listavailablesizes) 。 调整大小只能用于纵向扩展 DedicatedHost。 只需设置名称。

tags

object

资源标记

响应

名称 类型 说明
200 OK

DedicatedHost

确定

Other Status Codes

CloudError

描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

DedicatedHost_Update_MaximumSet_Gen
DedicatedHost_Update_MinimumSet_Gen
DedicatedHost_Update_Resize

DedicatedHost_Update_MaximumSet_Gen

示例请求

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

示例响应

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

示例请求

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/hostGroups/aa/hosts/aaaaaaaaaaaaaaaaaaaaaaaaaa?api-version=2024-03-01

{}

示例响应

{
  "location": "westus",
  "sku": {}
}

DedicatedHost_Update_Resize

示例请求

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

示例响应

{
  "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"
}

定义

名称 说明
ApiError

Api 错误。

ApiErrorBase

Api 错误基。

CloudError

来自计算服务的错误响应。

DedicatedHost

指定有关专用主机的信息。

DedicatedHostAllocatableVM

表示特定 VM 大小的专用主机未使用容量。

DedicatedHostAvailableCapacity

专用主机未使用容量。

DedicatedHostInstanceView

专用主机的实例视图。

DedicatedHostLicenseTypes

指定将应用于部署在专用主机上的 VM 的软件许可证类型。 可能的值为: None、Windows_Server_Hybrid、Windows_Server_Perpetual。 默认值为: None。

DedicatedHostUpdate

指定有关专用主机的信息。 只能更新标记、autoReplaceOnFailure 和 licenseType。

InnerError

内部错误详细信息。

InstanceViewStatus

实例视图状态。

Sku

介绍虚拟机规模集 SKU。 注意:如果规模集当前使用的硬件不支持新的 VM SKU,则需要在修改 SKU 名称之前解除分配规模集中的 VM。

StatusLevelTypes

级别代码。

SubResourceReadOnly

ApiError

Api 错误。

名称 类型 说明
code

string

错误代码。

details

ApiErrorBase[]

Api 错误详细信息

innererror

InnerError

Api 内部错误

message

string

错误消息。

target

string

特定错误的目标。

ApiErrorBase

Api 错误基。

名称 类型 说明
code

string

错误代码。

message

string

错误消息。

target

string

特定错误的目标。

CloudError

来自计算服务的错误响应。

名称 类型 说明
error

ApiError

Api 错误。

DedicatedHost

指定有关专用主机的信息。

名称 类型 说明
id

string

资源 ID

location

string

资源位置

name

string

资源名称

properties.autoReplaceOnFailure

boolean

指定在发生故障时是否应自动替换专用主机。 如果未提供该值,则该值默认为“true”。

properties.hostId

string

由平台生成并分配给专用主机的唯一 ID。 在主机的整个生存期内不会更改。

properties.instanceView

DedicatedHostInstanceView

专用主机实例视图。

properties.licenseType

DedicatedHostLicenseTypes

指定将应用于部署在专用主机上的 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

SubResourceReadOnly[]

对专用主机中所有虚拟机的引用列表。

sku

Sku

硬件代系和 VM 系列的专用主机的 SKU。 只需设置名称。 列出 Microsoft.Compute SKU 以获取可能值的列表。

tags

object

资源标记

type

string

资源类型

DedicatedHostAllocatableVM

表示特定 VM 大小的专用主机未使用容量。

名称 类型 说明
count

number

可以容纳专用主机剩余容量的 vmSize 大小的最大 VM 数。

vmSize

string

表示未使用的容量的 VM 大小。

DedicatedHostAvailableCapacity

专用主机未使用容量。

名称 类型 说明
allocatableVMs

DedicatedHostAllocatableVM[]

专用主机的未使用容量表示为允许部署到专用主机的每个 VM 大小。

DedicatedHostInstanceView

专用主机的实例视图。

名称 类型 说明
assetId

string

指定专用主机所在的专用物理计算机的唯一 ID。

availableCapacity

DedicatedHostAvailableCapacity

专用主机的未使用容量。

statuses

InstanceViewStatus[]

资源状态信息。

DedicatedHostLicenseTypes

指定将应用于部署在专用主机上的 VM 的软件许可证类型。 可能的值为: None、Windows_Server_Hybrid、Windows_Server_Perpetual。 默认值为: None。

名称 类型 说明
None

string

Windows_Server_Hybrid

string

Windows_Server_Perpetual

string

DedicatedHostUpdate

指定有关专用主机的信息。 只能更新标记、autoReplaceOnFailure 和 licenseType。

名称 类型 说明
properties.autoReplaceOnFailure

boolean

指定在发生故障时是否应自动替换专用主机。 如果未提供该值,则该值默认为“true”。

properties.hostId

string

由平台生成并分配给专用主机的唯一 ID。 在主机的整个生存期内不会更改。

properties.instanceView

DedicatedHostInstanceView

专用主机实例视图。

properties.licenseType

DedicatedHostLicenseTypes

指定将应用于部署在专用主机上的 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

SubResourceReadOnly[]

对专用主机中所有虚拟机的引用列表。

sku

Sku

[列出所有可用于调整大小的专用主机大小] (https://docs.microsoft.com/rest/api/compute/dedicated-hosts/listavailablesizes) 。 调整大小只能用于纵向扩展 DedicatedHost。 只需设置名称。

tags

object

资源标记

InnerError

内部错误详细信息。

名称 类型 说明
errordetail

string

内部错误消息或异常转储。

exceptiontype

string

异常类型。

InstanceViewStatus

实例视图状态。

名称 类型 说明
code

string

状态代码。

displayStatus

string

状态的简短可本地化标签。

level

StatusLevelTypes

级别代码。

message

string

详细状态消息,包括警报和错误消息。

time

string

状态的时间。

Sku

介绍虚拟机规模集 SKU。 注意:如果规模集当前使用的硬件不支持新的 VM SKU,则需要在修改 SKU 名称之前解除分配规模集中的 VM。

名称 类型 说明
capacity

integer

指定规模集中的虚拟机数。

name

string

SKU 名称。

tier

string

指定规模集中虚拟机的层。

可能的值:

标准

基本

StatusLevelTypes

级别代码。

名称 类型 说明
Error

string

Info

string

Warning

string

SubResourceReadOnly

名称 类型 说明
id

string

资源 ID