Help Center/ Data Admin Service/ API Reference/ APIs/ Intelligent O&M/ Querying Details About Historical Transaction Export Tasks
Updated on 2026-08-25 GMT+08:00

Querying Details About Historical Transaction Export Tasks

Function

After Collect Historical Transactions is enabled, this API is used to query details about historical transaction export tasks.

Authorization Information

Each account has permissions to call all APIs, but IAM users must have the required permissions specifically assigned.

  • If you are using role/policy-based authorization, see the required permissions in Permissions Policies and Supported Actions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    das::showCloudDBAInfo

    Read

    -

    -

    -

    -

URI

GET /v3/{project_id}/transaction/{instance_id}/get-export-task-info

Table 1 URI parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition

Project ID of a tenant in a region.

To obtain this value, see Obtaining a Project ID.

Constraints

N/A

Range

The value can contain 32 characters. Only letters and digits are supported.

Default Value

N/A

instance_id

Yes

String

Definition

Instance ID, which uniquely identifies an instance. You can obtain the instance ID from the instance list or instance details.

Constraints

N/A

Range

The value can contain 36 characters. Only letters and digits are allowed.

Default Value

N/A

Table 2 Query parameters

Parameter

Mandatory

Type

Description

task_id

Yes

Long

Definition

Export task ID

Constraints

N/A

Range

[0, 2^31 – 1]

Default Value

N/A

Request Parameters

None

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

task_id

Long

Definition

Export task ID

Range

[0, 2^31-1]

instance_id

String

Definition

Instance ID, which uniquely identifies an instance. You can obtain the instance ID from the instance list or instance details.

Range

The value can contain 36 characters. Only letters and digits are allowed.

task_status

Integer

Definition

Task status

Range

N/A

start_time

Long

Definition

Start time of an export task, in milliseconds

Range

N/A

end_time

Long

Definition

End time of an export task, in milliseconds

Range

N/A

create_at

Long

Definition

Creation time of an export task, in milliseconds

Range

N/A

export_line_num

Long

Definition

Number of exported records

Range

N/A

download_url

String

Definition

OBS download link of an exported file

Range

N/A

Example Requests

GET https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/transaction/da304cd5bbb944de828759bc7be3d3fein01/get-export-task-info?task_id=1

Example Responses

Status code: 200

Success.

{ 
  "task_id" : 516, 
  "instance_id" : "2154f176174041c68187401a968faa41in01", 
  "task_status" : 3, 
  "start_time" : 1758522650001, 
  "end_time" : 1758522650338, 
  "create_at" : 1758522640172, 
  "export_line_num" : 204, 
  "download_url" : "https://obs.xx-xx-xx.myhuaweicloud.com:443/obs-test/innodbstatus_2154f176174041c68187401a968faa41in01_1758522650029.zip" 
}

Status Codes

Status Code

Description

200

Success.

400

Client error.

500

Server error.

Error Codes

See Error Codes.