部门下新增全局角色_部门与角色关系接口_组织管理接口_用户组织管理API_IPDCenter基础服务API_API参考

功能介绍

部门下新增全局角色。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /basic/mgmt/public/api/v1/organization/group/globalRole

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
Authorization	是	String	JWTToken

表2 请求Body参数
参数	是否必选	参数类型	描述
source	是	ObjectReference	全局角色信息，source.clazz固定XDMRole
target	是	ObjectReference	部门信息，source.clazz固定XDMUserGroup
rdmExtensionType	是	String	固定XDMRoleMember
lastUpdateTime	是	String	更新时间，与创建时间取值相同
createTime	是	String	创建时间
modifier	否	String	更新者，若为空取鉴权头Authorization中携带的userId
creator	否	String	创建者，若为空取鉴权头Authorization中携带的userId

表3 ObjectReference参数
参数	是否必选	参数类型	描述
id	是	String	关联的对象ID
clazz	是	String	类型

响应参数

状态码： 200

表4 响应Body参数
参数	参数类型	描述
code	String	返回码
message	String	返回码描述
datas	Array of XDMRoleMemberViewDTO	返回数据
totalCount	Long	新增数据条数

表5 XDMRoleMemberViewDTO
参数	参数类型	描述
id	String	ID
name	String	实体姓名
description	String	描述
creator	String	创建人
createTime	Timestamp	创建时间
rdmVersion	Integer	系统版本
rdmDeleteFlag	Integer	是否删除标识
modifier	String	修改人
className	String	类名
source	XDMRoleViewDTO	源实体
target	BasicObjectViewDTO	目标实体
rdmExtensionType	String	扩展类型
tenant	TenantViewDTO	租户
lastUpdateTime	Timestamp	最新更新时间

表6 XDMRoleViewDTO
参数	参数类型	描述
id	String	ID
name	String	名称
nameEn	String	英文名称
description	String	描述
descriptionEn	String	英文描述
creator	String	创建人
createTime	Timestamp	创建时间
rdmVersion	Integer	系统版本
rdmDeleteFlag	Integer	是否删除标识
disableFlag	Boolean	失效标识
modifier	String	修改人
className	String	类名
rdmExtensionType	String	扩展类型
tenant	TenantViewDTO	租户
lastUpdateTime	Timestamp	最新更新时间

表7 BasicObjectViewDTO
参数	参数类型	描述
id	String	ID
name	String	名称
nameEn	String	英文名称
creator	String	创建人
createTime	Timestamp	创建时间
rdmVersion	Integer	系统版本
rdmDeleteFlag	Integer	是否删除标识
modifier	String	修改人
className	String	类名
description	String	描述
descriptionEn	String	英文描述
disableFlag	Boolean	失效标识
rdmExtensionType	String	扩展类型
tenant	TenantViewDTO	租户
groupType	String	部门来源
groupcode	String	部门编码
lastUpdateTime	Timestamp	最新更新时间

表8 TenantViewDTO
参数	参数类型	描述
id	String	租户ID
rdmVersion	Integer	系统版本
creator	String	创建人
kiaguid	String	KIA密级
code	String	租户编码
rdmDeleteFlag	Integer	是否删除标识
modifier	String	修改人
description	String	描述
className	String	类名
name	String	名称
nameEn	String	英文名称
securityLevel	String	安全密级
createTime	Timestamp	创建时间
disableFlag	Boolean	失效标识
rdmExtensionType	String	扩展类型
dataSource	String	租户使用的数据源名称
tenant	TenantViewDTO	租户
lastUpdateTime	Timestamp	最新更新时间

状态码： 400

表9 响应Body参数
参数	参数类型	描述
reserve	String	保留字段
error_code	String	错误编码
error_msg	String	错误信息

请求示例

/basic/mgmt/public/api/v1/organization/group/globalRole
[
  {
    "modifier": "2000003",
    "creator": "2000003",
    "lastUpdateTime": "2025-11-11T03:25:54.028Z",
    "createTime": "2025-11-11T03:25:54.028Z",
    "rdmExtensionType": "XDMRoleMember",
    "source": {
      "id": "678643551008997376",
      "clazz": "XDMRole"
    },
    "target": {
      "id": "680824304455143424",
      "clazz": "XDMUserGroup"
    }
  }
]

响应示例

状态码： 200

成功

{
    "code": "IPDC.01020000",
    "message": "success",
    "datas": [
        {
            "id": "830813791116599296",
            "creator": "2000003",
            "modifier": "2000003",
            "createTime": "2025-11-11T03:25:54.028+00:00",
            "lastUpdateTime": "2025-11-11T03:25:54.028+00:00",
            "rdmVersion": 1,
            "rdmDeleteFlag": 0,
            "rdmExtensionType": "XDMRoleMember",
            "tenant": {
                "id": "-1",
                "creator": "xdmAdmin",
                "modifier": "xdmAdmin",
                "createTime": "2023-10-10T09:02:55.831+00:00",
                "lastUpdateTime": "2023-10-10T09:02:55.831+00:00",
                "rdmVersion": 1,
                "rdmDeleteFlag": 0,
                "rdmExtensionType": "Tenant",
                "tenant": null,
                "className": "Tenant",
                "name": "basicTenant",
                "description": "默认租户",
                "kiaguid": null,
                "securityLevel": "internal",
                "nameEn": null,
                "code": "basicTenant",
                "disableFlag": false,
                "dataSource": "DefaultDataSource"
            },
            "className": "XDMRoleMember",
            "source": {
                "id": "678643551008997376",
                "creator": "xdmAdmin",
                "modifier": "xdmAdmin",
                "createTime": "2024-09-20T08:47:11.148+00:00",
                "lastUpdateTime": "2024-10-10T06:46:30.354+00:00",
                "rdmVersion": 9,
                "rdmDeleteFlag": 0,
                "rdmExtensionType": "XDMRole",
                "tenant": {
                    "id": "-1",
                    "creator": "xdmAdmin",
                    "modifier": "xdmAdmin",
                    "createTime": "2023-10-10T09:02:55.831+00:00",
                    "lastUpdateTime": "2023-10-10T09:02:55.831+00:00",
                    "rdmVersion": 1,
                    "rdmDeleteFlag": 0,
                    "rdmExtensionType": "Tenant",
                    "tenant": null,
                    "className": "Tenant",
                    "name": "basicTenant",
                    "description": "默认租户",
                    "kiaguid": null,
                    "securityLevel": "internal",
                    "nameEn": null,
                    "code": "basicTenant",
                    "disableFlag": false,
                    "dataSource": "DefaultDataSource"
                },
                "className": "XDMRole",
                "nameEn": "AuthorizedManager",
                "name": "授权管理者",
                "descriptionEn": null,
                "disableFlag": false,
                "description": "授权管理描述"
            },
            "target": {
                "id": "680824304455143424",
                "creator": "sysadmin 2001057",
                "modifier": "sysadmin 2001057",
                "createTime": "2024-09-26T09:12:43.286+00:00",
                "lastUpdateTime": "2024-09-26T09:12:43.286+00:00",
                "rdmVersion": 1,
                "rdmDeleteFlag": 0,
                "rdmExtensionType": "XDMUserGroup",
                "tenant": {
                    "id": "-1",
                    "creator": "xdmAdmin",
                    "modifier": "xdmAdmin",
                    "createTime": "2023-10-10T09:02:55.831+00:00",
                    "lastUpdateTime": "2023-10-10T09:02:55.831+00:00",
                    "rdmVersion": 1,
                    "rdmDeleteFlag": 0,
                    "rdmExtensionType": "Tenant",
                    "tenant": null,
                    "className": "Tenant",
                    "name": "basicTenant",
                    "description": "默认租户",
                    "kiaguid": null,
                    "securityLevel": "internal",
                    "nameEn": null,
                    "code": "basicTenant",
                    "disableFlag": false,
                    "dataSource": "DefaultDataSource"
                },
                "className": "XDMUserGroup",
                "description": "testYhz0925empLimit_2",
                "descriptionEn": null,
                "disableFlag": false,
                "name": "testYhz0925empLimit_2",
                "groupType": "base",
                "groupcode": null,
                "nameEn": "testYhz0925empLimit_2"
            },
            "name": null,
            "description": null
        }
    ],
    "totalCount": null
}

状态码： 401

认证失败

{
  "error_code" : "IPDC.02010034",
  "error_msg" : "Authorization token incorrect"
}

状态码

状态码	描述
200	成功
401	认证失败
500	服务器内部异常

部门下新增全局角色

功能介绍

授权信息

URI

请求参数

响应参数

请求示例

响应示例

状态码

相关文档

您对此文档页面的整体评价？