ListSupabaseDataBackups - 查询Supabase数据备份列表

更新时间:
复制 MD 格式

查询Supabase数据备份列表

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

RegionId

string

否

地域 ID。

说明

您可以调用 DescribeRegions 接口查看可用的地域 ID。

cn-hangzhou

ProjectId

string

是

Supabase 实例 ID,可以在控制台 Supabase 页面获取。

sbp-263****

StartTime

string

否

查询开始时间。格式: yyyy-MM-ddTHH:mmZ(UTC 时间)。

2011-06-01T15:00Z

PageSize

integer

否

每页记录数。取值说明:

  • 30

  • 50

  • 100

默认值:30。

30

PageNumber

integer

否

页码,取值大于 0 且不超过 Integer 的最大值。默认值:1。

1

EndTime

string

否

查询结束时间,需要大于查询开始时间。格式: yyyy-MM-ddTHH:mmZ(UTC 时间)。

2011-06-01T16:00Z

BackupId

string

否

备份集 ID。可从 ListSupabaseDataBackups 返回的 BackupSetId 获取。

327329803

DataType

string

否

备份类型。DATA:全量备份;RESTOREPOI:可恢复点。

DATA

BackupMode

string

否

备份模式。Automated:系统自动备份;Manual:手动备份。

Automated

BackupStatus

string

否

备份集状态。Success:备份成功;Failed:备份失败。

Success

MaxResults

integer

否

本次请求返回的最大记录数。

50

NextToken

string

否

分页查询标记。首次查询不传入;后续查询传入上一次响应返回的 NextToken。

caeba0bbb2be03f84eb48b699f0a****

返回参数

名称

类型

描述

示例值

object

Items

array<object>

备份集列表。

object

BackupEndTime

string

备份结束时间,格式为 yyyy-MM-ddTHH:mm:ssZ,使用 UTC 时间。

2026-10-09T01:24:44Z

BackupEndTimeLocal

string

备份结束时间的本地时间表示,格式为 yyyy-MM-ddTHH:mm:ssZ。当前返回值为北京时间(UTC+8);末尾 Z 是兼容格式中的固定字符,不表示零时区。需要按标准时间格式解析时,请使用 BackupEndTime。

2026-10-09T09:24:44Z

BackupMethod

string

备份方式。Physical:物理备份;Snapshot:快照备份。

Snapshot

BackupMode

string

备份模式。

全量备份取值说明:

  • Automated:系统自动备份。

  • Manual:手动备份。

恢复点取值说明:

  • Automated:全量备份后的恢复点。

  • Manual:用户手动触发的恢复点。

  • Period:因为备份策略,定时触发的恢复点。

Automated

BackupSetId

string

备份集 ID。

1111111111

BackupSize

integer

备份文件大小,单位:Byte(字节)。

10737418240

BackupStartTime

string

备份开始时间,格式为 yyyy-MM-ddTHH:mm:ssZ,使用 UTC 时间。

2026-10-09T01:23:02Z

BackupStartTimeLocal

string

备份开始时间的本地时间表示,格式为 yyyy-MM-ddTHH:mm:ssZ。当前返回值为北京时间(UTC+8);末尾 Z 是兼容格式中的固定字符,不表示零时区。需要按标准时间格式解析时,请使用 BackupStartTime。

2026-10-09T09:23:02Z

BackupStatus

string

备份集状态。取值说明:

  • Success:成功。

  • Failure:失败。

Success

BaksetName

string

恢复点名称或全量备份集名称。

logic_backup

ConsistentTime

integer

一致性时间点,使用 Unix 时间戳,单位:秒。全量备份表示备份的一致性时间点,可恢复点表示可恢复的时间点。

1791508983

DataType

string

备份类型。取值说明:

  • DATA:全量备份。

  • RESTOREPOI:可恢复点。

DATA

MaxResults

integer

本次请求返回的最大记录数。

50

NextToken

string

下一页的查询标记,可作为下次请求的 NextToken。

caeba0bbb2be03f84eb48b699f0a****

PageNumber

integer

页码。

1

PageSize

integer

本页备份集个数。

1

RequestId

string

请求 ID。

ABB39CC3-4488-4857-905D-2E4A051D****

TotalBackupSize

integer

总备份集大小,单位:Byte。

1111111111

TotalCount

integer

总记录数。

1

示例

正常返回示例

JSON格式

{
  "Items": [
    {
      "BackupEndTime": "2026-10-09T01:24:44Z",
      "BackupEndTimeLocal": "2026-10-09T09:24:44Z",
      "BackupMethod": "Snapshot",
      "BackupMode": "Automated",
      "BackupSetId": "1111111111",
      "BackupSize": 10737418240,
      "BackupStartTime": "2026-10-09T01:23:02Z",
      "BackupStartTimeLocal": "2026-10-09T09:23:02Z",
      "BackupStatus": "Success",
      "BaksetName": "logic_backup",
      "ConsistentTime": 1791508983,
      "DataType": "DATA"
    }
  ],
  "MaxResults": 50,
  "NextToken": "caeba0bbb2be03f84eb48b699f0a****",
  "PageNumber": 1,
  "PageSize": 1,
  "RequestId": "ABB39CC3-4488-4857-905D-2E4A051D****",
  "TotalBackupSize": 1111111111,
  "TotalCount": 1
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。