更新时间:2022-07-29 GMT+08:00

查询快照列表

功能介绍

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

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

    服务不可用。