检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 目前还未提供购买、删除专属主机的接口，您只能通过管理控制台创建或删除，其他如查询专属主机详情、列表等操作，可以使用接口。 表1 接口说明 类型/接口 说明 查询专属主机列表 查询专属主机列表，可以在URI中增加flavor、dedicated_host_id、state等参数，来过滤查询结果。
标签管理服务（TMS）使用该接口批量添加专属主机的标签。 约束 每个专属主机最多10个标签。 此接口为幂等接口： 创建时，如果创建的标签已经存在（key/value均相同视为重复），默认处理成功。 key相同，value不同时会覆盖原有标签。 调试 您可以在API Explorer中调试该接口。 URI
查询专属主机列表 功能介绍 通过该接口查询专属主机列表。 调试 您可以在API Explorer中调试该接口。 URI GET /v1.0/{project_id}/dedicated-hosts 参数说明请参见表1。 表1 参数说明 参数 参数类型 是否必选 描述 project_id
更新专属主机属性 功能介绍 该接口用于变更专属主机的“auto_placement”和“name”属性。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id}
查询租户的专属主机配额 功能介绍 该接口用于查询租户的专属主机配额。 调试 您可以在API Explorer中调试该接口。 URI GET /v1.0/{project_id}/quota-sets/{tenant_id} 参数说明请参见表1。 表1 参数说明 参数 参数类型 是否必选
批量删除专属主机标签 功能介绍 批量删除指定专属主机标签。 标签管理服务（TMS）使用该接口批量删除专属主机的标签。 约束 每个专属主机最多10个标签。 调试 您可以在API Explorer中调试该接口。 URI POST /v1.0/{project_id}/dedicated-h
完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于管理员创建IAM用户接口，返回如图1所示的消息头，其中“X-Subject-To
查询指定专属主机标签 功能介绍 查询指定专属主机的标签信息。 标签管理服务（TMS）使用该接口查询指定专属主机的全部标签数据。 调试 您可以在API Explorer中调试该接口。 URI GET /v1.0/{project_id}/dedicated-host-tags/{d
查询指定API版本信息 功能介绍 返回专属主机指定版本的信息。 调试 您可以在API Explorer中调试该接口。 URI GET /{api_version} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 api_version 是 API版本号。例如：v1.0
查询API版本信息列表 功能介绍 返回专属主机当前所有可用的版本信息列表。 调试 您可以在API Explorer中调试该接口。 URI GET / 请求消息 无 响应消息 表1 响应参数 参数 参数类型 描述 versions Array of objects 专属主机API版本信息列表。
按标签查询专属主机列表 功能介绍 使用标签过滤专属主机列表，并返回专属主机使用的所有标签。 标签管理服务（TMS）使用该接口过滤专属主机列表。 调试 您可以在API Explorer中调试该接口。 URI POST /v1.0/{project_id}/dedicated-host-tags/re
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https:
查询专属主机详情 功能介绍 查询某一台专属主机的详情。 调试 您可以在API Explorer中调试该接口。 URI GET /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id} 参数说明请参见表1。 表1 参数说明 参数 参数类型
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。
查询可用的专属主机类型 功能介绍 查询某一AZ内可用的专属主机类型。 调试 您可以在API Explorer中调试该接口。 URI Get /v1.0/{project_id}/availability-zone/{availability_zone}/dedicated-host-types
查询专属主机上的云服务器 功能介绍 查询专属主机上已部署的云服务器信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id}/servers 参数说明请参见表1。
文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说
专属主机上的实例总数。 instance_uuids List <String> R - - 专属主机上的实例UUID。 查询专属主机列表接口不显示此参数。 tags Dict(str:str) R - - 专属主机标签。 sys_tags Dict(str:str) R - -
器端软件许可，即支持自带许可（BYOL），提高对云服务器的自治。 您可以使用本文档提供API对专属主机进行相关操作，如查询、删除、更新等。支持的全部操作请参见API概览。 在调用专属主机API之前，请确保已经充分了解专属主机相关概念，详细信息请参见“专属主机产品介绍”。 父主题：
状态码 正常 返回值 说明 200 OK 服务器已成功处理了请求。 201 Created 请求成功并且服务器创建了新的资源。 202 Accepted 服务器已接受请求，延迟处理。 204 No Content 服务器成功处理了请求，但没有返回任何内容。 异常 返回值 说明 400
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
