授权信息

访问控制(RAM)是阿里云提供的管理用户身份与资源访问权限的服务。使用 RAM 可以让您避免与其他用户共享阿里云账号密钥,并可按需为用户授予最小权限。RAM 中使用权限策略描述授权的具体内容。

本文为您介绍 轻量消息队列(原 MNS) 为 RAM 权限策略定义的操作(Action)、资源(Resource)和条件(Condition)。 轻量消息队列(原 MNS) 的 RAM 代码(RamCode)为 mns ,支持的授权粒度为 资源级

权限策略通用结构

权限策略支持 JSON 格式,其通用结构如下:

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "<Effect>",
      "Action": "<Action>",
      "Resource": "<Resource>",
      "Condition": {
        "<Condition_operator>": {
          "<Condition_key>": [
            "<Condition_value>"
          ]
        }
      }
    }
  ]
}        

各字段含义如下:

  • Effect:权限策略效果。取值:Allow(允许)、Deny(拒绝)。

  • Action:授予允许或拒绝权限的具体操作。具体信息,请参见操作(Action)

  • Resource:受操作影响的具体对象,您可以使用资源 ARN 来描述指定资源。具体信息,请参见资源(Resource)

  • Condition:指授权生效的条件。可选字段。具体信息,请参见条件(Condition)

    • Condition_operator:条件运算符,不同类型的条件对应不同的条件运算符。具体信息,请参见权限策略基本元素

    • Condition_key:条件关键字。

    • Condition_value:条件关键字对应的值。

操作(Action)

下表是轻量消息队列(原 MNS)定义的操作,这些操作可以在 RAM 权限策略语句的Action元素中使用,用来授予执行该操作的权限。下面对表中的具体项提供说明:

  • 操作:是指具体的权限点。

  • API:是指操作对应的 API 接口。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。该列不体现适用于任何操作的通用条件关键字

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

API

访问级别

资源类型

条件关键字

关联操作

mns:GetConsumeTrace GetConsumeTrace get

*全部资源

*

mns:SetTopicAttributes SetTopicAttributes update

*Topic

acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}

mns:EnableLogging

mns:RevokeEndpointAcl RevokeEndpointAcl none

*全部资源

*

mns:PurgeQueue PurgeQueue update

*全部资源

*

mns:ListQueue GetResourceCount get

*全部资源

*

mns:TagResources TagResources create

*Topic

acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}

*Queue

acs:mns:{#regionId}:{#accountId}:/queues/{#QueueName}

mns:SetQueueAttributes SetQueueAttributes update

*Queue

acs:mns:{#regionId}:{#accountId}:/queues/{#QueueName}

mns:EnableLogging

mns:ListQueue ListResource list

*全部资源

*

mns:ResetQueueOffset ResetQueueOffset update

*全部资源

*

mns:ResetSubscriptionOffset ResetSubscriptionOffset update

*全部资源

*

mns:GetTopicAttributes GetTopicAttributes get

*Topic

acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}

mns:ListQueue ListQueue list

*全部资源

*

mns:Subscribe Subscribe update

*Subscription

acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}/subscriptions/{#SubscriptionName}

mns:PushType

mns:GetEndpointAttribute GetEndpointAttribute none

*全部资源

*

mns:GetQueueAttributes GetQueueAttributes get

*Queue

acs:mns:{#regionId}:{#accountId}:/queues/{#QueueName}

mns:GetSubscriptionDlqPolicy GetSubscriptionDlqPolicy get

*Subscription

acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}/subscriptions/{#SubscriptionName}

mns:ListEventRules ListEventRules list

*Topic

acs:mns:{#regionId}:{#accountId}:/products/{#ProductName}/rules

mns:ListTagResources ListTagResources list

*全部资源

*

mns:GetEventRule GetEventRule get

*Topic

acs:mns:{#regionId}:{#accountId}:/products/{#ProductName}/rules

mns:SetQueueDlqPolicy SetQueueDlqPolicy update

*Queue

acs:mns:{#regionId}:{#accountId}:/queues/{#QueueName}

mns:CreateQueue CreateQueue create

*Queue

acs:mns:{#regionId}:{#accountId}:/queues/{#QueueName}

mns:EnableLogging

mns:ListSubscriptionByTopic ListSubscriptionByTopic list

*Subscription

acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}/subscriptions

mns:CreateTopic CreateTopic create

*Topic

acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}

mns:EnableLogging

mns:GetSendTrace GetSendTrace get

*全部资源

*

mns:DisableEndpoint DisableEndpoint none

*全部资源

*

mns:GetSubscriptionTrace GetSubscriptionTrace get

*全部资源

*

mns:GetAccountAttributes GetAccountAttributes get

*全部资源

*

mns:DeleteTopic DeleteTopic delete

*Topic

acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}

mns:GetSubscriptionAttributes GetSubscriptionAttributes get

*Subscription

acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}/subscriptions/{#SubscriptionName}

mns:UntagResources UntagResources delete

*Topic

acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}

*Queue

acs:mns:{#regionId}:{#accountId}:/queues/{#QueueName}

mns:GetPushTrace GetPushTrace get

*全部资源

*

mns:SetSubscriptionDlqPolicy SetSubscriptionDlqPolicy update

*Subscription

acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}/subscriptions/{#SubscriptionName}

mns:EnableEndpoint EnableEndpoint none

*全部资源

*

mns:SetAccountAttributes SetAccountAttributes update

*全部资源

*

mns:SetSubscriptionAttributes SetSubscriptionAttributes update

*Subscription

acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}/subscriptions/{#SubscriptionName}

mns:ListMessageTraces ListMessageTraces list

*全部资源

*

mns:ListTopic ListTopic list

*全部资源

*

mns:DeleteQueue DeleteQueue delete

*Queue

acs:mns:{#regionId}:{#accountId}:/queues/{#QueueName}

mns:AuthorizeEndpointAcl AuthorizeEndpointAcl none

*全部资源

*

mns:DeleteEventNotifications DeleteEventRule delete

*全部资源

*

mns:PutEventNotifications CreateEventRule create

*全部资源

*

mns:Unsubscribe Unsubscribe update

*Subscription

acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}/subscriptions/{#SubscriptionName}

mns:GetQueueDlqPolicy GetQueueDlqPolicy get

*Queue

acs:mns:{#regionId}:{#accountId}:/queues/{#QueueName}

资源(Resource)

下表是轻量消息队列(原 MNS)定义的资源,这些资源可以在 RAM 权限策略语句的Resource元素中使用,用来授予对该资源执行具体操作的权限。 其中,资源 ARN 是资源在阿里云上的唯一标识。具体说明如下:

  • {#}为变量标识,需要您替换为实际值。例如:{#ramcode}需要您替换为实际的云服务RAM代码。

  • *表示全部。例如:

    • {#resourceType}*时:表示全部资源。

    • {#regionId}*时:表示全部地域。

    • {#accountId}*时:表示全部阿里云账号。

资源类型

资源 ARN

Topic
  • acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}
  • acs:messageservice:{#regionId}:{#accountId}:/topics/{#TopicName}/subscriptions/{#SubscriptionName}
  • acs:mns:{#regionId}:{#accountId}:/products/{#ProductName}/rules
  • acs:mns:{#regionId}:{#accountId}:/topics
  • acs:messageservice:{#regionId}:{#accountId}:/products/{#ProductName}/rules
Queue
  • acs:mns:{#regionId}:{#accountId}:/queues
  • acs:mns:{#regionId}:{#accountId}:/queues/{#QueueName}
  • acs:messageservice:{#regionId}:{#accountId}:/queues/{#QueueName}
Subscription
  • acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}/subscriptions/{#SubscriptionName}
  • acs:mns:{#regionId}:{#accountId}:/topics/{#TopicName}/subscriptions

条件(Condition)

下表是轻量消息队列(原 MNS) 定义的产品级条件关键字,这些条件关键字可以在 RAM 权限策略语句的Condition元素中使用,用来描述授予权限的条件。以下仅列举产品级的条件关键字,阿里云定义的通用条件关键字也同样适用轻量消息队列(原 MNS)

其中,数据类型决定了您可以使用哪些条件运算符将请求中的值与权限策略语句中的值进行比较。您必须使用与数据类型匹配的条件运算符,否则无法匹配策略语句,授权行为无效。数据类型与条件运算符的对应关系,请参见条件操作类型

条件关键字

描述

类型

mns:EnableLogging 是否启用日志功能 String
mns:PushType 订阅类型 String

相关操作

您可以创建自定义权限策略,并将权限策略授予 RAM 用户、RAM 用户组或 RAM 角色。具体操作如下: