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

查询用户组详情 - SCIMGetGroup

功能介绍

查询现有用户组的详情信息。

URI

GET /{tenant_id}/scim/v2/Groups/{group_id}

表1 路径参数

参数

是否必选

参数类型

描述

tenant_id

是

String

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

group_id

是

String

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

承载令牌。

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

id

String

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

externalId

String

外部标识符

meta

Object

元数据。

schemas

Array of strings

概要。

displayName

String

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

members

Array of objects

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

表4 meta

参数

参数类型

描述

resourceType

String

资源类型。

created

String

资源创建时间。

lastModified

String

资源最后更新时间。

表5 members

参数

参数类型

描述

value

String

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

$ref

String

成员的引用信息。

type

String

成员类型，User：用户。

状态码： 400

表6 响应Body参数

参数

参数类型

描述

schema

String

概要。

schemas

Array of strings

概要列表。

detail

String

异常详情。

status

Integer

状态码。

timeStamp

String

时间戳。

状态码： 403

表7 响应Body参数

参数

参数类型

描述

schema

String

概要。

schemas

Array of strings

概要列表。

detail

String

异常详情。

status

Integer

状态码。

timeStamp

String

时间戳。

状态码： 404

表8 响应Body参数

参数

参数类型

描述

schema

String

概要。

schemas

Array of strings

概要列表。

detail

String

异常详情。

status

Integer

状态码。

timeStamp

String

时间戳。

状态码： 409

表9 响应Body参数

参数

参数类型

描述

schema

String

概要。

schemas

Array of strings

概要列表。

detail

String

异常详情。

status

Integer

状态码。

timeStamp

String

时间戳。

状态码： 500

表10 响应Body参数

参数

参数类型

描述

schema

String

概要。

schemas

Array of strings

概要列表。

detail

String

异常详情。

status

Integer

状态码。

timeStamp

String

时间戳。

请求示例

查询用户组详情。

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

响应示例

状态码： 200

Successful

{
  "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"
  } ]
}

状态码

请参见状态码。

错误码

请参见错误码。