Help Center/ Data Admin Service/ API Reference/ APIs (in OBT)/ Intelligent O&M/ Querying Whether SQL Throttling Is Enabled
Updated on 2026-01-20 GMT+08:00

Querying Whether SQL Throttling Is Enabled

Function

This API is used to query whether SQL throttling is enabled. Currently, this function is only available to RDS for MySQL.

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

    Read

    Instance

    -

    -

    -

URI

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

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

datastore_type

Yes

String

Definition

Database type

Constraints

N/A

Range

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

Default Value

N/A

Request Parameters

None

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

switch_status

String

Definition

Switch status

Range

  • ON: Throttling is enabled.
  • OFF: Throttling is disabled.

Example Requests

Querying whether SQL throttling is enabled

GET https://das.cn-north-1.myhuaweicloud.com/v3/054c630ff780d4cc2f40c00d7f6fb21d/instances/6243b3fcf2f948578d46ed4c52fb54eein01/sql-limit/switch?datastore_type=MySQL

Example Responses

Status code: 200

Successful response

{
  "switch_status" : "ON"
}

Status Codes

Status Code

Description

200

Successful response

400

Client error

500

Server error

Error Codes

See Error Codes.