为一个域名批量添加一条或多条解析记录。每次最多添加 500 条解析记录。
请求频率:每秒最多调用 10 次。
除了以下参数,您还需要 对请求进行鉴权。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
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 | [ | 标识解析记录的唯一 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 | 未找到域名 |
400 | ErrParamInvalid | 参数校验失败 |
400 | ErrQuotaExceeded | [%s] 超出限额 [%d] |
400 | ErrDBDuplicated | 存在重复的解析记录 |
400 | ErrIdempotentParameterMismatch | 幂等请求参数不一致 |
400 | ErrIdempotentRequestInProgress | 上一次幂等请求还没结束,请稍后重试 |
500 | ErrInternalServer | 服务内部错误 |