External Bucket Overview

The bucket owner can authorize other accounts the read and write access to the bucket. If you are authorized with such permissions, you can add the bucket on OBS Browser as an external bucket. After the external bucket is added successfully, you can operate the bucket on OBS Browser. For details about what actions you can perform on the external bucket, check the permission settings.

Authorizing Permissions Required for Adding a Bucket as an External Bucket on OBS Browser

The read and write access to a bucket can be granted through the bucket ACL or bucket policy.

Permissions controlled by a bucket ACL are as follows:

Table 1 Permissions controlled by a bucket ACL

Bucket ACL

Option

Mapped Action in a Custom Bucket Policy

Access to Bucket

Read

  • ListBucket
  • ListBucketVersions
  • ListBucketMultipartUploads

Write

  • PutObject
  • DeleteObject
  • DeleteObjectVersion

Access to ACL

Read

GetBucketAcl

Write

PutBucketAcl

Permissions controlled by a standard bucket policy are as follows:

Table 2 Permissions controlled by a standard bucket policy

Parameter

Public Read

Public Read and Write

Effect

Allow

Allow

Principal

* (Any user)

* (Any user)

Resources

* (All objects in a bucket)

* (All objects in a bucket)

Actions

  • GetObject
  • GetObjectVersion
  • ListBucket
  • GetObject
  • GetObjectVersion
  • PutObject
  • DeleteObject
  • DeleteObjectVersion
  • ListBucket

Conditions

N/A

N/A

If a custom bucket policy is used to authorize such permissions, the ListBucket, GetObject, and GetObjectVersion actions must be allowed. More actions can be allowed according to your actual needs.

Operations That Can Be Performed on the External Bucket

Operations that can be performed by the authorized user on the external bucket: