ossutil mb command - Create an OSS bucket - Object Storage Service

Remarques

Pour créer un bucket, vous devez disposer de l'autorisation oss:PutBucket. Pour plus d'informations, consultez la rubrique Accorder une politique personnalisée.
À partir de la version 1.6.16, ossutil utilise le même nom binaire sur tous les systèmes d'exploitation. Les versions antérieures nécessitent des noms binaires spécifiques au système d'exploitation. Pour plus d'informations, consultez la rubrique Prise en main rapide de l'outil de ligne de commande ossutil.
À compter du 13 octobre 2025 à 10 h 00 (UTC+8), OSS active progressivement par défaut la fonctionnalité Block public access pour les buckets créés via des appels d'API ou à l'aide des SDK OSS ou d'ossutil dans toutes les régions. Pour connaître la date d'application de cette modification dans chaque région, consultez l'annonce. Une fois cette fonctionnalité activée, vous ne pouvez pas accorder d'autorisations d'accès public, y compris les listes de contrôle d'accès (ACL) public-read ou public-read-write et les politiques de bucket autorisant l'accès public. Si votre activité nécessite un accès public, désactivez le blocage de l'accès public après la création du bucket.

Créer un bucket avec des options de commande

Syntaxe de la commande

ossutil mb oss://bucketname 
[--acl <value>]
[--storage-class <value>]
[--redundancy-type <value>]

Paramètres et options :

Paramètre/Option	Description
bucketname	Nom du bucket. Il doit être globalement unique dans OSS et ne peut pas être modifié après la création.
--acl	Liste de contrôle d'accès (ACL) du bucket. Valeurs valides : private (par défaut) : Seul le propriétaire du bucket peut lire et écrire des objets. Les autres utilisateurs n'ont aucun accès. public-read : Seul le propriétaire du bucket peut écrire des objets. Tous les utilisateurs, y compris les utilisateurs anonymes, peuvent lire les objets. Cela peut entraîner un accès non autorisé et des frais imprévus. Utilisez cette option avec prudence. public-read-write : Tous les utilisateurs, y compris les utilisateurs anonymes, peuvent lire et écrire des objets. Cela peut entraîner un accès non autorisé, des frais imprévus et des risques juridiques liés aux téléchargements interdits. N'utilisez cette option que si nécessaire.
--storage-class	Classe de stockage du bucket. Valeurs valides : Standard (par défaut) : Pour les données fréquemment consultées. IA : Infrequent Access (accès peu fréquent). Pour les données consultées une ou deux fois par mois. Durée minimale de stockage : 30 jours. Taille minimale facturée : 64 Ko. Prend en charge l'accès en temps réel. Des frais de récupération des données s'appliquent. Archive : Pour le stockage à long terme. Durée minimale de stockage : 60 jours. Taille minimale facturée : 64 Ko. Nécessite une restauration avant l'accès (environ 1 minute). Des frais de récupération des données s'appliquent. ColdArchive : Pour le stockage à long terme de données rarement consultées. Durée minimale de stockage : 180 jours. Taille minimale facturée : 64 Ko. Nécessite une restauration avant l'accès. Le temps de restauration varie selon la taille de l'objet et le mode. Des frais de récupération des données s'appliquent. Remarque Si vous utilisez OSS sur CloudBox, seule la classe de stockage Standard est prise en charge. Pour plus d'informations sur les classes de stockage, consultez la rubrique Types de stockage.
--redundancy-type	Type de redondance du bucket. Valeurs valides : LRS (par défaut) : Locally redundant storage (stockage localement redondant). Stocke des copies sur plusieurs appareils au sein de la même zone, garantissant la fiabilité des données même en cas de panne simultanée de deux appareils. ZRS : Zone-redundant storage (stockage redondant inter-zones). Stocke des copies de données dans plusieurs zones d'une même région. Les données restent accessibles même si une zone devient indisponible. Important ZRS est disponible dans les régions suivantes : Chine (Shenzhen), Chine (Pékin), Chine (Hangzhou), Chine (Shanghai), Chine (Hong Kong), Singapour et Indonésie (Jakarta). ZRS augmente les coûts de stockage et ne peut pas être désactivé une fois activé. Si vous utilisez OSS sur CloudBox, ce paramètre n'est pas pris en charge.

Exemples

Créez un bucket nommé examplebucket :
```
ossutil mb oss://examplebucket
```
Si aucune région n'est spécifiée, le bucket est créé dans la région associée à l'endpoint défini dans votre fichier de configuration ossutil. Par exemple, si l'endpoint est https://oss-cn-hangzhou.aliyuncs.com, le bucket est créé dans la région Chine (Hangzhou).
Créez un bucket nommé examplebucket avec l'ACL définie sur private, la classe de stockage sur IA et le type de redondance sur ZRS :
```
ossutil mb oss://examplebucket --acl private --storage-class IA --redundancy-type ZRS
```
Si la sortie suivante s'affiche, le bucket a été créé avec succès :
```
0.335189(s) elapsed
```

Créer un bucket à partir d'un fichier XML

Syntaxe de la commande

ossutil mb oss://bucketname local_xml_file

Paramètres :

Paramètre

Description

bucketname

Nom du bucket.

local_xml_file

Chemin d'accès à un fichier XML local contenant les configurations du bucket. Exemple : localfile.xml.

Exemples

Définissez les configurations du bucket dans le fichier localfile.xml.

<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>    
    <StorageClass>IA</StorageClass>
    <DataRedundancyType>LRS</DataRedundancyType>
</CreateBucketConfiguration>

Créez un bucket à l'aide du fichier de configuration XML local :
```
ossutil mb oss://examplebucket localfile.xml
```

Options courantes

Pour accéder à un bucket situé dans une autre région, utilisez l'option -e pour spécifier l'endpoint. Pour accéder à un bucket appartenant à un autre compte Alibaba Cloud, utilisez l'option -i pour l'AccessKey ID et l'option -k pour l'AccessKey Secret.

Par exemple, créez un bucket nommé examplebucket dans la région Chine (Shanghai) sous un autre compte Alibaba Cloud :

ossutil mb oss://examplebucket -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret

Options courantes.