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

put_acl 方法（vdc 对象）

说明

替换整个网格 ACL。

语法

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

参数

owner

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

acl

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

vdc

目标虚拟数据中心的名称

事务类型

同步

请求类型

GET

示例

将 vdc mygrid 的整个 ACL 替换为所有者 api@3tera.com

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

将 vdc mygrid 的整个 ACL 替换为所有者 api@3tera.com 和主体 local:user:api@3tera.com=app_developer

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

将 vdc mygrid 的整个 ACL 替换为所有者 api@3tera.com 和主体 local:user:api@3tera.com=app_developer/local:user:test@3tera.com=monitor。

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

HTTP 错误代码

400

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

400.4

缺少必需参数 (owner)

－参数 owner=owner

缺少必需参数 (acl)

－缺少参数 acl=acl

404.1

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

－指定的 owner 或 acl 无效

样例输出

JSON：

{
   "message" : ""
} 

XML：

<message></message>

注释

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