保护实例变更规格
功能介绍
变更指定保护实例中弹性云服务器的规格,包括:同时变更生产站点云服务器和容灾站点云服务器的规格。 仅变更生产站点云服务器的规格,容灾站点云服务器规格不变。 生产站点云服务器规格不变,仅变更容灾站点云服务器的规格。 当且仅当待变更规格的云服务器处于关机状态时,才能执行此操作。 说明:不同规格的云服务器在性能上存在差异,可能会对云服务器上运行的应用产生影响。 为保证切换/故障切换后云服务器的性能,建议容灾站点服务器的规格(CPU、内存)不低于生产站点云服务器的规格(CPU、内存)。
接口约束
保护组的状态为available或者protected。 保护实例的状态为available或者protected或者error-resizing。 待变更规格的云服务器已关机。
调试
您可以在API Explorer中调试该接口。
URI
POST /v1/{project_id}/protected-instances/{protected_instance_id}/resize
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。 |
protected_instance_id |
是 |
String |
保护实例的ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
resize |
是 |
表示保护实例变更规格的操作。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
flavorRef |
否 |
String |
变更规格后,生产站点云服务器和容灾站点云服务器的flavor ID。可通过查询云服务器规格变更支持列表接口获取。 说明:系统支持同时变更生产站点云服务器和容灾站点云服务器的规格。如需同时变更,请使用flavorRef参数,变更规格后,生产站点云服务器和容灾站点云服务器的规格相同。 |
production_flavorRef |
否 |
String |
变更规格后,生产站点云服务器的flavor ID。可通过查询云服务器规格变更支持列表接口获取。 说明:系统支持仅变更生产站点云服务器的规格。此时,请使用production_flavorRef参数。当flavorRef参数有值时,production_flavorRef参数不生效。 |
dr_flavorRef |
否 |
String |
变更规格后,容灾站点云服务器的flavor ID。可通过查询云服务器规格变更支持列表接口获取。 说明:系统支持仅变更容灾站点云服务器的规格。此时,请使用dr_flavorRef参数。当flavorRef参数有值时,dr_flavorRef参数不生效。 |
production_dedicated_host_id |
否 |
String |
新生产站点专属主机ID。 说明:生产站点云服务器在专属主机上时,变更规格需要指定此参数。可以指定为生产站点云服务器当前所在专属主机ID或其他专属主机ID。 |
dr_dedicated_host_id |
否 |
String |
新容灾站点专属主机ID。 说明:容灾站点云服务器在专属主机上时,变更规格需要指定此参数。可以指定为容灾站点云服务器当前所在专属主机ID或其他专属主机ID。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
job_id |
String |
成功返回jobId信息 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error |
ErrorInfo object |
失败返回结构 |
状态码: 401
参数 |
参数类型 |
描述 |
---|---|---|
error |
ErrorInfo object |
失败返回结构 |
状态码: 403
参数 |
参数类型 |
描述 |
---|---|---|
error |
ErrorInfo object |
失败返回结构 |
状态码: 404
参数 |
参数类型 |
描述 |
---|---|---|
error |
ErrorInfo object |
失败返回结构 |
状态码: 405
参数 |
参数类型 |
描述 |
---|---|---|
error |
ErrorInfo object |
失败返回结构 |
状态码: 406
参数 |
参数类型 |
描述 |
---|---|---|
error |
ErrorInfo object |
失败返回结构 |
状态码: 407
参数 |
参数类型 |
描述 |
---|---|---|
error |
ErrorInfo object |
失败返回结构 |
状态码: 408
参数 |
参数类型 |
描述 |
---|---|---|
error |
ErrorInfo object |
失败返回结构 |
状态码: 409
参数 |
参数类型 |
描述 |
---|---|---|
error |
ErrorInfo object |
失败返回结构 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error |
ErrorInfo object |
失败返回结构 |
状态码: 501
参数 |
参数类型 |
描述 |
---|---|---|
error |
ErrorInfo object |
失败返回结构 |
状态码: 502
参数 |
参数类型 |
描述 |
---|---|---|
error |
ErrorInfo object |
失败返回结构 |
状态码: 503
参数 |
参数类型 |
描述 |
---|---|---|
error |
ErrorInfo object |
失败返回结构 |
状态码: 504
参数 |
参数类型 |
描述 |
---|---|---|
error |
ErrorInfo object |
失败返回结构 |
请求示例
-
变更生产站点云服务器的规格为e2.small,容灾站点云服务器规格不变
POST https://{Endpoint}/v1/{project_id}/protected-instances/00000000632302f501632305f63c000e/resize { "resize" : { "production_flavorRef" : "e2.small" } }
-
生产站点云服务器规格不变,变更容灾站点云服务器的规格为e2.small
POST https://{Endpoint}/v1/{project_id}/protected-instances/00000000632302f501632305f63c000e/resize { "resize" : { "dr_flavorRef" : "e2.small" } }
-
容灾站点云服务器为DeH,生产站点云服务器规格不变,变更容灾站点云服务器的规格为e2.small。
POST https://{Endpoint}/v1/{project_id}/protected-instances/00000000632302f501632305f63c000e/resize { "resize" : { "dr_flavorRef" : "e2.small", "dr_dedicated_host_id" : "59f82ad6-6fc9-4bae-8621-aef2194e112c" } }
-
变更规格后,生产站点云服务器和容灾站点云服务器的规格为e2.small
POST https://{Endpoint}/v1/{project_id}/protected-instances/00000000632302f501632305f63c000e/resize { "resize" : { "flavorRef" : "e2.small" } }
-
生产站点云服务器为DeH,变更生产站点云服务器的规格为e2.small,容灾站点云服务器规格不变。
POST https://{Endpoint}/v1/{project_id}/protected-instances/00000000632302f501632305f63c000e/resize { "resize" : { "production_flavorRef" : "e2.small", "production_dedicated_host_id" : "59f82ad6-6fc9-4bae-8621-aef2194e112c" } }
-
变更规格后,生产站点云服务器的规格为s3.small.1,容灾站点云服务器的规格为s3.large.2。
POST https://{Endpoint}/v1/{project_id}/protected-instances/00000000632302f501632305f63c000e/resize { "resize" : { "production_flavorRef" : "s3.small.1", "dr_flavorRef" : "s3.large.2" } }
响应示例
状态码: 200
OK
{ "job_id" : "0000000011db92d70162db9d20df32ch" }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not Found |
405 |
Method Not Allowed |
406 |
Not Acceptable |
407 |
Proxy Authentication Required |
408 |
Request Timeout |
409 |
Conflict |
500 |
Internal Server Error |
501 |
Not Implemented |
502 |
Bad Gateway |
503 |
Service Unavailable |
504 |
Gateway Timeout |
错误码
请参见错误码。