You need to enable JavaScript to run this app.
TrafficRoute DNS Suite

TrafficRoute DNS Suite

  • Documentation
    • TrafficRoute DNS SuiteVolcanoEngine PrivateZoneAPI ReferenceDNS Record APIsBatchUpdateRecord
Copy page
Download PDF
DNS Record APIs
BatchUpdateRecord
Copy page
Download PDF
BatchUpdateRecord

Updates one or multiple DNS records for a domain. You can update up to 500 DNS records per API call.

Usage

  • Rate limit: 5 calls per second.

Request

  • Method: POST
  • URL: https://private-zone.volcengineapi.com/?Action=BatchUpdateRecord?Version=2022-06-01

Request parameters

In addition to the following parameters, you also need to include the authentication parameters.

Query

Name
Type
Required
Example
Description
Action
String
Yes
BatchUpdateRecord
The name of the API. The value of this parameter is BatchUpdateRecord.
Version
String
Yes
2022-06-01
The version of the API. The value of this parameter is 2022-06-01.

Body

Name
Type
Required
Example
Description
ZID
Integer
Yes
1234
The unique ID that identifies the domain. You can obtain this through the following APIs:
  • CreatePrivateZone API
  • ListPrivateZones API
Records
Array of Objects
Yes
DNS records. Must not exceed 500 DNS records.

Response parameters

ResponseMetadata object

Name
Type
Description
RequestId
String
The ID that identifies this request.
Action
String
The value of the Action query parameter.
Version
String
The API version.
Service
String
The service type.
Region
String
The region where the service is located.

Example

Request example 

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

{
    "ZID": 1135,
    "Records": [
        {
            "RecordID": "9079256848778957938",
            "Enable": true,
            "Host": "www",
            "Value": "10.0.0.1",
            "Type": "A",
            "Weight": 10,
            "TTL": 600,
            "Line": "default",
            "Remark": ""
        }
    ]
}

Response example 

{
    "ResponseMetadata": {
        "RequestId": "20221216114649153461BC0A9F2BEA40CF",
        "Action": "BatchUpdateRecord",
        "Version": "2022-06-01",
        "Service": "private_zone",
        "Region": "cn-beijing"
    }
}

Common error codes

Refer to Common Error Codes.

Last updated: 2025.11.04 20:47:31