Manage buckets

A bucket is a namespace on the OSS and a management entity for billing, access control, logging, and other advanced features.

Create a bucket

The following code creates a bucket:

using Aliyun.OSS;
// Initialize an OSSClient
var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
/// <summary>
/// Create a new bucket
/// </summary>
/// <param name="bucketName">Name of the bucket</param>
public void CreateBucket(string bucketName)
{
    try
    {
        // Create a bucket
        client.CreateBucket(bucketName);
        Console.WriteLine("Create bucket succeeded");
    }
    catch (Exception ex)
    {
        Console.WriteLine("Create bucket failed. {0}", ex.Message);
    }
}

For complete code, see GitHub.

Note: The name of a bucket is globally unique. Hence, you must make sure that your bucket name is different from those of other users.

List all buckets of a user

The following code lists all buckets of a specified user:

using Aliyun.OSS;
// Initialize an OSSClient
var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
/// <summary>
/// List the information of all buckets under an account
/// </summary>
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);
    }
}

For complete code, see GitHub.

CNAME access

Once you direct your domain CNAME to the domain of your bucket, you can access OSS through your domain:

To use the CNAME for access, you must set IsCname in ClientConfigration to true.

using Aliyun.OSS;
using Aliyun.OSS.Common;
/// <summary>
/// Upload objects using the CNAME
/// </summary>
public void PutObjectByCname()
{
    try
    {
        // For example, your domain is "http://my-cname.com" and you can direct the CNAME to your bucket domain "mybucket.oss-cn-hangzhou.aliyuncs.com"
        // Create a ClientConfiguration instance
        var conf = new ClientConfiguration();
        // Use CNAME for configuration
        conf.IsCname = true;
        var client = new OssClient("http://my-cname.com/", accessKeyId, accessKeySecret, conf);
        var result = client.putObject("mybucket", key, fileToUpload);
        Console.WriteLine("Put object succeeded");
    }
    catch (Exception ex)
    {
        Console.WriteLine("Put object failed. {0}", ex.Message);
    }
}

For complete code, see GitHub

Note:

• When you create an OSSClient class instance, replace the endpoint for the bucket with the domain name mapped to the CNAME and set IsCname in ClientConfiguration to true.

• When you use the OSSClient instance for subsequent operations, the bucket name can only be set to the name to which the CNAME is directed.

Identify whether the bucket exists

The following code checks whether a bucket exists:

using Aliyun.OSS;
// Initialize an OSSClient
var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
/// <summary>
/// Identify whether the bucket exists
/// </summary>
/// <param name="bucketName">Name of the bucket</param>
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);
    }
}

For complete code, see GitHub.

Configure the access ACL of a bucket

The following code configures the access ACL of a bucket:

using Aliyun.OSS;
// Initialize an OSSClient
var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
/// <summary>
/// Configures the access ACL of the bucket
/// </summary>
/// <param name="bucketName">Name of the bucket</param>
public void SetBucketAcl(string buckteName)
{
    try
    {
        // Make bucket ACL as 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);
    }
}

For complete code, see GitHub.

Obtain the access ACL of a bucket

The following code obtains the access ACL of a bucket:

using Aliyun.OSS;
// Initialize an OSSClient
var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
/// <summary>
/// Obtain the access ACL of the bucket
/// </summary>
/// <param name="bucketName">Name of the bucket</param>
public void GetBucketAcl(string bucketName)
{
    try
    {
        string bucketName = "your-bucket";
        var acl = client.GetBucketAcl(bucketName);
        Console.WriteLine("Get bucket ACL success");
        foreach (var grant in acl.Grants)
        {
             Console.WriteLine ("The bucket ACL has been obtained successfully. Current permission: 0", grant.Permission.ToString());
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine("Get bucket ACL failed. {0}", ex.Message);
    }
}

For complete code, see GitHub.

Delete a bucket

The following code deletes a bucket:

using Aliyun.OSS;
// Initialize an OSSClient
var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
/// <summary>
/// Delete the bucket
/// </summary>
/// <param name="bucketName">Name of the bucket</param>
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);
    }
}

For complete code, see GitHub.

Note: A non-empty bucket (which contains objects or object fragments from multipart uploads) cannot be deleted. To delete a non-empty bucket, you must first delete all objects in it.