云数据库 PostgreSQL 版
云数据库 PostgreSQL 版
云数据库 PostgreSQL 版
文档指南
请输入
产品动态
用户指南
实例管理
连接管理
服务可用性
Schema 管理
备份恢复
日志管理
数据安全
插件
API 参考
V2（2022-01-01）
实例管理
账号管理
连接管理
参数管理
备份与恢复
数据安全
SDK 参考
V2（2022-01-01）
相关协议
- 文档首页
云数据库 PostgreSQL 版API 参考V2（2022-01-01）备份与恢复DescribeWALLogBackups
复制全文
下载 pdfDescribeWALLogBackups
文档反馈
问问助手调用 DescribeWALLogBackups 接口获取指定实例已备份的 WAL 日志列表。
请求类型
同步请求。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
参数 | 类型 | 是否必选 | 示例值 | 描述 |
InstanceId | String | 是 | postgres-08f97473**** | 实例 ID。 |
BackupId | String | 否 | 00000005000000010000000C | 备份文件 ID。 |
StartTime | String | 否 | 2025-12-01T13:00:00Z | 查询时间范围的起点，格式为 yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。 说明
|
EndTime | String | 否 | 2025-12-01T14:03:19Z | 查询时间范围的终点，格式为 yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。 说明
|
PageSize | Integer | 否 | 5 | 每页记录数，取值应大于 0 且不超过 1000，默认值为 10。 |
PageNumber | Integer | 否 | 2 | 分页页码。默认值为 1。 |
返回参数
参数 | 类型 | 示例值 | 描述 |
Total | Integer | 123 | 符合查询条件的 WAL 日志备份总数。 |
WALLogBackups | 请参见返回示例。 | WAL 日志备份列表。 |
WALLogBackupObject
参数 | 类型 | 示例值 | 描述 |
BackupFileSize | Long | 74628 | WAL 日志备份文件大小。单位为字节（Byte）。 |
BackupId | String | 00000005000000010000000F | WAL 日志备份的 ID。 |
BackupStatus | String | Success | WAL 日志备份的状态。 |
Checksum | String | c2001709ecf649523647ed33ebf8748a | 采用 crc64 算法的 ETag 格式的校验值。 |
DownloadStatus | String | Success | WAL 日志备份的可下载状态，当前固定取值为 LinkReady，即可立即下载。 |
ProjectName | String | default | WAL 日志备份所属实例所属的项目。 |
WALLogBackupEndTime | String | 2025-12-01T13:49:17Z | WAL 日志备份结束时间，格式为 yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。 |
示例
请求示例
POST /?Action=DescribeWALLogBackups&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-08f97473****",
"StartTime": "2025-12-01T13:00:00Z",
"EndTime": "2025-12-01T14:03:19Z",
"PageSize": 5,
"PageNumber": 2
}
返回示例
{
"ResponseMetadata": {
"RequestId": "20251201220740ADE6D1BCB10B962FA0FF-71630a",
"Action": "DescribeWALLogBackups",
"Version": "2022-01-01",
"Service": "rds_postgresql",
"Region": "cn-guangzhou"
},
"Result": {
"Total": 14,
"WALLogBackups": [
{
"BackupFileSize": 77466,
"BackupId": "00000005000000010000000C",
"BackupStatus": "Success",
"Checksum": "f75a840de3df79b9e0a04695448578f2",
"DownloadStatus": "LinkReady",
"ProjectName": "test01",
"WALLogBackupEndTime": "2025-12-01T13:34:17Z"
},
{
"BackupFileSize": 71018,
"BackupId": "00000005000000010000000B",
"BackupStatus": "Success",
"Checksum": "0e25006939f856ed0883294d92bb272d",
"DownloadStatus": "LinkReady",
"ProjectName": "test01",
"WALLogBackupEndTime": "2025-12-01T13:29:17Z"
},
{
"BackupFileSize": 71006,
"BackupId": "00000005000000010000000A",
"BackupStatus": "Success",
"Checksum": "8b848a7f356df12e6153a085789c4c17",
"DownloadStatus": "LinkReady",
"ProjectName": "test01",
"WALLogBackupEndTime": "2025-12-01T13:24:17Z"
},
{
"BackupFileSize": 71036,
"BackupId": "000000050000000100000009",
"BackupStatus": "Success",
"Checksum": "b062ddaa03400f9f749f1a7f53c37b79",
"DownloadStatus": "LinkReady",
"ProjectName": "test01",
"WALLogBackupEndTime": "2025-12-01T13:19:18Z"
},
{
"BackupFileSize": 70728,
"BackupId": "000000050000000100000008",
"BackupStatus": "Success",
"Checksum": "bd096a95530e1083168ea39e8b6332c6",
"DownloadStatus": "LinkReady",
"ProjectName": "test01",
"WALLogBackupEndTime": "2025-12-01T13:14:18Z"
}
]
}
}
最近更新时间：2026.03.31 10:39:12
这个页面对您有帮助吗？
有用
有用
无用
无用