Help Center/ Object Storage Service/ Tool Guide (obsutil) (Ankara Region)/ Bucket Commands/ Setting Bucket Properties
Updated on 2024-04-17 GMT+08:00
View PDF
Share

Setting Bucket Properties

Function

You can use this command to set the properties of a bucket, such as access policies.

Command Line Structure

  • In Windows 
    obsutil chattri obs://bucket [-acl=xxx] [-aclXml=xxx] [-config=xxx]
  • In Linux or macOS 
    ./obsutil chattri obs://bucket [-acl=xxx] [-aclXml=xxx] [-config=xxx]

Examples

  • Take the Windows OS as an example. Run the obsutil chattri obs://bucket-test -acl=private command to change the access control policy of the bucket to private read and write. 
    obsutil chattri obs://bucket-test -acl=private

Set the acl of bucket [bucket-test] to [private] successfully, request id [04050000016836C5DA6FB21F14A2A0C0]

Parameter Description

Parameter

Optional or Mandatory

Description

bucket

Mandatory

Bucket name

acl

Optional (additional parameter)

Access control policies that can be specified for buckets. Possible values are:

  • private
  • public-read
  • public-read-write
NOTE:

The preceding three values indicate private read and write, public read, and public read and write.

aclXml

Optional (additional parameter)

Access control policy of the bucket, in XML format.

<AccessControlPolicy>
    <Owner>
        <ID>ownerid</ID>
    </Owner>
    <AccessControlList>
        <Grant>
            <Grantee>
                <ID>userid</ID>
            </Grantee>
            <Permission>[WRITE|WRITE_ACP|READ|READ_ACP|FULL_CONTROL]</Permission>
        </Grant>
        <Grant>
            <Grantee>
                <Canned>Everyone</Canned>
            </Grantee>
            <Permission>[WRITE|WRITE_ACP|READ|READ_ACP|FULL_CONTROL]</Permission>
        </Grant>
    </AccessControlList>
</AccessControlPolicy>
NOTE:
  • Owner: Optional. Specify the bucket owner's ID.
  • In AccessControlList, the Grant field contains the authorized users. Grantee specifies the IDs of authorized users. Canned specifies the authorized user group (currently, only Everyone is supported).
  • The following permissions can be granted: WRITE (write), WRITE_ACP (write ACL), READ (read), READ_ACP (read ACL), and FULL_CONTROL (full control).
NOTICE:

Because angle brackets (<) and (>) are unavoidably included in the parameter value, you must use quotation marks to enclose them for escaping when running the command. Use single quotation marks for Linux or macOS and quotation marks for Windows.

config

Optional (additional parameter)

User-defined configuration file for executing a command. For details about parameters that can be configured, see Parameter Description.

Only one from acl, or aclXml can be set for each command.

Parent topic: Bucket Commands