Querying Monitoring Information of a Subscription

Function

This API is used to query monitoring information of a DB instance's subscription.

Before calling this API, learn how to authenticate it.
Before calling this API, learn about request header parameters.

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:update	write	-	-	rds:instance:modify	-

URI

URI format
GET /v3/{project_id}/instances/{instance_id}/replication/subscriptions/{subscription_id}/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 The value cannot be empty. Range N/A Default Value N/A
instance_id	Yes	Definition Instance ID. Constraints The value cannot be empty. Range N/A Default Value N/A
subscription_id	Yes	Definition Subscription ID. Constraints The value cannot be empty. Range N/A Default Value N/A

Request

Request parameters
None
URI example
GET https://{Endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/72ee4cc4607347049df9ad50f615bbd8in04/replication/subscriptions/5b7dfa4f-a16e-4588-9d4e-89353f823512/monitor

Response

Normal response

**Table 2** Parameters
Parameter	Type	Description
status	String	Definition Status of the snapshot agent associated with the subscription. Range started succeeded in_progress idle retrying failed
latency	Integer	Definition Maximum latency for data changes, in seconds. Range N/A
agent_not_running	Integer	Definition Duration during which the agent is not running, in hours. Range N/A
pending_cmd_count	Integer	Definition Number of pending commands for the subscription. Range N/A
last_dist_sync	String	Definition Last run time of the distribution agent. The format is yyyy-mm-ddThh:mm:ssZ. T is the separator between the calendar and the hourly notation of time. Z indicates the time zone offset. For example, in the Beijing time zone, the time zone offset is shown as +0800. Range N/A
estimated_process_time	Integer	Definition Estimated time (in seconds) required for executing the pending commands. Range N/A

Example normal response

{
    "status": "in_progress",
    "latency": 35,
    "last_dist_sync": "2025-11-04T03:10:05+0000",
    "pending_cmd_count": 0,
    "estimated_process_time": 0
}