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

modify_acl 方法（template 对象）

说明

替换模板 ACL 中与所有者或主体相关的部分。

语法

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

参数

模板

模板的名称

acl

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

vdc

目标虚拟数据中心的名称

事务类型

同步

请求类型

GET

示例

通过将所有者替换为 api@3tera.com 来修改模板应用 VDS_CentOS 的 ACL

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

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

GET
http://192.168.123.200/api/v2/template/modify_acl?template=VDS_CentOS&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 的访问级别来修改模板应用 VDS_CentOS 的 ACL。

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

HTTP 错误代码

400

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

400.4

缺少必需参数 (template)

－缺少参数 template=template

缺少必需参数 (acl)

－缺少参数 acl=acl

404.1

未找到实体－模板 VDS_CentOS 不存在。

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

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

－指定的 owner 或 acl 无效

样例输出

JSON：

{
   "message" : ""
} 

XML：

<message></message>

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