Todos os produtos
Search
Central de documentação

Object Storage Service:Create buckets (Android SDK)

Última atualização: Sep 21, 2026

Um bucket é um contêiner para armazenar objetos. Todos os objetos precisam ser armazenados em um bucket. Este tópico descreve como criar um bucket.

Antes de começar

  • Crie uma instância do OSSClient usando um método como um nome de domínio personalizado ou o Security Token Service (STS). Em seguida, execute o código de exemplo. Initialize an OSSClient instance for Android.

  • A partir das 10:00:00 (UTC+8) de 13 de outubro de 2025, o OSS ativa gradualmente o bloqueio de acesso público por padrão para buckets criados por chamadas de operações de API ou pelo uso de OSS SDKs ou ossutil em todas as regiões. Para saber quando a alteração entrará em vigor em cada região, consulte Anúncio.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões totais. Usuários ou funções do 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 RAM policies ou Bucket Policy.

API

Ação

Descrição

PutBucket

oss:PutBucket

Cria um bucket.

oss:PutBucketAcl

Após a criação de um bucket, essa permissão é necessária para que você modifique a ACL do bucket.

Código de exemplo

O código a seguir cria um bucket chamado examplebucket.

Nota

Para definir a região do bucket, especifique a região do endpoint durante a inicialização.

// Construct a request to create a bucket.
// Specify the bucket name.
CreateBucketRequest createBucketRequest = new CreateBucketRequest("examplebucket");
// Specify the access control list (ACL) of the bucket.
// createBucketRequest.setBucketACL(CannedAccessControlList.Private);
// Specify the storage class of the bucket.
// createBucketRequest.setBucketStorageClass(StorageClass.Standard);

// Create the bucket asynchronously.
OSSAsyncTask createTask = oss.asyncCreateBucket(createBucketRequest, new OSSCompletedCallback<CreateBucketRequest, CreateBucketResult>() {
    @Override
    public void onSuccess(CreateBucketRequest request, CreateBucketResult result) {
        Log.d("asyncCreateBucket", "Success");
    }
    @Override
    public void onFailure(CreateBucketRequest request, ClientException clientException, ServiceException serviceException) {
        // Request exception.
        if (clientException != null) {
            // Client-side exceptions, such as network errors.
            clientException.printStackTrace();
        }
        if (serviceException != null) {
            // Server-side exceptions.
            Log.e("ErrorCode", serviceException.getErrorCode());
            Log.e("RequestId", serviceException.getRequestId());
            Log.e("HostId", serviceException.getHostId());
            Log.e("RawMessage", serviceException.getRawMessage());
        }
    }
});

Referências