恢复集群
功能介绍
该接口用于使用快照恢复集群。
调用方法
请参见如何调用API。
URI
POST /v1.0/{project_id}/snapshots/{snapshot_id}/actions
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 项目ID。获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
snapshot_id |
是 |
String |
参数解释: 待恢复的快照ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
restore |
是 |
Restore object |
参数解释: 恢复对象。 取值范围: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
是 |
String |
参数解释: 集群名称。 取值范围: 要求唯一性,必须以字母开头并只包含字母、数字、中划线,下划线,长度为4~64个字符。 |
|
subnet_id |
否 |
String |
参数解释: 指定子网ID,用于集群网络配置。 取值范围: 默认值与原集群相同。 |
|
security_group_id |
否 |
String |
参数解释: 指定安全组ID,用于集群网络配置。默认值与原集群相同。 取值范围: 不涉及。 |
|
vpc_id |
否 |
String |
参数解释: 指定虚拟私有云ID,用于集群网络配置。默认值与原集群相同。 取值范围: 不涉及。 |
|
availability_zone |
否 |
String |
参数解释: 指定集群可用区。默认值与原集群相同。 取值范围: 不涉及。 |
|
port |
否 |
Integer |
参数解释: 指定集群服务端口。 取值范围: 不涉及。 |
|
public_ip |
否 |
PublicIp object |
参数解释: 公网IP地址,如果未指定,则默认不使用公网连接。 取值范围: 不涉及。 |
|
enterprise_project_id |
否 |
String |
参数解释: 企业项目ID,对集群指定企业项目。如果未指定,则使用默认企业项目“default”的ID,即0。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 0 |
|
ipv6_enable |
否 |
Boolean |
参数解释: 指定网络协议类型,表明是否支持IPv6,默认不使用IPv6。 取值范围: 不涉及。 |
请求示例
恢复快照到新集群dws-1,新集群在az1.dc1可用区下,数据库端口为8000,带子网ID,安全组ID,虚拟私有云ID,公网IP,企业ID等。
POST https://{Endpoint}/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" : "az1.dc1",
"port" : 8000,
"public_ip" : {
"public_bind_type" : "auto_assign",
"eip_id" : ""
},
"enterprise_project_id" : "aca4e50a-266f-4786-827c-f8d6cc3fbada"
}
}
响应示例
状态码:200
恢复集群请求下发成功。
{
"cluster" : {
"id" : "7d85f602-a948-4a30-afd4-e84f47471c15"
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
恢复集群请求下发成功。 |
|
400 |
请求错误。 |
|
401 |
鉴权失败。 |
|
403 |
没有操作权限。 |
|
404 |
找不到资源。 |
|
500 |
服务内部错误。 |
|
503 |
服务不可用。 |