更新专属主机属性 - UpdateDedicatedHost

功能介绍

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

调试

您可以在API Explorer中调试该接口。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

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

参数说明请参见表1。

表1 参数说明
参数	参数类型	是否必选	描述
project_id	String	是	项目ID。获取方式请参见获取项目ID。
dedicated_host_id	String	是	专属主机ID。可以从专属主机控制台查询，或者通过调用查询专属主机列表 - ListDedicatedHostsAPI获取。

请求消息

表2 请求参数
参数	是否必选	参数类型	描述
dedicated_host	是	Object	专属主机，详情请参见表3 dedicated_host字段数据结构说明。

表3 dedicated_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"
    }
}