move 方法（vol 对象）

集成指南 › Web 服务 API 参考指南 › 有效对象 › vol 对象 › move 方法（vol 对象）

move 方法（vol 对象）

说明

将卷移动至备用位置

语法

/api/v2/vol/move?app=application&vol=volume&volnew=new-volume-location&vdc=controller-name

参数

app: 源应用的名称
vol: 卷的名称
volnew: 新卷位置，格式为 <application>:<volume_name>
vdc: 目标虚拟数据中心的名称

事务类型

异步

请求类型

GET

示例

将卷 atest:vol1 移动到 btest:vol2。

GET http://192.168.123.200/api/v2/vol/move?app=atest&vol=vol1&volnew=btest:vol2&vdc=mygrid

样例输出

XML：

JSON：

{

"job" : "be805915-76b2-48c8-b8a0-b881cca66da6"

}

HTTP 错误代码

404: 未找到实体 vdc mygrid－WS_API 应用中没有配置指定的 VDC 名称。
400.4: 缺少必需参数 (app)。－请求中缺少参数 app=app。
400.4: 缺少必需参数 (vol)。－请求中缺少参数 vol=vol。
400.4: 缺少必需参数 (volnew)。－请求中缺少参数 volnew=new_vol。

注意：要获取作业的状态，请以上面返回的 job_id 作为参数发出 /api/v2/job/info? 请求。有关如何获取作业状态的详细信息，请参考作业对象（参见 308 页）。

relocate 方法（vol 对象）

说明

将卷重定位到其他的卷存储（local 或 san）或到启用的服务器

语法

/api/v2/vol/relocate?app=application&name=app-or-volume&vdc=controller-name

参数

name: 要重定位的卷名称
vdc: 目标虚拟数据中心的名称

选项

store: 指定卷将被重定位的卷存储。值可为“san”或“local”。
n: 指定同时重定位的卷数。默认值：一次一个卷。
&all: 重定位需要重定位的所有卷。
&status: 列出需要重定位的卷或特定卷的重定位状态。
&suspend: 挂起正在进行的卷重定位。

事务类型

异步

请求类型

GET

示例

将应用卷 MYAPP:data 重定位到本地存储：

GET http://aux/api/v2/vol/relocate?name=MYAPP:data&store=local&vdc=mygrid

为应用 MYAPP 将所有卷重定位到 SAN：

GET http://aux/api/v2/vol/relocate?name=MYAPP&store=san&vdc=mygrid

重定位所有卷离开禁用服务器，一次三个：

GET http://aux/api/v2/vol/relocate?&all&n=3&vdc=mygrid

样例输出

XML：

 <job>b88969ea-9264-40b2-ba08-29b7ecbcc150</job>

JSON：

{
   "job" : "b88969ea-9264-40b2-ba08-29b7ecbcc150"
}

HTTP 错误代码

404: 未找到实体 vdc mygrid－WS_API 应用中没有配置指定的 VDC 名称。

注意：要获取作业的状态，请以上面返回的 job_id 作为参数发出 /api/v2/job/info? 请求。有关如何获取作业状态的详细信息，请参考作业对象。

relocate_status 方法（vol 对象）

说明

报告网格上正在进行的卷重新定位的状态

语法

/api/v2/vol/relocate_status?&vdc=controller-name

参数

vdc: 目标虚拟数据中心的名称

事务类型

异步

请求类型

GET

示例

在网格 mygrid 上检查卷重定位的进度：

GET http://aux/api/v2/vol/relocate_status?&vdc=mygrid

样例输出

XML：

<opt></opt>

JSON：

{
   "message" : ""
}

HTTP 错误代码

404: 未找到实体 vdc mygrid－WS_API 应用中没有配置指定的 VDC 名称。