Manage a bucket

Create a bucket

For the complete code of creating a bucket, see GitHub.

You can run the following code to create a bucket:

using Aliyun.OSS;

// Initialize an OSSClient.
var client = new OssClient(endpoint, accessKeyId, accessKeySecret);

// Create a new bucket.
public void CreateBucket(string bucketName)
{
    try
    {
        // Create a bucket. The bucketName is globally unique.
        client.CreateBucket(bucketName);
        Console.WriteLine("Create bucket succeeded");
    }
    catch (Exception ex)
    {
        Console.WriteLine("Create bucket failed. {0}", ex.Message);
    }
}

List buckets

For the complete code of listing buckets, see GitHub.

You can run the following code to list all buckets under an account:

using Aliyun.OSS;

// Initialize an OSSClient instance.
var client = new OssClient(endpoint, accessKeyId, accessKeySecret);

// List the information about all buckets under an account.
public void ListBuckets()
{
    try
    {
        var buckets = client.ListBuckets();
        
        Console.WriteLine("List bucket succeeded");
        foreach (var bucket in buckets)
        {
	        Console.WriteLine("Bucket name：{0}，Location：{1}，Owner：{2}", bucket.Name, bucket.Location, bucket.Owner);
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine("List bucket failed. {0}", ex.Message);
    }
}

Determine whether a bucket exists

For the complete code of determining whether a bucket exists, see GitHub.

You can run the following code to determine whether a bucket exists:

using Aliyun.OSS;

//Initialize an OSSClient instance.
var client = new OssClient(endpoint, accessKeyId, accessKeySecret);

// Determine whether a bucket exists.
public void DoesBucketExist(string bucketName)
{
    try
    {
        var exist = client.DoesBucketExist(bucketName);

        Console.WriteLine("Check object Exist succeeded");
        Console.WriteLine("exist ? {0}", exist);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Check object Exist failed. {0}", ex.Message);
    }
}

Configure an ACL for a bucket

For the complete code of configuring ACL, see GitHub.

The ACL of a bucket includes the following permissions.

You can run the following code to configure an ACL for a bucket:

using Aliyun.OSS;

// Initialize an OSSClient instance.
var client = new OssClient(endpoint, accessKeyId, accessKeySecret);

// Configure an access ACL for the bucket
public void SetBucketAcl(string buckteName)
{
    try
    {
        // Set the ACL of the bucket to public read.
        client.SetBucketAcl(bucketName, CannedAccessControlList.PublicRead);
        Console.WriteLine("Set bucket ACL succeeded");
    }
    catch (Exception ex)
    {
        Console.WriteLine("Set bucket ACL failed. {0}", ex.Message);
    }
}

Obtain the ACL for a bucket

For the complete code of obtaining the ACL for a bucket, see GitHub.

You can run the following code to obtain the ACL for a bucket:

using Aliyun.OSS;

// Initialize an OSSClient instance.
var client = new OssClient(endpoint, accessKeyId, accessKeySecret);

// Obtain the ACL for the bucket.
public void GetBucketAcl(string bucketName)
{
    try
    {
        string bucketName = "your-bucket";
        var acl = client.GetBucketAcl(bucketName);

        Console.WriteLine("Get bucket ACL success"，acl.ACL.ToString());
    }
    catch (Exception ex)
    {
        Console.WriteLine("Get bucket ACL failed. {0}", ex.Message);
    }
}

Delete a bucket

For the complete code of deleting a bucket, see GitHub.

Before a bucket is deleted, ensure that all objects in the bucket and fragments that are generated from multipart upload are deleted.

You can run the following code to delete a bucket:

using Aliyun.OSS;

// Initialize an OSSClient instance.
var client = new OssClient(endpoint, accessKeyId, accessKeySecret);

// Delete the bucket.
public void DeleteBucket(string bucketName)
{
    try
    {
        client.DeleteBucket(bucketName);
        
        Console.WriteLine("Delete bucket succeeded");
    }
    catch (Exception ex)
    {
        Console.WriteLine("Delete bucket failed. {0}", ex.Message);
    }
}