PutBucketAcl - Set bucket ACL - Object Storage Service: Central de Documentação do Alibaba Cloud

Observações de uso

Ao chamar a operação PutBucketAcl, observe os seguintes pontos:

Você deve ter permissões de gravação no bucket.
A operação PutBucketAcl usa semântica de sobrescrita. A nova ACL substitui a existente.
Se o bucket especificado não existir, o sistema criará um novo bucket.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões totais. Usuários RAM ou funções RAM vinculados a uma conta Alibaba Cloud não têm permissões por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de políticas do RAM ou Bucket Policy.

Estrutura da solicitação

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

Cabeçalhos da solicitação

Cabeçalho

Tipo

Obrigatório

Valor de exemplo

Descrição

x-oss-acl

String

Sim

private

ACL a ser definida para o bucket.

Se este cabeçalho for omitido, as configurações de ACL não entrarão em vigor.

Valores válidos: public-read-write, public-read e private

public-read-write: Todos os usuários, incluindo anônimos, podem ler e gravar objetos no bucket. Use com cautela.
public-read: Apenas o proprietário do bucket ou usuários autorizados podem gravar objetos. Outros usuários, inclusive anônimos, têm permissão apenas para leitura. Use com cautela.
private: Somente o proprietário do bucket ou usuários autorizados podem ler e gravar objetos. Demais usuários, incluindo anônimos, não acessam os objetos sem autorização.

Para consultar os cabeçalhos comuns incluídos nas solicitações PutBucketAcl, consulte Cabeçalhos comuns de solicitação.

Cabeçalhos da resposta

A resposta a uma solicitação PutBucketAcl contém apenas cabeçalhos comuns. Para mais detalhes, consulte Cabeçalhos comuns de resposta.

Exemplos

Exemplo de solicitação

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

Exemplo de resposta

Resposta de sucesso

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

Resposta para configurações de ACL inválidas

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>

SDKs do OSS

Use os seguintes SDKs do OSS para chamar a operação PutBucketAcl:

ossutil

Para obter informações sobre o comando do ossutil correspondente à operação PutBucketAcl, consulte put-bucket-acl.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
AccessDenied	403	A solicitação não contém informações de autenticação do usuário. Você não tem permissão para executar esta operação.

API	Ação	Descrição
PutBucketAcl	oss:PutBucketAcl	Configura ou modifica a ACL de um bucket.