检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 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
查询API版本信息列表 功能介绍 返回专属主机当前所有可用的版本信息列表。 调试 您可以在API Explorer中调试该接口。 URI GET / 请求消息 无 响应消息 表1 响应参数 参数 参数类型 描述 versions Array of objects 专属主机API版本信息列表。
API 查询专属主机列表 查询专属主机详情 查询专属主机上的云服务器 更新专属主机属性 查询可用的专属主机类型 查询API版本信息 专属主机标签管理 配额设置
如何调用API 构造请求 认证鉴权 返回结果
查询指定API版本信息 功能介绍 返回专属主机指定版本的信息。 调试 您可以在API Explorer中调试该接口。 URI GET /{api_version} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 api_version 是 API版本号。例如：v1.0
文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说
公共参数 对象模型 状态码 获取项目ID
专属主机标签管理 批量添加专属主机标签 批量删除专属主机标签 查询指定专属主机标签 按标签查询专属主机列表 父主题： API
拥有某种权限。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 参数说明 参数 参数类型
更新专属主机属性 功能介绍 该接口用于变更专属主机的“auto_placement”和“name”属性。 调试 您可以在API Explorer中调试该接口。 URI PUT /v1.0/{project_id}/dedicated-hosts/{dedicated_host_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
查询专属主机列表 功能介绍 通过该接口查询专属主机列表。 调试 您可以在API Explorer中调试该接口。 URI GET /v1.0/{project_id}/dedicated-hosts 参数说明请参见表1。 表1 参数说明 参数 参数类型 是否必选 描述 project_id
完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于管理员创建IAM用户接口，返回如图1所示的消息头，其中“X-Subject-To
批量删除专属主机标签 功能介绍 批量删除指定专属主机标签。 标签管理服务（TMS）使用该接口批量删除专属主机的标签。 约束 每个专属主机最多10个标签。 调试 您可以在API Explorer中调试该接口。 URI POST /v1.0/{project_id}/dedicated-h
查询专属主机上的云服务器 功能介绍 查询专属主机上已部署的云服务器信息。 调试 您可以在API Explorer中调试该接口。 URI GET /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id}/servers 参数说明请参见表1。
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
