Um bucket é um contêiner para armazenamento de objetos. Todos os objetos devem ser armazenados em um bucket. Este tópico descreve como criar um bucket.
Antes de começar
Antes de executar o código de exemplo, crie uma instância do OSSClient usando um método como nome de domínio personalizado ou Security Token Service (STS). Inicializar uma instância do OSSClient para Android.
Permissões
Por padrão, uma conta Alibaba Cloud tem permissões totais. Usuários RAM e funções RAM vinculados a essa conta não possuem permissões iniciais. 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 |
|
PutBucket |
|
Cria um bucket. |
|
|
Necessária para modificar a ACL do bucket após a criação. |
Código de exemplo
O código a seguir cria um bucket chamado examplebucket.
A região do bucket corresponde à região do endpoint especificada 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
Exemplo completo de criação de bucket: Exemplo no GitHub.
Referência da API de criação de bucket: PutBucket.
Inicialização do OSSClient: Inicializar uma instância do OSSClient para Android.