创建域名解析记录集 - CreateRecordSet
功能介绍
创建域名解析记录集
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
POST /v1/traffic/recordsets
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
否 |
String |
身份认证信息，调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值 |
|
X-Zone-Project-ID |
是 |
String |
项目ID |
|
X-Zone-ID |
是 |
String |
DNS区域ID |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
[数组元素] |
是 |
Array of CreateRecordSetRequestBody objects |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
是 |
String |
域名，后缀需以zone name结束且为FQDN（即以“.”号结束的完整主机名） |
|
ttl |
是 |
Integer |
解析记录在本地DNS服务器的缓存时间，缓存时间越长更新生效越慢，以秒为单位 |
|
records |
否 |
Array of strings |
解析记录的值，不同类型解析记录对应的值的规则不同，必须是合法IP信息 |
|
line |
是 |
String |
解析线路ID |
|
weight |
否 |
Integer |
解析记录的权重 |
|
type |
否 |
String |
Record Set的类型， 取值范围：A、CNAME |
响应参数
状态码：201
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
[数组元素] |
Array of RecordSet objects |
DNS记录集合。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
- |
String |
状态码：500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
- |
String |
请求示例
创建域名解析记录集
PUT 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
} ]
状态码
|
状态码 |
描述 |
|---|---|
|
201 |
返回创建的域名解析记录集 |
|
400 |
客户端请求错误，服务器无法执行请求 |
|
500 |
服务器内部错误 |
错误码
请参见错误码。
