用户组管理-华为云

华为乾坤-查询用户组:响应示例

响应示例返回状态码为200：查询成功，响应体参考GetUsergroupsOutputDto。 HTTP/1.1 200 OK Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "pageIndex" : 1, "pageSize" : 20, "totalRecords" : 1, "errcode" : "0", "errmsg" : "", "data" : [ { "id" : "a91e1696-02a2-4a68-bad4-aa639359c8cf", "description" : "administrator group", "fullPathName" : "/root/admin", "bsid" : "00000-00001", "parentId" : "66848b66-482d-4ba1-b862-4f1ab763fc95", "name" : "admin", "address" : "Xihu North Community", "postalCode" : "417700", "adminEmail" : "xxx@example.com", "orderId" : 1134, "dataSource" : 0 } ] } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

华为乾坤用户组管理

华为乾坤-查询用户组:请求示例

请求示例 HTTP的示例 GET /controller/campus/v1/accountservice/usergroups?userGroupId=a91e1696-02a2-4a68-bad4-aa639359c8cf&userGroupName=user&isContainSubGroup=false&pageIndex=1&pageSize=20&sort=userGroupName HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-AC CES S-TOKEN: x-yyyyyy

华为乾坤用户组管理

华为乾坤-查询用户组:响应参数

响应参数返回状态码为200：查询成功，响应体参考GetUsergroupsOutputDto。表2 GetUsergroupsOutputDto对象的参数列表参数名称类型参数值域默认值参数说明参数示例 pageIndex int32 [0-2000000] - 当前页数。 1 pageSize int32 [0-1000] - 每页最大显示数量。 20 totalRecords int32 [0-2147483647] - 查询到的总结果数。 1 errcode string - - 错误码。 "0" errmsg string - - 错误信息描述。 "" data ARRAY_REFERENCE 0-1000个列表项，详细请参见表3。返回数据内容。 - 表3 UsergroupOutputDto对象的参数列表参数名称类型参数值域默认值参数说明参数示例 id string - - 用户组ID。UUID格式 "a91e1696-02a2-4a68-bad4-aa639359c8cf" description string - - 用户组描述。 "administrator group" fullPathName string - - 用户组全路径。 "/root/admin" bsid string - - 用户组层级关系。 "00000-00001" parentId string - - 父用户组ID。UUID格式 "66848b66-482d-4ba1-b862-4f1ab763fc95" name string - - 用户组名。 "admin" address string - - 地址。 "Xihu North Community" postalCode string - - 邮编。 "417700" adminEmail string - - 管理员邮箱。 "xxx@example.com" orderId int32 - - 用于同一级用户组排序。 1134 dataSource int32 - - 数据来源 0 返回状态码为400：校验异常。详细信息请参见实际响应消息体。返回状态码为500：内部错误。详细信息请参见实际响应消息体。

华为乾坤用户组管理

华为乾坤-查询用户组:URI

URI /controller/campus/v1/accountservice/usergroups 表1 query参数列表参数名称必选类型参数值域默认值参数说明参数示例 userGroupId 否 string - - 用户组ID。UUID格式 "a91e1696-02a2-4a68-bad4-aa639359c8cf" userGroupName 否 string 0~255个字符。 - 用户组名，支持模糊查询。 "user" isContainSubGroup 否 boolean true false - 是否包含子用户组，该变量需要和userGroupId一起使用，主要用于查询指定用户组下子部门（只包含当前指定用户组下一层子用户组，更下层的不包含）。默认值false。 "false" pageIndex 否 int32 [0-2000000] - 页面索引。 1 pageSize 否 int32 [0-1000] - 页面大小。 20 sort 否 string - - 排序字段仅支持‘userGroupName’ +表示升序，-表示降序，默认用升序。 "userGroupName"

华为乾坤用户组管理

华为乾坤-删除用户组:请求示例

请求示例 HTTP的示例 DELETE /controller/campus/v1/accountservice/usergroups/a91e1696-02a2-4a68-bad4-aa639359c8cf HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy

华为乾坤用户组管理

华为乾坤-删除用户组:响应示例

响应示例返回状态码为200：删除成功，响应体参考DeleteUsergroupOutputDto。 HTTP/1.1 200 OK Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0308001017", "errmsg" : "The user group to be queried does not exist", "success" : [ "" ], "fail" : [ { "errcode" : "0308001017", "errmsg" : "The user group to be queried does not exist", "data" : "a91e1696-02a2-4a68-bad4-aa639359c8cf" } ] } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

华为乾坤用户组管理

华为乾坤-修改用户组:请求示例

请求示例 HTTP的示例 PUT /controller/campus/v1/accountservice/usergroups/a91e1696-02a2-4a68-bad4-aa639359c8cf HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "name" : "family", "description" : "family member group" }

华为乾坤用户组管理

华为乾坤-修改用户组:响应参数

响应参数返回状态码为200：添加成功，响应体参考CommonUsergroupOutputDto。表4 CommonUsergroupOutputDto对象的参数列表参数名称类型参数值域默认值参数说明参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息描述。 "" 返回状态码为400：校验异常。详细信息请参见实际响应消息体。返回状态码为500：内部错误。详细信息请参见实际响应消息体。

华为乾坤用户组管理

华为乾坤-修改用户组:响应示例

响应示例返回状态码为200：添加成功，响应体参考CommonUsergroupOutputDto。 HTTP/1.1 200 OK Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "" } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

华为乾坤用户组管理

华为乾坤-修改用户组:请求参数

请求参数表2 body参数列表参数名称必选类型参数值域默认值参数说明参数示例 body 是 REFERENCE 详细请参见表3。用户组结构，响应体参考UpdateUsergroupInputDto。 - 表3 UpdateUsergroupInputDto对象的参数列表参数名称必选类型参数值域默认值参数说明参数示例 name 是 string 1~128个字符。 - 用户组名。 "family" description 否 string 0~256个字符。 - 用户组描述信息。 "family member group"

华为乾坤用户组管理

IAM 身份中心-创建用户组:请求示例

请求示例创建用户组。 POST https://{hostname}/{tenant_id}/scim/v2/Groups{ "displayName" : "SCIM用户组名g1", "members" : [ { "value" : "ac6aa714-daa7-1aaa-aaa2-6715aaaa4dd9", "$ref" : "../Users/ac6aa714-daa7-1aaa-aaa2-6715aaaa4dd9", "type" : "User" } ], "schemas" : [ "urn:ietf:params:scim:schemas:core:2.0:Group" ]}

IAM 身份中心 SCIM用户组管理

IAM 身份中心-创建用户组:响应示例

响应示例状态码： 201 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" } ]}

IAM 身份中心 SCIM用户组管理

IAM 身份中心-创建用户组:响应参数

响应参数状态码： 201 表5 响应Body参数参数参数类型描述 id String 用户组的全局唯一标识符（ID）。 externalId String 外部标识符。 meta Object 元数据。 schemas Array of strings 概要。 displayName String 包含用户组显示名称的字符串。 members Array of objects 用户组中的成员对象列表。表6 meta 参数参数类型描述 resourceType String 资源类型。 created String 资源创建时间。 lastModified String 资源最后更新时间。表7 members 参数参数类型描述 value String 成员的全局唯一标识符（ID）。 $ref String 成员的引用信息。 type String 成员类型，User：用户。状态码： 400 表8 响应Body参数参数参数类型描述 schema String 概要。 schemas Array of strings 概要列表。 detail String 异常详情。 status Integer 状态码。 timeStamp String 时间戳。状态码： 403 表9 响应Body参数参数参数类型描述 schema String 概要。 schemas Array of strings 概要列表。 detail String 异常详情。 status Integer 状态码。 timeStamp String 时间戳。状态码： 404 表10 响应Body参数参数参数类型描述 schema String 概要。 schemas Array of strings 概要列表。 detail String 异常详情。 status Integer 状态码。 timeStamp String 时间戳。状态码： 409 表11 响应Body参数参数参数类型描述 schema String 概要。 schemas Array of strings 概要列表。 detail String 异常详情。 status Integer 状态码。 timeStamp String 时间戳。状态码： 500 表12 响应Body参数参数参数类型描述 schema String 概要。 schemas Array of strings 概要列表。 detail String 异常详情。 status Integer 状态码。 timeStamp String 时间戳。

IAM 身份中心 SCIM用户组管理

IAM 身份中心-创建用户组:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 Authorization 是 String 承载令牌。表3 请求Body参数参数是否必选参数类型描述 externalId 否 String 外部标识符。 displayName 否 String 包含用户组显示名称的字符串。 members 否 Array of objects 用户组中的成员对象列表。 schemas 否 Array of strings 概要。表4 members 参数是否必选参数类型描述 value 是 String 成员的全局唯一标识符（ID）。 $ref 否 String 成员的引用信息。 type 否 String 成员类型，User：用户。

IAM 身份中心 SCIM用户组管理

IAM 身份中心-查询用户组详情:响应参数

响应参数状态码： 200 表3 响应Body参数参数参数类型描述 description String 包含组描述的字符串。最小长度：1 最大长度：1024 display_name String 包含组显示名称的字符串。最小长度：1 最大长度：1024 external_id String 外部身份源分配给此资源的标识符。 external_ids Array of objects 包含外部身份提供商颁发给此资源的标识符的对象列表。数组长度：1-10 group_id String 身份源中 IAM 身份中心用户组的全局唯一标识符（ID）。最小长度：1 最大长度：47 identity_store_id String 身份源的全局唯一标识符（ID）。最小长度：1 最大长度：36 created_at Long 创建时的时间戳。 created_by String 创建者。 updated_at Long 更新时的时间戳。 updated_by String 更新者。表4 external_ids 参数参数类型描述 id String 外部身份提供商颁发给此资源的标识符。最小长度：1 最大长度：256 issuer String 外部标识符的颁发者。最小长度：1 最大长度：100

IAM 身份中心用户组管理

云服务器内容精选

用户组管理

7*24

备案

专业服务

退订

建议反馈

售前咨询热线