实例迁移 REST API

可使用此 REST API 来将实例从一个计算节点移至云组中的另一个计算节点。

注: 如果启用了自动重新平衡,那么移动实例可能会导致系统自动移动该实例或其他实例以恢复平衡。 有关更多信息,请参阅相关信息部分。

迁移实例

表 1. 迁移实例
REST API 信息 描述
URI /admin/resources/instance_migrations  
方法 (method) POST  
返回 200 已创建实例迁移。
500 Platform System Manager 在处理请求时迂到内部错误。

请求主体

{
    "compute_nodes" : "/admin/resources/compute_nodes/637a4f06-71b2-4b0c-9088-577b0b92a47e",
    "name" : "Manual_Migration",
    "state" : "start",
    "instances" : "/admin/resources/instances/044bbb90-f0f5-40d5-b7c8-1821cfeb3b12"
}
compute_nodes
将实例移至的计算节点的 URI。
实例迁移的定制名称。
state
指定“start”以开始进行迁移。
实例
要移动的实例的 URI。

响应

系统会以 Location 头(用于指定已创建的实例迁移的 URI)作为响应。 您可以使用 检查实例迁移的状态中的信息来监视实例迁移的状态。

如果实例迁移成功,那么会生成 CWZIP6015I 事件。 如果实例迁移失败,那么会生成一个或多个错误事件。

检查实例迁移的状态

可以监视实例迁移的状态,以检查实例迁移是否成功。

表 2. 检查实例迁移的状态
REST API 信息 描述
URI /admin/resources/instance_migrations/{id}  
方法 (method) GET  
返回 200 检索到实例迁移。
404 找不到实例迁移。
500 Platform System Manager 在处理请求时迂到内部错误。

响应主体

{
      "compute_nodes": "/admin/resources/compute_nodes/637a4f06-71b2-4b0c-9088-577b0b92a47e",
      "progress": 100,
      "id": "/admin/resources/instance_migrations/ea403904-6c45-41df-9cc0-5088671fb53f",
      "created_time_raw": 1421345322940,
      "updated_time_raw": 1421345354015,
      "messages_key": "",
      "name": "",
      "state": "successful",
      "isas_rn": 1,
      "storage_volumes": null,
      "instances": "/admin/resources/instances/044bbb90-f0f5-40d5-b7c8-1821cfeb3b12",
      "created_time": "Thu 15 Jan 2015 18:08:42.940 UTC",
      "updated_time": "Thu 15 Jan 2015 18:09:14.015 UTC",
      "version": "2.1.0.0"
}
compute_nodes
该实例定向至的计算节点。
进度
实例迁移的进度(百分比)。
id
实例迁移的 URI。
state
实例迁移的状态。 完成实例迁移时,state 的值为“successful”;如果实例迁移失败,那么 state 的值为“failed”。
实例
所迁移的实例的 URI。