You need to enable JavaScript to run this app.
导航

删除桶(.NET SDK)

最近更新时间2024.02.04 18:31:07

首次发布时间2023.08.24 14:41:47

当您不再需要保留某个桶(Bucket)时,可将其删除,以免产生额外费用。

前提条件

删除桶之前,请确保您已经删除桶中所有数据。

  • 如果桶开启了版本控制,请确保已删除当前桶内所有当前版本和历史版本对象。具体操作,请参见删除对象
  • 如果桶中存在未合并的分片,请确保删除所有分片数据,具体操作,请参见删除分片
  • 如果桶中的对象较多,您可以通过生命周期规则,设置对象的批量删除。具体操作,请参见设置生命周期规则

注意事项

  • 桶删除后不可恢复,请谨慎操作。
  • 删除桶之前,您需要确保账号已拥有 tos:DeleteBucket 权限。具体操作,请参见权限配置指南

示例代码

以下代码用于删除存储桶。

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");
            // endpoint 若没有指定HTTP协议(HTTP/HTTPS),默认使用 HTTPS
            // Bucket 的 Endpoint,以华北2(北京)为例:https://tos-cn-beijing.volces.com
            var endpoint = "https://tos-cn-beijing.volces.com";
            var region = "cn-beijing";
            // 填写 BucketName
            var bucketName = "*** Provide your bucket name ***";

            // 创建TOSClient实例
            var client = TosClientBuilder.Builder().SetAk(ak).SetSk(sk).SetEndpoint(endpoint).SetRegion(region).Build();

            try
            {
                // 创建删除桶输入
                var deleteBucketInput = new DeleteBucketInput()
                {
                    Bucket = bucketName,
                };
                // 删除桶
                var deleteBucketOutput = client.DeleteBucket(deleteBucketInput);
                // 桶存在,查看请求信息和桶信息
                Console.WriteLine("Delete bucket succeeded, request id {0} ", deleteBucketOutput.RequestID);
                Console.WriteLine("Delete bucket succeeded, status code {0} ", deleteBucketOutput.StatusCode);
            }
            catch (TosServerException ex)
            {
                Console.WriteLine("Delete bucket failed, request id {0}", ex.RequestID);
                Console.WriteLine("Delete bucket failed, status code {0}", ex.StatusCode);
                Console.WriteLine("Delete bucket failed, response error code {0}", ex.Code);
                Console.WriteLine("Delete bucket failed, response error message {0}", ex.Message);
            }
            catch (TosClientException ex)
            {
                Console.WriteLine("Delete bucket failed, error message {0}", ex.Message);
            }
            catch (Exception ex)
            {
                Console.WriteLine("Delete bucket failed, {0}", ex.Message);
            }
        }
    }
}

相关文档

关于删除桶的 API 接口详细介绍,请参见 DeleteBucket