文档首页/ 云数据库 RDS/ API参考/ API v3(推荐)/ 备份与恢复/ 查询库级备份包含的库(PostgreSQL)
更新时间:2025-08-04 GMT+08:00

查询库级备份包含的库(PostgreSQL)

功能介绍

查询库级备份包含的库。

URI

  • URI格式

    GET /v3/{project_id}/instances/{instance_id}/database/db-table-name?backup_id={backup_id}

  • 参数说明
    表1 参数说明

    名称

    是否必选

    参数类型

    说明

    project_id

    String

    参数解释:

    租户在某一Region下的项目ID。

    获取方法请参见获取项目ID

    约束限制:

    非空。

    取值范围:

    不涉及。

    默认取值:

    不涉及。

    instance_id

    String

    参数解释:

    实例ID。

    约束限制:

    非空。

    取值范围:

    不涉及。

    默认取值:

    不涉及。

    backup_id

    String

    参数解释:

    备份ID。

    约束限制:

    非空。

    取值范围:

    不涉及。

    默认取值:

    不涉及。

请求消息

无。

请求示例

查询指定库级备份中包含的库。


 

响应消息

  • 正常响应要素说明
    表2 要素说明

    名称

    参数类型

    说明

    databases

    Array of objects

    参数解释:

    库信息列表。详情请参见表3

    取值范围:

    不涉及。

    database_limit

    Integer

    参数解释:

    可恢复库的个数。

    取值范围:

    不涉及。

    bucket_name

    String

    参数解释:

    OBS桶名。

    取值范围:

    不涉及。

    表3 databases字段说明

    名称

    参数类型

    说明

    database_name

    String

    参数解释:

    库名。

    取值范围:

    不涉及。

    backup_file_name

    String

    参数解释:

    备份文件名。

    取值范围:

    不涉及。

    backup_file_size

    Long

    参数解释:

    备份文件大小。

    取值范围:

    不涉及。

  • 正常响应样例
    { 
        "bucket_name": "backet1", 
        "databases": [ 
            { 
                "database_name": "databases1", 
                "backup_file_name": "file1", 
                "backup_file_size": 10 
            }, 
            { 
                "database_name": "databases2", 
                "backup_file_name": "file2", 
                "backup_file_size": 11 
            }, 
            { 
                "database_name": "databases3", 
                "backup_file_name": "file3", 
                "backup_file_size": 12 
            }, 
        ], 
        "database_limit": 50 
    }
  • 异常响应

    请参见异常请求结果

状态码

错误码

请参见错误码