PutBucketAcl - Object Storage Service - Centro de documentación de Alibaba Cloud

Configura o modifica la lista de control de acceso (ACL) de un bucket.

Notas de uso

Cuando llame a la operación PutBucketAcl, tenga en cuenta lo siguiente:

Debe contar con permisos de escritura sobre el bucket.
PutBucketAcl utiliza una semántica de sobrescritura. La nueva ACL reemplaza a la existente.
Si el bucket especificado no existe, se crea uno nuevo.

Permisos

De forma predeterminada, una cuenta de Alibaba Cloud tiene todos los permisos. Los usuarios y roles de RAM asociados a una cuenta de Alibaba Cloud no cuentan con ningún permiso de manera predeterminada. La cuenta de Alibaba Cloud o su administrador deben otorgar los permisos de operación mediante RAM policies o Bucket Policy.

API	Action	Descripción
PutBucketAcl	oss:PutBucketAcl	Configura o modifica la ACL de un bucket.

Estructura de la solicitud

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

Encabezados de la solicitud

Encabezado

Tipo

Obligatorio

Valor de ejemplo

Descripción

x-oss-acl

String

Sí

private

La ACL que se va a establecer para el bucket.

Si se omite este encabezado, la configuración de la ACL no surte efecto.

Valores válidos: public-read-write, public-read y private.

public-read-write: todos los usuarios, incluidos los anónimos, pueden leer y escribir objetos en el bucket. Utilice esta opción con precaución.
public-read: solo el propietario del bucket o los usuarios autorizados pueden escribir objetos. El resto de los usuarios, incluidos los anónimos, únicamente puede leerlos. Utilice esta opción con precaución.
private: solo el propietario del bucket o los usuarios autorizados pueden leer y escribir objetos. Ningún otro usuario, ni siquiera los anónimos, puede acceder a los objetos sin autorización.

Para conocer los encabezados comunes de las solicitudes PutBucketAcl, consulte Common request headers.

Encabezados de la respuesta

La respuesta a una solicitud PutBucketAcl contiene únicamente encabezados de respuesta comunes. Para obtener más información, consulte Common response headers.

Ejemplos

Ejemplo de solicitud

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

Ejemplo de respuesta

Ejemplo de respuesta exitosa

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

Ejemplo de respuesta cuando la configuración de la ACL no es válida

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 de OSS

Llame a PutBucketAcl con los siguientes SDK de OSS:

ossutil

Para conocer el comando de ossutil correspondiente a la operación PutBucketAcl, consulte put-bucket-acl.

Códigos de error

Código de error	Código de estado HTTP	Descripción
AccessDenied	403	Falta la información de autenticación del usuario en la solicitud. No cuenta con los permisos necesarios para ejecutar esta operación.