# 查询备份数量
#### 功能介绍
查询备份数量，支持过滤参数查询。
#### URI
- URI GET https://{endpoint}/v1/{project_id}/checkpoint_items/count
  
- 参数说明
  表1参数说明 
  | 参数         | 是否必选 | 参数类型   | 描述                                                                                                                               |
  |:---|:---|:---|:---|
  | project_id | 是    | String | 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-csbs/zh-cn_topic_0136033750.html)。 |
     
  
 
#### 请求
- 查询参数说明
  表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"                                                                                                                                             |
  | dec           | 否    | Boolean | 是否为专属备份                                                                                                                                                                  |
     
  
- 要素说明 无
  

- 请求样例
  ```
  查询所有的数量
  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 | 服务不可用   |
     
  
 
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-csbs/zh-cn_topic_0071888297.html)。