PutObjectAcl_对象存储_API文档-阿里云OpenAPI开发者门户

接口说明

注意事项

此操作只有 Bucket Owner 有权限执行，且需对 Object 有读写权限。

版本控制

调用 PutObjectACL 接口时，默认只能设置 Object 当前版本的 ACL。您可以通过指定 versionId 参数来设置指定 Object 版本的 ACL。如果 Object 的对应版本为删除标记（Delete Marker），则 OSS 将返回 404 Not Found。

ACL 说明

PutObjectACL 接口通过 Put 请求中的x-oss-object-acl头来设置 Object ACL。目前 Object 包括如下四种访问权限。

private：Object 是私有资源。只有该 Object 的 Owner 拥有该 Object 的读写权限，其他用户没有权限操作该 Object。
public-read：Object 是公共读资源。Object Owner 拥有该 Object 的读写权限。非 Object Owner 只有该 Object 的读权限。
public-read-write：Object 是公共读写资源。所有用户拥有对该 Object 的读写权限。
default：Object 遵循其所在 Bucket 的读写权限，即 Bucket 是什么权限，Object 就是什么权限。

说明注意

Object ACL 优先级高于 Bucket ACL。例如 Bucket ACL 是 private 的，而 Object ACL 是 public-read-write 的，则所有用户都拥有该 Object 的访问权限，即使该 Bucket 是私有 Bucket。如果某个 Object 未设置过 ACL，则访问权限遵循 Bucket ACL。
Object 的读操作包括 GetObject、HeadObject、CopyObject 和 UploadPartCopy 中的对原 Object 的读；Object 的写操作包括 PutObject、PostObject、AppendObject、DeleteObject、DeleteMultipleObjects、CompleteMultipartUpload 以及 CopyObject 对新 Object 的写。
您还可以在进行 Object 的写操作时，在请求头中带上 x-oss-object-acl 来设置 Object ACL，效果与 PutObjectACL 等同。例如 PutObject 时在请求头中带上 x-oss-object-acl 可以在上传一个 Object 的同时设置此 Object 的 ACL。

当前云产品API请求速率暂未透出。

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

oss:PutObjectAcl	Update	Object acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}/{#ObjectName}	acs:UserAgent acs:AccessId oss:BucketTag oss:DataAccessPointArn oss:AccessPointNetworkOrigin oss:DataAccessPointAccount oss:TLSVersion oss:x-oss-object-acl	oss:GetObject oss:PutObjectVersionAcl

PUT /{key}?acl HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
x-oss-object-acl: string

字段名称	字段详情
keystring	Object 的完整路径。示例值:exampledir/exampleobject/txt

字段名称	字段详情
bucketstring	Bucket 名称。示例值:examplebucket
x-oss-object-aclObjectACL	指定 OSS 创建 Object 时的访问权限。展开详情示例值:public-read枚举值:privatepublic-readpublic-read-writedefault
versionIdstring	Object 对应的版本示例值:CAEQMhiBgIC3rpSD0BYiIDBjYTk5MmIzN2JlNjQxZTFiNGIzM2E3OTliODA0****

暂无变更历史