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

Enabling or Disabling SQL Throttling

Function

  • This API is used to enable or disable SQL throttling.
  • 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:changeSqlLimitSwitchStatus

    Write

    Instance

    -

    -

    -

URI

POST /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

Request Parameters

None

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

switch_status

Yes

String

Definition

Switch status

Range

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

datastore_type

Yes

String

Definition

Database type

Range

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

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

job_id

String

Definition

ID of a SQL throttling task

Range

N/A

Example Requests

Enabling SQL throttling

POST https://das.cn-north-1.myhuaweicloud.com/v3/054c630ff780d4cc2f40c00d7f6fb21d/instances/6243b3fcf2f948578d46ed4c52fb54eein01/sql-limit/switch

{
  "datastore_type" : "MySQL",
  "switch_status" : "ON"
}

Example Responses

Status code: 200

Successful response

{
  "job_id" : "15535"
}

Status Codes

Status Code

Description

200

Successful response

400

Client error

500

Server error

Error Codes

See Error Codes.