GetBucketOverwriteConfig - Object Storage Service: Central de Documentação do Alibaba Cloud

Observações

Se não houver regras de sobrescrita configuradas para o bucket, a operação retornará o código de status 404.

Permissões

Por padrão, as contas Alibaba Cloud têm todas as permissões. Usuários e funções do Resource Access Management (RAM) não possuem permissões por padrão. O proprietário da conta Alibaba Cloud ou um administrador deve conceder permissões usando uma política do RAM ou uma política de bucket.

API	Action	Descrição
GetBucketOverwriteConfig	`oss:GetBucketOverwriteConfig`	Recupera a configuração de sobrescrita de um bucket.

Sintaxe da solicitação

GET /?overwriteConfig HTTP/1.1
Host: bucket-name.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

Cabeçalhos da solicitação

Esta operação usa apenas cabeçalhos de solicitação comuns. Para obter mais informações, consulte Cabeçalhos de solicitação comuns.

Elementos da solicitação

Esta operação não contém elementos de solicitação.

Elementos da resposta

Nome	Tipo	Exemplo	Descrição
OverwriteConfiguration	Container	None	Nó raiz da configuração de sobrescrita. Nó filho: Rule. Nó pai: None.
Rule	Container	None	Regra de sobrescrita. Nós filhos: ID, Action, Prefix, Suffix e Principals. Nó pai: OverwriteConfiguration.
ID	String	rule-001	Identificador exclusivo da regra. Nó filho: None. Nó pai: Rule.
Action	String	forbid	Ação a executar. Apenas `forbid` é compatível; isso impede a sobrescrita de objetos. Nó filho: None. Nó pai: Rule.
Prefix	String	a/	Prefixo do nome do objeto. Nó filho: None. Nó pai: Rule.
Suffix	String	.txt	Sufixo do nome do objeto. Nó filho: None. Nó pai: Rule.
Principals	Container	None	Conjunto de entidades autorizadas. Nó filho: Principal. Nó pai: Rule.
Principal	String	27737962156157xxxx	Entidade autorizada. Nó filho: None. Nó pai: Principals.

Cabeçalhos da resposta

Esta operação usa apenas cabeçalhos de resposta comuns. Para obter mais informações, consulte Cabeçalhos de solicitação comuns.

Exemplos

Exemplo de solicitação

GET /?overwriteConfig HTTP/1.1
Host: bucket-name.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

Exemplos de resposta

Resposta bem-sucedida (regras configuradas)

HTTP/1.1 200 OK
x-oss-request-id: 5C4E5B5C5E5F5A5B5C5D5E5F
Date: Mon, 25 Nov 2024 15:00:59 GMT
Content-Type: application/xml
Content-Length: 512

<?xml version="1.0" encoding="UTF-8"?>
<OverwriteConfiguration>
  <Rule>
    <ID>rule-001</ID>
    <Action>forbid</Action>
    <Prefix>a/</Prefix>
    <Suffix>.txt</Suffix>
    <Principals>
      <Principal>27737962156157xxxx</Principal>
    </Principals>
  </Rule>
  <Rule>
    <ID>rule-002</ID>
    <Action>forbid</Action>
    <Prefix>images/</Prefix>
    <Suffix/>
    <Principals/>
  </Rule>
  <Rule>
    <ID>rule-003</ID>
    <Action>forbid</Action>
    <Prefix/>
    <Suffix>.jpg</Suffix>
    <Principals/>
  </Rule>
  <Rule>
    <ID>rule-004</ID>
    <Action>forbid</Action>
    <Prefix/>
    <Suffix/>
    <Principals>
      <Principal>27737962156157xxxx</Principal>
    </Principals>
  </Rule>
</OverwriteConfiguration>

O exemplo de resposta a seguir mostra vários formatos de regra:

A Regra 1 especifica prefixo, sufixo e principal. Ela proíbe o usuário RAM 27737962156157xxxx de sobrescrever objetos com o prefixo a/ e o sufixo .txt.
A Regra 2 especifica apenas um prefixo. Ela proíbe todos os usuários de sobrescrever objetos com o prefixo images/.
A Regra 3 especifica apenas um sufixo. Ela proíbe todos os usuários de sobrescrever objetos com o sufixo .jpg.
A Regra 4 especifica apenas um principal. Ela proíbe o usuário especificado de sobrescrever qualquer objeto no bucket.
Resposta quando nenhuma regra está configurada (404)

HTTP/1.1 404 Not Found
x-oss-request-id: 5C4E5B5C5E5F5A5B5C5XXXX
Date: Mon, 25 Nov 2025 15:00:59 GMT
Content-Type: application/xml
Content-Length: 200

<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>NoSuchOverwriteConfiguration</Code>
  <Message>The specified overwrite configuration does not exist.</Message>
  <RequestId>5C4E5B5C5E5F5A5B5C5XXXX</RequestId>
  <HostId>bucket-name.oss-cn-hangzhou.aliyuncs.com</HostId>
</Error>