You need to enable JavaScript to run this app.
导航
BatchCreateRecord - 批量新增解析记录
最近更新时间:2025.05.22 20:04:21首次发布时间:2023.02.08 13:12:35
我的收藏
有用
有用
无用
无用

为一个域名批量添加一条或多条解析记录。每次最多添加 500 条解析记录。

使用说明

请求频率:每秒最多调用 10 次。

请求说明

  • 请求方式:POST
  • 请求地址:https://private-zone.volcengineapi.com/?Action=BatchCreateRecord?Version=2022-06-01

调试

请求参数

除了以下参数,您还需要 对请求进行鉴权

参数
类型
是否必填
示例值
描述
Action
String

BatchCreateRecord

要执行的操作,取值:BatchCreateRecord。

Version
String

2022-06-01

API的版本,取值:2022-06-01。

ZID
Long

1234

域名 ID。您可以通过以下 API 获取:

Records
Array of Object

解析记录。最多不超过 500 条。

ClientToken
String

123456abcdef

用于确保请求的幂等性。如果您设置了该参数,在相同的请求参数下,无论该 API 被调用多少次,返回的结果都是相同的。该参数仅允许 ASCII 字符且不能超过 64 个字符。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数
类型
示例值
描述
RecordIDs
Array of String

[
"9079256848778957743"
]

标识解析记录的唯一 ID。返回顺序与请求正文中的解析记录顺序相同。

请求示例

POST https://private-zone.volcengineapi.com/?Action=BatchCreateRecord&Version=2022-06-01

{
    "ZID": 1135,
    "Records":[
        {
            "Host": "def",
            "Value": "1.1.1.1",
            "Type": "A",
            "Weight": 10,
            "TTL": 600,
            "Line": "default",
            "Remark":""
        }
    ]

}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20221215223926E250179DD989831E599C",
        "Action": "BatchCreateRecord",
        "Version": "2022-06-01",
        "Service": "private_zone",
        "Region": "cn"
    },
    "Result": {
        "RecordIDs": [
            "9079256848778957743"
        ]
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
400
ErrZoneNotFound

zone not found

未找到域名

400
ErrParamInvalid

validation fail: params:[%s] , value:[%v]

参数校验失败

400
ErrQuotaExceeded

[%s] exceeds quota [%d]

[%s] 超出限额 [%d]

400
ErrDBDuplicated

duplicate

存在重复的解析记录

400
ErrIdempotentParameterMismatch

Arguments on this idempotent request are inconsistent with arguments used in previous request(s)

幂等请求参数不一致

400
ErrIdempotentRequestInProgress

last idempotent request is in progress, please try later

上一次幂等请求还没结束,请稍后重试

500
ErrInternalServer

server internal error

服务内部错误