批量创建记录集 - BatchCreateRecordSetsTask
功能介绍
提交批量创建记录集任务，返回任务ID。
接口约束
支持公网域名和内网域名。
每个任务最多支持2000条记录集。
同一个域名下只允许存在一个任务。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
URI
POST /v2.1/zones/{zone_id}/recordsets/batch-create-task
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
zone_id |
是 |
String |
参数解释： 域名ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
recordsets |
是 |
Array of BatchCreateRecordSetsTaskItem objects |
批量创建记录集列表。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
否 |
String |
参数解释： 主机记录或域名。 末尾有点则认为是完整域名，如果不包含点，则认为是域名前缀。例如： 输入"www"，创建成功后域名显示为"www.example.com." 输入"www.example.com."（注意域名末尾有点），创建成功后域名显示为"www.example.com." 输入"www.example.com"（注意域名末尾没有点），创建成功后域名显示为"www.example.com.example.com." 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
|
type |
是 |
String |
参数解释： 记录集的类型。 约束限制： 不涉及。 取值范围：
默认取值： 不涉及。 |
|
line |
否 |
String |
参数解释： 解析线路ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
|
ttl |
否 |
Integer |
参数解释： 解析记录在本地DNS服务器的缓存时间，缓存时间越长更新生效越慢，以秒为单位。 约束限制： 不涉及。 取值范围： 1~2147483647。 默认取值： 300 |
|
weight |
否 |
Integer |
参数解释： 解析记录的权重。 约束限制： MX记录集不支持权重，创建时会忽略权重字段，如果您的MX记录集有多个值，在一条记录集里写多个值即可。(若存在多条同主机记录、同线路类型的MX记录，会自动合并为一条创建) 取值范围： 0~1000。 默认取值： 不涉及。 |
|
records |
是 |
Array of strings |
参数解释： 解析记录的值。不同类型解析记录对应的值的规则不同。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
|
status |
否 |
String |
参数解释： 解析记录的状态。 约束限制： 不涉及。 取值范围：
默认取值： ENABLE。 |
|
description |
否 |
String |
参数解释： 记录集的描述信息。 约束限制： 不涉及。 取值范围： 长度不超过255个字符。 默认取值： 不涉及。 |
响应参数
状态码：202
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
task_id |
String |
参数解释： 批量创建记录集任务的ID。 取值范围： 不涉及。 |
请求示例
批量创建记录集。
POST https://{endpoint}/v2.1/zones/{zone_id}/recordsets/batch-create-task
{
"recordsets" : [ {
"name" : "www.example.com.",
"type" : "A",
"line" : "default_view",
"ttl" : 300,
"weight" : 1,
"records" : [ "192.168.10.1", "192.168.10.2" ],
"status" : "ENABLE",
"description" : "This is an example record set."
} ]
}
响应示例
状态码：202
批量创建记录集响应。
{
"task_id" : "9a186e66977dd48f01977e021c480cac"
}
状态码
|
状态码 |
描述 |
|---|---|
|
202 |
批量创建记录集响应。 |
错误码
请参见错误码。
