恢复集群

功能介绍

该接口用于使用快照恢复集群。

URI

• URI 格式

  POST /v1.0/{project_id}/snapshots/{snapshot_id}/actions

• 参数说明

  表1 URI参数说明

  参数	是否必选	参数类型	描述
  project_id	是	String	项目ID。获取方法，请参见获取项目ID。
  snapshot_id	是	String	待恢复的快照ID。

请求消息

• 请求样例

  POST /v1.0/89cd04f168b84af6be287f71730fdb4b/snapshots/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba90/actions
  {"restore": {
          "name": "dws-1",
          "subnet_id": "374eca02-cfc4-4de7-8ab5-dbebf7d9a720",
          "security_group_id": "dc3ec145-9029-4b39-b5a3-ace5a01f772b",
          "vpc_id": "85b20d7e-9eb7-4b2a-98f3-3c8843ea3574",
          "availability_zone": "ae-ad-1",
          "port": 8000,
          "public_ip": {
              "public_bind_type": "auto_assign",
              "eip_id": ""
          }, 
          "enterprise_project_id":"aca4e50a-266f-4786-827c-f8d6cc3fbada"
      }
  }

• 参数说明

  表2 请求参数说明

  参数	是否必选	参数类型	描述
  restore	是	Restore object	恢复对象

  表3 Restore

  参数	是否必选	参数类型	描述
  name	是	String	集群名称，要求唯一性，必须以字母开头并只包含字母、数字、中划线，下划线，长度为4~64个字符。
  subnet_id	否	String	指定子网id，用于集群网络配置。默认值与原集群相同。
  security_group_id	否	String	指定安全组id，用于集群网络配置。默认值与原集群相同。
  vpc_id	否	String	指定虚拟私有云id，用于集群网络配置。默认值与原集群相同。
  availability_zone	否	String	指定集群可用区。默认值与原集群相同
  port	否	Integer	指定集群服务端口，取值范围8000~30000。
  public_ip	否	PublicIp object	公网IP地址，如果未指定，则默认不使用公网连接。

  表4 PublicIp

  参数	是否必选	参数类型	描述
  public_bind_type	是	String	弹性IP绑定类型，取值如下: auto_assign：现在购买 not_use：暂不使用 bind_existing :使用已有
  eip_id	否	String	弹性IP的ID。

响应消息

• 响应样例

  {
      "cluster": {
          "id": "7d85f602-a948-4a30-afd4-e84f47471c15"
       }
  }

• 参数说明

  表5 响应参数说明

  参数	参数类型	描述
  cluster	Cluster object	集群对象

  表6 Cluster

  参数	参数类型	描述
  id	String	集群ID

状态码

• 正常

  200

• 异常

  表7 返回值说明

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