1. Interface Description
Interface request domain name: vpcdns.api3.convergecloud.com.
API for creating VPC DNS records
Default interface request rate limit: 20 times per second.
Interface update time: 2025-06-24 04:39:04.
The interface only verifies the signature but does not authenticate.
2. Input Parameters
The following list of request parameters only lists interface request parameters and some public parameters, For a complete list of public parameters see public request parameters.
| Parameter name | Required | Allow NULL | Type | Description |
|---|---|---|---|---|
| Action | Yes | No | String | Public parameter, The value of this interface: CreateVpcDnsRecord |
| Version | Yes | No | String | Public parameter, The value of this interface: 2019-10-25 |
| Region | No | No | String | Public parameter,Regional information This interface does not need to pass this parameter. |
| DomainId | Yes | No | Uint64 | The domain name ID. Example: 3 |
| SubDomain | Yes | No | String | The subdomain name. Example: www |
| RecordType | Yes | No | String | Record types: A, AAAA, MX, CNAME, TXT, PTR, SRV, SPF Example: A |
| Value | Yes | No | String | The record value. Example: 1.1.1.1 |
| Mx | No | No | Uint64 | The MX priority. Example: 45 |
| Weight | No | No | String | Weight. Example: 100 |
3. Output Parameters
| Parameter name | Type | Description |
|---|---|---|
| CreatedAt | Datetime | The return time of the creation request. Example: 2014-08-03 12:00:00 |
| Data | RecordId | Record ID. Example:View |
| RequestId | String | Unique request id, Each request will return. The RequestId of the request needs to be provided when locating the problem. |
4. Error Code
The following lists only the error codes related to the interface business logic, For other error codes, see public ErrorCode.
| Error Code | Description |
|---|---|
| InvalidParameter.IllegalPTRRecord | Invalid PTR record. |
| InvalidParameterValue.RecordAAAACountExceed | The number of AAAA records for CLB exceeds 50. |
| InternalError.UndefiendError | Undefined error. |
| InvalidParameter.IllegalRecordValue | Invalid record value. |
| InvalidParameterValue.CnameNotPrivateZone | You can only use CNAMEs to point to the private domains under the current account. |
| InvalidParameterValue.RecordExist | Record already exists. |
| InvalidParameter.IllegalRecord | Invalid records. |
| InvalidParameterValue.RecordUnsupportWeight | The current record type does not support the weight. |
| FailedOperation.CreateRecordFailed | Failed to create the record. |
| InvalidParameterValue.RecordConflict | Record conflict. |
| InvalidParameterValue.RecordMXCountExceed | The number of MX records for CLB exceeds 50. |
| InvalidParameterValue.DomainNotExist | The domain name does not exist. |
| InvalidParameterValue.RecordTXTCountExceed | The number of TXT records for CLB exceeds 10. |
| InvalidParameter. | Parameter error. |
| InvalidParameterValue.RecordACountExceed | The number of A records for CLB exceeds 50. |
| InvalidParameterValue.IllegalTXTValue | After Punycode encoding, the length of the txt format record value must be between 1 and 255. |