listGroups

名称

listGroups - 列出用户组的信息

语法

System.listGroups( [options], [filter] )

类别

System

描述

列出用户组的信息

参数

options 参数详细说明如下：

Note：

filter 参数支持对结果中的某些字段进行 and 、 or 、not 和精确匹配计算，对结果集进行筛选。

返回值

返回用户组的信息。

错误

如果出错则抛异常，并输出错误信息，可以通过 getLastErrMsg() 获取错误信息或通过 getLastError() 获取错误码。关于错误处理可以参考常见错误处理指南。

常见错误可参考错误码。

版本

v3.2 及以上版本

示例

• 列出所有用户组的信息

  > System.listGroups()
  {
      "name": "sequoiadb"
  }
  {
      "name": "lpadmin"
  }
  {
      "name": "sambashare"
  }
  {
      "name": "sdbadmin_group"
  }
  ...

• 对结果进行筛选

  > System.listGroups( { detail: true }, { "name": "sequoiadb" } )
  {
      "name": "sequoiadb",
      "gid": "1000",
      "members": ""
  }