更新时间:2022-02-22 GMT+08:00

查询备份数量

功能介绍

查询备份数量,支持过滤参数查询。

URI

  • URI

    GET https://{endpoint}/v1/{project_id}/checkpoint_items/count

  • 参数说明
    表1 参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    String

    项目ID。

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

请求

  • 查询参数说明
    表2 查询参数说明

    参数

    是否必选

    参数类型

    描述

    status

    String

    支持根据status字段查询,

    取值范围:[ waiting_protect, protecting, available, waiting_restore, restoring, error, waiting_delete, deleting,deleted]

    all_tenants

    Boolean

    是否查询所有租户的备份,只有管理员权限用户能查询所有租户备份

    name

    String

    支持根据备份名称查询

    az

    String

    支持按az来过滤

    resource_id

    String

    支持按照备份对象ID过滤

    resource_name

    String

    支持按照备份对象名称过滤

    start_time

    String

    支持按照备份时间过滤,过滤起始时间点,如:"2017-04-15T04:25:38"

    end_time

    String

    支持按照备份时间过滤,过滤结束时间点,如:"2017-04-15T04:25:38"

    image_type

    String

    支持按照备份镜像类型过滤,需要备份已创建镜像,才能使用该参数过滤,镜像类型请到镜像服务获取。

    policy_id

    String

    支持按照policy_id过滤

    ip

    String

    支持按虚拟机ip搜索

    checkpoint_id

    String

    支持按照checkpoint_id过滤

    resource_type

    String

    备份对象的类型,如:"OS::Nova::Server"

  • 要素说明

  • 请求样例
    查询所有的数量
    GET https://{endpoint}/v1/{project_id}/checkpoint_items/count
    带条件查询数量
    GET https://{endpoint}/v1/{project_id}/checkpoint_items/count?status=error

响应

  • 要素说明
    表3 要素说明

    参数

    参数类型

    描述

    count

    Integer

    备份数量

  • 响应样例
    {
      "count" : 10
    }

状态码

  • 正常

    状态码

    说明

    200

    OK

  • 异常

    状态码

    说明

    400

    请求参数不合法

    401

    鉴权失败

    403

    没有操作权限

    404

    请求对象不存在

    500

    服务内部错误

    503

    服务不可用

错误码

请参考错误码