文档首页/ 云解析服务 DNS/ API参考/ API/ 批量操作/ 批量转移公网域名 - BatchTransferPublicZonesTask
更新时间:2025-11-14 GMT+08:00
分享

批量转移公网域名 - BatchTransferPublicZonesTask

功能介绍

提交批量转移公网域名任务,返回任务ID。

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

接口约束

仅支持公网域名。

每个任务最多支持1000个域名。

调用方法

请参见如何调用API

授权信息

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

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

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    dns:zone:transfer

    Write

    zone *

    • g:ResourceTag/<tag-key>

    • g:EnterpriseProjectId

    -

    -

URI

POST /v2.1/operation-task/batch-transfer

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

zone_names

Array of strings

参数解释:

域名。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

target_user

String

参数解释:

对方账号ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:202

表2 响应Body参数

参数

参数类型

描述

task_id

String

参数解释:

批量操作任务的ID。

取值范围:

不涉及。

请求示例

批量转移公网域名。

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

{
  "zone_names" : [ "example.com." ],
  "target_user" : "a36017bd3e1e46b4bdf2d0c743ff6e3e"
}

响应示例

状态码:202

批量创建记录集响应。

{
  "task_id" : "7a820bba45f04abba75f9f82525fb11"
}

状态码

状态码

描述

202

批量创建记录集响应。

错误码

请参见错误码

相关文档