Un bucket est un conteneur de stockage d'objets. Tous les objets doivent être stockés dans un bucket. Cette rubrique explique comment créer un bucket.
Prérequis
Avant d'exécuter l'exemple de code, créez une instance OSSClient en utilisant une méthode telle qu'un nom de domaine personnalisé ou le Security Token Service (STS). Initialiser une instance OSSClient pour Android.
À partir du 13 octobre 2025 à 10:00:00 (UTC+8), OSS active progressivement par défaut le blocage de l'accès public pour les buckets créés via des appels d'API, l'utilisation des SDK OSS ou ossutil dans toutes les régions. Pour connaître la date d'entrée en vigueur de cette modification dans chaque région, consultez l'annonce.
Autorisations
Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM ou les rôles RAM associés à un compte Alibaba Cloud ne disposent d'aucune autorisation par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les autorisations d'opération via des politiques RAM ou une Bucket Policy.
|
API |
Action |
Description |
|
PutBucket |
|
Crée un bucket. |
|
|
Cette autorisation est requise pour modifier la liste de contrôle d'accès (ACL) du bucket après sa création. |
Exemple de code
Le code suivant crée un bucket nommé examplebucket.
La région du bucket est déterminée par la région de l'endpoint spécifiée lors de l'initialisation.
// 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());
}
}
});
Références
Exemple complet de création de bucket : exemple GitHub.
Référence de l'API de création de bucket : PutBucket.
Initialisation d'OSSClient : Initialiser une instance OSSClient pour Android.