
# 权限策略和授权项
如果您需要对您所拥有的GES服务进行精细的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），如果华为云账号已经能满足您的要求，不需要创建独立的IAM用户，您可以跳过本章节，不影响您使用GES服务的其它功能。
默认情况下，管理员创建的IAM用户没有任何权限，您需要将其加入用户组，并给用户组授予策略或角色，才能使得该用户组中的用户获得对应的权限，这一过程称为授权。授权后，用户就可以基于被授予的权限对云服务进行操作。关于策略的语法结构及示例，请参见[权限管理](https://support.huaweicloud.com/usermanual-ges/ges_01_0075.html)。
权限类别：根据授权精程度分为角色和策略。
- 角色：IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。该机制以服务为粒度，提供有限的服务相关角色用于授权。由于华为云各服务之间存在业务依赖关系，因此给用户授予角色时，可能需要一并授予依赖的其他角色，才能正确完成业务。角色并不能满足用户对精细化授权的要求，无法完全达到企业对权限最小化的安全管控要求。
- 策略：IAM最新提供的一种细粒度授权的能力，可以精确到具体服务的操作、资源以及请求条件等。基于策略的授权是一种更加灵活的授权方式，能够满足企业对权限最小化的安全管控要求。例如：针对GES服务，管理员能够控制IAM用户仅能对某一类云服务器资源进行指定的管理操作。
 
![](https://support.huaweicloud.com/api-ges/public_sys-resources/note_3.0-zh-cn.png)
- 如果您要允许或是禁止某个接口的操作权限，请使用策略。
- 由于缓存的存在，对用户和用户组授予OBS相关的角色后，大概需要等待13分钟角色才能生效；授予策略后，大概需要等待5分钟策略才能生效。
 
账号具备所有接口的调用权限，如果使用账号下的IAM用户发起API请求时，该IAM用户必须具备调用该接口所需的权限，否则，API请求将调用失败。每个接口所需要的权限，与各个接口所对应的授权项相对应，只有发起请求的用户被授予授权项所对应的策略，该用户才能成功调用该接口。例如，用户要调用接口来查询图列表，那么这个IAM用户被授予的策略中必须包含允许"ges:graph:list"的授权项，该接口才能调用成功。
#### 支持的授权项
策略支持的操作与API相对应，授权项列表说明如下：
- 权限：自定义策略中授权项定义的内容即为权限。
- 对应API接口：自定义策略实际调用的API接口。
- 授权项：自定义策略中支持的Action，在自定义策略中的Action中写入授权项，可以实现授权项对应的权限功能。
- 依赖的授权项：部分Action存在对其他Action的依赖，需要将依赖的Action同时写入授权项，才能实现对应的权限功能。
- AM项目(Project)/企业项目(Enterprise Project)：自定义策略的授权范围，包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目，表示此授权项对应的自定义策略，可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目，不支持企业项目，表示仅能在IAM中给用户组授权并生效，如果在企业管理中授权，则该自定义策略不生效。关于IAM项目与企业项目的区别，详情请参见：[IAM与企业管理的区别](https://support.huaweicloud.com/iam_faq/iam_01_0101.html)。
![](https://support.huaweicloud.com/api-ges/public_sys-resources/note_3.0-zh-cn.png)
"√"表示支持，"x"表示暂不支持。
GES支持自定义策略授权项如下表所示。
表1API授权项列表 
| 权限         | 对应API接口                                                                         | 授权项                  | 依赖的授权项                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | IAM项目 (Project) | 企业项目 (Enterprise Project) |
|:---|:---|:---|:---|:---|:---|
| 查询图列表      | GET /v1.0/{project_id}/graphs?offset={offset}\&limit={limit}                    | ges:graph:list       | 项目级服务VPC vpc:publicIps:get                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | √                                           | √                                                       |
| 查看图详情      | GET /v1.0/{project_id}/graphs/{graph_id}                                        | ges:graph:getDetail  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 创建图        | POST /v1.0/{project_id}/graphs                                                  | ges:graph:create     | 项目级服务ECS ecs:cloudServerFlavors:get ecs:cloudServerNics:update 项目级服务EVS evs:types:get  项目级服务VPC vpc:ports:create vpc:ports:update vpc:securityGroups:get vpc:publicIps:list vpc:ports:get vpc:subnets:get vpc:vpcs:list | √                                           | √                                                       |
| 关闭图        | POST /v1.0/{project_id}/graphs/{graph_id}/action?action_id=stop                 | ges:graph:operate    | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 启动图        | POST /v1.0/{project_id}/graphs/{graph_id}/action?action_id=start                | ges:graph:operate    | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 删除图        | DELETE /v1.0/{project_id}/graphs/{graph_id}                                     | ges:graph:delete     | 项目级服务VPC vpc:publicIps:get vpc:ports:delete vpc:ports:get                                                                                                                                                                                                                                                                                                                                                                                                                                                  | √                                           | √                                                       |
| 增量导入图      | POST /v1.0/{project_id}/graphs/{graph_id}/action?action_id=import-graph         | ges:graph:operate    | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 导出图        | POST /v1.0/{project_id}/graphs/{graph_id}/action?action_id=export-graph         | ges:graph:operate    | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 清空图        | POST /v1.0/{project_id}/graphs/{graph_id}/action?action_id=clear-graph          | ges:graph:operate    | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 升级图        | POST /v1.0/{project_id}/graphs/{graph_id}/action?action_id=upgrade              | ges:graph:operate    | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 重启图        | POST /v1.0/{project_id}/graphs/{graph_id}/action                                | ges:graph:operate    | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 变更图规格      | POST /v1.0/{project_id}/graphs/{graph_id}/resize                                | ges:graph:resize     | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 扩副本        | POST /v1.0/{project_id}/graphs/{graph_id}/expand                                | ges:graph:expand     | 项目级服务ECS ecs:cloudServerFlavors:get ecs:cloudServerNics:update 项目级服务EVS evs:types:get  项目级服务VPC vpc:ports:create vpc:ports:update vpc:securityGroups:get vpc:publicIps:list vpc:ports:get vpc:subnets:get vpc:vpcs:list  | √                                           | √                                                       |
| 绑定EIP      | POST /v1.0/{project_id}/graphs/{graph_id}/action?action_id=bindEip              | ges:graph:operate    | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 解绑EIP      | POST /v1.0/{project_id}/graphs/{graph_id}/action?action_id=unbindEip            | ges:graph:operate    | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 查看所有备份列表   | GET /v1.0/{project_id}/graphs/backups?offset={offset}\&limit={limit}            | ges:backup:list      | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 查看某个图的备份列表 | GET /v1.0/{project_id}/graphs/{graph_id}/backups?offset={offset}\&limit={limit} | ges:backup:list      | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 新增备份       | POST /v1.0/{project_id}/graphs/{graph_id}/backups                               | ges:backup:create    | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 删除备份       | DELETE /v1.0/{project_id}/graphs/{graph_id}/backups/{backup_id}                 | ges:backup:delete    | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 查询元数据列表    | GET /v1.0/{project_id}/graphs/metadatas?offset={offset}\&limit={limit}          | ges:metadata:list    | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 查询元数据      | GET /v1.0/{project_id}/graphs/metadatas/{metadata_id}                           | ges:metadata:list    | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 校验元数据      | POST /v1.0/{project_id}/graphs/action?action_id=check-schema                    | ges:metadata:operate | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 新增元数据      | POST /v1.0/{project_id}/graphs/metadatas                                        | ges:metadata:create  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 删除元数据      | DELETE /v1.0/{project_id}/graphs/metadatas/{metadata_id}                        | ges:metadata:delete  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 查询任务状态     | GET /v1.0/{project_id}/graphs/{graph_id}/jobs/{job_id}/status                   | ges:jobs:getDetail   | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √                                           | √                                                       |
| 查询任务列表     | GET /v1.0/{project_id}/graphs/jobs?offset={offset}\&limit={limit}               | ges:jobs:list        | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | √      | √                    |
   
