Tous les produits
Search
Centre de documentation

Object Storage Service:put-object-acl

Dernière mise à jour :Aug 18, 2026

La commande put-object-acl définit ou modifie la liste de contrôle d'accès (ACL) d'un objet.

Notes d'utilisation

  • Par défaut, un compte Alibaba Cloud est autorisé à configurer l'ACL d'un objet. Pour effectuer cette opération en tant qu'utilisateur RAM ou via le Security Token Service (STS), l'autorisation oss:PutObjectAcl est requise. Pour plus d'informations, consultez la rubrique Grant a custom policy.

    Seul le propriétaire du bucket disposant des droits de lecture et d'écriture sur les objets qu'il contient peut appeler cette opération pour modifier les ACL de l'objet.

  • L'ACL d'un objet prévaut sur celle du bucket dans lequel il est stocké. Par exemple, si un objet dont l'ACL est public-read-write se trouve dans un bucket dont l'ACL est private, tous les utilisateurs peuvent lire et écrire cet objet.

Syntaxe de la commande

ossutil api put-object-acl --bucket value --key value --object-acl value [flags]

Parameter

Type

Description

--bucket

string

Nom du bucket.

--key

string

Chemin complet de l'objet.

--object-acl

string

ACL de l'objet. Valeurs possibles :

  • private

  • public-read

  • public-read-write

  • default (l'objet hérite de l'ACL du bucket)

--version-id

string

ID de version de l'objet.

Remarque
  • La commande put-object-acl correspond à l'opération PutObjectACL. Pour plus de détails sur les paramètres de l'opération PutObjectACL, consultez la documentation PutObjectACL.

  • Pour consulter la liste des options globales prises en charge, voir la section Command-line options.

Exemple

Définissez l'ACL de examplebucket sur private.

ossutil api put-object-acl --bucket examplebucket --key exampleobject --object-acl private