import 方法（vol 对象）

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

import 方法（vol 对象）

说明

将卷从容器文件导出到 /vol/_impex/

语法

/api/v2/vol/import?app=application&vol=volume&target=filename.img.gz&vdc=controller-name

参数

app

承载新卷的应用或域名称

vol

新卷的名称

target

从中导入卷的容器文件名称。

从指定网格上导入/导出卷的根定位的文件检索卷数据：/vol/_impex/。如果文件名称扩展是 .gz，则是 gzip 压缩的数据。

vdc

目标虚拟数据中心的名称。

事务类型

异步

请求类型

GET

示例

从以下压缩的容器文件导入卷 test2:vol2

/vol/_impex/test.img.gz。

GET

http://192.168.123.200/api/v2/vol/import?app=test2&vol=vol2&target=test.img.gz&vdc=mygrid

样例输出

XML：


<job>bdc176a5-c069-4b23-89d2-d933127a9766</job>

JSON：


{
   "job" : "bdc176a5-c069-4b23-89d2-d933127a9766"
}

HTTP 错误代码

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

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

migrate 方法（vol 对象）

说明

使用不同体系结构在网格之间迁移卷。

语法

/api/v2/vol/migrate?remote_grid=grid_name&name=volume&local_ip=ip_address &remote_ip=ip_address&vdc=controller-name

参数

remote grid

从中导入卷（或在指定“导出(&E)”选项标志时将卷导出到）的网格名称。

name

要迁移的卷的名称。值遵循的格式

<application>:<volume>, _GLOBAL:<volume>, or _GLOBAL_RO:<volume>

local_ip

本地网格的可用 IP 地址，用于迁移应用以便使用。

值为以下格式之一：

[_vlan.][<vlan id>.]<ip address>
net.<networkName>.<ip_address>

remote_ip

远程网格的可用 IP 地址，用于迁移应用以便使用。

值为以下格式之一：

[_vlan.][<vlan id>.]<ip address>
net.<networkName>.<ip_address>

vdc

目标虚拟数据中心的名称。

选项

new_name

卷的新名称。值为以下格式之一：

<application>:<volume>, _GLOBAL:<volume>, or _GLOBAL_RO:<volume>

migrating_class

在建立迁移程序应用中使用的类。此类必须驻留在全局目录中。默认为 /filer:Filer_Linux_ADMI。

encr_key

指定包含要提供给应用执行卷迁移的固定加密密钥的卷名称。

<属性>=<值>

卷参数。

卷属性从正在迁移的卷中检索。以下参数可用于从正在迁移的卷覆盖当前值。在减少卷或分区大小时，请谨慎使用。

卷参数	说明
- fs	文件系统类型。（例如，ext3）
- size	卷大小。可指定单位（例如，128M[B]、2G[B]）默认情况下，该值被解析为若干 MB。
- comment	卷注释
- fs options	用于格式化卷的其他文件系统选项
- mirrored	卷已镜像
- parN.	分区参数（可选）。有关详细信息，请参阅注意。

&export: 将卷迁移到远程网格（默认），从而在两个网格之间需要双向信任。
&import: 从远程网格迁移卷（默认）