Tous les produits
Search
Centre de documentation

Object Storage Service:Create a bucket

Dernière mise à jour :Aug 18, 2026

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

oss:PutBucket

Crée un bucket.

oss:PutBucketAcl

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.

Remarque

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"
    }
Remarque

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\"}"