授权信息

更新时间:
复制 MD 格式

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

本文为您介绍 访问控制 为 RAM 权限策略定义的操作(Action)、资源(Resource)和条件(Condition)。 访问控制 的 RAM 代码(RamCode)为 ram ,支持的授权粒度为 资源级

权限策略通用结构

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

访问级别

资源类型

条件关键字

关联操作

ram:ClearAccountAlias ClearAccountAlias update

*全部资源

*

ram:ListPublicKeys ListPublicKeys list

*User

acs:ram::{#accountId}:user/{#UserName}

ram:UploadPublicKey UploadPublicKey create

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:SetSecurityPreference SetSecurityPreference update

*全部资源

*

ram:ListVirtualMFADevices ListVirtualMFADevices get

*MFADevice

acs:ram:*:{#accountId}:mfa/*

ram:GetPolicy GetPolicy get

Policy

acs:ram:*:system:policy/{#PolicyName}

Policy

acs:ram:*:{#accountId}:policy/{#PolicyName}

ram:CreatePolicy CreatePolicy create

*Policy

acs:ram:*:{#accountId}:policy/{#PolicyName}

ram:DeleteGroup DeleteGroup delete

*Group

acs:ram:*:{#accountId}:group/{#GroupName}

ram:SetAccountAlias SetAccountAlias update

*全部资源

*

ram:GetPolicyVersion GetPolicyVersion get

Policy

acs:ram:*:{#accountId}:policy/{#PolicyName}

Policy

acs:ram:*:system:policy/{#PolicyName}

ram:CreateAccessKey CreateAccessKey create

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:ListPoliciesForRole ListPoliciesForRole get

*Role

acs:ram:*:{#accountId}:role/{#RoleName}

ram:DeactivateService DeactivateService update

*全部资源

*

ram:BindMFADevice BindMFADevice

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:ListRoles ListRoles get

*Role

acs:ram:*:{#accountId}:role/*

ram:GetSecurityPreference GetSecurityPreference get

*全部资源

*

ram:ListUsers ListUsers get

*User

acs:ram:*:{#accountId}:user/*

ram:UpdateAccessKey UpdateAccessKey update

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:AttachPolicyToUser AttachPolicyToUser update

Policy

acs:ram:*:{#accountId}:policy/{#PolicyName}

*User

acs:ram:*:{#accountId}:user/{#UserName}

Policy

acs:ram:*:system:policy/{#PolicyName}

ram:DeleteRole DeleteRole delete

*Role

acs:ram:*:{#accountId}:role/{#RoleName}

ram:TrustedPrincipalTypes

ram:ServiceNames

ram:GetServiceLinkedRoleDeletionStatus GetServiceLinkedRoleDeletionStatus get

*ServiceLinkedRole

acs:ram:*:{#accountId}:role/{#RoleName}

ram:ServiceName

ram:CreateRole CreateRole create

*Role

acs:ram:*:{#accountId}:role/{#RoleName}

ram:TrustedPrincipalTypes

ram:ServiceNames

ram:DeleteLoginProfile DeleteLoginProfile delete

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:ListGroupsForUser ListGroupsForUser get

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:UpdateUser UpdateUser update

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:ActivateService ActivateService update

*全部资源

*

ram:DetachPolicyFromGroup DetachPolicyFromGroup update

*Group

acs:ram:*:{#accountId}:group/{#GroupName}

Policy

acs:ram:*:system:policy/{#PolicyName}

Policy

acs:ram:*:{#accountId}:policy/{#PolicyName}

ram:DecodeDiagnosticMessage DecodeDiagnosticMessage get

*全部资源

*

ram:ListEntitiesForPolicy ListEntitiesForPolicy get

Policy

acs:ram:*:system:policy/{#PolicyName}

Policy

acs:ram:*:{#accountId}:policy/{#PolicyName}

ram:GetServiceLastAccessedDetails GetServiceLastAccessedDetails get

*全部资源

*

ram:GetUser GetUser get

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:GetGroup GetGroup get

*Group

acs:ram:*:{#accountId}:group/{#GroupName}

ram:ListPolicies ListPolicies get

*Policy

acs:ram:*:{#accountId}:policy/*

ram:UpdateRole UpdateRole update

*Role

acs:ram:*:{#accountId}:role/{#RoleName}

ram:TrustedPrincipalTypes

ram:ServiceNames

ram:AttachPolicyToRole AttachPolicyToRole update

Policy

acs:ram:*:{#accountId}:policy/{#PolicyName}

*Role

acs:ram:*:{#accountId}:role/{#RoleName}

Policy

acs:ram:*:system:policy/{#PolicyName}

ram:TrustedPrincipalTypes

ram:ServiceNames

ram:GetPasswordPolicy GetPasswordPolicy get

*全部资源

*

ram:AttachPolicyToGroup AttachPolicyToGroup update

*Group

acs:ram:*:{#accountId}:group/{#GroupName}

Policy

acs:ram:*:{#accountId}:policy/{#PolicyName}

Policy

acs:ram:*:system:policy/{#PolicyName}

ram:DeleteServiceLinkedRole DeleteServiceLinkedRole delete

*ServiceLinkedRole

acs:ram:*:{#accountId}:role/{#RoleName}

ram:ServiceName

ram:DetachPolicyFromRole DetachPolicyFromRole update

Policy

acs:ram:*:{#accountId}:policy/{#PolicyName}

*Role

acs:ram:*:{#accountId}:role/{#RoleName}

Policy

acs:ram:*:system:policy/{#PolicyName}

ram:TrustedPrincipalTypes

ram:ServiceNames

ram:UpdatePolicyDescription UpdatePolicyDescription update

*Policy

acs:ram:*:{#accountId}:policy/{#PolicyName}

ram:ListRoles ListRolesForService list

*Role

acs:ram:*:{#accountId}:role/*

ram:CreateLoginProfile CreateLoginProfile create

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:UpdateLoginProfile UpdateLoginProfile update

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:DeletePolicyVersion DeletePolicyVersion delete

*Policy

acs:ram:*:{#accountId}:policy/{#PolicyName}

ram:UntagResources UntagResources delete

*全部资源

*

ram:RemoveUserFromGroup RemoveUserFromGroup update

*Group

acs:ram:*:{#accountId}:group/{#GroupName}

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:ListTagResources ListTagResources list

*全部资源

*

ram:GetRole GetRole get

*Role

acs:ram:*:{#accountId}:role/{#RoleName}

ram:GetLoginProfile GetLoginProfile get

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:CreateServiceLinkedRole CreateServiceLinkedRole create

*全部资源

*

ram:ServiceName

ram:ListUsersForGroup ListUsersForGroup get

*Group

acs:ram:*:{#accountId}:group/{#GroupName}

ram:GenerateServiceLastAccessedDetails GenerateServiceLastAccessedDetails create

*全部资源

*

ram:TagResources TagResources create

*全部资源

*

ram:DeleteUser DeleteUser delete

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:DeletePolicy DeletePolicy delete

*Policy

acs:ram:*:{#accountId}:policy/{#PolicyName}

ram:AddUserToGroup AddUserToGroup create

*Group

acs:ram:*:{#accountId}:group/{#GroupName}

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:GetAccountAlias GetAccountAlias get

*全部资源

*

ram:UnbindMFADevice UnbindMFADevice update

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:DeleteVirtualMFADevice DeleteVirtualMFADevice delete

*MFADevice

acs:ram:*:{#accountId}:mfa/{#SerialNumber}

ram:CreateUser CreateUser create

*User

acs:ram:*:{#accountId}:user/*

ram:DeletePublicKey DeletePublicKey delete

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:CreateGroup CreateGroup create

*Group

acs:ram:*:{#accountId}:group/*

ram:UpdateGroup UpdateGroup update

*Group

acs:ram:*:{#accountId}:group/{#GroupName}

ram:ListAccessKeys ListAccessKeys get

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:GetAccountSummary GetAccountSummary get

*全部资源

*

ram:ListPolicyVersions ListPolicyVersions get

Policy

acs:ram:*:{#accountId}:policy/{#PolicyName}

Policy

acs:ram:*:system:policy/{#PolicyName}

ram:CreateVirtualMFADevice CreateVirtualMFADevice create

*MFADevice

acs:ram:*:{#accountId}:mfa/*

ram:SetDefaultPolicyVersion SetDefaultPolicyVersion update

*Policy

acs:ram:*:{#accountId}:policy/{#PolicyName}

ram:ListPoliciesForGroup ListPoliciesForGroup get

*Group

acs:ram:*:{#accountId}:group/{#GroupName}

ram:GetPublicKey GetPublicKey get

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:DeleteAccessKey DeleteAccessKey delete

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:GetServiceStatus GetServiceStatus get

*全部资源

*

ram:ChangePassword ChangePassword update

*全部资源

*

ram:DetachPolicyFromUser DetachPolicyFromUser update

Policy

acs:ram:*:{#accountId}:policy/{#PolicyName}

*User

acs:ram:*:{#accountId}:user/{#UserName}

Policy

acs:ram:*:system:policy/{#PolicyName}

ram:ListPoliciesForUser ListPoliciesForUser get

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:GetUserMFAInfo GetUserMFAInfo get

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:CreatePolicyVersion CreatePolicyVersion create

*Policy

acs:ram:*:{#accountId}:policy/{#PolicyName}

ram:SetPasswordPolicy SetPasswordPolicy update

*全部资源

*

ram:GetAccessKeyLastUsed GetAccessKeyLastUsed get

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:UpdatePublicKey UpdatePublicKey update

*User

acs:ram:*:{#accountId}:user/{#UserName}

ram:ListGroups ListGroups get

*Group

acs:ram:*:{#accountId}:group/*

资源(Resource)

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

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

  • *表示全部。例如:

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

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

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

资源类型

资源 ARN

Unrestricted
  • acs:ram:*:{#accountId}:*
User
  • acs:ram::{#accountId}:user/{#UserName}
  • acs:ram:*:{#accountId}:user/{#UserName}
  • acs:ram:*:{#accountId}:user/*
  • {#Arn}
MFADevice
  • acs:ram:*:{#accountId}:mfa/*
  • acs:ram:*:{#accountId}:mfa/{#SerialNumber}
Policy
  • acs:ram:*:system:policy/{#PolicyName}
  • acs:ram:*:{#accountId}:policy/{#PolicyName}
  • acs:ram:*:{#accountId}:policy/*
  • acs:ram::{#accountId}:policy/{#PolicyName}
Group
  • acs:ram:*:{#accountId}:group/{#GroupName}
  • acs:ram:*:{#accountId}:group/*
Role
  • acs:ram:*:{#accountId}:role/{#RoleName}
  • acs:ram:*:{#accountId}:role/*
  • acs:ram::{#accountId}:role/{#RoleName}
ServiceLinkedRole
  • acs:ram:*:{#accountId}:role/{#RoleName}
  • acs:ram:*:{#accountId}:role/*

条件(Condition)

下表是访问控制 定义的产品级条件关键字,这些条件关键字可以在 RAM 权限策略语句的Condition元素中使用,用来描述授予权限的条件。以下仅列举产品级的条件关键字,阿里云定义的通用条件关键字也同样适用访问控制

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

条件关键字

描述

类型

acs:Service 角色可以被传递给云服务的标识,此限制条件仅适用于 PassRole 操作。取值示例:actiontrail.aliyuncs.com String
ram:ServiceNames 服务角色可信的云服务标识,多值,取值示例:[\"ecs.aliyun.com\",\"rds.aliyuncs.com\"] Array
ram:TrustedPrincipalTypes 角色可信实体的类型,多值。 Array

相关操作

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