设置桶或对象的预定义访问策略（set-acl）--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

设置桶或对象的预定义访问策略（set-acl）

最近更新时间：2024.02.29 20:16:18首次发布时间：2024.02.29 20:16:18

您可以使用 set-acl 命令设置桶或桶内对象的预定义访问策略。

设置桶 ACL

命令格式

Linux/macOS

Windows

./tosutil set-acl tos://bucket acl [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]

参数说明

通用可选参数的说明，请参见通用可选参数。

参数名	参数类型	描述
bucket	String	桶名。
acl	Enum	指定桶的预定义访问策略。取值说明如下： `private`：私有的，默认值。 `public-read`：公共读。 `public-read-write`：公共读写。 `authenticated-read`：认证用户读。 `bucket-owner-read`：桶所有者读。 `bucket-owner-full-control`：桶所有者完全权限。

参数名

参数类型

描述

bucket

String

桶名。

acl

Enum

指定桶的预定义访问策略。取值说明如下：

private：私有的，默认值。
public-read：公共读。
public-read-write：公共读写。
authenticated-read：认证用户读。
bucket-owner-read：桶所有者读。
bucket-owner-full-control：桶所有者完全权限。

使用示例

以下命令用于设置 bucketname 桶的预定义访问策略为 public-read。

命令

./tosutil set-acl tos://bucketname public-read

Start at 2024-01-22 10:42:49.230198 +0000 UTC
 
Set acl for bucket [bucketname] successfully!

设置对象 ACL

命令格式

Linux/macOS

Windows

设置单个对象的预定义访问策略

./tosutil set-acl tos://bucket/key acl [-versionId=xxx] [-fr] [-o=xxx] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]

批量设置对象的预定义访问策略

./tosutil set-acl tos://bucket/[prefix] acl -r [-j=1] [-v] [-include=*.xxx] [-exclude=*.xxx] [-o=xxx] [-e=xxx] [-re=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-conf=xxx]

参数说明

通用可选参数的说明，请参见通用可选参数。

参数名	参数类型	描述
bucket	String	存储桶名。
key	String	对象名。
prefix	String	批量操作时的对象名前缀。
acl	Enum	指定对象的预定义访问策略。支持的值如下： `private` `public-read` `public-read-write` `authenticated-read` `bucket-owner-read` `bucket-owner-full-control` `bucket-owner-entrusted`
-r	Bool	执行批量设置对象预定义访问策略操作。
-j	Integer	批量设置对象预定义访问策略的最大并发数，默认为配置文件中的 `defaultJobs`。
-v	Bool	按指定的对象名前缀批量设置多版本对象的预定义访问策略。
-versionId	String	待设置对象预定义访问策略的单个对象的版本号。
-include	String	批量设置对象预定义访问策略时对包含对象的名称匹配模式，支持以下字符： `?` ：匹配单个任意字符。 `` ：匹配多个任意字符。 `#` ：作为分隔符。例如 `-include=.png#*.txt` 表示匹配所有以 `.png` 和 `.txt` 结尾的文件。说明为了避免因操作系统转义特殊符号的导致的解析失败等问题，建议您使用引号设置名称匹配模式。名称匹配模式只在上传文件夹或文件列表时生效。
-exclude	String	批量设置对象预定义访问策略时对不包含对象的名称匹配模式，支持以下字符： `?` ：匹配单个任意字符。 `` ：匹配多个任意字符。 `#` ：作为分隔符。例如 `-exclude=.png#*.txt` 表示匹配所有以 `.png` 和 `.txt` 结尾的文件。说明为了避免因操作系统转义特殊符号导致的解析失败等问题，建议您使用引号设置名称匹配模式。名称匹配模式只在上传文件夹或文件列表时生效。
-fr	Bool	设置单个对象预定义访问策略时生成结果清单文件。
-o	String	生成结果清单文件的文件夹，默认为配置文件中的 `defaultOutputDir`。

使用示例

设置单个对象的预定义访问策略

以下命令用于设置 bucketname 桶内 object.png 对象的预定义访问策略为 public-read。

命令

./tosutil set-acl tos://bucketname/object.png public-read

Start at 2024-01-22 14:22:15.66498 +0000 UTC

Set acl for object [object.png] in the bucket [bucketname] successfully, cost [179], request id [f06701ae7a17971865ae7a17-b293fe0-1rRvBn-POA-cb-tos-front-azc-1]

批量对象的预定义访问策略

以下命令用于设置 bucketname 桶内的前缀为 object 的对象的预定义访问策略为 public-read。

命令

./tosutil set-acl tos://bucketname/object public-read -r

Start at 2024-01-22 14:23:36.625134 +0000 UTC

[--------------------------------------------------------------------------------------------] 100.00% tps:0.00 1/1 90ms
Succeed count is:   1         Failed count is:    0
Metrics [max cost:46 ms, min cost:46 ms, average cost:46.00 ms, average tps:10.99]

Task id is: d4b331fc-b931-11ee-8422-b645e1163e55