创建域名解析记录集 - CreateRecordSet

功能介绍

创建域名解析记录集

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /v1/traffic/recordsets

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	否	String	身份认证信息，调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值
X-Zone-Project-ID	是	String	项目ID
X-Zone-ID	是	String	DNS区域ID
Content-Type	是	String	消息体的类型（格式），仅支持application/json

表2 请求Body参数
参数	是否必选	参数类型	描述
[数组元素]	是	Array of CreateRecordSetRequestBody objects	-

表3 CreateRecordSetRequestBody
参数	是否必选	参数类型	描述
name	是	String	域名，后缀需以zone name结束且为FQDN（即以“.”号结束的完整主机名）
ttl	是	Integer	解析记录在本地DNS服务器的缓存时间，缓存时间越长更新生效越慢，以秒为单位
records	否	Array of strings	解析记录的值，不同类型解析记录对应的值的规则不同
line	是	String	解析线路ID
weight	否	Integer	解析记录的权重
type	否	String	Record Set的类型，取值范围：A、CNAME

响应参数

状态码：201

表4 响应Body参数
参数	参数类型	描述
[数组元素]	Array of RecordSet objects	DNS记录集合。

表5 RecordSet
参数	参数类型	描述
id	String	记录集id
description	String	描述信息
zone_id	String	可用区id
zone_name	String	可用区名称
type	String	记录类型
project_id	String	项目id
name	String	记录集名称
ttl	Integer	生存时间
records	Array of strings	记录信息
weight	Integer	比例
line	String	解析线路ID
create_at	String	创建时间
update_at	String	更新时间
default	Boolean	是否为默认记录集合

状态码：400

表6 响应Body参数
参数	参数类型	描述
-	String	-

状态码：500

表7 响应Body参数
参数	参数类型	描述
-	String	-

请求示例

创建域名解析记录集

POST https://ucs.myhuaweicloud.com/v1/traffic/recordsets

[ {
  "name" : "xxx.test1110.com.",
  "type" : "A",
  "ttl" : 300,
  "records" : [ "172.18.0.200" ],
  "line" : "default_view",
  "weight" : 1
} ]

响应示例

状态码：201

返回创建的域名解析记录集

[ {
  "id" : "ff80808299859ea0019a6da52d3e7bb3",
  "name" : "xxx.test1110.com.",
  "description" : "",
  "zone_id" : "ff80808299859ea0019a6d1206716694",
  "zone_name" : "test1110.com.",
  "type" : "A",
  "ttl" : 300,
  "records" : [ "172.18.0.200" ],
  "create_at" : "",
  "update_at" : "",
  "default" : false,
  "project_id" : "05495693df80d3c92fa1c01795c2be02",
  "weight" : 1,
  "line" : "default_view",
  "tags" : null
} ]