查询快照点信息 - 云平台 OCP V4.3.0

查询快照点信息

更新时间：2026-04-14 11:55:54

编辑

功能说明

查询指定集群的快照点信息。

调用说明

接口约束

调用者需要具备指定集群的读写权限。

请求路径

GET /api/v2/ob/clusters/{id}/performance/workload/snapshots

请求参数

参数	类型	必选	示例值	描述
id	Integer	是	1	目标 OceanBase 集群的 ID。
snapshotId	Long	否	123	返回结果的起始快照点信息。

返回结果

基础数据结构

参数	类型	说明
data	Object
├─ contents	Array
├─ snapshotId	Long	快照点ID。
├─ snapshotTime	String	快照点产生的时间。
successful	Boolean	请求是否成功。
timestamp	Datetime	服务端完成请求的时间戳。
duration	Integer	服务端处理请求的时间（毫秒）。
status	Integer	符合 HTTP Status 规范的编码。
traceId	String	请求的 Trace ID，用于排查问题。
server	String	响应请求的应用服务的地址。

示例

请求示例

GET  /api/v2/ob/clusters/1/performance/workload/snapshots

返回示例

{
	"data": {
		"contents": [{
			"snapshotId": 1399,
			"snapshotTime": "2022-10-01T00:01:00.214Z"
		}, {
			"snapshotId": 3801,
			"snapshotTime": "2023-01-12T10:01:00.72Z"
		}, {
			"snapshotId": 3802,
			"snapshotTime": "2023-01-12T11:01:00.696Z"
		}]
	},
	"duration": 35,
	"server": "11.124.5.59",
	"status": 200,
	"successful": true,
	"timestamp": "2023-01-12T19:24:59.494+08:00",
	"traceId": "5a8a92acb9f84ea2"
}