云数据库 GaussDB-查询备份列表:URI

时间:2023-11-01 16:19:35

URI

  • URI格式

    GET https://{Endpoint}/v3.1/{project_id}/backups?instance_id={instance_id}&backup_id={backup_id}&backup_type={backup_type}&offset={offset}&limit={limit}&begin_time={begin_time}&end_time={end_time}

  • URI样例
    • 查询所有备份列表

    https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3.1/0483b6b16e954cb88930a360d2c4e663/backups

    • 根据指定条件查询实例列表

    https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3.1/0483b6b16e954cb88930a360d2c4e663/backups?instance_id=88be33e4c5a64ceba42b42da89310111in14&backup_id=88be1234c5a64ceba42b42da89310111br14&backup_type=auto&begin_time=2022-05-09T16:15:50+0800&end_time=2022-05-09T16:20:45+0800&limit=1&offset=1

  • 参数说明
    表1 参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    String

    租户在某一region下的project ID。

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

    instance_id

    String

    实例ID。

    backup_id

    String

    备份ID,严格匹配UUID规则。

    backup_type

    String

    备份类型,取值范围:

    • auto:实例级自动全量备份
    • manual:实例级手动全量备份

    offset

    Integer

    索引位置,偏移量。从第一条数据偏移offset条数据后开始查询,默认为0(偏移0条数据,表示从第一条数据开始查询),必须为数字,不能为负数。

    最小值:0

    limit

    Integer

    查询记录数。默认为100,不能为负数,最小值为1,最大值为100。

    最小值:1

    最大值:100

    begin_time

    String

    查询开始时间,格式为“yyyy-mm-ddThh:mm:ssZ”。其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。与end_time必须同时使用。

    end_time

    String

    查询结束时间,格式为“yyyy-mm-ddThh:mm:ssZ”,且大于查询开始时间。其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。与begin_time必须同时使用。

support.huaweicloud.com/api-opengauss/zh-cn_topic_0000001490520306.html