文档首页/ 云解析服务 DNS/ API参考/ API/ 批量操作/ 批量创建公网记录集 - BatchCreateCombinedPublicRecordsetsTask
更新时间:2025-11-14 GMT+08:00
分享

批量创建公网记录集 - BatchCreateCombinedPublicRecordsetsTask

功能介绍

提交批量创建公网记录集任务,返回任务ID。

公网域名为全局资源,请选择“华北-北京四(cn-north-4)”区域调用。

接口约束

仅支持公网域名。

每个任务最多支持10000个记录集。

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    dns:recordset:batchCreatePublicZoneRecordsets

    Write

    -

    -

    • dns:recordset:batchImportPublicRecordSet
    • dns:recordset:create
    • dns:quota:list

URI

POST /v2.1/operation-task/batch-create-combined-recordset

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

zone_names

Array of strings

参数解释:

托管该记录的域名。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

recordset_name_prefixes

Array of strings

参数解释:

主机记录。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

records

Array of strings

参数解释:

解析记录的值。不同类型解析记录对应的值的规则不同。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

type

String

参数解释:

记录集的类型。

约束限制:

不涉及。

取值范围:

  • 公网域名的记录类型: A、CNAME、MX、AAAA、TXT、SRV、NS、CAA。

默认取值:

不涉及。

line

String

参数解释:

解析线路ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

default_view。

ttl

Integer

参数解释:

解析记录在本地DNS服务器的缓存时间,缓存时间越长更新生效越慢,以秒为单位。

约束限制:

不涉及。

取值范围:

1~2147483647。

默认取值:

300

响应参数

状态码:202

表2 响应Body参数

参数

参数类型

描述

task_id

String

参数解释:

批量操作任务的ID。

取值范围:

不涉及。

请求示例

批量创建公网记录集。

POST https://{endpoint}/v2.1/operation-task/batch-create-combined-recordset

{
  "zone_names" : [ "example.com." ],
  "recordset_name_prefixes" : [ "www" ],
  "records" : [ "192.168.10.1", "192.168.10.2" ],
  "type" : "A",
  "line" : "default_view",
  "ttl" : 300
}

响应示例

状态码:202

批量创建公网记录集响应。

{
  "task_id" : "7a820bba45f04abba75f9f82525fb11"
}

状态码

状态码

描述

202

批量创建公网记录集响应。

错误码

请参见错误码

相关文档