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

rename 方法（cat 对象）

说明

重命名全局目录

语法

/api/v2/cat/rename?cat=catalog&new_name=new-catalog&vdc=controller-name 

参数

Cat

要重命名的目录的名称

new_name

目录的新名称

vdc

目标虚拟数据中心的名称

事务类型

同步

请求类型

GET

示例

将 /test 目录重命名为 /test2。

GET http://192.168.123.200/api/v2/cat/rename?cat=/test&new_name=/test2&vdc=mygrid 

样例输出

XML：

<opt></opt>

JSON：

{} 

HTTP 错误代码

404

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

400.4

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

400.4

缺少必需参数 (new_name)。 －请求中缺少参数 new_name=new-catalog。

404.1

目录 test 不存在。 －请求中指定的目录无效。

404.1

test 不是有效的目录。 －目录中指定的 new_name 无效。