How to create a bucket - Object Storage Service - Centre de documentation Alibaba Cloud

Un bucket est un conteneur qui stocke des objets dans Object Storage Service (OSS). Tous les objets sont stockés dans des buckets. Cette rubrique explique comment créer un bucket.

Notes

Avant d'utiliser l'exemple de code de cette rubrique, créez une instance OSSClient en utilisant un nom de domaine personnalisé ou Security Token Service (STS). Pour plus d'informations, consultez Initialisation (SDK iOS).

Remarque
La région du bucket est déterminée par l'endpoint que vous spécifiez lors de l'initialisation.
À partir du 13 octobre 2025 à 10:00:00 (UTC+8), OSS active progressivement le blocage de l'accès public par défaut 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 politique de bucket.

API	Action	Description
PutBucket	`oss:PutBucket`	Crée un bucket.
PutBucket	`oss:PutBucketAcl`	Après la création d'un bucket, cette autorisation est requise pour modifier la liste de contrôle d'accès (ACL) du bucket.

Exemple de code

Le code suivant montre comment créer un bucket nommé examplebucket :

// Construct a request to create a bucket.
OSSCreateBucketRequest * create = [OSSCreateBucketRequest new];
// Set the bucket name to examplebucket.
create.bucketName = @"examplebucket";
// Set the access control list (ACL) of the bucket to private.
create.xOssACL = @"private";
// Set the storage class of the bucket to Infrequent Access (IA).
create.storageClass = OSSBucketStorageClassIA;

OSSTask * createTask = [client createBucket:create];

[createTask continueWithBlock:^id(OSSTask *task) {
    if (!task.error) {
        NSLog(@"create bucket success!");
    } else {
        NSLog(@"create bucket failed, error: %@", task.error);
    }
    return nil;
}];
// Block the current thread to wait for the task to complete.
// [createTask waitUntilFinished];

Références

Pour obtenir l'exemple de code complet permettant de créer un bucket, consultez l'exemple GitHub.
Pour plus d'informations sur l'opération d'API permettant de créer un bucket, consultez PutBucket.
Pour savoir comment initialiser une instance OSSClient, consultez Initialiser une instance OSSClient.