# 创建用户 - SCIMCreateUser #### 功能介绍 使用SCIM协议，同步用户到IAM身份中心。 #### URI POST /{tenant_id}/scim/v2/Users 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | tenant_id | 是 | String | 租户的全局唯一标识符（ID）。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Authorization | 是 | String | 承载令牌。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | externalId | 否 | String | 外部标识符。 | | userName | 是 | String | 用户名，用于标识用户的唯一字符串。 | | [name] | 是 | Object | 包含用户姓名信息的对象。 | | displayName | 是 | String | 包含用户显示名称的字符串。 | | nickName | 否 | String | 包含用户昵称的字符串。 | | profileUrl | 否 | String | 包含可能与用户关联的URL的字符串。 | | [emails] | 是 | Array of objects | 包含用户的电子邮箱信息的对象列表。 | | [addresses] | 否 | Array of objects | 包含用户地址信息的对象列表。 | | [phoneNumbers] | 否 | Array of objects | 包含用户电话号码信息的对象列表。 | | userType | 否 | String | 指示用户类型的字符串。 | | title | 否 | String | 包含用户头衔的字符串。 | | preferredLanguage | 否 | String | 包含用户首选语言的字符串。 | | locale | 否 | String | 包含用户地理区域或位置的字符串。 | | timezone | 否 | String | 包含用户时区的字符串。 | | active | 否 | Boolean | 表示用户是否启用。 | | schemas | 是 | Array of strings | 概要。 | | [urn:ietf:params:scim:schemas:extension:enterprise:2.0:User] | 否 | Object | 包含用户工作相关信息的对象。 | 表4name | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | formatted | 否 | String | 包含要显示的名称的格式化版本的字符串。 | | familyName | 是 | String | 用户的姓氏。 | | givenName | 是 | String | 用户的名字。 | | middleName | 否 | String | 用户的中间名。 | | honorificPrefix | 否 | String | 用户的尊称前缀。 | | honorificSuffix | 否 | String | 用户的尊称后缀。 | 表5emails | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | value | 是 | String | 包含电子邮箱地址的字符串。 | | type | 是 | String | 表示电子邮箱类型的字符串。 | | primary | 是 | Boolean | 一个布尔值，表示这是否为用户的主电子邮箱。 | 表6addresses | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | formatted | 否 | String | 包含要显示的地址的格式化版本的字符串。 | | streetAddress | 否 | String | 街道。 | | locality | 否 | String | 地址位置。 | | region | 否 | String | 区域。 | | postalCode | 否 | String | 邮政编码。 | | country | 否 | String | 国家或地区。 | | type | 否 | String | 表示地址类型的字符串。 | | primary | 否 | Boolean | 一个布尔值，表示这是否为用户的主地址。 | 表7phoneNumbers | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | value | 否 | String | 包含电话号码的字符串。 | | type | 否 | String | 表示电话号码类型的字符串。 | | primary | 否 | Boolean | 一个布尔值，表示这是否为用户的主电话号码。 | 表8urn: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** | 表9manager | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | value | 否 | String | 经理。 最小长度：**1** 最大长度：**1024** | #### 响应参数 **状态码： 201** 表10响应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 | 包含用户工作相关信息的对象。 | 表11meta | 参数 | 参数类型 | 描述 | |:---|:---|:---| | resourceType | String | 资源类型。 | | created | String | 资源创建时间。 | | lastModified | String | 资源最后更新时间。 | 表12name | 参数 | 参数类型 | 描述 | |:---|:---|:---| | formatted | String | 包含要显示的名称的格式化版本的字符串。 | | familyName | String | 用户的姓氏。 | | givenName | String | 用户的名字。 | | middleName | String | 用户的中间名。 | | honorificPrefix | String | 用户的尊称前缀。 | | honorificSuffix | String | 用户的尊称后缀。 | 表13emails | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | String | 包含电子邮箱地址的字符串。 | | type | String | 表示电子邮箱类型的字符串。 | | primary | Boolean | 一个布尔值，表示这是否为用户的主电子邮箱。 | 表14addresses | 参数 | 参数类型 | 描述 | |:---|:---|:---| | formatted | String | 包含要显示的地址的格式化版本的字符串。 | | streetAddress | String | 街道。 | | locality | String | 地址位置。 | | region | String | 区域。 | | postalCode | String | 邮政编码。 | | country | String | 国家或地区。 | | type | String | 表示地址类型的字符串。 | | primary | Boolean | 一个布尔值，表示这是否为用户的主地址。 | 表15phoneNumbers | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | String | 包含电话号码的字符串。 | | type | String | 表示电话号码类型的字符串。 | | primary | Boolean | 一个布尔值，表示这是否为用户的主电话号码。 | 表16urn: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** | 表17manager | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | String | 经理。 最小长度：**1** 最大长度：**1024** | **状态码： 400** 表18响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | schema | String | 概要。 | | schemas | Array of strings | 概要列表。 | | detail | String | 异常详情。 | | status | Integer | 状态码。 | | timeStamp | String | 时间戳。 | **状态码： 403** 表19响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | schema | String | 概要。 | | schemas | Array of strings | 概要列表。 | | detail | String | 异常详情。 | | status | Integer | 状态码。 | | timeStamp | String | 时间戳。 | **状态码： 404** 表20响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | schema | String | 概要。 | | schemas | Array of strings | 概要列表。 | | detail | String | 异常详情。 | | status | Integer | 状态码。 | | timeStamp | String | 时间戳。 | **状态码： 409** 表21响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | schema | String | 概要。 | | schemas | Array of strings | 概要列表。 | | detail | String | 异常详情。 | | status | Integer | 状态码。 | | timeStamp | String | 时间戳。 | **状态码： 500** 表22响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | schema | String | 概要。 | | schemas | Array of strings | 概要列表。 | | detail | String | 异常详情。 | | status | Integer | 状态码。 | | timeStamp | String | 时间戳。 | #### 请求示例 创建用户 ``` POST https://{hostname}/{tenant_id}/scim/v2/Users { "externalId" : "123456", "userName" : "xxx", "name" : { "formatted" : "xxx", "familyName" : "xxx", "givenName" : "xxx", "middleName" : "xxx", "honorificPrefix" : "xxx", "honorificSuffix" : "xxx" }, "displayName" : "xxx", "nickName" : "xxx", "profileUrl" : "xxx", "emails" : [ { "value" : "xxx", "type" : "work", "primary" : true } ], "addresses" : [ { "formatted" : "xxx", "streetAddress" : "xxx", "locality" : "xxx", "region" : "xxx", "postalCode" : "123456", "country" : "xxx", "type" : "work", "primary" : true } ], "phoneNumbers" : [ { "value" : "xxx", "type" : "work", "primary" : true } ], "userType" : "xxx", "title" : "xxx", "preferredLanguage" : "zh-CN", "locale" : "zh-CN", "timezone" : "xxx", "active" : true, "schemas" : [ "urn:ietf:params:scim:schemas:core:2.0:User" ] } ``` #### 响应示例 **状态码： 201** Successful ``` { "id" : "ac6aa714-daa7-1aaa-aaa2-6715aaaa4dd9", "externalId" : "123456", "meta" : { "resourceType" : "User", "created" : "2023-04-08T14:53:43Z", "lastModified" : "2023-04-08T14:53:43Z" }, "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" : true, "emails" : [ { "value" : "xxx", "type" : "work", "primary" : true } ], "addresses" : [ { "formatted" : "xxx", "streetAddress" : "xxx", "locality" : "xxx", "region" : "xxx", "postalCode" : "123456", "country" : "xxx", "type" : "work", "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)。