文档中心

AI 原生 BaaS 平台 Supabase 版

分支管理

DescribeRestorableBranches

DescribeRestorableBranches

调用 DescribeRestorableBranches 接口查询 Workspace（工作区）在指定时间点的可恢复分支。

请求类型

同步请求。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

请求参数

参数	类型	是否必选	示例值	描述
WorkspaceId	String	是	ideal-fir-9fc8****	Workspace 的 ID。
Time	String	是	2026-02-26T10:35:12Z	目标时间点（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。
Offset	Integer	否	1	分页查询的起始页，默认值为 0。
Limit	Integer	否	10	分页查询的页容量，默认值为 10。
Search	String	否	br-bloom-duck-61c7****	按分支 ID 或分支名称前缀搜索。

返回参数

参数	类型	示例值	描述
Branches	Array of Branch	请参见返回示例。	指定查询条件下的分支列表。
RestoreWindow	Array of RestoreWindow	请参见返回示例。	可用窗口时间列表.
Total	Integer	2	符合查询条件的分支总数。
WorkspaceName	String	TestWorkspace	Workspace 的名称。

Branch

参数	类型	示例值	描述
Archived	Boolean	false	分支是否已归档。取值： true：是。 false：否。
BranchId	String	br-bloom-duck-61c7****	分支 ID。
BranchName	String	childbranch	分支的名称。
BranchStatus	String	Ready	分支的状态。取值： Unknown：未知。 Init：初始化。 Activating：激活中。 Ready：就绪。 Archived：已归档。 Deleted：已删除。 Resetting：重置中。 Deleting：删除中。 Stopping：暂停中。 Stopped：已暂停。 Suspending：休眠中。 Suspended：已休眠。 Replacing：计算资源替换中。 Restarting：重启中。 Updating：更新中。
BranchUsage	Object of BranchUsage	请参见返回示例。	分支的资源使用信息。说明在该接口中，不会返回分支的资源使用信息，仅返回 null。
CreateTime	String	2025-10-08T10:51:06.000Z	分支的创建时间（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。
CreationSource	String	Console	分支的创建源。取值为 Console。
Default	Boolean	false	是否为默认分支。取值： true：是。 false：否。
InitSource	String	ParentData	分支初始化的源。说明在该接口中，不会返回分支的初始化源，仅返回 None。
LastResetTime	String	2025-10-07T08:57:21.000Z	分支最近一次重置的时间（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。说明如分支没有进行过重置，则返回空。
Protected	Boolean	true	是否为分支设置了分支保护。取值： true：是。 false：否。
StatusChangedTime	String	2025-10-08T10:16:45.000Z	分支状态变更时间（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。
SupportAnalytic	Boolean	true	分支下的算力是否支持 AP 加速功能。取值： true：是。 false：否。
UpdateTime	String	2025-10-09T08:46:27.000Z	分支最近一次更新的时间（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。
WorkspaceId	String	ideal-fir-9fc8****	Workspace 的 ID。

RestoreWindow

参数	类型	示例值	描述
BranchCreateTime	String	2025-10-08T06:54:51.000Z	分支的创建时间（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。
BranchId	String	br-bloom-duck-61c7****	分支 ID。
EndTime	String	2025-10-09T09:21:28.013Z	可恢复时间段的结束时间（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。
StartTime	String	2025-10-08T06:54:51.000Z	可恢复时间段的开始时间（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。
WindowSizeSeconds	Long	86400	可恢复时间段的时长，单位为秒。

BranchUsage

参数	类型	示例值	描述
BranchId	String	br-bloom-duck-61c7****	分支 ID。
ComputeTimeSeconds	Long	0	分支所有算力的算力用量，单位为秒。
DataSizeTotalBytes	Long	-1	分支数据占用的存储空间大小。单位为字节。说明返回值为 -1时表示无限制。
DataSizeUsedBytes	Long	24576	分支已使用数据大小，单位为字节。
FunctionCallNum	Long	3562	分支已调用函数次数。说明该字段仅在使用 Supabase 引擎的 Workspace 中返回。
LastRunningTime	String	2025-10-21 06:46:33 +0000 UTC	分支的最后运行时间（UTC 时间）。格式为 yyyy-MM-dd HH:mm:ss +0000 UTC。
ServiceTimeSeconds	Long	365	分支已使用服务时长。
StatTime	String	2025-10-21 06:46:33 +0000 UTC	分支资源使用信息的统计时间（UTC 时间）。格式为 yyyy-MM-dd HH:mm:ss +0000 UTC。
StorageSizeUsedBytes	Long	24576	分支已使用存储服务数据大小，单位为字节。
WorkspaceId	String	ideal-fir-9fc8****	Workspace 的 ID。
VectorReadVCU	Double	19.22	对 Vector Bucket 中的向量数据发起检索、查询等读取操作时所消耗的查询资源。单位为 vCU。说明该字段仅在使用 Supabase 引擎的 Workspace 中返回。
VectorWriteVCU	Double	7.3	向 Vector Bucket 中写入、更新或删除向量数据时所消耗的更新资源。单位为 vCU。说明该字段仅在使用 Supabase 引擎的 Workspace 中返回。
VectorStorageSizeUsedBytes	Long	909805	存储在 Vector Bucket 中的向量数据所占用的存储空间。单位为字节。说明该字段仅在使用 Supabase 引擎的 Workspace 中返回。

示例

请求示例

返回示例

错误码

更多详情，请参见错误码。

最近更新时间：2026.08.25 12:34:59

这个页面对您有帮助吗？

有用

有用

无用

无用