Help Center/ Data Admin Service/ API Reference/ APIs (in OBT)/ Intelligent O&M/ Querying a SQL Throttling Task
Updated on 2026-01-20 GMT+08:00
View PDF
Share

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

    -

    -

    -

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

Unique ID of an instance

Constraints

N/A

Range

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

Default Value

N/A
Table 2 Query parameter

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