文档首页/IAM 身份中心/API参考/API/SCIM用户组管理/列出用户组 - SCIMListGroups
更新时间：2025-12-12 GMT+08:00
在线调试
CLI示例
查看PDF
分享

列出用户组 - SCIMListGroups

功能介绍

对现有用户组列表执行筛选查询，最多只能返回50个结果。

URI

GET /{tenant_id}/scim/v2/Groups

表1 路径参数

参数

是否必选

参数类型

描述

tenant_id

是

String

租户的全局唯一标识符（ID）。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

承载令牌。

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

totalResults

Integer

总结果数。

itemsPerPage

Integer

每页的元素个数。

startIndex

String

起始索引。

schemas

Array of strings

概要。

Resources

Array of objects

包含用户组信息的列表。

表4 Resources

参数

参数类型

描述

id

String

用户组的全局唯一标识符（ID）。

externalId

String

外部标识符。

meta

Object

元数据。

schemas

Array of strings

概要。

displayName

String

包含用户组显示名称的字符串。

members

Array of objects

用户组中的成员对象列表。

表5 Resources.meta

参数

参数类型

描述

resourceType

String

资源类型。

created

String

资源创建时间。

lastModified

String

资源最后更新时间。

表6 Resources.members

参数

参数类型

描述

value

String

成员的全局唯一标识符（ID）。

$ref

String

成员的引用信息。

type

String

成员类型，User：用户。

状态码： 400

表7 响应Body参数

参数

参数类型

描述

schema

String

概要。

schemas

Array of strings

概要列表。

detail

String

异常详情。

status

Integer

状态码。

timeStamp

String

时间戳。

状态码： 403

表8 响应Body参数

参数

参数类型

描述

schema

String

概要。

schemas

Array of strings

概要列表。

detail

String

异常详情。

status

Integer

状态码。

timeStamp

String

时间戳。

状态码： 404

表9 响应Body参数

参数

参数类型

描述

schema

String

概要。

schemas

Array of strings

概要列表。

detail

String

异常详情。

status

Integer

状态码。

timeStamp

String

时间戳。

状态码： 409

表10 响应Body参数

参数

参数类型

描述

schema

String

概要。

schemas

Array of strings

概要列表。

detail

String

异常详情。

status

Integer

状态码。

timeStamp

String

时间戳。

状态码： 500

表11 响应Body参数

参数

参数类型

描述

schema

String

概要。

schemas

Array of strings

概要列表。

detail

String

异常详情。

status

Integer

状态码。

timeStamp

String

时间戳。

请求示例

列出用户组。

GET https://{hostname}/{tenant_id}/scim/v2/Groups

响应示例

状态码： 200

Successful

{
  "totalResults" : 1,
  "itemsPerPage" : 10,
  "startIndex" : "649040aaaaaaaaaaaa3e3050",
  "schemas" : [ "urn:ietf:params:scim:api:messages:2.0:ListResponse" ],
  "Resources" : [ {
    "id" : "0efaa0db-6aa4-7aaa-6aa5-c222aaaaf31a",
    "meta" : {
      "resourceType" : "Group",
      "created" : "2023-04-08T14:53:43Z",
      "lastModified" : "2023-04-08T14:53:43Z"
    },
    "schemas" : [ "urn:ietf:params:scim:schemas:core:2.0:Group" ],
    "displayName" : "SCIM用户组名g1",
    "members" : [ {
      "value" : "ac6aa714-daa7-1aaa-aaa2-6715aaaa4dd9",
      "$ref" : "../Users/ac6aa714-daa7-1aaa-aaa2-6715aaaa4dd9",
      "type" : "User"
    } ]
  } ]
}

状态码

请参见状态码。

错误码

请参见错误码。