文档首页/ 图引擎服务 GES/ API参考/ 权限策略和授权项
更新时间:2024-05-23 GMT+08:00
分享

权限策略和授权项

如果您需要对您所拥有的GES服务进行精细的权限管理,您可以使用统一身份认证服务(Identity and Access Management,简称IAM),如果华为云账号已经能满足您的要求,不需要创建独立的IAM用户,您可以跳过本章节,不影响您使用GES服务的其它功能。

默认情况下,管理员创建的IAM用户没有任何权限,您需要将其加入用户组,并给用户组授予策略或角色,才能使得该用户组中的用户获得对应的权限,这一过程称为授权。授权后,用户就可以基于被授予的权限对云服务进行操作。关于策略的语法结构及示例,请参见权限管理

权限类别:根据授权精程度分为角色和策略。
  • 角色:IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。该机制以服务为粒度,提供有限的服务相关角色用于授权。由于华为云各服务之间存在业务依赖关系,因此给用户授予角色时,可能需要一并授予依赖的其他角色,才能正确完成业务。角色并不能满足用户对精细化授权的要求,无法完全达到企业对权限最小化的安全管控要求。
  • 策略:IAM最新提供的一种细粒度授权的能力,可以精确到具体服务的操作、资源以及请求条件等。基于策略的授权是一种更加灵活的授权方式,能够满足企业对权限最小化的安全管控要求。例如:针对GES服务,管理员能够控制IAM用户仅能对某一类云服务器资源进行指定的管理操作。
  • 如果您要允许或是禁止某个接口的操作权限,请使用策略。
  • 由于缓存的存在,对用户和用户组授予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与企业管理的区别

“√”表示支持,“x”表示暂不支持。

GES支持自定义策略授权项如下表所示。

表1 API授权项列表

权限

对应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

-

相关文档