文档首页/ 云解析服务 DNS/ API参考/ API/ 批量操作/ 批量修改公网记录集 - BatchUpdatePublicRecordsetsTask
更新时间：2025-11-14 GMT+08:00
在线调试
CLI示例
查看PDF
分享

批量修改公网记录集 - BatchUpdatePublicRecordsetsTask

功能介绍

提交批量修改公网记录集任务，返回任务ID。

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

接口约束

仅支持公网域名。

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

调用方法

请参见如何调用API。

授权信息

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

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

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    dns:recordset:batchUpdatePublicZoneRecordsets

    Write

    -

    -

    -

    dns:recordset:update

URI

POST /v2.1/operation-task/batch-update-recordset

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

zone_names

是

Array of strings

参数解释：

托管该记录的域名。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

filter

是

BatchUpdatePublicRecordsetsFilter object

参数解释：

过滤条件。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

update_info

是

BatchUpdatePublicRecordsetsUpdateValue object

参数解释：

待修改的信息。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表2 BatchUpdatePublicRecordsetsFilter

参数

是否必选

参数类型

描述

relation

是

String

参数解释：

过滤条件之间的关系。

约束限制：

不涉及。

取值范围：

  • OR：或

  • AND：与

默认取值：

不涉及。

conditions

是

Array of BatchUpdatePublicRecordsetsConditionvalue objects

参数解释：

条件列表。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表3 BatchUpdatePublicRecordsetsConditionvalue

参数

是否必选

参数类型

描述

condition

是

String

参数解释：

条件信息的键。

约束限制：

不涉及。

取值范围：

  • host_name：主机记录。

默认取值：

不涉及。

value

否

String

参数解释：

条件信息的值。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表4 BatchUpdatePublicRecordsetsUpdateValue

参数

是否必选

参数类型

描述

key

是

String

参数解释：

待修改信息的键。

约束限制：

不涉及。

取值范围：

  • host_name：主机记录。

  • rr_value: 记录值。

默认取值：

不涉及。

values

是

Array of strings

参数解释：

待修改信息的值。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码：202

表5 响应Body参数

参数

参数类型

描述

task_id

String

参数解释：

批量操作任务的ID。

取值范围：

不涉及。

请求示例

批量修改公网记录集。

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

{
  "zone_names" : [ "example.com." ],
  "filter" : {
    "relation" : "OR",
    "conditions" : [ {
      "condition" : "host_name",
      "value" : "www"
    } ]
  },
  "update_info" : {
    "key" : "host_name",
    "values" : [ "www", "api" ]
  }
}

响应示例

状态码：202

批量修改公网记录集响应。

{
  "task_id" : "7a820bba45f04abba75f9f82525fb11"
}

状态码

状态码

描述

202

批量修改公网记录集响应。

错误码

请参见错误码。

父主题： 批量操作

相关文档