为一个域名批量更新一条或多条解析记录。每次最多更新 500 条解析记录。
请求频率:每秒最多调用 5 次。
除了以下参数,您还需要 对请求进行鉴权。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | BatchUpdateRecord | 要执行的操作,取值:BatchUpdateRecord。 |
Version | String | 是 | 2022-06-01 | API的版本,取值:2022-06-01。 |
ZID | Long | 是 | 1234 | 域名 ID。您可以通过以下 API 获取: |
Records | Array of Object | 是 | 无 | 解析记录。最多不超过 500 条。 |
本接口无特有的返回参数。更多信息请见返回结构。
POST https://private-zone.volcengineapi.com/?Action=BatchUpdateRecord&Version=2022-06-01 { "ZID": 1135, "Records": [ { "RecordID": "9079256848778957938", "Enable": true, "Host": "www", "Value": "1.1.1.1", "Type": "A", "Weight": 10, "TTL": 600, "Line": "default", "Remark": "" } ] }
{ "ResponseMetadata": { "RequestId": "20221216114649153461BC0A9F2BEA40CF", "Action": "BatchUpdateRecord", "Version": "2022-06-01", "Service": "private_zone", "Region": "cn" } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | ErrParamInvalid | validation fail: params:[%s] , value:[%v] | 参数校验失败 |
400 | ErrDBDuplicated | duplicate | 存在重复的解析记录 |
400 | ErrDBNotFound | db not found | 数据条目未找到 |
400 | ErrZoneNotFound | zone not found | 未找到域名 |
500 | ErrInternalServer | server internal error | 服务内部错误 |