更新时间:2022-08-16 GMT+08:00

创建快照

功能介绍

该接口用于为指定集群创建快照。

URI

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

    参数

    是否必选

    参数类型

    描述

    project_id

    String

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

请求消息

  • 请求样例
    POST /v1.0/89cd04f168b84af6be287f71730fdb4b/snapshots
    {
        "snapshot": {
           "name": "snapshot-3",
           "cluster_id": "44b277eb-39be-4921-be31-3d61b43651d7",
           "description": "Snapshot-3 description"
         }
    }
  • 参数说明
    表2 请求参数说明

    参数

    是否必选

    参数类型

    描述

    snapshot

    Snapshot object

    快照对象

    表3 Snapshot

    参数

    是否必选

    参数类型

    描述

    name

    String

    快照名称,要求唯一性且必须以字母开头,不区分大小写,可以包含字母、数字、中划线或者下划线,不能包含其他的特殊字符,长度为4~64个字符。

    cluster_id

    String

    指定创建快照的集群ID。获取方法,请参见获取集群ID

    description

    String

    快照描述,若不指定,描述为空。快照描述的字符长度不能超过256个字符,且不支持特殊字符!<>'=&"。

响应消息

  • 响应样例
    status CODE 200
    {
        "snapshot": {
            "id": "2a4d0f86-67cd-408a-8b66-017454fb7793"
        }
    }
  • 参数说明
    表4 响应参数说明

    参数

    参数类型

    描述

    snapshot

    SnapshotResp object

    快照对象。

    表5 SnapshotResp

    参数

    参数类型

    描述

    id

    String

    快照ID。

状态码

  • 正常

    200

  • 异常
    表6 返回值说明

    返回值

    描述

    400 Bad Request

    请求错误。

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。