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

本文为您介绍对象存储(Oss)为RAM权限策略定义的操作(Action)、资源(Resource)和条件(Condition)。对象存储(Oss)的RAM代码(RamCode)为 oss,支持的授权粒度为资源级

权限策略通用结构

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

操作(Action)

下表是对象存储(Oss)定义的操作,这些操作可以在RAM权限策略语句的Action元素中使用,用来授予执行该操作的权限。下面对表中的具体项提供说明:展开详情

操作API访问级别资源类型条件关键字关联操作
oss:AbortBucketWorm
删除指定存储空间(Bucket)未锁定的合规保留策略
Delete
Bucket
acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}
acs:UserAgent
acs:AccessId
oss:BucketTag
oss:TLSVersion
oss:AbortMultipartUpload
用于取消MultipartUpload事件并删除对应的Part数据
Delete
Object
acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}/{#ObjectName}
acs:UserAgent
acs:AccessId
oss:BucketTag
oss:DataAccessPointArn
oss:AccessPointNetworkOrigin
oss:DataAccessPointAccount
oss:TLSVersion
oss:GetObject
oss:CleanRestoredObject
清理从冷归档或深度冷归档对象中解冻而来的副本
Delete
Object
acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}/{#ObjectName}
oss:Prefix
acs:AccessId
oss:TLSVersion
oss:CleanRestoredObjectVersion
oss:CloseMetaQuery
关闭存储空间(Bucket)的元数据管理功能。OSS会自动删除Bucket的元数据索引库,将无法进行元数据索引
Update
Bucket
acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}
acs:UserAgent
acs:AccessId
oss:BucketTag
oss:TLSVersion
oss:CompleteBucketWorm
锁定合规保留策略
Update
Bucket
acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}
acs:UserAgent
acs:AccessId
oss:BucketTag
oss:TLSVersion
oss:CreateAccessPoint
创建接入点
Create
Bucket
acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}
acs:UserAgent
acs:AccessId
oss:CreateAccessPointForObjectProcess
创建对象FC接入点
Create
Bucket
acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}
acs:UserAgent
acs:AccessId
oss:TLSVersion
oss:CreateBucketDataRedundancyTransition
为Bucket创建存储冗余转换任务
Create
Bucket
acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}
acs:UserAgent
acs:AccessId
oss:TLSVersion
oss:CreateCnameToken
创建域名所有权验证所需的CnameToken
Create
Bucket
acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}
acs:UserAgent
acs:AccessId
oss:BucketTag
oss:TLSVersion
oss:CreateReservedCapacity
Create
全部资源
*
acs:UserAgent
acs:AccessId
oss:TLSVersion
资源(Resource)

下表是对象存储(Oss)定义的资源,这些资源可以在RAM权限策略语句的Resource元素中使用,用来授予对该资源执行具体操作的权限。

其中,资源ARN是资源在阿里云上的唯一标识。具体说明如下:

  • {#}为变量标识,需要您替换为实际值。例如: {#ramcode} 需要您替换为实际的云服务RAM代码。
  • *表示全部。例如:
    • {#resourceType}/* :表示全部资源。
    • {#regionId}*时:表示全部地域。
    • {#accountId}*时:表示全部阿里云账号。
资源类型资源ARN
Bucket
  • acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}
  • acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}/{#ObjectName}
  • acs:oss:*:{#accountId}:{#BucketName}
Object
  • acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}/{#ObjectName}
  • acs:oss:{#regionId}:{#accountId}:{#BucketName}/{#ObjectName}
ResourcePool
  • acs:oss:oss-{#regionId}:{#accountId}:resourcepool/*
  • acs:oss:oss-{#regionId}:{#accountId}:resourcepool/{#resourcePool}
Unrestricted
  • acs:oss:oss-{#regionId}:{#accountId}:*
条件(Condition)

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

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

条件关键字描述类型
acs:AccessId
请求中携带的AccessKey ID,取值示例:akidvnUsCXNWxxxxx
string
acs:UserAgent
指定HTTP User-Agent头,取值示例:java-sdk
string
oss:AccessPointNetworkOrigin
为互联网或专有网络VPC下的接入点委派权限。委派后,仅指定网络的接入点生效。
枚举值:
internetvpc
string
oss:BucketTag
存储空间标签(BucketTag)。 单个BucketTag可以作为一个Condition。当设置多个BucketTag时,需在每个BucketTag前加上oss:BucketTag/,组成多个Condition。取值示例:"oss:BucketTag/team": "dev"
string
oss:DataAccessPointAccount
为当前账号下的所有接入点委派权限。委派后,账号下所有的接入点生效。取值示例:12345678900000
boolean
oss:DataAccessPointArn
为指定的接入点委派权限。委派后,仅指定的接入点生效。取值示例:acs:oss:cn-hangzhou:123456789xxxxx:accesspoint/ap-name
string
oss:Delimiter
用于ListObjects请求时,对Object名字进行分组的字符,取值示例:/
string
oss:ExistingObjectTag
请求的Object已存在标签。 单个ObjectTag可以作为一个Condition。当设置多个ObjectTag时,需在每个ObjectTag前加上oss:ExistingObjectTag/,组成多个Condition。 主要针对GetObject、HeadObject等读取文件接口以及PutObjectTagging、GetObjectTagging等ObjectTagging接口。取值示例:"oss:ExistingObjectTag/team": "dev"
string
oss:Prefix
用于ListObjects请求时,列举指定前缀的Object,取值示例:prefix01
string
oss:RequestObjectTag
请求中携带的对象标签。 单个ObjectTag可以作为一个Condition。当设置多个ObjectTag时,需在每个ObjectTag前加上oss:RequestObjectTag/,组成多个Condition。 主要针对PutObject、PostObject等写入文件接口以及PutObjectTagging、GetObjectTagging等ObjectTagging接口。取值示例:"oss:RequestObjectTag/team": "dev"
string
相关操作

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