Help Center/ Relational Database Service/ API Reference/ API v3/ Monitoring and Alarms/ Querying a Monitoring by Seconds Policy
Updated on 2026-08-25 GMT+08:00
View PDF
Share

Querying a Monitoring by Seconds Policy

Function

This API is used to query the Monitoring by Seconds policy of a DB instance.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.
  • If you are using role/policy-based authorization, see Permissions and Supported Actions for details on the required permissions.
  • 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

rds:instance:getSecondLevelMonitoringConfig

read

instance

g:EnterpriseProjectId

g:ResourceTag/<tag-key>

rds:log:list

-

Constraints

  • This API is in OBT. To use this API, contact customer service.
  • This API is available to RDS for MySQL only.

URI

  • URI format

    GET /v3/{project_id}/instances/{instance_id}/second-level-monitor

  • Parameter description
    Table 1 Parameters

    Parameter

    Mandatory

    Description

    project_id

    Yes

    Definition

    Project ID of a tenant in a region.

    To obtain the value, see Obtaining a Project ID.

    Constraints

    N/A

    Range

    N/A

    Default Value

    N/A

    instance_id

    Yes

    Definition

    Instance ID.

    You can obtain the value of this parameter from id in Table 4 by calling the API for querying DB instances.

    Constraints

    N/A

    Range

    N/A

    Default Value

    N/A

Request

  • Parameter description

    None

  • URI example

    GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/3d39c18788b54a919bab633874c159dfin01/second-level-monitor

Response

  • Normal response
    Table 2 Parameters

    Parameter

    Type

    Description

    switch_option

    Boolean

    Definition

    Whether Monitoring by Seconds is enabled.

    Range

    • true: indicates that Monitoring by Seconds is enabled.
    • false: indicates that Monitoring by Seconds is disabled.

    interval

    Integer

    Definition

    Monitoring interval, in seconds.

    Range

    • 1
    • 5
  • Example normal response 
    {
  "switch_option" : true,
  "interval" : 5
}
  • Abnormal response

    For details, see Abnormal Response Results.

Status Code

Error Code

For details, see Error Codes.

Parent topic: Monitoring and Alarms