Sharing a Folder

Scenarios

You can share folders with other users temporarily or permanently.

• Temporary sharing:

  Share a folder to other users through the temporary URL of the file. All shared URLs are temporary with a validity period.

  Folders can be temporarily shared by access code or URL:

  Sharing by access code

  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.

  A temporary URL consists of the access domain name and the temporary authentication information of a folder. Example:

  https://e-share.obs-website.ap-southeast-1.myhuaweicloud.com:443/image.png?token=xxx

  For details about the temporary authentication method and parameters, see Authentication of Signature in a URL in the Object Storage Service API Reference.

  Sharing by URL

  You can specify a validity period and then share the generated link with others. Anyone can use a signature to access all objects in the shared folder.

  A temporary URL for accessing an object in a folder consists of a bucket domain name (prefix), an object path, and signature information (suffix).

• Permanent sharing:

  If you set the permission for an object to allow anonymous users to read it, anonymous users can access the object through the URL that you shared. For details about how to configure permissions, see Granting Public Read Permissions on Objects to Anonymous Users.

  For details about how to obtain the object access URL, see How Do I Obtain the Access Path to an Object?

  If access to an object using the URL fails, fix the problem by referring to Why Can't I Access an Object Through Its URL?

Constraints

• Folder sharing is available only in some regions. For details about the applicable regions, see Function Overview.
• Objects in the Archive or Deep Archive storage class can be shared only after they have been restored.
• Only buckets of version 3.0 or later support temporary folder sharing. For details about how to query the bucket version, see Checking OBS Version (OBS 2.0 or OBS 3.0).
• The following table describes the URL validity period of the folders that are temporarily shared using different tools.

  Tool	URL Validity Period
  OBS Console	The URL is valid for 1 minute to 18 hours. After an object is shared, the system will generate a URL that contains the temporary authentication information, valid for five minutes since its generation by default. Each time you change the validity period of a URL, OBS obtains the authentication information again to generate a new URL for sharing. The new URL becomes valid at the moment the validity period is changed.
  API	Configure parameter Expires to specify when a temporary authorization expires. The temporary authorization expires in 24 hours.
  OBS Browser+	When you log in to OBS Browser+ using an account and password, a shared URL can be valid for 24 hours at most. The default validity period is 10 hours. If a longer validity period is required, use the permanent AK/SK for login.
  obsutil	Use the additional parameter vp to specify how long an authorization code is valid. The default validity period is one day. The allowed units include m (months), w (weeks), d (days), h (hours), min (minutes), and s (seconds). If no time unit is specified, the value is calculated in seconds.

How to Use

You can use OBS Console, APIs, OBS Browser+, or obsutil to share folders.