
# 部门下新增全局角色
#### 功能介绍
部门下新增全局角色。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-craftartsipdcenter/ipdcenter_06_0034.html)。
#### 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 |
   
表3ObjectReference参数 
| 参数    | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| id    | 是    | String | 关联的对象ID |
| clazz | 是    | String | 类型      |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数         | 参数类型                                                                               | 描述     |
|:---|:---|:---|
| code       | String                                                                             | 返回码    |
| message    | String                                                                             | 返回码描述  |
| datas      | Array of [XDMRoleMemberViewDTO] | 返回数据   |
| totalCount | Long                                                                               | 新增数据条数 |
   
 表5XDMRoleMemberViewDTO 
| 参数               | 参数类型                                                                  | 描述     |
|:---|:---|:---|
| 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                                                             | 最新更新时间 |
   
 表6XDMRoleViewDTO 
| 参数               | 参数类型                                                              | 描述     |
|:---|:---|:---|
| 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                                                         | 最新更新时间 |
   
 表7BasicObjectViewDTO 
| 参数               | 参数类型                                                              | 描述     |
|:---|:---|:---|
| 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                                                         | 最新更新时间 |
   
 表8TenantViewDTO 
| 参数               | 参数类型                                                                                                                                           | 描述         |
|:---|:---|:---|
| 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](https://support.huaweicloud.com/api-craftartsipdcenter/ipdcenter_06_0142.html#ZH-CN_TOPIC_0000002252628180__table117601648110) | 租户         |
| 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 | 服务器内部异常 |
   
