All Products
Search
Document Center

ApsaraDB RDS:ListImportTasks

Last Updated:Apr 18, 2026

Lists the data import tasks for native replication.

Operation description

Lists the data import tasks for instances that use native replication.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

GET  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

Yes

The region ID.

cn-beijing

DBInstanceId

string

Yes

The instance ID. You can call the DescribeDBInstances operation to query this ID.

rm-uf6wjk5****

MaxResults

integer

No

The page size. Valid values: 1 to 100.

Default value: 30.

Note

If you specify this parameter, you cannot use the PageSize and PageNumber parameters.

30

NextToken

string

No

The pagination token. Set this parameter to the NextToken value returned from a previous call to retrieve the next page of results.

AAAAAdDWBF2

Response elements

Element

Type

Description

Example

object

The returned data.

RequestId

string

The request ID.

1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC

Items

array<object>

A list of data import tasks.

object

The details of a data import task.

TaskId

integer

The task ID.

342900000

TaskName

string

The task name.

362c6c7a-4d20-4eac-898c-1495ceab374c

CreatedTime

string

The time at which the task was created. The time is in UTC and is formatted as YYYY-MM-DDTHH:mm:ssZ.

2018-05-30T14:30:00Z

Status

string

The task status.

Importing

DbVersion

string

The database engine version.

5.7

TaskType

string

The task type.

import

TargetInstanceName

string

The ID of the target instance.

rm-bp*****

NextToken

string

A pagination token for the next page of results. This parameter is returned only if the results are truncated.

None

MaxResults

integer

The number of entries returned on the current page.

Default value: 30.

Note

If this parameter is specified, the PageSize and PageNumber parameters are unavailable.

30

Examples

Success response

JSON format

{
  "RequestId": "1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC",
  "Items": [
    {
      "TaskId": 342900000,
      "TaskName": "362c6c7a-4d20-4eac-898c-1495ceab374c",
      "CreatedTime": "2018-05-30T14:30:00Z",
      "Status": "Importing",
      "DbVersion": "5.7",
      "TaskType": "import",
      "TargetInstanceName": "rm-bp*****"
    }
  ],
  "NextToken": "None",
  "MaxResults": 30
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidDBInstanceEngineType.Format the DB instance engine type does not support this operation. This operation is not supported for the database engine of the instance.
403 IncorrectDBInstanceType Current DB instance type does not support this operation. The operation failed. The RDS instance is not in a ready state.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.