检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
认证鉴权 调用接口有使用Token认证方式。 Token认证:通过Token认证通用请求。 Token认证 Token的有效期为24小时,需要使用一个Token鉴权时,可以先缓存起来,避免频繁调用。 使用Token前请确保Token离过期有足够的时间,防止调用API的过程中Token过期导致调用API失败。
构造请求 本节介绍REST API请求的组成,并以调用IAM服务的获取用户Token接口说明如何调用API,该API获取用户的Token,Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API:https://bbs.huaweicloud.com/videos/102987
API 域名管理 域名注册 域名查询 信息模板查询
oken。有了Token之后,您就可以使用Token认证调用其他API。 图1 获取用户Token响应消息头 响应消息体 响应消息体通常以结构化格式返回,与响应消息头中Content-type对应,传递除响应消息头之外的内容。 对于获取用户Token接口,返回如下消息体。为篇幅起见,这里只展示部分内容。
API概览 域名注册服务提供的具体API如表1所示。 表1 接口说明 子类型 说明 域名管理 管理域名的相关操作API 域名注册 域名注册操作API 域名查询 域名查询相关操作API 信息模板查询 模板查询相关操作API
如何调用API 构造请求 认证鉴权 返回结果
获取帐号ID 操作场景 在调用接口的时候,部分URL中需要填入帐号ID,所以需要先在管理控制台上获取到帐号ID。 操作步骤 帐号ID获取步骤如下: 登录管理控制台。 单击用户名,在下拉列表中单击“我的凭证”。 在“API凭证”页面中查看账号ID。 图1 获取账号ID 父主题: 附录
NONAUDIT:未实名认证 SUCCEED:已实名认证 FAILED:实名认证失败 AUDITING:实名认证审核中 audit_fail_reason String 域名实名认证失败原因 transfer_audit_status String 域名过户实名认证状态。 取值范围:
audit_status 否 String 信息模板实名状态。 取值范围: NONAUDIT:未实名认证 SUCCEED:已实名认证 FAILED:实名认证失败 AUDITING:实名认证审核中 register_cn 否 String 域名所有者中文名,长度不超过64字符。 请求参数
功能介绍 域名信息模板过户接口。 URI PUT /v2/domains/actions/registrant-change 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户IAM-Token 表2 请求Body参数
在华为云创建一个域名注册任务。 调用当前API前请先调用查询域名是否可用。 URI POST /v2/domains/actions/register 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户IAM-Token 表2 请求Body参数
permission to perform this operation using the API. API权限不足,检查接口使用的token权限 API权限不足,检查接口使用的token权限;管理类API的操作权限需要帐号的管理员权限。 400 DOMAIN.000014 Request
取值范围:4~253个字符。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户IAM-Token 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 exist Boolean 是否包含敏感词。
/v2/domains/actions/renew 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户IAM-Token 表2 请求Body参数 参数 是否必选 参数类型 描述 domain_name 是 String 域名名称,只允许输入1个域名,且包括前缀和后缀。
n-availability 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户IAM-Token 表2 请求Body参数 参数 是否必选 参数类型 描述 domain_name 是 String 域名名称,只允许输入1个域名,且包括前缀和后缀。
任务编号,长度不超过64个字符。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户IAM-Token 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 total Integer 任务总数 domain_tasks
取值范围:4~253个字符。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户IAM-Token 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 domain_name String 域名名称
-change-status 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户IAM-Token 表2 请求Query参数 参数 是否必选 参数类型 描述 domain_name 是 String 域名名称,只允许输入1个域名,且包括前缀和后缀。
域名注册 注册域名 父主题: API
域名管理 续费域名 修改域名DNS 域名过户 父主题: API