Setting Bucket Properties

Updated on 2025-02-10 GMT+08:00

View PDF

Function

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

Command Line Structure

In Windows

obsutil chattri obs://bucket [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-config=xxx]

In Linux or macOS

./obsutil chattri obs://bucket [-sc=xxx] [-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

Start at 2024-09-29 07:58:46.0506904 +0000 UTC

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

Parameter Description

Parameter	Optional or Mandatory	Description
bucket	Mandatory	Bucket name
sc	Optional (additional parameter)	Default storage class of the bucket. Possible values are: standard: Standard storage class. It features low access latency and high throughput, and is applicable to storing frequently accessed data (multiple accesses per month) or data that is smaller than 1 MB. warm: storage class. It is ideal for storing infrequently accessed (less than 12 times a year) data, but when needed, the access has to be fast. cold: storage class. It provides secure, durable, and inexpensive storage for rarely-accessed (once a year) data.
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 the current command. To learn the parameters that can be configured in this file, see .

NOTE:

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

Parent topic: Bucket Commands

Previous topic: Querying Bucket Properties

Next topic: Deleting a Bucket

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot