检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 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版本信息列表 查询指定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版本信息列表。
退订专属主机资源 操作场景 对于包年/包月购买的专属主机，如果您不再使用该资源，可以执行退订将其删除。当前仅支持单个资源退订。 前提条件 专属主机上的云服务器迁移至公共资源池，即不再部署在专属主机上。详情请参见专属主机上的云服务器迁移。 在费用中心退订 登录管理控制台，进入“退订与退换货”页面。
调整专属主机资源配额 什么是配额？ 为防止资源滥用，平台限定了各服务资源的配额，对用户的资源数量和容量做了限制。如您最多可以创建多少台弹性云服务器、多少块云硬盘。 如果当前资源配额限制无法满足使用需要，您可以申请扩大配额。 怎样查看我的配额？ 登录管理控制台。 单击管理控制台左上角的，选择区域和项目。
说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候，PATCH可能会去创建一个新的资源。
约束与限制 您能创建的专属主机资源的数量与配额有关系，如果您想查看服务配额、扩大配额，具体请参见“调整专属主机资源配额”。 更详细的限制请参见具体API的说明。 父主题： 使用前必读
怎么查看一台专属主机上有多少可用资源？ 在专属主机控制台页面可以看到每台专属主机的总资源和可用资源，vCPUs、内存的表示形式为可用资源/总资源。 例如：deh-7617-czw专属主机vCPUs总量为144，可用量为130；总内存为576GiB，可用内存为552GiB。 图1 专属主机可用资源查询 父主题：
务器，该场景为“不指定专属主机创建云服务器”。此时，要求租户的专属主机资源中，至少有一台专属主机的自动部署功能处于开启状态。 选择云服务器的类型时，应注意与专属主机类型的匹配关系。如果没有匹配类型的专属主机资源，将无法创建云服务器。 当前仅支持在专属主机上创建按需付费方式的弹性云服务器。
配额设置 查询租户的专属主机配额 父主题： API
查询租户的专属主机配额 功能介绍 该接口用于查询租户的专属主机配额。 调试 您可以在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/{dedicated_host_id} 参数说明请参见表1。 表1 参数说明 参数 参数类型
拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。
查询专属主机列表 功能介绍 通过该接口查询专属主机列表。 调试 您可以在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
按标签查询专属主机列表 功能介绍 使用标签过滤专属主机列表，并返回专属主机使用的所有标签。 标签管理服务（TMS）使用该接口过滤专属主机列表。 调试 您可以在API Explorer中调试该接口。 URI POST /v1.0/{project_id}/dedicated-host-tags/re
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
