# 更新专属主机属性 - UpdateDedicatedHost
#### 功能介绍
该接口用于变更专属主机的"auto_placement"和"name"属性。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DeH&api=UpdateDedicatedHost)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-deh/deh_08_0001.html)。
#### URI
PUT /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id}
参数说明请参见[表1]。
 表1参数说明 
| 参数                | 参数类型   | 是否必选 | 描述                                                                                                                                                       |
|:---|:---|:---|:---|
| project_id        | String | 是    | 项目ID。 获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-deh/deh_02_0010.html)。                                              |
| dedicated_host_id | String | 是    | 专属主机ID。 可以从专属主机控制台查询，或者通过调用[查询专属主机列表 - ListDedicatedHosts](https://support.huaweicloud.com/api-deh/deh_02_0020.html)API获取。 |
   
#### 请求消息
表2请求参数 
| **参数**         | **是否必选** | **参数类型** | **描述**                                                                    |
|:---|:---|:---|:---|
| dedicated_host | 是        | Object   | 专属主机，详情请参见[表3 dedicated_host字段数据结构说明]。 |
   
 表3dedicated_host字段数据结构说明 
| 参数             | 位置 | 参数类型   | 是否必选 | 描述                                                                                                     |
|:---|:---|:---|:---|:---|
| auto_placement | in | String | 否    | 在创建云服务器时（未指定专属主机ID），是否允许云服务器自动分配在一台可用的专属主机上。 取值范围："on"或"off"。            |
| name           | in | String | 否    | 专属主机名称。 只能由中文字符、英文字母、数字及"_"、"-"、"."组成，且长度为\[1-255\]个英文字符或\[1-64\]个中文字符。 |
   
#### 响应消息
无
#### 请求示例
更新专属主机属性，在创建云服务器时，不允许云服务器自动分配在一台可用的专属主机上；将专属主机名称更新为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
```
#### 返回值
请参见[状态码](https://support.huaweicloud.com/api-deh/deh_02_0016.html)。