Updated on 2026-08-25 GMT+08:00

Creating a Task for Exporting Historical Transactions

Function

After Collect Historical Transactions is enabled, this API is used to create a task to export historical transaction data within a specified time range at a time.

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

-

-

-

-

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
das::showCloudDBAInfo	Read	-	-	-	-

URI

POST /v3/{project_id}/transaction/{instance_id}/create-export-task

**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

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
bucket_name	Yes	String	Definition OBS bucket name Constraints Maximum length: 63 characters Range N/A Default Value N/A
start_at	Yes	Long	Definition Start time Constraints Unix timestamp, in milliseconds Range [0, 2^63 – 1]. The actual value depends on the query result. Default Value N/A
end_at	Yes	Long	Definition End time Constraints Unix timestamp, in milliseconds Range [0, 2^63 – 1]. The actual value depends on the query result. Default Value N/A
file_path	No	String	Definition OBS file directory Constraints Maximum length: 1024 characters Range N/A Default Value N/A
time_zone	No	String	Definition Time zone Constraints Maximum length: 64 characters Range Any valid time zone definition, for example, UTC or GMT Default Value N/A
order	No	String	Definition Sorting field Constraints N/A Range collectTime: collection time occurrenceTime: occurrence time lastSec: transaction duration waitLockStructCount: number of held locks holdLockStructCount: number of waiting locks Default Value N/A
order_by	No	String	Definition Sorting rule Constraints N/A Range asc: The query results are displayed in ascending order. desc: The query results are displayed in the descending order. Default Value N/A
last_sec_min	No	Long	Definition Minimum duration Constraints N/A Range [0, 2^31-1]. The actual value depends on the query result. Default Value N/A
last_sec_max	No	Long	Definition Maximum duration Constraints N/A Range [0, 2^31-1]. The actual value depends on the query result. Default Value N/A

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]

Example Requests

POST https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/transaction/da304cd5bbb944de828759bc7be3d3fein01/create-export-task 
 
{ 
  "bucket_name" : "obs-test", 
  "file_path" : "", 
  "time_zone" : "GMT+8", 
  "start_at" : 1757729655062, 
  "end_at" : 1758334455062, 
  "order" : "collectTime", 
  "order_by" : "asc", 
  "last_sec_min" : 0, 
  "last_sec_max" : 3600 
}

Example Responses

Status code: 200

Success.

{ 
  "task_id" : 1 
}

Status Codes

Status Code	Description
200	Success.
400	Client error
500	Server error

Error Codes

See Error Codes.

Parent topic: Intelligent O&M