Docs

Torch Object Storage

Authorizing IAM users of the current account

Allowing an IAM user to download an object in a directory

This topic explains how to grant an IAM user of the current account access to a specific directory within a bucket.

Scenario

Principal: IAM user iamuser of account 210015****.

Resource: The data directory in the bucketname bucket.

Notes

If a configured permission does not take effect, we recommend that you retry later, as there is a delay.

Steps

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.

In the left navigation pane, select Permissions > Bucket policies.

Edit the policy using your preferred view.

Visual view

JSON view

Click Create policy.

On the Create Bucket Authorization Policy page, select Folder Read-Only and click Next.

Configure the following parameters.

Category	Parameter	Description
Basic configuration	Policy configuration method	Use the default option, i.e., Visual view.
Basic configuration		Policy name	Enter a name for the policy. The policy name must be unique within a bucket.
Effect	Effect	Select the effect of the policy. In this example, use the default value. Allow (Default): Allows the matched requests. Deny: Denies the matched requests.
Authorized user	Authorized user	Use the default option, i.e., Specified account.
Authorized user		Other accounts	Select Current main account. Then, click Add Field and select the IAM user you want to authorize from the drop-down menu under Sub account name. In this example, we use iamuser.
Resource	Resource scope	Use the default option, i.e., Specified object(s). Then, enter the Resource Path to specify the object you want to share. In this example, we use data/*.
Action	General actions	The current template includes several pre-configured actions. You can leave them as they are or modify the allowed actions according to your needs. For more information on actions allowed by bucket policies, see Supported actions.
			Bucket Action
			Object Action
		Operational strategy	Use the default option, i.e., Include the above actions. This option allows users to perform the specified actions.
Condition (Optional)	-	Click the Add Field icon and set the condition and value. For more information, see Conditions.

Save your settings by clicking Next.

After verifying the details, click Create.

Then, you will see the bucket policy that you just created in the policy list.

Next steps

Once the bucket policy has been created, the IAM user can download objects from the specified directory using one of the following methods:

Use an API, SDK, or TOS Browser to download objects from the specified directory.

To download objects from a directory using the console, grant the user the ListBuckets permission through an IAM policy. For more information about actions allowed by IAM policies, see Supported actions.

tip

Despite having the aforementioned permissions, the IAM user may still encounter errors such as Request failed with status code 403 or Insufficient permissions when attempting to download the object via the console. This occurs due to missing permissions for other APIs. These errors do not affect existing permissions and can be disregarded.

Last updated: 2026.08.14 16:23:30