Help Center/ Data Admin Service/ API Reference/ APIs/ Intelligent O&M/ Checking Whether Collect All Query Logs Is Enabled
Updated on 2026-08-25 GMT+08:00

Checking Whether Collect All Query Logs Is Enabled

Function

This API is used to check whether Collect All Query Logs is enabled.

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

    Read

    Instance

    -

    -

    -

URI

GET /v3/{project_id}/fullsql/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. Only letters and digits are supported.

Default Value

N/A

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

engine_type

No

String

Definition

DB engine type

Constraints

N/A

Range

N/A

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 supported.

Default Value

N/A

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

open_status

Integer

Definition

Switch status

Range

  • 1: enabled
  • 0: disabled

retention_days

Long

Definition

Retention duration, in hours

Range

N/A

can_open

Boolean

Definition

Whether the switch can be toggled on

Range

N/A

cant_open_msg

String

Definition

Reason why the switch cannot be toggled on

Range

N/A

last_open_time

Long

Definition

Time when the switch was last toggled on, in milliseconds

Range

N/A

Example Requests

GET https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/fullsql/switch?instance_id=bcfa975193f1402fa11a6d4fd6baf5fbin01 
 

Example Responses

Status code: 200

Success.

{
    "open_status": 1,
    "retention_days": 168,
    "can_open": true,
    "last_open_time": 1763086148470
}

Status Codes

Status Code

Description

200

Success.

400

Client error.

500

Server error.

Error Codes

See Error Codes.