Todos os produtos
Search

Este produto

    Object Storage Service:Excluir buckets (C# SDK V1)

    Central de documentação

    Object Storage Service:Excluir buckets (C# SDK V1)

    Última atualização: Jul 03, 2026

    Aviso

    • Após a exclusão de um bucket, o nome fica disponível para outros usuários. Para preservar o nome do bucket, esvazie-o em vez de excluí-lo.

    • Não é possível recuperar os dados de um bucket após a exclusão. Antes de excluir um bucket, confirme que os dados não são mais necessários. Se precisar continuar usando os dados do bucket, faça um backup antecipadamente. Para mais informações, consulte Fazer backup de um bucket.

    Observações

    • Este tópico utiliza o endpoint público da região China (Hangzhou). Para acessar o OSS a partir de outros serviços da Alibaba Cloud na mesma região, use um endpoint interno. Para obter mais detalhes sobre regiões e endpoints do OSS, consulte Regiões e endpoints.

    • O exemplo abaixo demonstra como criar uma instância OSSClient com um endpoint do OSS. Para configurações alternativas, como uso de domínio personalizado ou autenticação com credenciais do Security Token Service (STS), consulte Inicialização (C# SDK V1).

    • Antes de excluir um bucket, certifique-se de ter excluído os recursos necessários.

    Permissões

    Por padrão, uma conta Alibaba Cloud tem permissões totais. Usuários RAM ou funções RAM vinculados a uma conta Alibaba Cloud não têm permissões por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de políticas do RAM ou Bucket Policy.

    API

    Ação

    Descrição

    DeleteBucket

    oss:DeleteBucket

    Exclui um bucket.

    Código de exemplo

    O código a seguir exemplifica como excluir o bucket chamado examplebucket:

    using System;
using Aliyun.OSS;
using Aliyun.OSS.Common;

namespace Samples
{
    public class Program
    {
        public static void Main(string[] args)
        {
            // Set endpoint to the Endpoint of the region where your bucket is located. For example, if your bucket is in the China (Hangzhou) region, set the Endpoint to https://oss-cn-hangzhou.aliyuncs.com.
            var endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
            // Obtain access credentials from environment variables. Before you run this sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
            var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
            var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
            // Set bucketName to the name of your bucket. Example: examplebucket.
            var bucketName = "examplebucket314";
            // Set region to the ID of the region where your bucket is located. For example, if your bucket is in the China (Hangzhou) region, set the region to cn-hangzhou.
            const string region = "cn-hangzhou";
            // Create a ClientConfiguration instance and modify the default parameters as needed.
            var conf = new ClientConfiguration();
            // Set the signature version to V4.
            conf.SignatureVersion = SignatureVersion.V4;

            // Create an OssClient instance.
            var client = new OssClient(endpoint, accessKeyId, accessKeySecret, conf);
            client.SetRegion(region);
            
            try
            {
                client.DeleteBucket(bucketName);

                Console.WriteLine("Delete bucket succeeded");
            }
            catch (Exception ex)
            {
                Console.WriteLine("Delete bucket failed. {0}", ex.Message);
            }
        }
    }
}

    Referências