All Products
Search

This Product

    ApsaraDB RDS:DescribeImportTask

    Document Center

    ApsaraDB RDS:DescribeImportTask

    Last Updated:Apr 18, 2026

    Queries the details of a data import task for an RDS instance that uses native replication.

    Operation description

    This operation queries the details of a data import task.

    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. You can call the DescribeRegions operation to query the latest list of regions.

    cn-hangzhou
    DBInstanceId

    string

    Yes

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

    rm-****
    TaskId

    string

    Yes

    The task ID.

    159****

    Response elements

    Element

    Type

    Description

    Example

    object

    The response parameters.

    RequestId

    string

    The request ID.

    A103039D-B1B2-4C57-B989-7D7C0DA95426
    TaskId

    integer

    The task ID.

    416980000
    TaskName

    string

    The task name.

    test01
    Status

    string

    The status of the task.

    Importing
    Detail

    string

    The details of the task.

    Error Message
    TargetInstanceName

    string

    The name of the target instance.

    rm-t4neh0q12v1******
    TaskType

    string

    The type of the task.

    import

    SourceIp

    string

    The source IP address.

    59.172.25.122
    SourcePort

    string

    The port of the source instance.

    3306
    Account

    string

    The account name.

    myadmin
    DbVersion

    string

    The kernel version of the source database.

    5.7
    SourceCategory

    string

    The category of the source instance.

    • ECS: A self-managed database on an Alibaba Cloud ECS instance.

    • other: A database not hosted on an Alibaba Cloud service.

    aliyunRDS

    Examples

    Success response

    JSON format

    {
  "RequestId": "A103039D-B1B2-4C57-B989-7D7C0DA95426",
  "TaskId": 416980000,
  "TaskName": "test01",
  "Status": "Importing",
  "Detail": "Error Message",
  "TargetInstanceName": "rm-t4neh0q12v1******",
  "TaskType": "import\n",
  "SourceIp": "59.172.25.122",
  "SourcePort": "3306",
  "Account": "myadmin",
  "DbVersion": "5.7",
  "SourceCategory": "aliyunRDS"
}

    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.