上一主题: destroy 方法（vol 对象）下一主题: rename 方法（vol 对象）

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

format 方法（vol 对象）
说明

格式化现有的卷

语法
/api/v2/vol/format?app=application&vol=volume&fs=filesystem&vdc=controller-name
参数
app

应用的名称

vol

卷的名称

fs

要创建的卷的文件系统

vdc

目标虚拟数据中心的名称

事务类型

异步

请求类型

GET

示例

格式化 fs=ext3 的卷 test:vol1。 

GET http://192.168.123.200/api/v2/vol/format?app=test&vol=vol1&fs=ext3&vdc=mygrid
样例输出
XML：
<job>be805915-76b2-48c8-b8a0-b881cca66da6</job>
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

缺少必需参数 (fs)。 －请求中缺少参数 fs=fs。

注意：这将删除当前存储在卷上的所有数据。 要获取作业的状态，请以上面返回的 job_id 作为参数发出 /api/v2/job/info? 请求。 有关如何获取作业状态的详细信息，请参考作业对象。