调用 DescribeBackups 接口查询备份列表。
同步请求。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
InstanceId | String | 是 | postgres-21a3333b**** | 实例 ID。 |
BackupId | String | 否 | 20231101-021****_20231101-101**** | 备份 ID。 说明 无默认值。不传该字段时返回其他参数所限定的查询条件下所有备份。 |
BackupStartTime | String | 否 | 2023-10-19T06:20:06.000Z | 备份创建最早时间,格式为 说明
|
BackupEndTime | String | 否 | 2023-10-19T06:20:08.000Z | 备份创建最晚时间,格式为 说明
|
BackupStatus | String | 否 | Success | 备份状态,取值:
|
BackupType | String | 否 | Full | 备份类型,取值:
说明 无默认值。不传该字段时返回其他参数所限定的查询条件下所有备份。 |
PageNumber | Integer | 否 | 1 | 当前页查询偏移量,默认值为 1。 |
PageSize | Integer | 否 | 10 | 每页记录数,取值应大于 0 且不超过 1000,默认值为 10。 |
DownloadStatus | String | 否 | NotAllowed | 备份集的可下载状态。取值:
|
BackupMethod | String | 否 | Logical | 备份类型。取值:
说明 当 BackupScope 取值为 |
BackupDatabaseName | String | 否 | database1 | 备份集中包含的数据库名称。指定该字段后,会以该字段为关键词搜索备份集包含的数据库名称。 说明 仅在 BackupMethod 取值为 |
BackupDescription | String | 否 | This is a description of the backup set. | 备份集的描述信息。 |
CreateType | String | 否 | System | 创建类型,取值:
说明 无默认值。不指定时,则返回其他查询条件限定的备份。 |
BackupScope | String | 否 | Database | 备份对象。取值:
|
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Total | Integer | 1 | 备份总数。 |
Backups | Object[] | 请参见返回示例。 | 备份列表。 |
POST /?Action=DescribeBackups&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-a3e7eb2f****" }
{ "ResponseMetadata": { "RequestId": "202308041100439000B4A38D7086052659", "Action": "DescribeBackups", "Version": "2022-01-01", "Service": "rds_postgresql", "Region": "cn-beijing" }, "Result": { "Backups": [ { "BackupDataSize": 16785668, "BackupDescription": "", "BackupEndTime": "2025-05-12T12:21:15.000Z", "BackupFileName": "20250512-194637F_20250512-202111I", "BackupFileSize": 16785668, "BackupId": "20250512-194637F_20250512-202111I", "BackupMethod": "Physical", "BackupProgress": 100, "BackupScope": "Instance", "BackupStartTime": "2025-05-12T12:21:11.000Z", "BackupStatus": "Success", "BackupType": "Increment", "CreateType": "System", "DownloadStatus": "NotAllowed", "InstanceInfo": { "ChargeDetail": { "AutoRenew": false, "ChargeEndTime": "", "ChargeStartTime": "2023-09-11T06:43:34.000Z", "ChargeStatus": "Normal", "ChargeType": "PostPaid", "Number": 1, "OverdueReclaimTime": "", "OverdueTime": "", "Period": 1, "PeriodUnit": "Month" }, "DBEngineVersion": "PostgreSQL_12", "InstanceId": "postgres-da8f12d3****", "InstanceName": "测试实例", "InstanceStatus": "Running", "InstanceType": "HA", "Memory": 2, "Nodes": [ { "InstanceId": "postgres-da8f12d3****", "NodeId": "postgres-da8f12d3****", "NodeSpec": "rds.postgres.1c2g", "NodeType": "Primary", "ZoneId": "cn-beijing-b" }, { "InstanceId": "postgres-da8f12d3****", "NodeId": "postgres-da8f12d3****-fkoh", "NodeSpec": "rds.postgres.1c2g", "NodeType": "Secondary", "ZoneId": "cn-beijing-a" } ], "ProjectName": "rds-pg", "StorageSpace": 20, "StorageType": "LocalSSD", "SubnetId": "subnet-30uhx4w39n75s7r2qr0lq****", "VCPU": 1, "VpcId": "vpc-2gdgzrrl5icjk50ztyz6b****", "ZoneId": "cn-beijing-b" } } ], "Total": 1 } }