创建快照

功能介绍

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

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	服务不可用。