文档首页/ 专属主机 DeH/ API参考/ API/ 更新专属主机属性
更新时间：2023-08-21 GMT+08:00
查看PDF
分享

更新专属主机属性

功能介绍

该接口用于变更专属主机的“auto_placement”和“name”属性。

URI

PUT /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id}

参数说明请参见表1。

表1 参数说明

参数

参数类型

是否必选

描述

project_id

String

是

项目ID。

获取方式请参见获取项目ID。

dedicated_host_id

String

是

专属主机ID。

可以从专属主机控制台查询，或者通过调用查询专属主机列表API获取。

请求消息

表2 请求参数

参数

是否必选

参数类型

描述

dedicated_host

是

Object

专属主机，详情请参见表3 dedicated_host字段数据结构说明。
表3 dedicated_host字段数据结构说明

参数

位置

参数类型

是否必选

描述

auto_placement

in

String

否

在创建云服务器时（未指定专属主机ID），是否允许云服务器自动分配在一台可用的专属主机上。

取值范围：“on”或“off”。

name

in

String

否

专属主机名称。

响应消息

无

请求示例

更新专属主机属性，在创建云服务器时，不允许云服务器自动分配在一台可用的专属主机上；将专属主机名称更新为DeH_vm3。 
PUT https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-hosts/74259164-e63a-4ad9-9c77-a1bd2c9aa187
{
    "dedicated_host": {
        "auto_placement": "off",
        "name": "DeH_vm3"
    }
}

响应示例

Http Response Code: 204

返回值

请参见状态码。

父主题： API