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

modify_acl 方法（cat 对象）

说明

替换目录 ACL 中与所有者或主体有关的部分。

语法

/api/v2/cat/modify_acl?cat=catalog&acl=<ACLs>&vdc=controller-name

参数

Cat

目录的名称

acl

用斜杠 (/) 分隔的主体的 URL 编码列表

事务类型

同步

请求类型

GET

示例

通过将所有者替换为 api@3tera.com 来修改目录 test 的 ACL

GET
http://192.168.123.200/api/v2/cat/modify_acl?cat=/test&acl=local%3Auser%3Aapi%403tera.com%3Downer&vdc=mygrid

通过替换所有者 api@3tera.com 和主体 local:user:api@3tera.com=full 来修改应用 test 的 ACL

GET
http://192.168.123.200/api/v2/cat/modify_acl?cat=/test&acl=local%3Auser%3Aapi%403tera.com%3Downer%2Flocal%3Auser%3Aapi%403tera.com%3Dfull&vdc=mygrid

通过替换 test@3tera.com 和 api@3tera.com 以及主体 local:user:api@3tera.com=configure/local:user:test@3tera.com=read 的访问级别来修改应用的 ACL。

GET
http://192.168.123.200/api/v2/cat/modify_acl?cat=/test&acl=local%3Auser%3Aapi%403tera.com%3Dconfigure%2Flocal%3Auser%3Atest%403tera.com%3Dread&vdc=mygrid

样例输出

JSON：

{
   "message" : ""
} 

XML：

<message></message>

HTTP 错误代码

400

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

400.4

缺少必需参数 (cat)
－缺少参数 cat=cat

缺少必需参数 (acl)

－缺少参数 acl=acl

404.1

未找到实体－目录 test 不存在。

－指定的目录在 mygrid 上不存在。

未找到实体－无法放置目录 ACL－主体数据无效－主体本地用户“test@3tera.com”不存在。

－指定的 owner 或 acl 无效

注意：此 API 可用于 WS_API_r6-1.0.6-1 及更高版本。