Object Storage Service:Create a bucket

Create a bucket with default settings

ossutil api put-bucket --bucket examplebucket

On success, the command returns HTTP 200. Verify the bucket exists:

ossutil ls oss://examplebucket

An empty listing with no error confirms the bucket is ready.

Create an Infrequent Access bucket with zone-redundant storage

ossutil api put-bucket --bucket examplebucket \
  --create-bucket-configuration '{"StorageClass":"IA","DataRedundancyType":"ZRS"}'

The bucket is created with IA storage class and zone-redundant storage (ZRS).

Load configuration from a JSON file

1. Create a file named bucket-config.json:

      {
        "StorageClass": "IA",
        "DataRedundancyType": "ZRS"
      }

2. Run the command:

      ossutil api put-bucket --bucket examplebucket \
        --create-bucket-configuration file://bucket-config.json

Load configuration from an XML file

1. Create a file named bucket-config.xml:

      <?xml version="1.0" encoding="UTF-8"?>
      <CreateBucketConfiguration>
        <StorageClass>Archive</StorageClass>
        <DataRedundancyType>LRS</DataRedundancyType>
      </CreateBucketConfiguration>

2. Run the command:

      ossutil api put-bucket --bucket examplebucket \
        --create-bucket-configuration file://bucket-config.xml

Set the ACL and assign a resource group

ossutil api put-bucket --bucket examplebucket \
  --acl private \
  --resource-group-id rg-123 \
  --create-bucket-configuration '{"StorageClass":"Standard","DataRedundancyType":"LRS"}'

--bucket string (required)

The bucket name. Names must meet all of the following rules:

• 3 to 63 characters long

• Contains only lowercase letters, digits, and hyphens (-)

• Starts and ends with a lowercase letter or digit

• No consecutive hyphens

Bucket names are globally unique across all OSS users. If the name is taken by another account, the command returns BucketAlreadyExists.

--acl string (optional)

The access control list for the bucket. Defaults to private.

If Block Public Access is enabled, setting public-read or public-read-write returns an error.

--create-bucket-configuration string (optional)

The storage class and redundancy type. Accepts an inline JSON string, an inline XML string, or a file path prefixed with file://.

Inline JSON:

{
  "StorageClass": "Standard",
  "DataRedundancyType": "LRS"
}

Inline XML:

<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>
  <StorageClass>Standard</StorageClass>
  <DataRedundancyType>LRS</DataRedundancyType>
</CreateBucketConfiguration>

From a file:

--create-bucket-configuration file://bucket-config.json
--create-bucket-configuration file://bucket-config.xml

--resource-group-id string (optional)

The resource group to assign the bucket to. If omitted, the bucket is added to the default resource group.