文档首页> 数据接入服务 DIS> API参考> 权限策略及授权项
更新时间:2022-03-23 GMT+08:00
分享

权限策略及授权项

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

默认情况下,新建的IAM用户没有任何权限,您需要将其加入用户组,并给用户组授予策略或角色,才能使用户组中的用户获得相应的权限,这一过程称为授权。授权后,用户就可以基于已有权限对云服务进行操作。

权限根据授权的精细程度,分为角色和策略。角色以服务为粒度,是IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。策略以API接口为粒度进行权限拆分,授权更加精细,可以精确到某个操作、资源和条件,能够满足企业对权限最小化的安全管控要求。

说明:

如果您要允许或是禁止某个接口的操作权限,请使用策略。

账号具备所有接口的调用权限,如果使用账号下的IAM用户发起API请求时,该IAM用户必须具备调用该接口所需的权限,否则,API请求将调用失败。每个接口所需要的权限,与各个接口所对应的授权项相对应,只有发起请求的用户被授予授权项所对应的策略,该用户才能成功调用该接口。例如,用户要调用接口来查询集群列表,那么这个IAM用户被授予的策略中必须包含允许“dis:streams:list”的授权项,该接口才能调用成功。

支持的授权项

策略包含系统策略和自定义策略,如果系统策略不满足授权要求,管理员可以创建自定义策略,并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应,授权项列表说明如下:

· 权限:允许或拒绝某项操作。

· 对应API接口:自定义策略实际调用的API接口。

· 授权项:自定义策略中支持的Action,在自定义策略中的Action中写入授权项,可以实现授权项对应的权限功能。

· IAM项目(Project)/企业项目(Enterprise Project):自定义策略的授权范围,包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目,表示此授权项对应的自定义策略,可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目,不支持企业项目,表示仅能在IAM中给用户组授权并生效,如果在企业管理中授权,则该自定义策略不生效。

说明:

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

DIS的支持自定义策略授权项如表1所示,表中的授权项作用域支持项目(Project)和企业项目(Enterprise Project)。

表1 自定义策略授权项

权限

对应API接口

授权项

IAM项目(Project)

企业项目(Enterprise Project)

创建消费App

POST /v2/{project_id}/apps

dis:apps:create

×

删除App

DELETE /v2/{project_id}/apps/{app_name}

dis:apps:delete

×

查询App列表

GET

/v2/{project_id}/apps

dis:apps:list

×

查看App详情

GET

/v2/{project_id}/apps/{app_name}

dis:apps:get

×

查看App消费状态

GET

/v2/{project_id}/apps/{app}/streams/{stream_name}

dis:appState:get

分页查看该用户下所有事件列表

GET

/v1/{project_id}/events

dis:events:list

×

创建订阅

POST

/v1/{project_id}/event-subs

dis:eventEnumSubs:create

×

删除订阅

DELETE

/v1/{project_id}/event-subs/{sub_id}

dis:eventEnumSubs:delete

×

修改订阅

PUT

/v1/{project_id}/event-subs/{sub_id}

dis:eventEnumSubs:update

×

查询该用户下的订阅列表

GET

/v1/{project_id}/event-subs

dis:eventEnumSubs:list

×

添加权限策略

POST

/v2/{project_id}/streams/{streamName}/policies

dis:streamPolicies:create

查询权限策略列表

GET

/v2/{project_id}/streams/{streamName}/policies

dis:streamPolicies:list

删除通道下的权限策略

DELETE

/v2/{project_id}/streams/{streamName}/policies

dis:streamPolicies:delete

查看通道详情

GET

/v2/{project_id}/streams/{streamName}

dis:streams:get

创建通道

POST

/v2/{project_id}/streams

dis:streams:create

删除指定通道

DELETE

/v2/{project_id}/streams/{stream_name}

dis:streams:delete

查询通道列表

GET

/v2/{project_id}/streams

dis:streams:list

×

更新通道信息

PUT

/v2/{project_id}/streams/{stream_name}/update

dis:streams:update

添加转储任务

POST

/v2/{project_id}/streams/{stream_name}/transfer-tasks

dis:transferTasks:create

更新转储任务

PUT

/v2/{project_id}/streams/{stream_name}/transfer-tasks

dis:transferTasks:update

查询转储任务列表

GET

/v2/{project_id}/streams/{stream_name}/transfer-tasks

dis:transferTasks:list

查询转储任务详情

GET

/v2/{project_id}/streams/{stream_name}/transfer-tasks/{task_name}

dis:transferTasks:get

删除转储任务

DELETE

/v2/{project_id}/streams/{stream_name}/transfer-tasks/{task_name}

dis:transferTasks:delete

上传数据

POST

/v2/{project_id}/records

dis:records:write

获取数据游标

GET

/v2/{project_id}/cursors

dis:records:readCursor

下载数据

GET

/v2/{project_id}/records

dis:records:read

添加checkpoint

POST

/v2/{project_id}/checkpoints

dis:checkpoints:commit

查询checkpoint详情

GET

/v2/{project_id}/checkpoints

dis:checkpoints:get

删除checkpoint

DELETE

/v2/{project_id}/checkpoints

dis:checkpoints:delete

使用标签过滤通道资源

POST

/{project_id}/{resource_type}/resource_instances/action

dis:tagResources:list

×

批量添加/删除资源标签

POST

/{project_id}/{resource_type}/{resource_id}/tags/action

dis:tagResources:update

×

给指定通道添加标签

POST

/{project_id}/{resource_type}/{resource_id}/tags

dis:tagResources:create

×

删除指定通道的标签

DELETE

/{project_id}/{resource_type}/{resource_id}/tags/{key}

dis:tagResources:delete

×

查询指定区域所有标签集合

GET

/{project_id}/{resource_type}/tags

dis:tags:list

×

备注:对应不存在表1中的授权项,例如:查看App Quota:/{projectId}/quotas,首页概览页面查看DIS资源统计值:/v1/{projectId}/statistics等接口,为用户配置系统预置策略:DIS User/DIS ReadOnlyAccess/DIS CommonOperations/DIS FullAccess,即可访问。

分享:

    相关文档

    相关产品

关闭导读