Scenarios

With the folder sharing function, you can share your folder in OBS to other users.

Background Information

Folder sharing is temporary and has a validity period. You need to prepare a six-digit extraction code before sharing a folder. After the sharing link of the folder is created, OBS automatically aggregates the download links of all objects in the folder to a static website that is hosted by a public OBS bucket. Then users who have the temporary URL and extraction code can access the static website and download files.

Limitations and Constraints

• A folder shared from OBS Console is valid from one minute to 18 hours. If you need a longer validity period for a shared folder, use the client tool OBS Browser+ that allows a validity period of up to one year. If you want a shared folder permanently valid, use a bucket policy to grant anonymous users public read permissions on the folder by referring to Granting Public Read Permissions on Objects to Anonymous Users.
• The folder sharing function is restricted to a few regions only.
• Only buckets of version 3.0 or later support the folder sharing function. You can view the bucket version in the Basic Information area on the Overview page of a bucket.
• Archived objects in the folder need to be restored in the bucket before they can be downloaded.

Procedure

1. In the navigation pane on the left of OBS Console, choose Object Storage.
2. In the bucket list, click a bucket name, and then the Overview page of the bucket is displayed.
3. In the navigation pane on the left, click Objects.
4. Find the folder that you want to share and click Share under the Operation column. The Share Folder dialog box is displayed.
   Figure 1 Sharing a folder
   

5. Configure parameters.

   Table 1 Parameters for sharing a folder

   Parameter	Description
   URL Validity Period	The validity period is measured by minutes or hours, and ranges from one minute to 18 hours. The default value is five minutes. Within the URL validity period, any user who has the URL can access the folder.
   Extraction Code	A six-digit code. An extraction code is required to access a shared folder.

6. Click Create Share to generate sharing URL of the folder.
7. You can send the URL and extraction code to other users. Then they can access the folder using the URL and the extraction code.

Verification

Verify that other users can access the shared folder through the URL.

1. Open a web browser, enter the shared URL, and open it.
2. In the dialog box that is displayed, enter the extraction code and confirm the access to the shared folder.

Verify that other users can access the shared folder through OBS Browser+.

1. Start OBS Browser+.
2. On the login page, click Authorization Code Login.
3. Enter the authorization code and access code.
4. Click Log In to access the shared folder.