Tous les produits
Search
Centre de documentation

Object Storage Service:get-object-acl

Dernière mise à jour :Aug 18, 2026

La commande get-object-acl permet d'interroger la liste de contrôle d'accès (ACL) d'un objet dans un bucket.

Notes d'utilisation

  • Par défaut, un compte Alibaba Cloud dispose des autorisations nécessaires pour interroger les ACL des objets. Pour effectuer cette opération via un utilisateur RAM ou le Security Token Service (STS), vous devez détenir l'autorisation oss:GetObjectAcl. Pour plus d'informations, consultez la rubrique Accorder une stratégie personnalisée.

  • Si une requête GetObjectACL est envoyée pour un objet dont l'ACL n'est pas configurée explicitement, OSS renvoie l'ACL par défaut. Dans ce cas, l'ACL de l'objet correspond à celle du bucket qui le contient. Par exemple, si l'ACL du bucket est définie sur private, l'ACL de l'objet est également private.

Syntaxe de la commande

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

Paramètre

Type

Description

--bucket

string

Nom du bucket.

--key

string

Chemin complet de l'objet.

--version-id

string

ID de version de l'objet.

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

  • Pour obtenir la liste des options globales prises en charge, reportez-vous à la section Options de ligne de commande.

Exemples

  • Interrogez l'ACL du bucket examplebucket.

    ossutil api get-object-acl --bucket examplebucket --key exampleobject
  • Récupérez l'ACL du bucket examplebucket et affichez le résultat au format JSON.

    ossutil api get-object-acl --bucket examplebucket --key exampleobject --output-format json
  • Récupérez l'ACL du bucket examplebucket et affichez le résultat au format YAML.

    ossutil api get-object-acl --bucket examplebucket --key exampleobject --output-format yaml