文档中心

管理对象公共读权限

最近更新时间：2024.03.20 17:12:25

首次发布时间：2024.03.20 17:12:25

本文介绍如何如何开启和单个对象公共读，批量开启对象公共读。

开启单个对象公共读

当前仅支持使用 tosutil 工具在上传对象时批量开启对象公共读权限。
前提条件
在使用工具批量开启对象公共读操作前，您需要先完成以下操作：

已下载并安装 tosutil 工具，具体步骤，请参见下载与安装。
已获取 Region、Endpoint、Access Key ID 和 Secret Access Key，具体步骤，请参见地域和访问域名（Endpoint）和查看 AK 和 SK 信息。
已初始化配置 tosutil 工具，并检查版本和连通性，具体操作，请参见步骤一：初始化配置和步骤二：检查版本和连通性。

操作步骤
在 tosutil 工具执行以下命令，批量上传文件，并设置文件的访问权限为公共读。

./tosutil cp file1_url,folder1_url|filelist_url tos://bucket[/prefix] -msm=2 -r -acl public-read

参数	参数类型	说明
file_url	String	本地文件路径。如果要上传多个文件，可以在可在命令中添加多个 `file_url`，以英文逗号（,）分隔。
folder_url	String	本地文件夹路径，需要 `-r` 参数配合使用。
filelist_url	String	本地列表文件，记录了文件或文件夹的本地路径。说明如下：该文件为文本文件，例如.txt，.csv格式的文件，文件中每一行代表一个文件或文件夹。
bucket	String	存储桶名称。
prefix	String	批量操作时的对象名前缀。
-msm	Enum	开启多文件或文件夹上传模式，说明如下： `-msm=1`：代表上传路径是一组文件或文件夹列表，以英文逗号（,）分隔。 `-msm=2`：代表上传路径是一个包含文件或文件夹列表的清单文件。注意如果文件或文件夹名本身包含英文逗号，请不要使用 `-msm=1` 的模式。如果没有设置 `-r` 参数，则列表中的文件夹不会被上传。
-r	Bool	执行批量上传、下载或复制操作。
-acl	String	上传或复制对象时可指定的预定义访问策略。支持的值如下： `private`：私有 `public-read`：公共读 `public-read-write`：公共读写 `authenticated-read`：认证用户读 `bucket-owner-read`：桶所有者读 `bucket-owner-full-control`：桶所有者完全权限 `bucket-owner-entrusted`：受桶策略控制，桶所有者完全权限

说明

使用 tosutil 工具上传对象的更多参数介绍，请参见上传对象（cp）。

开启单个对象公共读

关闭单个对象公共读

批量开启对象公共读