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

Querying a SQL Throttling Task

Function

This API is used to query the information about a SQL throttling task with a specified ID.

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:clouddba:showSqlLimitJobInfo

read

Instance

-

-

-

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
das:clouddba:showSqlLimitJobInfo	read	Instance	-	-	-

URI

GET /v3/{project_id}/instances/{instance_id}/sql-limit/job

**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 allowed. 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
job_id	Yes	String	Definition ID of a SQL throttling task Constraints N/A Range N/A Default Value N/A

Request Parameters

None

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
job_id	String	Definition Task ID Range N/A
job_status	String	Definition Task status Range RUNNING COMPLETED FAILED
fail_reason	String	Definition Failure cause Range N/A

Example Requests

Querying a SQL throttling task

GET https://das.cn-north-1.myhuaweicloud.com/v3/054c630ff780d4cc2f40c00d7f6fb21d/instances/6243b3fcf2f948578d46ed4c52fb54eein01/sql-limit/job?job_id=15535

Example Responses

Status code: 200

Successful response

{
  "job_id" : "15535",
  "job_status" : "COMPLETED",
  "fail_reason" : ""
}

Status Codes

Status Code	Description
200	Successful response
400	Client error
500	Server error

Error Codes

See Error Codes.

Parent topic: Intelligent O&M