查询快照列表

功能介绍

该接口用于查询快照列表。

URI

• URI 格式

  GET /v1.0/{project_id}/snapshots

• 参数说明

  表1 URI参数说明

  参数	是否必选	参数类型	描述
  project_id	是	String	项目ID。获取方法，请参见获取项目ID。

请求消息

请求样例

GET /v1.0/89cd04f168b84af6be287f71730fdb4b/snapshots

响应消息

• 响应样例

  status CODE 200
  {
      "snapshots": [
          {
              "id": "2a4d0f86-67cd-408a-8b66-017454fb7793",
              "name": "snapshot-1",
              "description": "",
              "started": "2016-08-23T03:59:23Z",
              "finished": "2016-08-23T04:01:40Z", 
              "size": 500,
              "status": "AVAILABLE",
              "type": "MANUAL",
              "cluster_id": "4f87d3c4-9e33-482f-b962-e23b30d1a18c"
          },
          {
              "id": "4af11460-06ec-48a4-b3ad-0e3bbdcd8ab1",
              "name": "snapshot-2",
              "description": "",
              "started": "2016-08-23T18:20:00Z",
              "finished": "2016-08-23T18:22:12Z",
              "size": 500,
              "status": "AVAILABLE",
              "type": "MANUAL",
              "cluster_id": "4f87d3c4-9e33-482f-b962-e23b30d1a18c"
          }
      ],
         "count":2
  }

• 参数说明

  表2 响应参数说明

  参数	参数类型	描述
  snapshots	Array of Snapshots objects	快照对象列表。
  count	Integer	快照对象列表总数。

  表3 Snapshots

  参数	参数类型	描述
  id	String	快照ID。
  name	String	快照名称。
  description	String	快照描述。
  started	String	快照创建的日期时间，格式为 ISO8601：YYYY-MM-DDThh:mm:ssZ。
  finished	String	快照完成的日期时间，格式为 ISO8601：YYYY-MM-DDThh:mm:ssZ。
  size	Double	快照大小，单位 GB。
  status	String	快照状态： CREATING：创建中。 AVAILABLE：可用。 UNAVAILABLE：不可用。
  type	String	快照创建类型有： MANUAL：手动快照。 AUTOMATED：自动快照。
  cluster_id	String	快照对应的集群ID。获取方法，请参见获取集群ID。

状态码

• 正常

  200

• 异常

  表4 返回值说明

  返回值	描述
  400 Bad Request	请求错误。
  401 Unauthorized	鉴权失败。
  403 Forbidden	没有操作权限。
  404 Not Found	找不到资源。
  500 Internal Server Error	服务内部错误
  503 Service Unavailable	服务不可用。