PutBucketAcl - Set bucket ACL - Object Storage Service - Centre de documentation Alibaba Cloud

Remarques sur l'utilisation

Lorsque vous appelez l'opération PutBucketAcl, tenez compte des points suivants :

Vous devez disposer des autorisations d'écriture sur le bucket.
PutBucketAcl utilise une sémantique d'écrasement. La nouvelle ACL remplace celle existante.
Si le bucket spécifié n'existe pas, un nouveau bucket est créé.

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 ne disposent d'aucune autorisation par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les autorisations d'opération via les politiques RAM ou la stratégie de bucket.

Structure de la requête

PUT /? acl HTTP/1.1
x-oss-acl: Permission
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

En-têtes de requête

En-tête

Type

Obligatoire

Valeur d'exemple

Description

x-oss-acl

String

Oui

private

L'ACL à définir pour le bucket.

Si cet en-tête est omis, les paramètres ACL ne prennent pas effet.

Valeurs valides : public-read-write, public-read et private

public-read-write : tous les utilisateurs, y compris les utilisateurs anonymes, peuvent lire et écrire des objets dans le bucket. À utiliser avec prudence.
public-read : seul le propriétaire du bucket ou les utilisateurs autorisés peut écrire des objets. Les autres utilisateurs, y compris les utilisateurs anonymes, peuvent uniquement lire les objets. À utiliser avec prudence.
private : seul le propriétaire du bucket ou les utilisateurs autorisés peut lire et écrire des objets. Les autres utilisateurs, y compris les utilisateurs anonymes, ne peuvent pas accéder aux objets sans autorisation.

Pour connaître les en-têtes de requête communs inclus dans les requêtes PutBucketAcl, consultez En-têtes de requête communs.

En-têtes de réponse

La réponse à une requête PutBucketAcl contient uniquement des en-têtes de réponse communs. Pour plus d'informations, consultez En-têtes de réponse communs.

Exemples

Exemple de requête

PUT /? acl HTTP/1.1
x-oss-acl: public-read
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 03:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Exemple de réponse

Exemple de réponse en cas de succès

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 24 Feb 2012 03:21:12 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

Exemple de réponse en cas de paramètres ACL invalides

HTTP/1.1 400 Bad Request
x-oss-request-id: 56594298207FB3044385****
Date: Fri, 24 Feb 2012 03:55:00 GMT
Content-Length: 309
Content-Type: text/xml; charset=UTF-8
Connection: keep-alive
Server: AliyunOSS

<? xml version="1.0" encoding="UTF-8"? >
<Error>
  <Code>InvalidArgument</Code>
  <Message>no such bucket access control exists</Message>
  <RequestId>5***9</RequestId>
  <HostId>***-test.example.com</HostId>
  <ArgumentName>x-oss-acl</ArgumentName>
  <ArgumentValue>error-acl</ArgumentValue>
</Error>

SDK OSS

Appelez PutBucketAcl avec les SDK OSS suivants :

ossutil

Pour obtenir des informations sur la commande ossutil correspondant à l'opération PutBucketAcl, consultez put-bucket-acl.

Codes d'erreur

Code d'erreur	Code d'état HTTP	Description
AccessDenied	403	Les informations d'authentification de l'utilisateur sont manquantes dans la requête. Vous ne disposez pas des autorisations nécessaires pour effectuer cette opération.