文档首页/ 分布式消息服务RocketMQ版/ API参考/ 权限和授权项
更新时间：2025-09-16 GMT+08:00
在线调试
CLI示例
查看PDF
分享

权限和授权项

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

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

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

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

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

支持的授权项

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

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

DMS for RocketMQ的支持自定义策略授权项参见表1。

表1 DMS for RocketMQ授权项明细

权限

对应API接口

授权项

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:delete

√

√

查询代理列表

GET /v2/{project_id}/instances/{instance_id}/brokers

dms:broker:list

√

√

创建主题或批量删除主题

POST /v2/{project_id}/instances/{instance_id}/topics
  • dms:topic:create
  • dms:topic:delete

√

√

查询主题列表

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

dms:topic:list

√

√

删除指定主题

DELETE /v2/{project_id}/instances/{instance_id}/topics/{topic}

dms:topic:delete

√

√

修改主题

PUT /v2/{project_id}/instances/{instance_id}/topics/{topic}

dms:topic:modify

√

√

查询主题消费组列表

GET /v2/{project_id}/instances/{instance_id}/topics/{topic}/groups

dms:topic:get

√

√

查询主题的消息数

GET /v2/{project_id}/instances/{instance_id}/topics/{topic}/status

dms:topic:get

√

√

查询消息

GET /v2/{engine}/{project_id}/instances/{instance_id}/messages

dms:message:get

√

√

发送消息

POST /v2/{engine}/{project_id}/instances/{instance_id}/messages

dms:message:send

√

√

查询消息轨迹

GET /v2/{engine}/{project_id}/instances/{instance_id}/trace

dms:message:getTrace

√

√

导出消息列表

POST /v2/{project_id}/instances/{instance_id}/messages/export

dms:message:export

√

√

重发死信消息

POST /v2/{engine}/{project_id}/instances/{instance_id}/messages/deadletter-resend

dms:instance:resendDlqMsg

√

√

创建用户

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

dms:user:create

√

√

查询用户列表

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

dms:user:list

√

√

查询用户详情

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

dms:user:get

√

√

修改用户参数

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

dms:user:modify

√

√

删除用户

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

dms:user:delete

√

√

创建消费组或批量删除消费组

POST /v2/{project_id}/instances/{instance_id}/groups
  • dms:group:create
  • dms:group:delete

√

√

查询消费列表或详情

GET /v2/{project_id}/instances/{instance_id}/groups/{group}/topics
  • dms:group:list
  • dms:group:get

√

√

删除指定消费组

DELETE /v2/{project_id}/instances/{instance_id}/groups/{group}

dms:group:delete

√

√

重置消费进度

POST /v2/{engine}/{project_id}/instances/{instance_id}/groups/{group_id}/reset-message-offset

dms:group:resetConsumeOffset

√

√

修改消费者组

PUT /v2/{project_id}/instances/{instance_id}/groups/{group}

dms:group:modify

√

√

新建元数据迁移任务

POST /v2/{project_id}/instances/{instance_id}/metadata

dms:instance:createMetadataMigrationTask

√

√

查询实例下所有迁移任务或查询指定迁移任务信息

GET /v2/{project_id}/instances/{instance_id}/metadata
  • dms:instance:listMetadataMigrationTasks
  • dms:instance:getMetadataMigrationTask

√

√

删除元数据迁移任务

DELETE /v2/{project_id}/instances/{instance_id}/metadata

dms:instance:deleteMetadataMigrationTask

√

√

创建实例诊断任务

POST /v2/{engine}/{project_id}/instances/{instance_id}/diagnosis

instance:createDiagnosisTask

√

√

查询实例诊断报告列表

GET /v2/{engine}/{project_id}/instances/{instance_id}/diagnosis

dms:instance:listDiagnosisReport

√

√

批量删除实例诊断记录

DELETE /v2/{engine}/{project_id}/instances/{instance_id}/diagnosis

dms:instance:deleteDiagnosisReport

√

√

查询实例诊断报告

GET /v2/{engine}/{project_id}/diagnosis/{report_id}

dms:instance:getDiagnosisReport

√

√

实例规格变更

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

dms:instance:scale

√

√

修改实例ssl相关配置

POST /v2/{project_id}/{engine}/instances/{instance_id}/plain-ssl-switch

dms:instance:modifySslSwitch

√

√

重启指定实例

POST /v2/{project_id}/{engine}/instances/{instance_id}/restart

dms:instance:modifyStatus

√

√

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

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

√

√

相关文档