TrafficRoute DNS Suite
TrafficRoute DNS Suite
TrafficRoute DNS Suite
Document
Product Billing
VolcanoEngine DNS
Getting Started
Activate VolcanoEngine DNS And Add a Domain
Route User Requests to a Website Server
Set up an Email Address
Route User Requests to CDN
User Guide
Configure DNS servers provided by DNS for a Domain
Domain Management
DNS Record Management
Load Balancing
Import or Export DNS Records
Batch Operation
Line Group Management
Access Log Management
Value-added Services
API reference
Record Set APIs
Line APIs
DNS Query Metrics APIs
IP-based Line APIs
SDK Reference
IP-based Line Management
Legal
VolcanoEngine GTM
Getting Started
User Guide
GTM Instance Management
Policy Management
Rule Management
Software-defined parsing for AnyMatch
Pool Management
Alarms and Notifications
Statistics and Analysis
Health Check
Route analysis
API Reference
GTM instance management
Policy Management
Health Check Management
Pool Management
Rule Management
Load Feedback Management
Best Practices
FAQs
VolcanoEngine PrivateZone
Product Overview
Getting Started
User Guide
Domain Management
Authoritative domain management for cloud products
Record Management
ECS Hostname Records Management
Import or Export DNS Records
Advanced DNS
Resolver
Forward DNS Requests to An External DNS Server
Forward DNS Requests From On-premise IDC/Third-party Cloud Services to Resolver
Access Log Management
DNS Query M.etrics
Best Practices
Use the DNS Cache Plugin to Improve Availability
API Reference
Domain APIs
DNS Record APIs
Record Set APIs
Cross-account VPC Association APIs
Resolver APIs
ECS Hostname Synchronization APIs
Cross-account resource sharing
SDK Reference
VolcanoEngine HTTPDNS
Getting Started
User Guide
Custom domain resolution
Software-defined parsing: AnyMatch
Access log management
Use the DoH protocol
API Reference
Account management APIs
Key management interface
Domain name management interface
Custom parsing management interface
Encrypted DNS management interface
Client development guide
Use the client SDK
Integrate SDKs
Android SDK
iOS SDK
API Reference
Android SDK
HttpDNS class
Method
iOS SDK
TTDnsResolver class
Attribute
Method
VolcanoEngine PublicDNS
Getting Started
Troubleshooting Guide
- Documentation
TrafficRoute DNS SuiteVolcanoEngine DNSAPI referenceIP-based Line APIsUpdateCustomLine
Copy page
Download PDFIP-based Line APIs
UpdateCustomLine
Copy pageDownload PDFUpdateCustomLine
Update an IP-based line.
Usage
Request frequency: Maximum of 1 call per second.
Request
- Request method: POST
- Request address: https://dns.volcengineapi.com/?Action=UpdateCustomLine&Version=2018-08-01
Debugging
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
Request parameters
Parameters | Type | Required or optional | Example value | Description |
Action | String | Is | UpdateCustomLine | The operation to be performed; the value is UpdateCustomLine. |
Version | String | Is | 2018-08-01 | API version. Value: 2018-08-01. |
Line | String | Is | custom-2811 | ID of the IP-based line. You can obtain the ID of the IP-based line via the Line parameter returned by the ListCustomLines API. |
NameCN | String | No | IP-based line 1 | The name of the IP-based line. UTF-8 format. The maximum length is 32 UTF-8 characters. If you do not set this parameter, its value remains unchanged. |
IPSegments | Array of String | No | 192.168.1.0/24 | One or more CIDR blocks of IP-based lines. Supports IPv4 addresses and IPv6 addresses. For example, 192.168.1.0/24 or 2001:db8::/103. If you do not set this parameter, the value of this parameter remains unchanged. |
Remark | String | No | Remark | Remark of the IP-based line. UTF-8 format. The maximum length is 64 UTF-8 characters. If you do not set this parameter, the value of the parameter remains unchanged. |
Response parameters
The following table lists only the response parameters specific to this interface. For more information, see Return structure.
Parameters | Type | Example value | Description |
Line | String | custom-5040 | ID of the IP-based line. |
Request example
POST /?Action=UpdateCustomLine&Version=2018-08-01 HTTP/1.1
Host: dns.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20240909T090144Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240909/cn-beijing/dns/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f
{
"Line": "custom-5040",
"NameCN": "customline002",
"Remark": "create a line",
"IPSegments": [
"1.0.0.0/24",
"10.0.0.0/8"
]
}
Response example
{
"ResponseMetadata": {
"RequestId": "20240909170154149209002136B8B4E4",
"Action": "UpdateCustomLine",
"Version": "2018-08-01",
"Service": "dns",
"Region": "cn-beijing"
},
"Result": {
"Line": "custom-5040"
}
}
Common error codes
The following table lists the error codes related to this interface and its business logic. Please refer to the public error codes document.
Status codes | error codes | Error message | Note |
400 | ErrParsingParams | parsing params error | Failed to parse request. |
400 | ErrParamInvalid | validation fail:%s | Parameter validation failed. |
400 | ErrDBNotFound | record not found :%s | Database entry not found. |
500 | ErrInternalServer | server internal error | Internal service error. |
Last updated: 2025.11.10 22:36:58
All rights reserved © Beijing Volcano Engine Technology Co., Ltd2024
