检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 目前还未提供购买、删除专属主机的接口，您只能通过管理控制台创建或删除，其他如查询专属主机详情、列表等操作，可以使用接口。 表1 接口说明 类型/接口 说明 查询专属主机列表 查询专属主机列表，可以在URI中增加flavor、dedicated_host_id、state等参数，来过滤查询结果。
API 查询专属主机列表 查询专属主机详情 查询专属主机上的云服务器 更新专属主机属性 查询可用的专属主机类型 查询API版本信息 专属主机标签管理 配额设置
查询指定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版本信息列表。
如何调用API 构造请求 认证鉴权 返回结果
查询API版本信息 查询API版本信息列表 查询指定API版本信息 父主题： API
文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。
对应请求消息头，响应同样也有消息头，如“Content-type”。 对于管理员创建IAM用户接口，返回如图1所示的消息头，其中“X-Subject-Token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。 建议在配置文件或者环境变量中密文存放，使用时解密，确保安全。
查询专属主机详情 功能介绍 查询某一台专属主机的详情。 调试 您可以在API Explorer中调试该接口。 URI GET /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id} 参数说明请参见表1。 表1 参数说明 参数 参数类型
更新专属主机属性 功能介绍 该接口用于变更专属主机的“auto_placement”和“name”属性。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id}
查询专属主机列表 功能介绍 通过该接口查询专属主机列表。 调试 您可以在API Explorer中调试该接口。 URI GET /v1.0/{project_id}/dedicated-hosts 参数说明请参见表1。 表1 参数说明 参数 参数类型 是否必选 描述 project_id
查询可用的专属主机类型 功能介绍 查询某一AZ内可用的专属主机类型。 调试 您可以在API Explorer中调试该接口。 URI Get /v1.0/{project_id}/availability-zone/{availability_zone}/dedicated-host-types
查询租户的专属主机配额 功能介绍 该接口用于查询租户的专属主机配额。 调试 您可以在API Explorer中调试该接口。 URI GET /v1.0/{project_id}/quota-sets/{tenant_id} 参数说明请参见表1。 表1 参数说明 参数 参数类型 是否必选
查询专属主机上的云服务器 功能介绍 查询专属主机上已部署的云服务器信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id}/servers 参数说明请参见表1。
查询指定专属主机标签 功能介绍 查询指定专属主机的标签信息。 标签管理服务（TMS）使用该接口查询指定专属主机的全部标签数据。 调试 您可以在API Explorer中调试该接口。 URI GET /v1.0/{project_id}/dedicated-host-tags/{d
批量删除专属主机标签 功能介绍 批量删除指定专属主机标签。 标签管理服务（TMS）使用该接口批量删除专属主机的标签。 约束 每个专属主机最多10个标签。 调试 您可以在API Explorer中调试该接口。 URI POST /v1.0/{project_id}/dedicated-h
约束与限制 您能创建的专属主机资源的数量与配额有关系，如果您想查看服务配额、扩大配额，具体请参见“调整专属主机资源配额”。 更详细的限制请参见具体API的说明。 父主题： 使用前必读
按标签查询专属主机列表 功能介绍 使用标签过滤专属主机列表，并返回专属主机使用的所有标签。 标签管理服务（TMS）使用该接口过滤专属主机列表。 调试 您可以在API Explorer中调试该接口。 URI POST /v1.0/{project_id}/dedicated-host-tags/re
配额设置 查询租户的专属主机配额 父主题： API
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
