Docs

Torch Object Storage

Managing public read access

Managing object public read access

This topic outlines how to grant or revoke public read access to a single object and how to grant public access to multiple objects simultaneously.

Granting or revoking public read access to an object

In the left navigation pane, click Buckets.

In the top menu bar, select the project of the bucket you want to manage.

On the Buckets page, click the name of the bucket.

On the Objects page, select ··· > Modify Access Permission in the Actions column of the object you want to manage.

In the Modify Access Permission dialog box

To enable public read access, select Public read and click Save.

To disable public read access, select Private and click Save.

Granting public read access to multiple objects simultaneously

Currently, you can only grant public read access to multiple objects when uploading them using tosutil.

Prerequisites

Before you begin, make sure:

You have installed tosutil. For instructions, see Downloading and installing tosutil.

You have obtained the region, endpoint, access key ID, and secret access key. For instructions, see Regions and endpoints and Viewing the Access Key ID and Secret Access Key.

You have initialized and configured tosutil, and verified its version and connectivity. For instructions, see Step 1: Initialize tosutil and Step 2: Check version and connectivity.

Steps

Use the following tosutil command to upload objects in batches and set their access permissions to "public read".

Parameter	Type	Description
file_url	String	The path for a local file. To upload multiple objects, add multiple file_url values to the command and separate them with commas (,).
folder_url	String	The path for a local folder. This parameter must be used in conjunction with the -r parameter.
filelist_url	String	The path of the file that contains the list of files or folders to be uploaded. The details are as follows: The list file is formatted in a standard text type, such as TXT or CSV. Each line of the file corresponds to a file or folder that will be uploaded.
bucket	String	Bucket name.
prefix	String	The prefix used for filtering objects in batch operations.
-msm	Enum	Sets the mode for uploading multiple objects or folders at once. The options are as follows: -msm=1: The upload path is a list of objects or folders separated by commas (,). -msm=2: The upload path is a manifest file containing a list of objects or folders. warning Do not use the -msm=1 mode if an object or folder name contains a comma. Unless the -r parameter is set, folders in the list will not be uploaded.
-r	Bool	Perform batch upload, download, or copy operations.
-acl	String	Sets the predefined access control lists (ACLs) for objects to be uploaded or copied. Possible values: private: Private permission. public-read: Publicly readable. public-read-write: Publicly readable and writable. authenticated-read: Authenticated users have read access. bucket-owner-read: The bucket owner has read access. bucket-owner-full-control: The bucket owner has full control. bucket-owner-entrusted: Controlled by the bucket policy, with the bucket owner having full control.

tip

For additional parameters related to this tosutil command, see Upload objects (cp).

Last updated: 2026.08.14 16:23:30