Todos os produtos
Search
Central de documentação

Object Storage Service:Delete a bucket (iOS SDK)

Última atualização: Jun 23, 2026
null

  • Depois de excluir um bucket, o nome dele fica disponível e outro usuário pode reivindicá-lo. Para manter o nome do bucket, esvazie-o em vez de excluí-lo.

  • Não é possível recuperar os dados de um bucket após excluí-lo. Antes de excluir um bucket, confirme se os dados não são mais necessários. Caso precise continuar usando os dados do bucket, faça backup deles antecipadamente. Para mais informações, consulte Fazer backup de um bucket.

Pré-requisitos

  • Todos os pontos de acesso do bucket foram excluídos. Para mais informações, consulte Pontos de acesso.

  • Todos os objetos do bucket foram excluídos.

    null

    Se o versionamento estiver ativado para o bucket, certifique-se de excluir todas as versões atuais e anteriores dos objetos do bucket. Para mais informações, consulte Versionamento.

    • Se o bucket tiver uma pequena quantidade de objetos, exclua-os manualmente. Para mais informações, consulte Excluir objetos.

    • Se o bucket tiver muitos objetos, configure regras de ciclo de vida para excluí-los automaticamente. Para mais informações, consulte Ciclo de vida.

  • Todas as partes geradas por uploads multipart ou uploads retomáveis no bucket foram excluídas. Para mais informações, consulte Excluir partes.

  • Todos os LiveChannels do bucket foram excluídos. Para mais informações, consulte DeleteLiveChannel.

Observações

Antes de executar o código de exemplo neste tópico, crie uma instância do OSSClient. Crie a instância usando um nome de domínio personalizado ou o Security Token Service (STS). Para mais informações, consulte Inicialização (iOS SDK).

null

O endpoint configurado durante a inicialização determina a região do bucket que você deseja excluir.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões totais. Os usuários RAM ou as funções RAM em uma conta Alibaba Cloud não têm nenhuma permissão 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 RAM ou Bucket Policy.

APIAçãoDescrição
DeleteBucketoss:DeleteBucketExclui um bucket.
null

Se você tiver a permissão oss:DeleteBucket em uma política RAM, mas não conseguir excluir o bucket, uma política de bucket pode conter uma permissão oss:DeleteBucket com o efeito definido como Deny. Altere o efeito para Allow ou exclua a política do bucket antes de excluí-lo.

Código de exemplo

O código a seguir mostra como excluir um bucket chamado examplebucket.

OSSDeleteBucketRequest * delete = [OSSDeleteBucketRequest new];
// Specify the bucket name. For example, examplebucket.
delete.bucketName = @"examplebucket";
OSSTask * deleteTask = [client deleteBucket:delete];
[deleteTask continueWithBlock:^id(OSSTask *task) {
    if (!task.error) {
        NSLog(@"delete bucket success!");
    } else {
        NSLog(@"delete bucket failed, error: %@", task.error);
    }
    return nil;
}];
// Block the current thread until the task is complete.
// [getdeleteTask waitUntilFinished];

Documentos relacionados

  • Para acessar o código de exemplo completo que mostra como excluir um bucket, consulte o exemplo no GitHub.

  • Para mais informações sobre a operação de API para excluir um bucket, consulte DeleteBucket.

  • Para mais informações sobre como inicializar uma instância do OSSClient, consulte Inicialização (iOS SDK).