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

put_acl 方法（app 对象）

说明

替换整个应用 ACL。

语法

/api/v2/app/put_acl?app=application&owner=<owner>&acl=<ACLs>&vdc=controller-name

参数

app

应用的名称

owner

指定主体的应用 ACL 的 URL 编码所有者属性。 例如：local:user:api@3tera.com 应以 local%3Auser%3Aapi%403tera.com 的形式传递

owner

指定主体的网格 ACL 的 URL 编码的所有者属性

acl

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

vdc

目标虚拟数据中心的名称

事务类型

同步

请求类型

GET

示例

将应用 test 的整个 ACL 替换为所有者 api@3tera.com

GET
http://192.168.123.200/api/v2/app/put_acl?app=test&owner=local%3Auser%3Aapi%403tera.com&acl=&vdc=mygrid 

将应用 test 的整个 ACL 替换为所有者 api@3tera.com 和主体 local:user:api@3tera.com=full

GET
http://192.168.123.200/api/v2/app/put_acl?app=test&owner=local%3Auser%3Aapi%403tera.com&acl= local%3Auser%3Aapi%403tera.com%3Dfull&vdc=mygrid

将应用 test 的整个 ACL 替换为所有者 api@3tera.com 和主体 local:user:api@3tera.com=full/local:user:test@3tera.com=configure。

GET
http://192.168.123.200/api/v2/app/put_acl?app=test&owner=local%3Auser%3Aapi%403tera.com&acl=local%3Auser%3Aapi%403tera.com%3Dfull%2Flocal%3Auser%3Atest%403tera.com%3Dconfigure&vdc=mygrid

样例输出

JSON

{
   "message" : ""
} 

XML

<message></message>

HTTP 错误代码

404

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

400.4

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

缺少必需参数 (owner)

－参数 owner=owner

缺少必需参数 (acl)

－缺少参数 acl=acl

404.1

未找到实体－应用 test 不存在。

－指定的应用在 mygrid 上不存在。

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

－指定的 owner 或 acl 无效

注释

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