权限及授权项说明
如果您需要对您所拥有的GaussDB(DWS)服务进行精细的权限管理,您可以使用统一身份认证服务(identity and Access Management,简称IAM),如果华为云账号已经能满足您的要求,不需要创建独立的IAM用户,您可以跳过本章节,不影响您使用GaussDB(DWS)服务的其它功能。
默认情况下,新建的IAM用户没有任何权限,您需要将其加入用户组,并给用户组授予策略或角色,才能使用户组中的用户获得相应的权限,这一过程称为授权。授权后,用户就可以基于已有权限对云服务进行操作。用户通过创建自定义策略进行授权,具体操作请参见GaussDB(DWS)自定义策略。
权限根据授权的精细程度,分为角色和策略。角色以服务为粒度,是IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。策略以API接口为粒度进行权限拆分,授权更加精细,可以精确到某个操作、资源和条件,能够满足企业对权限最小化的安全管控要求。
如果您要允许或是禁止某个接口的操作权限,请使用策略。
账号具备所有接口的调用权限,如果使用账号下的IAM用户发起API请求时,该IAM用户必须具备调用该接口所需的权限,否则,API请求将调用失败。每个接口所需要的权限,与各个接口所对应的授权项相对应,只有发起请求的用户被授予授权项所对应的策略,该用户才能成功调用该接口。例如,用户要调用接口来查询GaussDB(DWS)集群列表,那么这个IAM用户被授予的策略中必须包含允许“dws:openAPICluster:list”的授权项,该接口才能调用成功。
支持的授权项
策略包含系统策略和自定义策略,如果系统策略不满足授权要求,管理员可以创建自定义策略,并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应,授权项列表说明如下:
- 权限:允许或拒绝对指定资源在特定条件下进行某项操作。
- 对应API接口:自定义策略实际调用的API接口。
- 授权项:自定义策略中支持的Action,在自定义策略中的Action中写入授权项,可以实现授权项对应的权限功能。
- IAM项目(Project)/企业项目(Enterprise Project):自定义策略的授权范围,包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目,表示此授权项对应的自定义策略,可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目,不支持企业项目,表示仅能在IAM中给用户组授权并生效,如果在企业管理中授权,则该自定义策略不生效。关于IAM项目与企业项目的区别,详情请参见:IAM与企业管理的区别。
“√”表示支持,“x”表示暂不支持。
GaussDB(DWS) 支持的自定义策略授权项如下所示
集群管理
权限 |
对应API接口 |
授权项 |
IAM项目 (Project) |
企业项目 (Enterprise Project) |
---|---|---|---|---|
创建集群 |
POST /v1.0/{project_id}/clusters |
dws:openAPICluster:create |
√ |
x |
查询集群列表 |
GET /v1.0/{project_id}/clusters |
dws:openAPICluster:list |
√ |
x |
查询集群详情 |
GET /v1.0/{project_id}/clusters/{cluster_id} |
dws:openAPICluster:getDetail |
√ |
x |
查询节点类型 |
GET /v2/{project_id}/node-types |
dws:openAPIFlavors:get |
√ |
x |
删除集群 |
DELETE /v1.0/{project_id}/clusters/{cluster_id} |
dws:openAPICluster:delete |
√ |
x |
重启集群 |
POST /v1.0/{project_id}/clusters/{cluster_id}/restart |
dws:openAPICluster:restart |
√ |
x |
扩容集群大小 |
POST /v1.0/{project_id}/clusters/{cluster_id}/resize |
dws:cluster:scaleOutOrOpenAPIResize |
√ |
x |
重置集群管理员密码 |
POST /v1.0/{project_id}/clusters/{cluster_id}/reset-password |
dws:openAPICluster:resetPassword |
√ |
x |
启动集群 |
POST /v1/ {project_id}/clusters/{cluster_id}/start |
dws:cluster:startCluster |
√ |
× |
停止集群 |
POST /v1/{project_id}/clusters/{cluster_id}/stop |
dws:cluster:stopCluster |
√ |
× |
当前版本启动集群、停止集群接口仅对数据库类型为serverless的集群开放。
快照管理
权限 |
对应API接口 |
授权项 |
IAM项目 (Project) |
企业项目 (Enterprise Project) |
---|---|---|---|---|
创建快照 |
POST /v1.0/{project_id}/snapshots |
dws:openAPISnapshot:create |
√ |
x |
查询快照列表 |
GET /v1.0/{project_id}/snapshots |
dws:openAPISnapshot:list |
√ |
x |
查询快照详情 |
GET /v1.0/{project_id}/snapshots/{snapshot_id} |
dws:openAPISnapshot:detail |
√ |
x |
删除快照 |
DELETE /v1.0/{project_id}/snapshots/{snapshot_id} |
dws:openAPISnapshot:delete |
√ |
x |
恢复集群 |
POST /v1.0/{project_id}/snapshots/{snapshot_id}/actions |
dws:openAPISnapshot:restore |
√ |
x |