QueryFormationTasksByType

Updated at:
Copy as MD

Queries metadata discovery tasks by task type.

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 parameters

Parameter

Type

Required

Description

Example

RegionId

string

Yes

The region ID.

Note

You can call the DescribeRegions operation to query the supported regions and zones, including region IDs.

cn-hangzhou

TaskType

string

Yes

The task type.

["CRAWLER"]

DBClusterId

string

Yes

The cluster ID.

Note

You can call the DescribeDBClusters operation to query the details of all AnalyticDB for MySQL clusters in a region, including cluster IDs.

am-uf6g8w25jacm7****

Response elements

Element

Type

Description

Example

object

HttpStatusCode

integer

The HTTP status code.

200

Data

array<object>

The task list.

object

The returned data.

LastTaskInstID

string

The instance ID of the most recent task.

46872

Schema

string

The database name.

sales_db

CreateTime

string

The creation time.

2026-07-08 17:05:25

TaskName

string

The task name.

[\"oss://test-bucket/**/**/\"] -> sales_db

SourceType

string

The source type.

OSSWAREHOUSE

LastTaskInstState

string

The instance status of the most recent node.

SUCCESS

TaskType

string

The task type.

CRAWLER

SyncTime

string

The scheduling frequency.

{\"cron\":\"\",\"type\":\"run_on_demand\"}

LastTaskInstMessage

string

The error message of the most recent task.

xxx

LastTaskInstCostTime

string

The execution duration of the most recent task.

2

TaskId

string

The task ID.

10

ScheduleState

string

The scheduling status.

STOP

RequestId

string

The request ID.

1AD222E9-E606-4A42-BF6D-8A4442913CEF

Success

boolean

Indicates whether the call was successful. Valid values:

  • true: The call was successful.

  • false: The call failed.

true

Code

string

The status code.

200

Message

string

The response message. OK is returned if the call was successful.

OK

Examples

Success response

JSON format

{
  "HttpStatusCode": 200,
  "Data": [
    {
      "LastTaskInstID": "46872",
      "Schema": "sales_db",
      "CreateTime": "2026-07-08 17:05:25",
      "TaskName": "[\\\"oss://test-bucket/**/**/\\\"] -> sales_db",
      "SourceType": "OSSWAREHOUSE",
      "LastTaskInstState": "SUCCESS",
      "TaskType": "CRAWLER",
      "SyncTime": "{\\\"cron\\\":\\\"\\\",\\\"type\\\":\\\"run_on_demand\\\"}",
      "LastTaskInstMessage": "xxx",
      "LastTaskInstCostTime": "2",
      "TaskId": "10",
      "ScheduleState": "STOP"
    }
  ],
  "RequestId": "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
  "Success": true,
  "Code": "200",
  "Message": "OK"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.