# 管理角色和继承

查询和维护角色、角色生命周期及继承关系，并在删除或调整前检查权限、所有权和删除影响。本页不将角色绑定到具体用户。

## 前提条件

准备可访问目标工作区的凭据和目标角色标识。有关服务地址、认证和通用请求格式，请参阅 [调用前准备](../../api-call-basics.md)。

修改继承或删除角色前，先查询角色列表、继承关系和相关影响信息。

## 调用顺序

1. 先[查看角色列表](../../../../reference/api/ai-studio/users-and-permissions/roles/list-roles.md)，确定目标角色。
2. 需要了解当前关系时，查询继承关系、继承图和权限视图。
3. 添加或删除继承后重新查询继承关系；更新角色或生命周期后查询角色列表确认结果。
4. 删除前查询删除影响和所有权影响，并在动作页中确认条件和结果。

## API 操作

### 查询角色、关系和影响

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 查询角色列表 | [查看角色列表](../../../../reference/api/ai-studio/users-and-permissions/roles/list-roles.md) | 选择目标角色或确认变更时使用。 |
| 查询角色继承关系 | [查看角色继承关系](../../../../reference/api/ai-studio/users-and-permissions/roles/list-role-inheritance.md) | 调整前后查看继承关系时使用。 |
| 查询角色继承图 | [查看角色继承图](../../../../reference/api/ai-studio/users-and-permissions/roles/get-role-inheritance-graph.md) | 需要查看继承关系图时使用。 |
| 查询角色权限视图 | [查看角色权限视图](../../../../reference/api/ai-studio/users-and-permissions/roles/get-role-permission-view.md) | 调整前确认角色权限时使用。 |
| 查询角色审计事件 | [查看角色审计事件](../../../../reference/api/ai-studio/users-and-permissions/roles/list-role-audit-events.md) | 需要查看角色审计事件时使用。 |
| 查询角色删除影响 | [查看角色删除影响](../../../../reference/api/ai-studio/users-and-permissions/roles/get-role-delete-impact.md) | 删除前确认删除影响时使用。 |
| 查询角色所有权影响 | [查看角色所有权影响](../../../../reference/api/ai-studio/users-and-permissions/roles/get-role-ownership-impact.md) | 删除或调整前确认所有权影响时使用。 |

### 更新角色和继承

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 更新角色 | [更新角色](../../../../reference/api/ai-studio/users-and-permissions/roles/update-role.md) | 已取得角色标识，需要修改时使用。 |
| 更新角色生命周期 | [更新角色生命周期](../../../../reference/api/ai-studio/users-and-permissions/roles/update-role-lifecycle.md) | 需要调整目标角色生命周期时使用。 |
| 添加角色继承 | [添加角色继承](../../../../reference/api/ai-studio/users-and-permissions/roles/add-role-inheritance.md) | 已确定两个角色，需要建立继承关系时使用。 |
| 删除角色继承 | [删除角色继承](../../../../reference/api/ai-studio/users-and-permissions/roles/remove-role-inheritance.md) | 移除前先确认目标继承关系时使用。 |

### 删除角色

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 删除角色 | [删除角色](../../../../reference/api/ai-studio/users-and-permissions/roles/delete-role.md) | 已确认删除影响和所有权影响后使用。 |

## 结果确认

更新或调整继承后，使用[查看角色列表](../../../../reference/api/ai-studio/users-and-permissions/roles/list-roles.md)和[查看角色继承关系](../../../../reference/api/ai-studio/users-and-permissions/roles/list-role-inheritance.md)确认当前结果。删除后通过列表确认角色是否仍可查询。

## 限制和注意事项

删除角色、修改生命周期或继承关系会影响相关角色。执行前请使用影响查询动作并在对应 Reference 页确认条件和结果。

## 下一步

- [管理用户和用户标签](users-tags.md)
- [配置数据权限](data-privileges.md)