检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
com/videos/102987。 请求URI 请求URI由如下部分组成： {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。
状态码 正常 返回值 说明 200 OK 服务器已成功处理了请求。 201 Created 请求成功并且服务器创建了新的资源。 202 Accepted 服务器已接受请求，延迟处理。 204 No Content 服务器成功处理了请求，但没有返回任何内容。 异常 返回值 说明 400
状态码 请求发送以后，您会收到响应，其中包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头
12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK（Access Key ID）：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。
调用说明 专属主机服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 父主题： 使用前必读
终端节点 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 父主题： 使用前必读
对于包年/包月计费模式的专属主机及其关联的资源，用户已经预先支付了资源费用，因此在账户出现欠费的情况下，已有的包年/包月资源仍可正常使用。然而，对于涉及费用的操作，如新购专属主机、续费订单等，用户将无法正常进行。 按需计费 当您的账号因专属主机中ECS关联的按需资源，如镜像、弹性公网IP、云硬盘、云备份等，
续费概述 续费简介 包年/包月专属主机到期后，会影响专属主机正常运行。如果您想继续使用，需要在指定的时间内为专属主机续费，否则专属主机中的云服务器会自动释放，数据丢失且不可恢复。 专属主机在到期前续费成功，所有资源得以保留，且专属主机的运行不受影响。专属主机到期后的状态说明，请参见到期后影响。
dedicated_host_id String 是 专属主机ID。 可以从专属主机控制台查询，或者通过调用查询专属主机列表API获取。 请求消息 表2 请求参数 参数 是否必选 参数类型 描述 dedicated_host 是 Object 专属主机，详情请参见表3 dedicated_host字段数据结构说明。
dedicated_host_id String 是 专属主机ID。 可以从专属主机控制台查询，或者通过调用查询专属主机列表API获取。 请求消息 表2 请求参数 参数 参数类型 是否必选 描述 tags Array of objects 是 标签列表。 详情见表3。 action String
生命周期 一台专属主机从创建到释放的整个生命周期会经历不同状态，如表1所示。 表1 专属主机状态说明 状态 状态属性 说明 正常 稳定状态 专属主机正常运行状态。 在这个状态的专属主机可以运行您的业务。 故障 故障状态 专属主机出现故障。 在这个状态下的专属主机不能对外提供业务，需要联系客服进行处理。
可以从专属主机控制台查询，或者通过调用查询专属主机列表API获取。 请求消息 可以在URI中添加“resource”参数，例如： /v1.0/{project_id}/quota-sets/{tenant_id}?resource={resource} 表2 请求参数 参数 位置 参数类型 是否必选 描述
dedicated_host_id String 是 专属主机ID。 可以从专属主机控制台查询，或者通过调用查询专属主机列表API获取。 请求消息 表2 请求参数 参数 参数类型 是否必选 描述 tags Array of objects 是 标签列表。详情见表3。 action String
如何调用API 构造请求 认证鉴权 返回结果
project_id String 是 项目ID。 获取方式请参见获取项目ID。 availability_zone String 是 AZ。 请求消息 无 响应消息 表2 响应参数 参数 位置 参数类型 描述 dedicated_host_types body Array of objects
查询API版本信息列表 功能介绍 返回专属主机当前所有可用的版本信息列表。 调试 您可以在API Explorer中调试该接口。 URI GET / 请求消息 无 响应消息 表1 响应参数 参数 参数类型 描述 versions Array of objects 专属主机API版本信息列表。
/{api_version} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 api_version 是 API版本号。例如：v1.0 请求消息 无 响应消息 表2 响应参数 参数 参数类型 描述 version Object 专属主机指定API版本信息。 表3 version字段数据结构说明
I获取。 请求消息 无 响应消息 表2 响应参数 参数 参数类型 描述 tags Array of objects 标签列表。 详情请参见表3。 表3 tag字段数据结构说明 名称 参数类型 说明 key String 标签键。 value String 标签值。 请求示例 查询
参数说明请参见表1。 表1 参数说明 参数 参数类型 是否必选 描述 project_id String 是 项目ID。 获取方式请参见获取项目ID。 请求消息 可以在URI中增加如下参数，来过滤查询结果：host_type、host_type_name、flavor、dedicated_ho
可以从专属主机控制台查询，或者通过调用查询专属主机列表API获取。 请求消息 无 响应消息 表2 响应参数 参数 位置 参数类型 描述 dedicated_host body Object 专属主机对象。 具体请参见表1。 请求示例 查询ID为ab910cf0daebca90c4001的专属主机详情。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
