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

get_newobj_acl 方法（group 对象）

说明

显示与组关联的新对象 ACL 定义，或显示与特定主体相关的部分新对象 ACL 定义。

语法

/api/v2/group/get_newobj_acl?group=group&principal=principal&vdc=vdc 

参数

group

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

principal

主体的名称。 <主体> 的格式如下：

URL

编码的主体格式如下：

<名称>－本地用户或组。

<名称>－全局用户或组。

<范围>:<类型>:<名称>－完全限定的主体名称，其中 <范围> 是“全局”或“本地”，<类型> 是“组”或“用户”，<名称> 是组或用户名。

例如：local:user:api@3tera.com=full 应以 local%3Auser%3Aapi%403tera.com%3Dfull 的形式传递

如果主体是空字符串，那么显示与组关联的完全的新对象 ACL 定义，否则只会显示与特定主体相关的部分新对象 ACL 定义。

vdc

目标虚拟数据中心的名称

事务类型

同步

请求类型

GET

示例

GET http://192.168.123.200/api/v2/group/get_newobj_acl?group=apigroup&principal=&vdc=mygrid

样例输出

XML：

<acl>
  <entries>
    <entry>
      <full>1</full>
      <id>a5cb10bc-7291-4a86-84f8-74419fc9ae63</id>
    </entry>
  </entries>
  <owner>
    <id></id>
  </owner>
</acl>

JSON：

{
   "acl" : {
      "owner" : {
         "id" : ""
      },
      "entries" : [
         {
            "id" : "a5cb10bc-7291-4a86-84f8-74419fc9ae63",
            "full" : 1
         }
      ]
   }
}

HTTP 错误代码

404

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

404.1

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

400.4

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

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