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

查询快照详情

功能介绍

该接口用于使用快照id查询快照详情。

URI

  • URI 格式
    GET /v1.0/{project_id}/snapshots/{snapshot_id}
  • 参数说明
    表1 URI参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    String

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

    snapshot_id

    String

    快照ID。

请求消息

请求样例

GET /v1.0/89cd04f168b84af6be287f71730fdb4b/snapshots/b5c45780-1006-49e3-b2d5-b3229975bbc7

响应消息

  • 响应样例
    status CODE 200
    {
        "snapshot": {
            "id": "2a4d0f86-67cd-408a-8b66-017454fb7793",
            "name": "snapshot-1",
            "description": "snapshot 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"
        }
    }
  • 参数说明
    表2 响应参数说明

    参数

    参数类型

    描述

    snapshot

    SnapshotDetail object

    快照对象

    表3 SnapshotDetail

    参数

    参数类型

    描述

    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

    服务不可用。