# 更新全局角色接口
#### 功能介绍
更新全局角色。
#### 授权信息
账号需要具备**角色管理** 权限点，未绑定情况下需要通过自定义角色进行权限点绑定。具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-craftartsipdcenter/ipdcenter_06_0034.html)。
#### URI
POST /basic/mgmt/public/api/v1/global/role/update
#### 请求参数
表1请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述       |
|:---|:---|:---|:---|
| Authorization | 是    | String | JWTToken |
   
表2请求Body参数 
| 参数      | 是否必选 | 参数类型                                                                                                                                                                          | 描述       |
|:---|:---|:---|:---|
| request | 是    | [RoleCreateRequest](https://support.huaweicloud.com/api-craftartsipdcenter/ipdcenter_06_0164.html#ZH-CN_TOPIC_0000002542642737__zh-cn_topic_0000001831126904_table220mcpsimp) | 更新全局角色请求 |
   
表3RoleCreateRequest 
| 参数            | 是否必选 | 参数类型           | 描述     |
|:---|:---|:---|:---|
| name          | 是    | String         | 角色名称   |
| numberLimit   | 是    | Integer        | 全局角色限制 |
| privileges    | 是    | List\<String\> | 权限集合   |
| nameEn        | 否    | String         | 英文名称   |
| description   | 否    | String         | 描述     |
| descriptionEn | 否    | String         | 英文描述   |
   
#### 请求示例
```
{
  "privileges": [
    "00030001",
    "0003",
    "00030002",
    "00030003",
    "00030004"
  ],
  "id": "837635050227896320",
  "name": "机机接口测试",
  "nameEn": "machineroletest",
  "description": "XXX",
  "numberlimit": 5
}
```
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数         | 参数类型                                                                | 描述      |
|:---|:---|:---|
| code       | String                                                              | 返回码     |
| message    | String                                                              | 返回码描述   |
| totalCount | Long                                                                | 返回数据总条数 |
| datas      | [XDMRoleViewDTO] | 响应数据    |
   
 表5XDMRoleViewDTO 
| 参数               | 参数类型                                                              | 描述     |
|:---|:---|:---|
| id               | String                                                            | 角色ID   |
| name             | String                                                            | 角色名称   |
| nameEn           | String                                                            | 英文名称   |
| description      | String                                                            | 描述     |
| descriptionEn    | String                                                            | 英文描述   |
| creator          | String                                                            | 创建人    |
| createTime       | Timestamp                                                         | 创建时间   |
| rdmVersion       | Integer                                                           | 系统版本   |
| rdmDeleteFlag    | Integer                                                           | 是否删除标识 |
| modifier         | String                                                            | 修改人    |
| className        | String                                                            | 类名     |
| disableFlag      | Boolean                                                           | 失效标识   |
| rdmExtensionType | String                                                            | 扩展类型   |
| tenant           | [TenantViewDTO] | 租户     |
| lastUpdateTime   | Timestamp                                                         | 最新更新时间 |
   
 表6TenantViewDTO 
| 参数               | 参数类型                                                              | 描述         |
|:---|:---|:---|
| 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                                                         | 最新更新时间     |
   
#### 响应示例
```
{
  "code": "IPDC.01020000",
  "message": "success",
  "datas": {
    "id": "841753032348672000",
    "creator": "xdmAdmin",
    "modifier": "xdmAdmin",
    "createTime": "2025-12-14T11:06:01.927+00:00",
    "lastUpdateTime": "2025-12-15T01:07:14.292+00:00",
    "rdmVersion": 2,
    "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": "machineroletest",
    "name": "机机接口测试",
    "descriptionEn": null,
    "disableFlag": false,
    "description": "XXX"
  },
  "totalCount": null
}
```
**状态码： 401**
认证失败
```
{
  "error_code" : "IPDC.02010034",
  "error_msg" : "Authorization token incorrect"
}
```
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-craftartsipdcenter/ErrorCode.html)。