云数据库 PostgreSQL 版
云数据库 PostgreSQL 版
云数据库 PostgreSQL 版
文档指南
请输入
产品动态
用户指南
实例管理
连接管理
服务可用性
Schema 管理
备份恢复
日志管理
数据安全
插件
API 参考
V2（2022-01-01）
实例管理
账号管理
连接管理
参数管理
备份与恢复
数据安全
SDK 参考
V2（2022-01-01）
相关协议
- 文档首页
云数据库 PostgreSQL 版API 参考V2（2022-01-01）日志管理DescribeFailoverLogs
复制全文
下载 pdfDescribeFailoverLogs
文档反馈
问问助手调用 DescribeFailoverLogs 接口查询实例主备切换日志。
请求类型
同步请求。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
参数 | 类型 | 是否必选 | 示例值 | 描述 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
InstanceId | String | 是 | postgres-21a3333b**** | 实例 ID。 |
QueryStartTime | String | 否 | 2023-07-31T12:00:19Z | 查询开始时间。格式：yyyy-MM-ddTHH:mmZ（UTC 时间）。 其中，T 指某个时间的开始；Z 指时区偏移量，例如北京时间偏移显示为+0800。 默认值为实例的创建时间，即自实例创建起查询。 |
QueryEndTime | String | 否 | 2023-07-31T12:00:19Z | 查询结束时间，需要晚于查询开始时间，且与查询开始时间的间隔应小于 31 天。格式：yyyy-MM-ddTHH:mmZ（UTC 时间）。 默认值为发起请求的时间。 |
Limit | Integer | 否 | 1000 | 每页记录数，最大值为 1000，最小值为 1，默认值为 500。 |
Context | String | 否 | [1690808035000,100367578,8388608,null] | 索引信息，翻页加载更多日志时使用。透传上次返回的 context 值，获取后续的日志内容。 默认值为空。 |
返回参数
参数 | 类型 | 示例值 | 描述 |
参数 | 类型 | 示例值 | 描述 |
Total | Integer | 1 | 主备切换日志总数。 |
InstanceId | String | postgres-21a3333b**** | 实例 ID。 |
FailoverLogs | 请参见返回示例。 | 实例主备切换日志列表。 | |
Context | String | [1690808035000,100367578,8388608,null] | 索引信息。以最后一个备份文件作为索引进行返回。可作为下一次请求的参数，加载更多时选择。 |
FailoverLogs
参数 | 类型 | 示例值 | 描述 |
参数 | 类型 | 示例值 | 描述 |
NewMasterNodeId | String | postgres-21a3333b****-0 | 新主节点 ID。 |
OldMasterNodeId | String | postgres-21a3333b****-1 | 旧主节点 ID。 |
FailoverType | String | System | 主备切换类型。
|
FailoverTime | String | 2020-06-18T01:40:44Z | 主备切换时间。 |
示例
请求示例
POST /?Action=DescribeFailoverLogs&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-21a3333b****",
"QueryStartTime": "2023-07-31T12:00:19Z",
"Limit": 50
}
返回示例
{
"ResponseMetadata": {
"RequestId": "20230801163925C4433796666B3E75888D",
"Action": "DescribeFailoverLogs",
"Version": "2022-01-01",
"Service": "rds_postgresql",
"Region": "cn-beijing"
},
"Result": {
"Context": "[1690808035000,100367578,8388608,null]",
"FailoverLogs": [
{
"FailoverTime": "2023-10-16T12:13:39.000Z",
"FailoverType": "User",
"NewMasterNodeId": "postgres-21a3333b****-gsss-867dddc678-j5zdt",
"OldMasterNodeId": "postgres-21a3333b****-c945c486b-kn294"
},
{
"FailoverTime": "2023-10-16T12:13:39.000Z",
"FailoverType": "User",
"NewMasterNodeId": "postgres-21a3333b****-c945c486b-kn294",
"OldMasterNodeId": "postgres-21a3333b****-gsss-867dddc678-j5zdt"
}
],
"InstanceId": "postgres-21a3333b****",
"Total": 2
}
}
最近更新时间：2026.03.31 10:39:10
这个页面对您有帮助吗？
有用
有用
无用
无用