Object Storage Service:PutBucket

API

Action

Description

PutBucket

oss:PutBucket

Crée un bucket.

oss:PutBucketAcl

Après la création d'un bucket, cette autorisation est requise pour modifier l'ACL du bucket.

Name

Type

Required

Example

Description

x-oss-acl

String

No

private

La liste de contrôle d'accès (ACL) du bucket. Valeurs possibles :

• public-read-write : Accorde des autorisations de lecture et d'écriture publiques.

• public-read : Lecture publique

• private (par défaut)

Pour plus d'informations sur les ACL des buckets, consultez Set bucket ACLs.

x-oss-resource-group-id

String

No

rg-aek27tc****

L'ID du groupe de ressources.

• Si vous incluez cet en-tête dans la requête et spécifiez un ID de groupe de ressources, le bucket créé appartient au groupe de ressources spécifié.

  Si vous définissez l'ID du groupe de ressources sur rg-default-id, le bucket créé appartient au groupe de ressources par défaut.

• Si vous n'incluez pas cet en-tête dans la requête, le bucket créé appartient au groupe de ressources par défaut.

Vous pouvez obtenir l'ID du groupe de ressources dans la console Resource Management ou en appelant l'opération ListResourceGroups. Pour plus d'informations, consultez View resource groups et ListResourceGroups.

x-oss-bucket-tagging

String

No

k1=v1&k2=v2

Spécifie les tags du bucket.

x-oss-hns-status

String

No

disabled

Indique s'il faut activer la fonctionnalité de namespace hiérarchique pour le bucket.

Vous ne pouvez activer la fonctionnalité de namespace hiérarchique que lors de la création d'un bucket. Vous ne pouvez pas modifier l'état du namespace hiérarchique d'un bucket existant.

• enabled : Activé

  Après avoir activé la fonctionnalité de namespace hiérarchique pour un bucket, vous pouvez effectuer des opérations de répertoire dans le bucket, telles que la création, la suppression et le renommage de répertoires.

• disabled (par défaut) : La fonctionnalité est désactivée.

x-oss-server-side-encryption

String

No

AES256

Définit la méthode de chiffrement côté serveur par défaut.

Valeurs possibles : KMS, AES256

L'utilisation de la fonctionnalité KMS entraîne des frais minimes pour les appels d'API KMS. Pour plus d'informations sur la tarification, consultez KMS pricing.

Lors de la réplication inter-régions, si le bucket de destination a activé le chiffrement côté serveur par défaut et que la règle de réplication est configurée avec un ReplicaCMKID, les situations suivantes s'appliquent :

• Si un objet dans le bucket source n'est pas chiffré, l'objet est chiffré à l'aide de la méthode de chiffrement par défaut du bucket de destination après sa réplication.

• Si un objet dans le bucket source est chiffré à l'aide de SSE-KMS ou SSE-OSS, l'objet conserve sa méthode de chiffrement d'origine dans le bucket de destination.

Pour plus d'informations, consultez Cross-region replication with server-side encryption.

x-oss-server-side-encryption-key-id

String

No

9468da86-3509-4f8d-a61e-6eab1eac****

L'ID de la clé KMS. Cet en-tête est requis uniquement lorsque x-oss-server-side-encryption est défini sur KMS. Dans les autres cas, cet en-tête doit être vide.

Si vous utilisez OSS on CloudBox, ce paramètre n'est pas pris en charge.

Nom

Type

Obligatoire

Exemple

Description

StorageClass

String

Non

Standard

Classe de stockage du bucket. Valeurs possibles :

• Standard (par défaut)

• IA : Infrequent Access

• Archive : Archive Storage

• ColdArchive : Cold Archive

• DeepColdArchive : Deep Cold Archive

Nœud parent : CreateBucketConfiguration

Nœuds enfants : Aucun

DataRedundancyType

String

Non

LRS

Type de redondance des données du bucket. Valeurs possibles :

• LRS (par défaut)

  Le stockage localement redondant (LRS) stocke des copies de vos données sur différents périphériques de stockage au sein de la même zone. Cela garantit la durabilité et la disponibilité des données, même si deux périphériques de stockage sont endommagés simultanément.

• ZRS

  Le stockage redondant inter-zones (ZRS) utilise un mécanisme de redondance des données entre plusieurs zones. Le ZRS répartit les données d'un objet sur plusieurs zones dans la même région. Si une zone devient indisponible, vous pouvez toujours accéder aux données.

Nœud parent : CreateBucketConfiguration

Nœuds enfants : Aucun

Nom

Type

Exemple

Description

Location

String

/oss-example

Adresse du bucket. La valeur correspond à une barre oblique (/) suivie du nom du bucket.

Valeur par défaut : Aucune

Code d'erreur

Code d'état HTTP

Description

InvalidBucketName

400

Le nom du bucket ne respecte pas les conventions de dénomination.

AccessDenied

403

Les causes possibles de cette erreur sont les suivantes :

• Les informations d'authentification de l'utilisateur ne sont pas incluses dans la requête PutBucket.

• Vous ne disposez pas des autorisations requises.

TooManyBuckets

400

Le nombre de buckets créés dépasse la limite supérieure. Un compte Alibaba Cloud peut créer au maximum 100 buckets dans la même région.

BucketAlreadyExists

409

• Si un bucket a été supprimé, la condition de délai pour la création d'un bucket portant le même nom n'est pas remplie.

  Vous tentez de créer un bucket avec un nom qui était utilisé par un bucket récemment supprimé. Après la suppression d'un bucket, vous devez attendre plusieurs heures (généralement 4 à 8 heures) avant de pouvoir créer un bucket portant le même nom.

• Vous appelez l'opération PutBucket à l'aide de méthodes telles qu'un utilisateur RAM ou STS pour créer un bucket portant le même nom qu'un bucket existant.

  Seul le compte Alibaba Cloud d'origine peut recréer un bucket portant le même nom.

• Vous ne disposez pas des autorisations nécessaires pour appeler l'opération PutBucketAcl. Assurez-vous que l'appelant a reçu l'autorisation oss:PutBucketAcl via une politique de bucket ou une politique RAM.

• Vous tentez de modifier l'état de l'espace de noms hiérarchique d'un bucket existant. Vous ne pouvez activer la fonctionnalité d'espace de noms hiérarchique que lors de la création d'un bucket.