Todos los productos
Search
Centro de documentos

Object Storage Service:put-object-acl

Última actualización: Sep 25, 2026

El comando put-object-acl sirve para establecer o modificar la lista de control de acceso (ACL) de un objeto.

Notas de uso

  • De forma predeterminada, una cuenta de Alibaba Cloud tiene los permisos necesarios para establecer la ACL de un objeto. Si configura la ACL como usuario de RAM o mediante Security Token Service (STS), requiere el permiso oss:PutObjectAcl. Para más información, consulte Grant a custom policy.

    Solo el propietario del bucket con permisos de lectura y escritura sobre los objetos almacenados en él puede invocar esta operación para modificar las ACL del objeto.

  • La ACL de un objeto tiene prioridad sobre la ACL del bucket donde se almacena. Por ejemplo, si un objeto con ACL public-read-write se guarda en un bucket con ACL private, todos los usuarios pueden leer y escribir dicho objeto.

Sintaxis del comando

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

Parámetro

Tipo

Descripción

--bucket

string

Nombre del bucket.

--key

string

Ruta completa del objeto.

--object-acl

string

ACL del objeto. Valores válidos:

  • private

  • public-read

  • public-read-write

  • default (el objeto hereda la ACL del bucket).

--version-id

string

ID de versión del objeto.

Nota
  • El comando put-object-acl corresponde a la operación PutObjectACL. Para más información sobre los parámetros de esta operación, consulte PutObjectACL.

  • Para más información sobre las opciones globales de línea de comandos compatibles, consulte Command-line options.

Ejemplo

Establezca la ACL de examplebucket como private.

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