权限策略及授权项
如果您需要对您所拥有的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）。
权限 |
对应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，即可访问。
