批量修改记录集
功能介绍
批量修改记录集。属于原子性操作，请求记录集将全部完成修改，或不做任何修改。
仅公网域名支持。
调用方法
请参见如何调用API。
URI
PUT /v2.1/zones/{zone_id}/recordsets
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
zone_id |
是 |
String |
域名ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
recordsets |
是 |
Array of BatchUpdateRecordSet objects |
记录集列表。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
id |
是 |
String |
记录集资源ID。 |
|
description |
否 |
String |
记录集资源描述。 |
|
ttl |
否 |
Integer |
记录集的有效缓存时间，以秒为单位。 取值范围：300-2147483647。 默认值为300s。 |
|
weight |
否 |
Integer |
解析记录的权重，默认为null。 当weight=null时，表示该解析记录不设置权重。 当weight=0，表示备用域名解析记录。 当weight>0，表示主用域名解析记录。 取值范围：0~100 在相同域名、类型、线路下的解析记录，规则如下： 全部设置权重，或全部不设置权重。 当不设置权重时，只能创建一个解析记录。 当设置权重时，最多能创建20个解析记录。 |
|
records |
是 |
Array of strings |
解析记录的值。不同类型解析记录对应的值的规则不同。 |
响应参数
状态码：202
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
links |
pageLink object |
指向当前资源或者其他资源的链接。当查询需要分页时，需要包含一个next链接指向下一页。 |
|
recordsets |
Array of QueryRecordSetWithLineResp objects |
记录集的列表信息。 |
|
metadata |
metadata object |
返回满足过滤条件的资源总数。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
记录集的ID。 |
|
name |
String |
记录集的名称。 |
|
description |
String |
记录集的描述信息。 |
|
zone_id |
String |
托管该记录的域名ID。 |
|
zone_name |
String |
托管该记录的域名。 |
|
type |
String |
记录类型。 |
|
ttl |
Integer |
解析记录在本地DNS服务器的缓存时间，缓存时间越长更新生效越慢，以秒为单位。 |
|
records |
Array of strings |
域名解析后的值。 |
|
created_at |
String |
创建时间。 格式：yyyy-MM-dd'T'HH:mm:ss.SSS。 |
|
updated_at |
String |
更新时间。 格式：yyyy-MM-dd'T'HH:mm:ss.SSS。 |
|
status |
String |
资源状态。 |
|
default |
Boolean |
标识是否由系统默认生成，系统默认生成的记录集不能删除。 |
|
project_id |
String |
该记录集所属的项目ID。 |
|
links |
pageLink object |
指向当前资源或者其他资源的链接。当查询需要分页时，需要包含一个next链接指向下一页。 |
|
line |
String |
解析线路ID。 |
|
weight |
Integer |
解析记录的权重。 |
|
health_check_id |
String |
健康检查ID。 |
|
alias_target |
alias_target object |
别名记录。 |
|
bundle |
String |
规格，默认规格，保留字段。 |
请求示例
批量修改解析记录，设置ID"2c9eb155587194ec01587224c9f9014a"的记录集TTL为3600秒，解析记录值为"192.168.10.1"、 "192.168.10.2"，权重为10；设置ID"2c9eb155587194ec01587224c9f9014c"的记录集TTL为300秒，解析记录值为"fe80:0:0:0:202:b3ff:fe1e:8329"、 "ff03:0db8:85a3:0:0:8a2e:0370:7334" ，权重为5。
PUT https://{endpoint}/v2.1/zones/{zone_id}/recordsets
{
"recordsets" : [ {
"id" : "2c9eb155587194ec01587224c9f9014a",
"description" : "This is an type A record set.",
"ttl" : 3600,
"weight" : 10,
"records" : [ "192.168.10.1", "192.168.10.2" ]
}, {
"id" : "2c9eb155587194ec01587224c9f9014c",
"description" : "This is an type AAAA record set.",
"ttl" : 300,
"weight" : 5,
"records" : [ "fe80:0:0:0:202:b3ff:fe1e:8329", "ff03:0db8:85a3:0:0:8a2e:0370:7334" ]
} ]
}响应示例
状态码：202
批量修改记录集响应。
{
"links" : {
"self" : "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/batch/lines"
},
"recordsets" : [ {
"id" : "2c9eb155587228570158722b6ac30007",
"name" : "www.example.com.",
"description" : "This is an example record set.",
"type" : "A",
"ttl" : 300,
"records" : [ "192.168.10.2", "192.168.10.1" ],
"status" : "PENDING_CREATE",
"links" : {
"self" : "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587228570158722b6ac30007"
},
"zone_id" : "2c9eb155587194ec01587224c9f90149",
"zone_name" : "example.com.",
"created_at" : "2016-11-17T12:03:17.827",
"updated_at" : null,
"health_check_id" : "e55c6f3dc4e34c8e86353b664ae0e89f",
"default" : false,
"project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c",
"line" : "default_view",
"weight" : 0
}, {
"id" : "2c9eb155587228570158722b6ac30008",
"name" : "www.example.com.",
"description" : "This is an example record set.",
"type" : "A",
"ttl" : 300,
"records" : [ "192.168.10.2", "192.168.10.1" ],
"status" : "PENDING_CREATE",
"links" : {
"self" : "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587228570158722b6ac30008"
},
"zone_id" : "2c9eb155587194ec01587224c9f90149",
"zone_name" : "example.com.",
"created_at" : "2016-11-17T12:03:17.827",
"updated_at" : null,
"health_check_id" : "e55c6f3dc4e34c8e86353b664ae0e89c",
"default" : false,
"project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c",
"line" : "Abroad",
"weight" : 0
} ],
"metadata" : {
"total_count" : 2
}
}状态码
|
状态码 |
描述 |
|---|---|
|
202 |
批量修改记录集响应。 |
错误码
请参见错误码。
