访问控制(RAM)是阿里云提供的管理用户身份与资源访问权限的服务。使用RAM可以让您避免与其他用户共享阿里云账号密钥,并可按需为用户授予最小权限。RAM中使用权限策略描述授权的具体内容。
本文为您介绍访问控制(RAM)为RAM权限策略定义的操作(Action)、资源(Resource)和条件(Condition)。访问控制(RAM)的RAM代码(RamCode)为ram,sts,支持的授权粒度为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)
下表是访问控制(RAM)定义的操作,这些操作可以在RAM权限策略语句的Action
元素中使用,用来授予执行该操作的权限。下面对表中的具体项提供说明:- 操作:是指具体的权限点。
- API:是指操作对应的API接口。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。该列不体现适用于任何操作的通用条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | API | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|---|
ram:ChangePassword | ChangePassword | update | 全部资源 * | 无 | 无 |
ram:ClearAccountAlias | ClearAccountAlias | update | 全部资源 * | 无 | 无 |
ram:CreateUser | CreateUser | create | User acs:ram:*:{#accountId}:user/* | 无 | 无 |
ram:UpdateRole | UpdateRole | update | Role acs:ram:*:{#accountId}:role/{#RoleName} | ram:TrustedPrincipalTypes ram:ServiceNames | 无 |
ram:CreatePolicy | CreatePolicy | create | Policy acs:ram:*:{#accountId}:policy/{#PolicyName} | 无 | 无 |
ram:CreatePolicyVersion | CreatePolicyVersion | create | Policy acs:ram:*:{#accountId}:policy/{#PolicyName} | 无 | 无 |
ram:CreateGroup | CreateGroup | create | Group acs:ram:*:{#accountId}:group/* | 无 | 无 |
ram:ListUsers | ListUsers | get | User acs:ram:*:{#accountId}:user/* | 无 | 无 |
ram:GetPolicyVersion | GetPolicyVersion | get | Policy acs:ram:*:{#accountId}:policy/{#PolicyName}Policy acs:ram:*:system:policy/{#PolicyName} | 无 | 无 |
ram:GetLoginProfile | GetLoginProfile | get | User acs:ram:*:{#accountId}:user/{#UserName} | 无 | 无 |
ram:GetGroup | GetGroup | get | Group acs:ram:*:{#accountId}:group/{#GroupName} | 无 | 无 |
ram:DeleteLoginProfile | DeleteLoginProfile | delete | User acs:ram:*:{#accountId}:user/{#UserName} | 无 | 无 |
ram:UnbindMFADevice | UnbindMFADevice | update | User acs:ram:*:{#accountId}:user/{#UserName} | 无 | 无 |
ram:DeletePolicy | DeletePolicy | delete | Policy acs:ram:*:{#accountId}:policy/{#PolicyName} | 无 | 无 |
ram:ListPoliciesForGroup | ListPoliciesForGroup | get | Group acs:ram:*:{#accountId}:group/{#GroupName} | 无 | 无 |
ram:ListVirtualMFADevices | ListVirtualMFADevices | get | MFADevice acs:ram:*:{#accountId}:mfa/* | 无 | 无 |
ram:ListPoliciesForUser | ListPoliciesForUser | get | User acs:ram:*:{#accountId}:user/{#UserName} | 无 | 无 |
ram:GetSecurityPreference | GetSecurityPreference | get | 全部资源 * | 无 | 无 |
ram:DeleteUser | DeleteUser | delete | User acs:ram:*:{#accountId}:user/{#UserName} | 无 | 无 |
ram:SetAccountAlias | SetAccountAlias | update | 全部资源 * | 无 | 无 |
ram:ListGroups | ListGroups | get | Group acs:ram:*:{#accountId}:group/* | 无 | 无 |
ram:AttachPolicyToGroup | AttachPolicyToGroup | update | Group acs:ram:*:{#accountId}:group/{#GroupName}Policy acs:ram:*:{#accountId}:policy/{#PolicyName}Policy acs:ram:*:system:policy/{#PolicyName} | 无 | 无 |
ram:SetSecurityPreference | SetSecurityPreference | update | 全部资源 * | 无 | 无 |
ram:SetPasswordPolicy | SetPasswordPolicy | update | 全部资源 * | 无 | 无 |
ram:ListPolicyVersions | ListPolicyVersions | get | Policy acs:ram:*:{#accountId}:policy/{#PolicyName}Policy acs:ram:*:system:policy/{#PolicyName} | 无 | 无 |
ram:ListUsersForGroup | ListUsersForGroup | get | Group acs:ram:*:{#accountId}:group/{#GroupName} | 无 | 无 |
ram:GetPasswordPolicy | GetPasswordPolicy | get | 全部资源 * | 无 | 无 |
ram:GetRole | GetRole | get | Role acs:ram:*:{#accountId}:role/{#RoleName} | 无 | 无 |
ram:ListEntitiesForPolicy | ListEntitiesForPolicy | get | Policy acs:ram:*:system:policy/{#PolicyName}Policy acs:ram:*:{#accountId}:policy/{#PolicyName} | 无 | 无 |
ram:AttachPolicyToUser | AttachPolicyToUser | update | Policy acs:ram:*:{#accountId}:policy/{#PolicyName}User acs:ram:*:{#accountId}:user/{#UserName}Policy acs:ram:*:system:policy/{#PolicyName} | 无 | 无 |
ram:UpdateAccessKey | UpdateAccessKey | update | User acs:ram:*:{#accountId}:user/{#UserName} | 无 | 无 |
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:DeletePolicyVersion | DeletePolicyVersion | delete | Policy acs:ram:*:{#accountId}:policy/{#PolicyName} | 无 | 无 |
ram:UpdateUser | UpdateUser | update | User acs:ram:*:{#accountId}:user/{#UserName} | 无 | 无 |
ram:ListGroupsForUser | ListGroupsForUser | get | User acs:ram:*:{#accountId}:user/{#UserName} | 无 | 无 |
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:UpdatePolicyDescription | UpdatePolicyDescription | update | Policy acs:ram:*:{#accountId}:policy/{#PolicyName} | 无 | 无 |
ram:ListPolicies | ListPolicies | get | Policy acs:ram:*:{#accountId}:policy/* | 无 | 无 |
ram:BindMFADevice | BindMFADevice | Write | User acs:ram:*:{#accountId}:user/{#UserName} | 无 | 无 |
ram:ListRoles | ListRoles | get | Role acs:ram:*:{#accountId}:role/* | 无 | 无 |
ram:DetachPolicyFromUser | DetachPolicyFromUser | update | Policy acs:ram:*:{#accountId}:policy/{#PolicyName}User acs:ram:*:{#accountId}:user/{#UserName}Policy acs:ram:*:system:policy/{#PolicyName} | 无 | 无 |
ram:UpdateGroup | UpdateGroup | update | Group acs:ram:*:{#accountId}:group/{#GroupName} | 无 | 无 |
ram:DeleteRole | DeleteRole | delete | Role acs:ram:*:{#accountId}:role/{#RoleName} | ram:TrustedPrincipalTypes ram:ServiceNames | 无 |
ram:GetUserMFAInfo | GetUserMFAInfo | get | User acs:ram:*:{#accountId}:user/{#UserName} | 无 | 无 |
ram:DetachPolicyFromGroup | DetachPolicyFromGroup | update | Group acs:ram:*:{#accountId}:group/{#GroupName}Policy acs:ram:*:system:policy/{#PolicyName}Policy acs:ram:*:{#accountId}:policy/{#PolicyName} | 无 | 无 |
ram:DeleteGroup | DeleteGroup | delete | Group acs:ram:*:{#accountId}:group/{#GroupName} | 无 | 无 |
ram:CreateVirtualMFADevice | CreateVirtualMFADevice | create | MFADevice acs:ram:*:{#accountId}:mfa/* | 无 | 无 |
ram:CreateRole | CreateRole | create | Role acs:ram:*:{#accountId}:role/{#RoleName} | ram:TrustedPrincipalTypes ram:ServiceNames | 无 |
ram:GetAccountAlias | GetAccountAlias | get | 全部资源 * | 无 | 无 |
ram:RemoveUserFromGroup | RemoveUserFromGroup | update | Group acs:ram:*:{#accountId}:group/{#GroupName}User acs:ram:*:{#accountId}:user/{#UserName} | 无 | 无 |
ram:DecodeDiagnosticMessage | DecodeDiagnosticMessage | get | 全部资源 * | 无 | 无 |
ram:AddUserToGroup | AddUserToGroup | create | Group acs:ram:*:{#accountId}:group/{#GroupName}User acs:ram:*:{#accountId}:user/{#UserName} | 无 | 无 |
ram:CreateLoginProfile | CreateLoginProfile | create | User acs:ram:*:{#accountId}:user/{#UserName} | 无 | 无 |
ram:ListAccessKeys | ListAccessKeys | get | User acs:ram:*:{#accountId}:user/{#UserName} | 无 | 无 |
ram:DeleteAccessKey | DeleteAccessKey | delete | User acs:ram:*:{#accountId}:user/{#UserName} | 无 | 无 |
ram:SetDefaultPolicyVersion | SetDefaultPolicyVersion | update | Policy acs:ram:*:{#accountId}:policy/{#PolicyName} | 无 | 无 |
ram:ListPoliciesForRole | ListPoliciesForRole | get | Role acs:ram:*:{#accountId}:role/{#RoleName} | 无 | 无 |
ram:UpdateLoginProfile | UpdateLoginProfile | update | User acs:ram:*:{#accountId}:user/{#UserName} | 无 | 无 |
ram:GetPolicy | GetPolicy | get | Policy acs:ram:*:system:policy/{#PolicyName}Policy acs:ram:*:{#accountId}:policy/{#PolicyName} | 无 | 无 |
ram:CreateAccessKey | CreateAccessKey | create | User acs:ram:*:{#accountId}:user/{#UserName} | 无 | 无 |
ram:GetUser | GetUser | get | User acs:ram:*:{#accountId}:user/{#UserName} | 无 | 无 |
ram:DeleteVirtualMFADevice | DeleteVirtualMFADevice | delete | MFADevice acs:ram:*:{#accountId}:mfa/{#SerialNumber} | 无 | 无 |
资源(Resource)
下表是访问控制(RAM)定义的资源,这些资源可以在RAM权限策略语句的Resource
元素中使用,用来授予对该资源执行具体操作的权限。 其中,资源ARN是资源在阿里云上的唯一标识。具体说明如下:{#}
为变量标识,需要您替换为实际值。例如:{#ramcode}
需要您替换为实际的云服务RAM代码。-
*
表示全部。例如:{#resourceType}
为*
时:表示全部资源。{#regionId}
为*
时:表示全部地域。{#accountId}
为*
时:表示全部阿里云账号。
资源类型 | 资源ARN |
---|---|
User | acs:ram:*:{#accountId}:user/{#UserName} |
Unrestricted | acs:ram:*:{#accountId}:* |
User | acs:ram::{#accountId}:user/{#UserName} |
User | acs:ram:*:{#accountId}:user/* |
Role | acs:ram:*:{#accountId}:role/{#RoleName} |
Policy | acs:ram:*:{#accountId}:policy/{#PolicyName} |
Group | acs:ram:*:{#accountId}:group/* |
Policy | acs:ram:*:system:policy/{#PolicyName} |
Group | acs:ram:*:{#accountId}:group/{#GroupName} |
MFADevice | acs:ram:*:{#accountId}:mfa/* |
User | {#Arn} |
Policy | acs:ram:*:{#accountId}:policy/* |
Role | acs:ram:*:{#accountId}:role/* |
MFADevice | acs:ram:*:{#accountId}:mfa/{#SerialNumber} |
条件(Condition)
下表是访问控制(RAM)定义的产品级条件关键字,这些条件关键字可以在RAM权限策略语句的
Condition
元素中使用,用来描述授予权限的条件。以下仅列举产品级的条件关键字,阿里云定义的通用条件关键字也同样适用访问控制(RAM)。其中,数据类型决定了您可以使用哪些条件运算符将请求中的值与权限策略语句中的值进行比较。您必须使用与数据类型匹配的条件运算符,否则无法匹配策略语句,授权行为无效。数据类型与条件运算符的对应关系,请参见条件操作类型。
条件关键字 | 描述 | 类型 |
---|---|---|
acs:Service | 角色可以被传递给云服务的标识,此限制条件仅适用于 PassRole 操作。取值示例:actiontrail.aliyuncs.com | String |
ram:TrustedPrincipalTypes | 角色可信实体的类型,多值。 | String |
ram:ServiceNames | 服务角色可信的云服务标识,多值,取值示例:["ecs.aliyun.com","rds.aliyuncs.com"] | String |