API参考 - API参考 - 实例管理 -DescribeDBInstanceSwitchLog

该接口DescribeDBInstanceSwitchLog用于查询指定实例的主备切换日志信息，支持的实例类型包括MySQL高可用版、MySQL金融版、SQL Server、PostgreSQL以及PPAS实例。以下是调用此接口所需的请求参数及返回参数详情：

请求参数

• Action: String 类型，系统规定参数，固定取值为 DescribeDBInstanceSwitchLog。
• DBInstanceId: String 类型，是必填项，表示要查询的实例ID。
• StartTime: String 类型，查询的开始时间，格式应为 yyyy-mm-ddTHH:mmZ（UTC时间），此参数也是必填项。
• EndTime: String 类型，查询的结束时间，格式同上，必须晚于查询开始时间，同样是必填项。
• PageSize: Integer 类型，每页记录数，可选值为30、50、100，默认值为30。
• PageNumber: Integer 类型，当前页码，取值需大于0且不超过30，默认值为1。

返回参数

• RequestId: String 类型，每次API调用的唯一标识。
• DBInstanceId: String 类型，实例ID。
• TotalRecordCount: Integer 类型，总记录数。
• PageNumber: Integer 类型，当前页数。
• PageRecordCount: Integer 类型，每页显示的记录数。
• ItemsList: List 类型，主备日志列表，其中每个Item包含：
  • SwitchId: String 类型，切换实例的ID。
  • SwitchCauseCode: String 类型，切换原因代码。
  • SwitchStartTime: String 类型，切换开始时间。
  • SwitchFinishTime: String 类型，切换结束时间。
  • TotalSessions: String 类型，切换时总会话数。
  • AffectedSessions: String 类型，切换时影响的会话数。

请注意，调用此接口前需确保您的实例类型符合要求，并且提供的时间参数格式正确，结束时间需晚于开始时间。此外，通过调整PageSize和PageNumber可以控制查询结果的分页展示。

参考资料：[1]