Créez un bucket OSS en définissant éventuellement le contrôle d'accès (ACL), la classe de stockage et la redondance des données.
Remarques d'utilisation
Un compte Alibaba Cloud peut créer au maximum 100 buckets par région.
Chaque région dispose d'un endpoint correspondant. Pour plus d'informations sur les endpoints de chaque région, consultez la rubrique Endpoints.
À partir du 13 octobre 2025 à 10:00:00 (UTC+8), OSS active progressivement par défaut l'option Block public access pour les buckets créés via des appels d'API, 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. Une fois cette fonctionnalité activée, vous ne pouvez pas accorder d'autorisations d'accès public, y compris les 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.
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 n'ont 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 |
|
Crée un bucket. |
|
|
Cette autorisation est requise pour modifier l'ACL du bucket après sa création. |
Syntaxe de la commande
ossutil api put-bucket --bucket value [flags]
|
Paramètre |
Type |
Description |
|
--acl |
string |
L'ACL du bucket. |
|
--bucket |
string |
Le nom du bucket. |
|
--create-bucket-configuration |
string |
La configuration du bucket au format XML ou JSON. |
|
--resource-group-id |
string |
L'ID du groupe de ressources. |
La commande put-bucket permet d'accéder à l'opération PutBucket. Pour plus d'informations sur cette opération d'API, consultez la rubrique PutBucket.
--create-bucket-configuration
Ce paramètre accepte les formats XML ou JSON :
-
Format XML :
<?xml version="1.0" encoding="UTF-8"?> <CreateBucketConfiguration> <StorageClass>Standard</StorageClass> <DataRedundancyType>LRS</DataRedundancyType> </CreateBucketConfiguration> -
Format JSON :
{ "StorageClass": "Standard", "DataRedundancyType": "LRS" }
Pour plus d'informations, consultez la rubrique Options de ligne de commande.
Exemples
-
Créez un bucket nommé examplebucket.
ossutil api put-bucket --bucket examplebucket -
Créez le bucket examplebucket avec une ACL privée, le groupe de ressources rg-123, la classe de stockage Standard et la redondance LRS.
-
Fichier de configuration XML (create-bucket-configuration.xml)
<?xml version="1.0" encoding="UTF-8"?> <CreateBucketConfiguration> <StorageClass>Standard</StorageClass> <DataRedundancyType>LRS</DataRedundancyType> </CreateBucketConfiguration>Commande :
ossutil api put-bucket --bucket examplebucket --acl private --resource-group-id rg-123 --create-bucket-configuration file://create-bucket-configuration.xml -
Fichier de configuration JSON (create-bucket-configuration.json)
{ "StorageClass": "Standard", "DataRedundancyType": "LRS" }Commande :
ossutil api put-bucket --bucket examplebucket --acl private --resource-group-id rg-123 --create-bucket-configuration file://create-bucket-configuration.json -
Paramètres JSON intégrés
ossutil api put-bucket --bucket examplebucket --acl private --resource-group-id rg-123 --create-bucket-configuration "{\"StorageClass\":\"Standard\",\"DataRedundancyType\":\"LRS\"}"
-