You need to enable JavaScript to run this app.
RDS for PostgreSQL

RDS for PostgreSQL

Copy page
Download PDF
Backup and recovery
DescribeSlots
Copy page
Download PDF
DescribeSlots
Call the DescribeSlots API to query the replication slots of the instance.​
Request type​
Synchronous request.​
Debug​
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
​
Request parameters​
​
Parameter​
Type​
Required?​
Example​
Description​
InstanceId​
String​
Yes​
postgres-96138f57****​
ID of the instance to which the replication slot belongs.​
SlotName​
String​
No​
ExampleOfSlotName​
Name of the replication slot to query.​
tip​
Default value: none. Returns all query results under other parameter-restricted query conditions if this field is not passed.​
SlotType​
String​
No​
logical​
Types of replication slots. Values:​
  • physical: physical replication slot.​
  • logical: logical replication slot.​
tip​
No default value. Returns all query results under other parameter-restricted query conditions if this field is not passed.​
Plugin​
String​
No​
pgoutput​
Name of the extension used by the logical replication slot to parse WAL logs.​
tip​
  • When slottype is physical, no value needs to be passed for this field.​
  • Default value. If this field is not provided, all results under the query conditions limited by other parameters will be returned.​
Database​
String​
No​
postgres​
Database where the replication slot is located.​
tip​
  • When SlotType is physical, no value is needed for this field.​
  • Default value. If this field is not provided, all results under the query conditions limited by other parameters will be returned.​
Temporary​
Boolean​
No​
true​
Whether it is a temporary copy slot. Values:​
  • true: yes.​
  • false: no.​
tip​
Default value. when this field is not passed, return all query results under the query conditions limited by other parameters.​
SlotStatus​
String​
No​
ACTIVE​
Status of replication slot. Values:​
  • ACTIVE: active.​
  • INACTIVE: inactive.​
tip​
Default value. Returns all query results under other parameter-restricted query conditions if this field is not passed.​
IPAddress​
String​
No​
10.xxx.xxx.1​
IP address.​
​
Response parameter​
​
Parameter​
Type​
Example​
Description​
Total​
Integer​
3​
Quantity of replication slots for the instance.​
ReplicationSlots​
Refer to the sample response.​
Slots for copying specified by query conditions in the instance.​
​
ReplicationSlotObject​
​
Parameter​
Type​
Example​
Description​
SlotName​
String​
Slot000003​
Slot name.​
SlotType​
String​
logical​
Types of replication slots. Values:​
  • physical: physical replication slot.​
  • logical: logical replication slot.​
Plugin​
String​
pgoutput​
Extension name used with the logical replication slot to parse WAL logs.​
tip​
When slotType is physical, this field returnsnull。​
Database​
String​
postgres​
Database where the copy slot resides.​
tip​
When SlotType is set to physical, this field returnsnull。​
Temporary​
Boolean​
false​
Whether it is a temporary copy slot. Values:​
  • true: yes.​
  • false: no.​
SlotStatus​
String​
INACTIVE​
Status of replication slot. Values:​
  • ACTIVE: active.​
  • INACTIVE: inactive.​
WalDelay​
Long​
50327736​
The accumulated WAL logs corresponding to the replication slots. Unit: Byte.​
IPAddress​
String​
10.xxx.xxx.1​
IP address.​
tip​
Only active replication slots have IP addresses.​
​
Example​
Sample request​
​
POST /?Action=DescribeSlots&Version=2022-01-01 HTTP/1.1​
Content-Type: application/json​
Host: rds-postgresql.cn-beijing.volcengineapi.com​
X-Date: 20231002T101010Z​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_postgresql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****​
{​
"InstanceId": "postgres-96138f57****"​
}​
​
Sample response​
​
{​
"ResponseMetadata": {​
"RequestId": "202407181601463F9A69D65646D0A65A1B-262141",​
"Action": "DescribeSlots",​
"Version": "2022-01-01",​
"Service": "rds_postgresql",​
"Region": "cn-beijing"​
},​
"Result": {​
"ReplicationSlots": [​
{​
"Database": "null",​
"Plugin": "null",​
"SlotName": "Slot000001",​
"SlotStatus": "INACTIVE",​
"SlotType": "physical",​
"Temporary": false,​
"WalDelay": 0​
},​
{​
"Database": "null",​
"Plugin": "null",​
"SlotName": "Slot000002",​
"SlotStatus": "INACTIVE",​
"SlotType": "physical",​
"Temporary": false,​
"WalDelay": 50331608​
},​
{​
"Database": "postgres",​
"Plugin": "pgoutput",​
"SlotName": "Slot000003",​
"SlotStatus": "INACTIVE",​
"SlotType": "logical",​
"Temporary": false,​
"WalDelay": 50327792​
},​
{​
"Database": "postgres",​
"Plugin": "pgoutput",​
"SlotName": "Slot000004",​
"SlotStatus": "INACTIVE",​
"SlotType": "logical",​
"Temporary": false,​
"WalDelay": 50327736​
},​
{​
"Database": "postgres",​
"Plugin": "pgoutput",​
"SlotName": "Slot000005",​
"SlotStatus": "ACTIVE",​
"SlotType": "logical",​
"Temporary": true,​
"WalDelay": 50327624​
}​
],​
"Total": 5​
}​
}​
​
Last updated: 2026.03.31 10:45:18