Créez un compartiment OSS avec des paramètres facultatifs de liste de contrôle d'accès (ACL), de classe de stockage et de redondance des données.
Remarques
Un compte Alibaba Cloud peut créer au maximum 100 compartiments 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 la fonctionnalité Block public access pour les compartiments 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 compartiment autorisant l'accès public. Si votre activité nécessite un accès public, vous pouvez désactiver le blocage de l'accès public après la création du compartiment.
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 compartiment.
|
API |
Action |
Description |
|
PutBucket |
|
Crée un compartiment. |
|
|
Après la création d'un compartiment, cette autorisation est requise pour modifier l'ACL du compartiment. |
Syntaxe de la commande
ossutil api put-bucket --bucket value [flags]
|
Paramètre |
Type |
Description |
|
--acl |
string |
L'ACL du compartiment. |
|
--bucket |
string |
Le nom du compartiment. |
|
--create-bucket-configuration |
string |
La configuration du compartiment 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 compartiment nommé examplebucket.
ossutil api put-bucket --bucket examplebucket -
Créez le compartiment 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\"}"
-