/ / / 权限和授权项
更新时间：2024-07-05 gmt 08:00

权限和授权项-九游平台

如果您需要对您所拥有的kafka实例进行精细的权限管理，您可以使用统一身份认证服务（identity and access management，简称iam），如果华为账号已经能满足您的要求，不需要创建独立的iam用户，您可以跳过本章节，不影响您使用kafka实例的其它功能。

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

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

dms for kafka系统策略说明请参考权限管理。

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

账号具备所有接口的调用权限，如果使用账号下的iam用户发起api请求时，该iam用户必须具备调用该接口所需的权限，否则，api请求将调用失败。每个接口所需要的权限，与各个接口所对应的授权项相对应，只有发起请求的用户被授予授权项所对应的策略，该用户才能成功调用该接口。例如，用户要调用接口来创建kafka实例，那么这个iam用户被授予的策略中必须包含允许“dms:instance:create”的授权项，该接口才能调用成功。

支持的授权项

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

  • 权限：允许或拒绝某项操作。
  • 对应api接口：自定义策略实际调用的api接口。
  • 授权项：自定义策略中支持的action，在自定义策略中的action中写入授权项，可以实现授权项对应的权限功能。
  • iam项目（project）/企业项目（enterprise project）：自定义策略的授权范围，包括iam项目与企业项目。授权范围如果同时支持iam项目和企业项目，表示此授权项对应的自定义策略，可以在iam和企业管理两个服务中给用户组授权并生效。如果仅支持iam项目，不支持企业项目，表示仅能在iam中给用户组授权并生效，如果在企业管理中授权，则该自定义策略不生效。管理员可以在授权项列表中查看授权项是否支持iam项目或企业项目，“√”表示支持，“×”表示暂不支持。关于iam项目与企业项目的区别，详情请参见：iam与企业管理的区别。

dms for kafka的支持自定义策略授权项如下所示：

  • 生命周期管理，包含kafka实例所有生命周期接口对应的授权项，如创建实例、查询实例列表、修改实例信息、批量重启或删除实例等接口。
  • 实例管理，包括kafka实例管理接口对应的授权项，如重置密码、开启或关闭实例自动创建topic功能等接口。
  • smart connect，包括smart connect接口对应的授权项，如开启smart connect、关闭smart connect、创建smart connect任务等接口。
  • 规格变更管理，包括实例规格变更管理接口对应的授权项，如实例规格变更接口。
  • 主题管理，包括topic管理接口对应的授权项，如创建topic、查询topic、修改topic等接口。
  • 用户管理，包括用户管理接口对应的授权项，如创建用户、查询用户列表、设置用户权限等接口。
  • 消息查询，包括消息查询接口对应的授权项，如查询消息接口。
  • 后台任务管理，包括实例的后台任务管理接口对应的授权项，如查询实例的后台任务列表、查询后台任务管理中的指定记录等接口。
  • 标签管理，包括实例的标签管理接口对应的授权项，如查询实例标签、查询项目标签等接口。

生命周期管理

表1 生命周期管理

权限

对应api接口

授权项（action）

iam项目

(project)

企业项目

(enterprise project)

创建实例

post /v2/{engine}/{project_id}/instances

dms:instance:create

√

√

查询所有实例列表

get /v2/{project_id}/instances

dms:instance:list

√

√

查询指定实例

get /v2/{project_id}/instances/{instance_id}

dms:instance:get

√

√

删除指定的实例

delete /v2/{project_id}/instances/{instance_id}

dms:instance:delete

√

√

修改实例信息

put /v2/{project_id}/instances/{instance_id}

dms:instance:modify

√

√

批量重启或删除实例

post /v2/{project_id}/instances/action

重启：dms:instance:modifystatus

删除：dms:instance:delete

√

√

实例管理

表2 实例管理

权限

对应api接口

授权项（action）

iam项目

(project)

企业项目

(enterprise project)

重置密码

post /v2/{project_id}/instances/{instance_id}/password

dms:instance:resetauthinfo

√

√

重置manager密码

put /v2/{project_id}/instances/{instance_id}/kafka-manager-password

dms:instance:resetauthinfo

√

√

重启manager

put /v2/{project_id}/instances/{instance_id}/restart-kafka-manager

dms:instance:modifystatus

√

√

开启或关闭实例自动创建topic功能

post /v2/{project_id}/instances/{instance_id}/autotopic

dms:instance:modify

√

√

修改实例跨vpc访问的内网ip

post /v2/{project_id}/instances/{instance_id}/crossvpc/modify

dms:instance:modify

√

√

重置消费组消费进度到指定位置

post /v2/{project_id}/instances/{instance_id}/management/groups/{group}/reset-message-offset

dms:instance:modify

√

√

smart connect

表3 smart connect

权限

对应api接口

授权项

iam项目(project)

企业项目(enterprise project)

开启smart connect

post /v2/{project_id}/instances/{instance_id}/connector

dms:instance:connector

√

√

关闭smart connect

post /v2/{project_id}/kafka/instances/{instance_id}/delete-connector

dms:instance:connector

√

√

创建smart connect任务

post /v2/{project_id}/instances/{instance_id}/connector/tasks

dms:instance:createconnectorsinktask

√

√

查询smart connect任务列表

get /v2/{project_id}/instances/{instance_id}/connector/tasks

dms:instance:listconnectorsinktask

√

√

查询smart connector任务详情

get /v2/{project_id}/instances/{instance_id}/connector/tasks/{task_id}

dms:instance:getconnectorsinktask

√

√

删除smart connector任务

delete /v2/{project_id}/instances/{instance_id}/connector/tasks/{task_id}

dms:instance:deleteconnectorsinktask

√

√

暂停smart connect任务

put /v2/{project_id}/instances/{instance_id}/connector/tasks/{task_id}/pause

dms:instance:updateconnectortask

√

√

启动已暂停的smart connect任务

put /v2/{project_id}/instances/{instance_id}/connector/tasks/{task_id}/resume

dms:instance:updateconnectortask

√

√

启动未启动的smart connect任务/重启已暂停或者运行中的smart connect任务

put /v2/{project_id}/kafka/instances/{instance_id}/connector/tasks/{task_id}/restart

dms:instance:updateconnectortask

√

√

规格变更管理

表4 规格变更管理

权限

对应api接口

授权项

iam项目(project)

企业项目(enterprise project)

实例规格变更

post /v2/{engine}/{project_id}/instances/{instance_id}/extend

dms:instance:scale

√

√

主题管理

表5 主题管理

权限

对应api接口

授权项

iam项目(project)

企业项目(enterprise project)

kafka实例创建topic

post /v2/{project_id}/instances/{instance_id}/topics

dms:instance:modify

√

√

kafka实例查询topic

get /v2/{project_id}/instances/{instance_id}/topics

dms:instance:get

√

√

修改kafka实例topic

put /v2/{project_id}/instances/{instance_id}/topics

dms:instance:modify

√

√

kafka实例批量删除topic

post /v2/{project_id}/instances/{instance_id}/topics/delete

dms:instance:modify

√

√

用户管理

表6 用户管理

权限

对应api接口

授权项

iam项目(project)

企业项目(enterprise project)

查询用户列表

get /v2/{project_id}/instances/{instance_id}/users

dms:instance:get

√

√

创建用户

post /v2/{project_id}/instances/{instance_id}/users

dms:instance:modify

√

√

批量删除用户

put /v2/{project_id}/instances/{instance_id}/users

dms:instance:modify

√

√

重置用户密码

put /v2/{project_id}/instances/{instance_id}/users/{user_name}

dms:instance:get

√

√

查询用户权限

get /v1/{project_id}/instances/{instance_id}/topics/{topic_name}/accesspolicy

dms:instance:get

√

√

设置用户权限

post /v1/{project_id}/instances/{instance_id}/topics/accesspolicy

dms:instance:modify

√

√

消息查询

表7 消息查询

权限

对应api接口

授权项

iam项目(project)

企业项目(enterprise project)

查询消息

get /v2/{project_id}/instances/{instance_id}/messages

dms:instance:get

√

√

后台任务管理

表8 后台任务管理

权限

对应api接口

授权项

iam项目(project)

企业项目(enterprise project)

查询实例的后台任务列表

get /v2/{project_id}/instances/{instance_id}/tasks

dms:instance:getbackgroundtask

√

√

查询后台任务管理中的指定记录

get /v2/{project_id}/instances/{instance_id}/tasks/{task_id}

dms:instance:getbackgroundtask

√

√

删除后台任务管理中的指定记录

delete /v2/{project_id}/instances/{instance_id}/tasks/{task_id}

dms:instance:deletebackgroundtask

√

√

标签管理

表9 标签管理

权限

对应api接口

授权项

iam项目(project)

企业项目(enterprise project)

批量添加或删除实例标签

post /v2/{project_id}/kafka/{instance_id}/tags/action

dms:instance:modify

√

√

查询实例标签

get /v2/{project_id}/kafka/{instance_id}/tags

dms:instance:get

√

√

查询项目标签

get /v2/{project_id}/kafka/tags

dms:instance:get

√

√

相关文档

网站地图