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

put_newobj_acl 方法（group 对象）

说明

替换与组关联的整个新对象 ACL 定义。

语法

/api/v2/group/put_newobj_acl?group=group&acl=<ACLs>&vdc=controller-name 
 

参数

group

组名；在组名前添加 / 来表示全局组。

acl

URL 编码的“/” 分隔的主体列表。

所有者的主体必须是组。

例如，local:group:apigroup=full 应以 local%3Agroup%3Aapigroup%3Dfull 的形式传递

例如，local:group:apigroup=full/local:user:test@3tera.com=configure 应以 local%3Agroup%3Aapigroup%3Dfull%2Flocal%3Auser%3Atest%403tera.com%3Dconfigure 的形式传递

vdc

目标虚拟数据中心的名称

事务类型

同步

请求类型

GET

示例

GET http://192.168.123.200/api/v2/group/put_newobj_acl?group=apigroup&acl=apigroup%3Downer%2Ftest%403tera.com%3Dconfigure&vdc=mygrid  

样例输出

XML：

<message></message>

JSON：

{
   "message" : ""
} 

HTTP 错误代码

404

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

404.1

未找到实体 －没有与“principal”匹配的主体名称

400.4

缺少必需参数 (acl)。 －请求中缺少参数 acl=<ACL>。

400.4

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

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