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

部分更新用户组 - SCIMPatchGroup

功能介绍

修改现有用户组的部分属性，和管理用户组中的用户。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

tenant_id

是

String

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

group_id

是

String

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

承载令牌。
表3 请求Body参数

参数

是否必选

参数类型

描述

schemas

是

Array of strings

概要。

Operations

是

Array of objects

要执行的修改操作列表。
表4 Operations

参数

是否必选

参数类型

描述

op

是

String

要执行的修改操作类型。 add：添加属性，replace：替换属性，remove：删除属性。

value

否

Object

要修改的属性值。

path

否

String

要修改的属性路径。只有用户组的以下属性可以修改： displayName，members，externalId。

响应参数

状态码： 400

表5 响应Body参数

参数

参数类型

描述

schema

String

概要。

schemas

Array of strings

概要列表。

detail

String

异常详情。

status

Integer

状态码。

timeStamp

String

时间戳。

状态码： 403

表6 响应Body参数

参数

参数类型

描述

schema

String

概要。

schemas

Array of strings

概要列表。

detail

String

异常详情。

status

Integer

状态码。

timeStamp

String

时间戳。

状态码： 404

表7 响应Body参数

参数

参数类型

描述

schema

String

概要。

schemas

Array of strings

概要列表。

detail

String

异常详情。

status

Integer

状态码。

timeStamp

String

时间戳。

状态码： 409

表8 响应Body参数

参数

参数类型

描述

schema

String

概要。

schemas

Array of strings

概要列表。

detail

String

异常详情。

status

Integer

状态码。

timeStamp

String

时间戳。

状态码： 500

表9 响应Body参数

参数

参数类型

描述

schema

String

概要。

schemas

Array of strings

概要列表。

detail

String

异常详情。

status

Integer

状态码。

timeStamp

String

时间戳。

请求示例

更新用户组的部分属性。

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

{
  "schemas" : [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ],
  "Operations" : [ {
    "op" : "replace",
    "value" : {
      "id" : "0efaa0db-6aa4-7aaa-6aa5-c222aaaaf31a",
      "displayName" : "更新显示名称"
    }
  }, {
    "op" : "add",
    "path" : "members",
    "value" : [ {
      "value" : "ac6aa714-daa7-1aaa-aaa2-6715aaaa4dd9"
    } ]
  }, {
    "op" : "replace",
    "path" : "members",
    "value" : [ {
      "value" : "ac6aa714-daa7-1aaa-aaa2-6715aaaa4dd9"
    }, {
      "value" : "1bdaa75c-7aaf-3aa2-7aac-6a00aaaa335f"
    } ]
  }, {
    "op" : "remove",
    "path" : "members",
    "value" : [ {
      "value" : "ac6aa714-daa7-1aaa-aaa2-6715aaaa4dd9"
    }, {
      "value" : "1bdaa75c-7aaf-3aa2-7aac-6a00aaaa335f"
    } ]
  } ]
}

响应示例

无

状态码

请参见状态码。

错误码

请参见错误码。

父主题： SCIM用户组管理