1. Interface Description
Interface request domain name: vpcdns.api3.convergecloud.com.
Complete the import operation and return the import result. Importing is an asynchronous process: (1) Call DescribeUploadUrl to get the upload link for the imported file. -> (2) The frontend puts the file into the link. -> (3) Call ImportRecords to complete the import.
Default interface request rate limit: 20 times per second.
Interface update time: 2025-06-24 05:13:12.
The interface is both signature verification and authentication.
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: ImportRecords |
| 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 | String | The domain name ID. Example: 3 |
| FileType | Yes | No | String | File types: xlsx, xls, csv Example: xlsx |
3. Output Parameters
| Parameter name | Type | Description |
|---|---|---|
| CreatedAt | Datetime | The response time of the binding request. Example: 2014-08-03 12:00:00 |
| SuccessfulCount | Uint64 | Success count Example: 12 |
| FailedRecords | Array of FailedRecordDetail | Adds details. 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 |
|---|---|
| InvalidParameterValue.DomainNotExist | The domain name does not exist. |
| InternalError.UndefiendError | Undefined error. |
| FailedOperation.CreateRecordFailed | Failed to create the record. |
| InvalidParameter. | Parameter error. |
| InvalidParameter.ImportedFileExpired | The file is expired |
| InvalidParameterValue.InvalidZoneFileSize | The file size exceeds the limit. |
| InternalError.FetchCOSFileError | Pulling the COS file failed. |
| InternalError. | Internal Error |