授权信息

更新时间: 2024-12-06 18:00:38

访问控制(RAM)是阿里云提供的管理用户身份与资源访问权限的服务。使用RAM可以让您避免与其他用户共享阿里云账号密钥,并可按需为用户授予最小权限。RAM中使用权限策略描述授权的具体内容。本文为您介绍云消息队列 Kafka 版(AliKafka)为RAM权限策略定义的操作(Action)、资源(Resource)和条件(Condition)。云消息队列 Kafka 版(AliKafka)的RAM代码(RamCode)为[{"popCode":"alikafkanext","ramCodes":["alikafka"]},{"popCode":"alikafka","ramCodes":["alikafka"]}],支持的授权粒度为RESOURCE

权限策略通用结构

权限策略支持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)

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

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

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

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

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

    • 对于必选的资源类型,用背景高亮的方式表示。

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

  • 条件关键字:是指云产品自身定义的条件关键字。该列不体现适用于任何操作的权限策略基本元素

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

操作

API

访问级别

资源类型

条件关键字

关联操作

alikafka:CreatePrePayOrder

CreatePrePayOrder - 创建预付费实例

create

Instance

acs:alikafka:{#regionId}:{#accountId}:instance/*

alikafka:SpecType

alikafka:DeployModule

alikafka:StartInstance

StartInstance - 部署实例

update

全部资源

*

alikafka:DeployModule

alikafka:SpecType

alikafka:Acl

alikafka:DiskEncryption

alikafka:UpdateInstance

ModifyInstanceName - 修改实例的名称

update

Instance

acs:alikafka:{#regionId}:{#accountId}:{#InstanceId}

alikafka:ListInstance

GetInstanceList - 查询指定地域的实例信息

get

全部资源

*

alikafka:ListInstance

GetAllInstanceIdList - 查询所有地域的实例ID

get

全部资源

*

alikafka:UpgradePostPayOrder

UpgradePrePayOrder - 升配预付费实例

update

全部资源

*

alikafka:DeployModule

alikafka:ListTagResources

ListTagResources - 查询资源绑定的标签列表

get

全部资源

*

alikafka:UntagResources

UntagResources - 为资源解绑标签

update

全部资源

*

alikafka:TagResources

TagResources - 为资源绑定标签

update

Instance

acs:alikafka:{#regionId}:{#accountId}:{#InstanceId}

alikafka:CreateSaslUser

CreateSaslUser - 创建SASL用户

create

Instance

acs:alikafka:{#regionId}:{#accountId}:{#InstanceId}

alikafka:DeleteSaslUser

DeleteSaslUser - 删除SASL用户

delete

Instance

acs:alikafka:{#regionId}:{#accountId}:{#InstanceId}

alikafka:ListSaslUser

DescribeSaslUsers - 查询SASL用户

get

Instance

acs:alikafka:{#regionId}:{#accountId}:{#InstanceId}

资源(Resource)

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

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

  • *表示全部。例如:

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

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

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

资源类型

资源ARN

Instance

acs:alikafka:{#regionId}:{#accountId}:{#InstanceId}

ConsumerGroup

acs:alikafka:{#regionId}:{#accountId}:instance/{#InstanceId}/consumergroup/{#ConsumerGroupId}

Instance

acs:alikafka:{#regionId}:{#accountId}:*

Instance

acs:alikafka:{#regionId}:{#accountId}:instance/{#InstanceId}

Instance

acs:alikafka:{#regionId}:{#accountId}:instance/*

Topic

acs:alikafka:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#Topic}

条件(Condition)

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

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

条件关键字

描述

类型

alikafka:DeployModule

部署模式

String

alikafka:SpecType

实例规格

String

alikafka:Acl

是否开启ACL

Boolean

alikafka:DiskEncryption

磁盘是否加密

Boolean

相关操作

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

上一篇: 服务接入点 下一篇: API目录
阿里云首页 云消息队列 Kafka 版 相关技术圈