# 修改身份主体

`POST` `/api/principal/update`

修改当前应用下指定身份主体的名称和描述，名称会同步更新到点金内核；不允许修改系统内置主体

## 请求参数

### 请求体（JSON）

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| principalId | integer | 是 | 要修改的身份主体ID |
| principalName | string | 是 | 主体名称，用于标识该身份主体，会同步更新到点金内核 |
| principalDescription | string | 否 | 主体描述，选填，仅在控制台本地维护 |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | AppPrincipalVO | 响应数据 |
|     principalId | integer | 身份主体ID |
|     principalName | string | 主体名称 |
|     principalDescription | string | 主体描述 |
|     gmtCreate | string | 创建时间 |
|     gmtModified | string | 修改时间 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 400

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 500

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |