检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API 查询专属主机列表 查询专属主机详情 查询专属主机上的云服务器 更新专属主机属性 查询可用的专属主机类型 查询API版本信息 专属主机标签管理 配额设置
API概览 目前还未提供购买、删除专属主机的接口，您只能通过管理控制台创建或删除，其他如查询专属主机详情、列表等操作，可以使用接口。 表1 接口说明 类型/接口 说明 查询专属主机列表 查询专属主机列表，可以在URI中增加flavor、dedicated_host_id、state等参数，来过滤查询结果。
如何调用API 构造请求 认证鉴权 返回结果
查询指定API版本信息 功能介绍 返回专属主机指定版本的信息。 调试 您可以在API Explorer中调试该接口。 URI GET /{api_version} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 api_version 是 API版本号。例如：v1.0
查询API版本信息 查询API版本信息列表 查询指定API版本信息 父主题： API
查询API版本信息列表 功能介绍 返回专属主机当前所有可用的版本信息列表。 调试 您可以在API Explorer中调试该接口。 URI GET / 请求消息 无 响应消息 表1 响应参数 参数 参数类型 描述 versions Array of objects 专属主机API版本信息列表。
请求发送以后，您会收到响应，其中包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。
String 否 在创建云服务器时（未指定专属主机ID），是否允许云服务器自动分配在一台可用的专属主机上。 取值范围：“on”或“off”。 name in String 否 专属主机名称。 响应消息 无 请求示例 更新专属主机属性，在创建云服务器时，不允许云服务器自动分配在一台可用的
查询专属主机上的云服务器 功能介绍 查询专属主机上已部署的云服务器信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id}/servers 参数说明请参见表1。
批量删除专属主机标签 功能介绍 批量删除指定专属主机标签。 标签管理服务（TMS）使用该接口批量删除专属主机的标签。 约束 每个专属主机最多10个标签。 调试 您可以在API Explorer中调试该接口。 URI POST /v1.0/{project_id}/dedicate
配额设置 查询租户的专属主机配额 父主题： API
文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。
查询专属主机详情 功能介绍 查询某一台专属主机的详情。 调试 您可以在API Explorer中调试该接口。 URI GET /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id} 参数说明请参见表1。 表1 参数说明 参数 参数类型
专属主机标签管理 批量添加专属主机标签 批量删除专属主机标签 查询指定专属主机标签 按标签查询专属主机列表 父主题： API
查询专属主机列表 功能介绍 通过该接口查询专属主机列表。 调试 您可以在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 参数说明 参数 参数类型 是否必选
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
查询指定专属主机标签 功能介绍 查询指定专属主机的标签信息。 标签管理服务（TMS）使用该接口查询指定专属主机的全部标签数据。 调试 您可以在API Explorer中调试该接口。 URI GET /v1.0/{project_id}/dedicated-host-tags/{d
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
