Updated on 2026-01-20 GMT+08:00

Querying SQL Throttling Rules

Function

  • This API is used to query SQL throttling rules.
  • Currently, only MySQL is supported.

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:listSqlLimitRules

    List

    Instance

    -

    -

    -

URI

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

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, including only letters and digits.

Default Value

N/A

instance_id

Yes

String

Definition

Unique ID of an instance

Constraints

N/A

Range

The value can contain 32 characters, including only letters and digits.

Default Value

N/A

Table 2 Query parameters

Parameter

Mandatory

Type

Description

offset

No

Integer

Definition

Offset. The query starts from the next piece of data indexed by this parameter.

Constraints

N/A

Range

[0, 2^31-1]. The actual value depends on the query result.

Default Value

0: The query starts from the first data record.

limit

No

Integer

Definition

Number of records to be queried

Constraints

N/A

Range

[1, 100]

Default Value

100

datastore_type

Yes

String

Definition

Database type

Range

  • MySQL: RDS for MySQL
  • PostgreSQL: RDS for PostgreSQL
  • MariaDB: RDS for MariaDB
  • TaurusDB

Request Parameters

None

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

sql_limit_rules

Array of SqlLimitRule objects

Definition

SQL throttling rules

Range

N/A

total_count

Integer

Definition

Total number of SQL throttling rules

Range

[0, 2^31-1]. The actual value depends on the query result.

Table 4 SqlLimitRule

Parameter

Type

Description

id

String

Definition

ID of a SQL throttling rule

Range

N/A

sql_type

String

Definition

SQL type

Range

  • insert
  • delete
  • update
  • select

pattern

String

Definition

Throttling rule

Range

N/A

max_concurrency

Integer

Definition

Maximum number of concurrent SQL statements

Range

N/A

max_waiting

Integer

Definition

Maximum waiting time

Range

N/A

Example Requests

Querying SQL throttling rules

GET https://das.cn-north-1.myhuaweicloud.com/v3/054c630ff780d4cc2f40c00d7f6fb21d/instances/d871e13ee1044e21a473330cd67047cbin01/sql-limit/rules?datastore_type=MySQL&offset=0&limit=10

Example Responses

Status code: 200

Successful response

{
  "sql_limit_rules" : [ {
    "id" : "6",
    "sql_type" : "SELECT",
    "max_concurrency" : 1,
    "pattern" : "select~var~where~id"
  }, {
    "id" : "7",
    "sql_type" : "UPDATE",
    "max_concurrency" : 10,
    "pattern" : "update~table01~where~id"
  } ],
  "total_count" : 2
}

Status Codes

Status Code

Description

200

Successful response

400

Client error

500

Server error

Error Codes

See Error Codes.