查询备份数量

功能介绍

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

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	服务不可用

错误码

请参考错误码。