检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 云解析服务提供自研的REST接口。 通过使用云解析服务的接口,您可以完整的使用云解析服务的所有功能,包括对公网域名、内网域名、记录集等资源的创建、查询、修改和删除。 云解析服务提供的具体API如表1所示。 表1 接口说明 子类型 说明 版本管理 DNS API的版本查
创建线路分组 功能介绍 创建一个线路分组。 该接口部分区域未上线、如需使用请提交工单申请开通。 调用方法 请参见如何调用API。 URI POST /v2.1/linegroups 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是
更新线路分组 功能介绍 更新单个线路分组。该接口部分区域未上线、如需使用请提交工单申请开通。 调用方法 请参见如何调用API。 URI PUT /v2.1/linegroups/{linegroup_id} 表1 路径参数 参数 是否必选 参数类型 描述 linegroup_id
修改单个内网Zone 功能介绍 修改单个内网Zone 调用方法 请参见如何调用API。 URI PATCH /v2/zones/{zone_id} 表1 路径参数 参数 是否必选 参数类型 描述 zone_id 是 String 待修改Zone的ID。 请求参数 表2 请求Header参数
修改单个公网Zone 功能介绍 修改单个公网Zone 调用方法 请参见如何调用API。 URI PATCH /v2/zones/{zone_id} 表1 路径参数 参数 是否必选 参数类型 描述 zone_id 是 String 待修改zone的ID 请求参数 表2 请求Header参数
批量修改RecordSet 功能介绍 批量修改RecordSet。属于原子性操作,请求Record Set将全部完成修改,或不做任何修改。 仅公网Zone支持。 调用方法 请参见如何调用API。 URI PUT /v2.1/zones/{zone_id}/recordsets 表1
创建单个公网Zone 功能介绍 创建单个公网Zone 调用方法 请参见如何调用API。 URI POST /v2/zones 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取
修改单个Record Set 功能介绍 修改单个Record Set 调用方法 请参见如何调用API。 URI PUT /v2/zones/{zone_id}/recordsets/{recordset_id} 表1 路径参数 参数 是否必选 参数类型 描述 zone_id 是 String
修改单个Record Set 功能介绍 修改单个Record Set 调用方法 请参见如何调用API。 URI PUT /v2.1/zones/{zone_id}/recordsets/{recordset_id} 表1 路径参数 参数 是否必选 参数类型 描述 zone_id 是
设置子域名递归解析 操作场景 内网域名支持设置递归解析代理功能。 开启该功能后,如果请求的子域名没有配置解析记录,DNS服务不会直接返回nxdomain(解析记录不存在),而是会把请求转发到互联网解析再返回结果。 约束与限制 内网递归暂不支持递归判断解析器转发规则。 内网域名的子域名递归解析示例
批量线路创建RecordSet 功能介绍 批量线路创建RecordSet。属于原子性操作,如果存在一个参数校验不通过,则创建失败。仅公网Zone支持。 调用方法 请参见如何调用API。 URI POST /v2.1/zones/{zone_id}/recordsets/batch/lines
创建单个内网Zone 功能介绍 创建单个内网Zone 调用方法 请参见如何调用API。 URI POST /v2/zones 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取
创建单个Record Set 功能介绍 创建单个Record Set,仅适用于公网DNS 调用方法 请参见如何调用API。 URI POST /v2.1/zones/{zone_id}/recordsets 表1 路径参数 参数 是否必选 参数类型 描述 zone_id 是 String
查询线路分组列表 功能介绍 查询线路分组列表。该接口部分区域未上线、如需使用请提交工单申请开通。 调用方法 请参见如何调用API。 URI GET /v2.1/linegroups 表1 Query参数 参数 是否必选 参数类型 描述 line_id 否 String 线路分组ID。
示例2:创建内网域名解析 场景描述 如果用户想要使云服务能够不经过公网,直接使用内网域名访问云服务器,可以通过DNS为云服务器创建一个内网域名,并为该域名添加A类型记录集。 下面介绍如何通过调用创建单个内网Zone和创建单个Record Set接口创建内网域名和添加记录集。API的调用方法请参见如何调用API。
返回结果 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请
删除线路分组 功能介绍 删除单个线路分组。该接口部分区域未上线、如需使用请提交工单申请开通。 调用方法 请参见如何调用API。 URI DELETE /v2.1/linegroups/{linegroup_id} 表1 路径参数 参数 是否必选 参数类型 描述 linegroup_id
查询线路分组 功能介绍 查询线路分组。该接口部分区域未上线、如需使用请提交工单申请开通。 调用方法 请参见如何调用API。 URI GET /v2.1/linegroups/{linegroup_id} 表1 路径参数 参数 是否必选 参数类型 描述 linegroup_id 是
批量删除Zone 功能介绍 批量删除Zone。 本接口为原子操作,所有记录应全部删除成功或全部失败。 仅支持公网Zone、内网Zone。 调用方法 请参见如何调用API。 URI DELETE /v2.1/zones 请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述
批量设置Zone状态 功能介绍 批量设置Zone状态。 响应结果中只包含本次实际更新的Zone。 仅支持公网Zone、内网Zone。 调用方法 请参见如何调用API。 URI PUT /v2.1/zones/statuses 请求参数 表1 请求Body参数 参数 是否必选 参数类型