# 部分更新用户 - SCIMPatchUser #### 功能介绍 修改现有用户的部分属性。 #### URI PATCH /{tenant_id}/scim/v2/Users/{user_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | tenant_id | 是 | String | 租户的全局唯一标识符（ID）。 | | user_id | 是 | String | 用户的全局唯一标识符（ID）。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Authorization | 是 | String | 承载令牌。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | schemas | 是 | Array of strings | 概要。 | | [Operations] | 是 | Array of objects | 要执行的修改操作列表。 | 表4Operations | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | op | 是 | String | 要执行的修改操作类型。 add：添加属性，replace：替换属性，remove：删除属性。 | | path | 否 | String | 要修改的属性路径。只有用户的以下属性可以修改： userName，active，externalId，displayName，nickName，title，userType，preferredLanguage，locale，timezone，name，enterprise，emails，addresses，phoneNumbers。 | | value | 否 | Object | 要修改的属性值。执行删除操作时无需填写。 | #### 响应参数 **状态码： 200** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 用户的全局唯一标识符（ID）。 | | externalId | String | 外部标识符。 | | [meta] | Object | 元数据。 | | schemas | Array of strings | 概要。 | | userName | String | 用户名，用于标识用户的唯一字符串。 | | [name] | Object | 包含用户姓名信息的对象。 | | displayName | String | 包含用户显示名称的字符串。 | | nickName | String | 包含用户昵称的字符串。 | | title | String | 包含用户头衔的字符串。 | | userType | String | 指示用户类型的字符串。 | | preferredLanguage | String | 包含用户首选语言的字符串。 | | locale | String | 包含用户地理区域或位置的字符串。 | | timezone | String | 包含用户时区的字符串。 | | active | Boolean | 表示用户是否启用。 | | [emails] | Array of objects | 包含用户的电子邮箱信息的对象列表。 | | [addresses] | Array of objects | 包含用户地址信息的对象列表。 | | [phoneNumbers] | Array of objects | 包含用户电话号码信息的对象列表。 | | [urn:ietf:params:scim:schemas:extension:enterprise:2.0:User] | Object | 包含用户工作相关信息的对象。 | 表6meta | 参数 | 参数类型 | 描述 | |:---|:---|:---| | resourceType | String | 资源类型。 | | created | String | 资源创建时间。 | | lastModified | String | 资源最后更新时间。 | 表7name | 参数 | 参数类型 | 描述 | |:---|:---|:---| | formatted | String | 包含要显示的名称的格式化版本的字符串。 | | familyName | String | 用户的姓氏。 | | givenName | String | 用户的名字。 | | middleName | String | 用户的中间名。 | | honorificPrefix | String | 用户的尊称前缀。 | | honorificSuffix | String | 用户的尊称后缀。 | 表8emails | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | String | 包含电子邮箱地址的字符串。 | | type | String | 表示电子邮箱类型的字符串。 | | primary | Boolean | 一个布尔值，表示这是否为用户的主电子邮箱。 | 表9addresses | 参数 | 参数类型 | 描述 | |:---|:---|:---| | formatted | String | 包含要显示的地址的格式化版本的字符串。 | | streetAddress | String | 街道。 | | locality | String | 地址位置。 | | region | String | 区域。 | | postalCode | String | 邮政编码。 | | country | String | 国家或地区。 | | type | String | 表示地址类型的字符串。 | | primary | Boolean | 一个布尔值，表示这是否为用户的主地址。 | 表10phoneNumbers | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | String | 包含电话号码的字符串。 | | type | String | 表示电话号码类型的字符串。 | | primary | Boolean | 一个布尔值，表示这是否为用户的主电话号码。 | 表11urn:ietf:params:scim:schemas:extension:enterprise:2.0:User | 参数 | 参数类型 | 描述 | |:---|:---|:---| | costCenter | String | 成本中心。 最小长度：**1** 最大长度：**1024** | | department | String | 部门。 最小长度：**1** 最大长度：**1024** | | division | String | 分部。 最小长度：**1** 最大长度：**1024** | | employeeNumber | String | 员工编号。 最小长度：**1** 最大长度：**1024** | | [manager] | Object | 经理。 | | organization | String | 组织。 最小长度：**1** 最大长度：**1024** | 表12manager | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | String | 经理。 最小长度：**1** 最大长度：**1024** | **状态码： 400** 表13响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | schema | String | 概要。 | | schemas | Array of strings | 概要列表。 | | detail | String | 异常详情。 | | status | Integer | 状态码。 | | timeStamp | String | 时间戳。 | **状态码： 403** 表14响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | schema | String | 概要。 | | schemas | Array of strings | 概要列表。 | | detail | String | 异常详情。 | | status | Integer | 状态码。 | | timeStamp | String | 时间戳。 | **状态码： 404** 表15响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | schema | String | 概要。 | | schemas | Array of strings | 概要列表。 | | detail | String | 异常详情。 | | status | Integer | 状态码。 | | timeStamp | String | 时间戳。 | **状态码： 409** 表16响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | schema | String | 概要。 | | schemas | Array of strings | 概要列表。 | | detail | String | 异常详情。 | | status | Integer | 状态码。 | | timeStamp | String | 时间戳。 | **状态码： 500** 表17响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | schema | String | 概要。 | | schemas | Array of strings | 概要列表。 | | detail | String | 异常详情。 | | status | Integer | 状态码。 | | timeStamp | String | 时间戳。 | #### 请求示例 修改现有用户的部分属性。 ``` PATCH https://{hostname}/{tenant_id}/scim/v2/Users/{user_id} { "schemas" : [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ], "Operations" : [ { "op" : "replace", "path" : "active", "value" : "false" } ] } ``` #### 响应示例 **状态码： 200** Successful ``` { "id" : "ac6aa714-daa7-1aaa-aaa2-6715aaaa4dd9", "externalId" : "123456", "meta" : { "resourceType" : "User", "created" : "2023-04-08T14:53:43Z", "lastModified" : "2023-04-16T21:32:55Z" }, "schemas" : [ "urn:ietf:params:scim:schemas:core:2.0:User" ], "userName" : "xxx", "name" : { "formatted" : "xxx", "familyName" : "xxx", "givenName" : "xxx", "middleName" : "xxx", "honorificPrefix" : "xxx", "honorificSuffix" : "xxx" }, "displayName" : "xxx", "nickName" : "xxx", "title" : "xxx", "userType" : "xxx", "preferredLanguage" : "zh-CN", "locale" : "zh-CN", "timezone" : "xxx", "active" : false, "emails" : [ { "value" : "xxx", "type" : "work", "primary" : true } ], "addresses" : [ { "formatted" : "xxx", "streetAddress" : "xxx", "locality" : "xxx", "region" : "xxx", "postalCode" : "123456", "country" : "xxx", "type" : "xxx", "primary" : true } ], "phoneNumbers" : [ { "value" : "xxx", "type" : "work", "primary" : true } ] } ``` #### 状态码 请参见[状态码](https://support.huaweicloud.com/api-identitycenter/iic_04_0030.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-identitycenter/ErrorCode.html)。