授权信息

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

本文为您介绍 数据湖构建 为 RAM 权限策略定义的操作(Action)、资源(Resource)和条件(Condition)。 数据湖构建 的 RAM 代码(RamCode)为 dlf ,支持的授权粒度为 操作级

权限策略通用结构

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

下表是数据湖构建定义的操作,这些操作可以在 RAM 权限策略语句的Action元素中使用,用来授予执行该操作的权限。下面对表中的具体项提供说明:

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

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

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

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

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

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

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

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

操作

API

访问级别

资源类型

条件关键字

关联操作

dlf:AlterReceiver AlterReceiver none

*全部资源

*

dlf:ListIcebergNamespaceDetails ListIcebergNamespaceDetails get

*全部资源

*

dlf:AlterShareReceivers AlterShareReceivers none

*全部资源

*

dlf:AlterTable AlterTable none

*全部资源

*

dlf:ListUserRoles ListUserRoles get

*全部资源

*

dlf:GetCatalogSummary GetCatalogSummary get

*全部资源

*

dlf:GetTable GetTable get

*全部资源

*

dlf:ListPermissions ListPermissions get

*全部资源

*

dlf:ListTableDetails ListTableDetails get

*全部资源

*

dlf:ListProvidedShares ListProvidedShares get

*全部资源

*

dlf:AlterShareResources AlterShareResources none

*全部资源

*

dlf:GetDatabase GetDatabase get

*全部资源

*

dlf:GetTableSnapshot GetTableSnapshot get

*全部资源

*

dlf:GetTableToken GetTableToken get

*全部资源

*

dlf:BatchRevokePermissions BatchRevokePermissions create

*全部资源

*

dlf:DescribeRegions DescribeRegions get

*全部资源

*

dlf:CreateCatalog CreateCatalog create

*全部资源

*

dlf:UpdateRole UpdateRole update

*全部资源

*

dlf:DeleteRole DeleteRole delete

*全部资源

*

dlf:ListTables ListTables get

*全部资源

*

dlf:ListShareReceivers ListShareReceivers get

*全部资源

*

dlf:AlterShare AlterShare none

*全部资源

*

dlf:GetTableSummary GetTableSummary get

*全部资源

*

dlf:GetReceiver GetReceiver get

*全部资源

*

dlf:GetCatalogToken GetCatalogToken get

*全部资源

*

dlf:GetUser GetUser get

*全部资源

*

dlf:GetIcebergNamespace GetIcebergNamespace get

*全部资源

*

dlf:ListUsers ListUsers get

*全部资源

*

dlf:ListDatabaseDetails ListDatabaseDetails get

*全部资源

*

dlf:ListShareResources ListShareResources get

*全部资源

*

dlf:GetDatabaseSummary GetDatabaseSummary get

*全部资源

*

dlf:CreateDatabase CreateDatabase create

*全部资源

*

dlf:ListRoleUsers ListRoleUsers get

*全部资源

*

dlf:RevokeRoleFromUsers RevokeRoleFromUsers none

*全部资源

*

dlf:GetIcebergTable GetIcebergTable get

*全部资源

*

dlf:ListSnapshots ListSnapshots get

*全部资源

*

dlf:ListDatabases ListDatabases get

*全部资源

*

dlf:GrantRoleToUsers GrantRoleToUsers create

*全部资源

*

dlf:DropTable DropTable delete

*全部资源

*

dlf:Subscribe Subscribe create

*全部资源

*

dlf:ListReceivedShares ListReceivedShares get

*全部资源

*

dlf:ListCatalogs ListCatalogs get

*全部资源

*

dlf:DropCatalog DropCatalog delete

*全部资源

*

dlf:GetCatalog GetCatalog get

*全部资源

*

dlf:UpdateRoleUsers UpdateRoleUsers update

*全部资源

*

dlf:BatchGrantPermissions BatchGrantPermissions create

*全部资源

*

dlf:AlterDatabase AlterDatabase none

*全部资源

*

dlf:GetRole GetRole get

*全部资源

*

dlf:CreateShare CreateShare create

*全部资源

*

dlf:AlterCatalog AlterCatalog none

*全部资源

*

dlf:ListReceivers ListReceivers get

*全部资源

*

dlf:ListPartitions ListPartitions get

*全部资源

*

dlf:ListIcebergTableDetails ListIcebergTableDetails get

*全部资源

*

dlf:CreateTable CreateTable create

*全部资源

*

dlf:ListIcebergSnapshots ListIcebergSnapshots get

*全部资源

*

dlf:DropShare DropShare delete

*全部资源

*

dlf:RefreshUserSync RefreshUserSync create

*全部资源

*

dlf:DropReceiver DropReceiver delete

*全部资源

*

dlf:CreateRole CreateRole create

*全部资源

*

dlf:CreateReceiver CreateReceiver create

*全部资源

*

dlf:ListPartitionSummaries ListPartitionSummaries get

*全部资源

*

dlf:ListRoles ListRoles get

*全部资源

*

dlf:GetCatalogById GetCatalogById get

*全部资源

*

dlf:GetCatalogSummaryTrend GetCatalogSummaryTrend get

*全部资源

*

dlf:RollbackTable RollbackTable none

*全部资源

*

dlf:GetRegionStatus GetRegionStatus get

*全部资源

*

dlf:DropDatabase DropDatabase delete

*全部资源

*

dlf:GetShare GetShare get

*全部资源

*

资源(Resource)

下表是数据湖构建定义的资源,这些资源可以在 RAM 权限策略语句的Resource元素中使用,用来授予对该资源执行具体操作的权限。 其中,资源 ARN 是资源在阿里云上的唯一标识。具体说明如下:

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

  • *表示全部。例如:

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

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

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

资源类型

资源 ARN

条件(Condition)

数据湖构建未定义产品级别的条件关键字。如需查看适用于所有云产品的通用条件关键字,请参见通用条件关键字

相关操作

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