A Bucket in TOS is a globally unique namespace that serves as a container for storing Object data. The name of a newly created bucket must be unique within TOS. This document describes how to create a bucket.

Notes

The naming conventions for storage buckets are as follows:

Can only contain lowercase letters (a-z), numbers, and hyphens (-).

Must start and end with a number or letter.

Length must be between 3 and 63 characters.

When accessing TOS via other Volcano Engine products within the same region, it is recommended to use the internal network Endpoint. For more information about regions and Endpoints, see Regions and Access Domain Names.

Before creating a storage bucket, you must ensure that your account has the tos:CreateBucket permission. You can grant the appropriate permissions through IAM policies. For detailed steps, please refer to IAM Policies.

Sample Code

Specify ACL

The following code is used to specify the ACL when creating a storage bucket.

using System;​
using TOS;​
using TOS.Error;​
using TOS.Model;​
​
namespace ConsoleApp​
{​
    internal class Program​
    {​
        private static void Main(string[] args)​
        {​
            var ak = Environment.GetEnvironmentVariable("TOS_ACCESS_KEY");​
            var sk = Environment.GetEnvironmentVariable("TOS_SECRET_KEY");​
            var endpoint = "https://tos-cn-beijing.volces.com";​
            var region = "cn-beijing";​
            var bucketName = "*** Provide your bucket name ***";​
​
            var client = TosClientBuilder.Builder().SetAk(ak).SetSk(sk).SetEndpoint(endpoint).SetRegion(region).Build();​
​
            try​
            {​
                var createBucketInput = new CreateBucketInput()​
                {​
                    Bucket = bucketName,​
                    ACL = ACLType.ACLPrivate​
                };​
                var createBucketOutput = client.CreateBucket(createBucketInput);​
                Console.WriteLine("Create bucket succeeded, request id {0} ", createBucketOutput.RequestID);​
                Console.WriteLine("Create bucket succeeded, status code {0} ", createBucketOutput.StatusCode);​
            }​
            catch (TosServerException ex)​
            {​
                Console.WriteLine("Create bucket failed, request id {0}", ex.RequestID);​
                Console.WriteLine("Create bucket failed, status code {0}", ex.StatusCode);​
                Console.WriteLine("Create bucket failed, response error code {0}", ex.Code);​
                Console.WriteLine("Create bucket failed, response error message {0}", ex.Message);​
            }​
            catch (TosClientException ex)​
            {​
                Console.WriteLine("Create bucket failed, error message {0}", ex.Message);​
            }​
            catch (Exception ex)​
            {​
                Console.WriteLine("Create bucket failed, {0}", ex.Message);​
            }​
        }​
    }​
}​

Specify Storage Type

The following code is used to specify the storage type when creating a bucket.

using System;​
using TOS;​
using TOS.Error;​
using TOS.Model;​
​
var ak = Environment.GetEnvironmentVariable("TOS_ACCESS_KEY");​
var sk = Environment.GetEnvironmentVariable("TOS_SECRET_KEY");​
var endpoint = "https://tos-cn-beijing.volces.com";​
var region = "cn-beijing";​
var bucketName = "*** Provide your bucket name ***";​
​
var client = TosClientBuilder.Builder().SetAk(ak).SetSk(sk).SetEndpoint(endpoint).SetRegion(region).Build();​
​
try​
{​
    var createBucketInput = new CreateBucketInput()​
    {​
        Bucket = bucketName,​
        StorageClass = StorageClassType.StorageClassIa​
    };​
    var createBucketOutput = client.CreateBucket(createBucketInput);​
    Console.WriteLine("Create bucket succeeded, request id {0} ", createBucketOutput.RequestID);​
    Console.WriteLine("Create bucket succeeded, status code {0} ", createBucketOutput.StatusCode);​
}​
catch (TosServerException ex)​
{​
    Console.WriteLine("Create bucket failed, request id {0}", ex.RequestID);​
    Console.WriteLine("Create bucket failed, status code {0}", ex.StatusCode);​
    Console.WriteLine("Create bucket failed, response error code {0}", ex.Code);​
    Console.WriteLine("Create bucket failed, response error message {0}", ex.Message);​
}​
catch (TosClientException ex)​
{​
    Console.WriteLine("Create bucket failed, error message {0}", ex.Message);​
}​
catch (Exception ex)​
{​
    Console.WriteLine("Create bucket failed, {0}", ex.Message);​
}​

Specify Availability Zone Type

The following code demonstrates how to specify the Availability Zone type when creating a bucket.

using System;​
using TOS;​
using TOS.Error;​
using TOS.Model;​
​
namespace ConsoleApp​
{​
    internal class Program​
    {​
        private static void Main(string[] args)​
        {​
            var ak = Environment.GetEnvironmentVariable("TOS_ACCESS_KEY");​
            var sk = Environment.GetEnvironmentVariable("TOS_SECRET_KEY");​
            var endpoint = "https://tos-cn-beijing.volces.com";​
            var region = "cn-beijing";​
            var bucketName = "*** Provide your bucket name ***";​
​
            var client = TosClientBuilder.Builder().SetAk(ak).SetSk(sk).SetEndpoint(endpoint).SetRegion(region).Build();​
​
            try​
            {​
                var createBucketInput = new CreateBucketInput()​
                {​
                    Bucket = bucketName,​
                    AzRedundancy = AzRedundancyType.AzRedundancyMultiAz​
                };​
                var createBucketOutput = client.CreateBucket(createBucketInput);​
                Console.WriteLine("Create bucket succeeded, request id {0} ", createBucketOutput.RequestID);​
                Console.WriteLine("Create bucket succeeded, status code {0} ", createBucketOutput.StatusCode);​
            }​
            catch (TosServerException ex)​
            {​
                Console.WriteLine("Create bucket failed, request id {0}", ex.RequestID);​
                Console.WriteLine("Create bucket failed, status code {0}", ex.StatusCode);​
                Console.WriteLine("Create bucket failed, response error code {0}", ex.Code);​
                Console.WriteLine("Create bucket failed, response error message {0}", ex.Message);​
            }​
            catch (TosClientException ex)​
            {​
                Console.WriteLine("Create bucket failed, error message {0}", ex.Message);​
            }​
            catch (Exception ex)​
            {​
                Console.WriteLine("Create bucket failed, {0}", ex.Message);​
            }​
        }​
    }​
}​