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

Obtiene la configuración de sobrescritura de un bucket.

Notas

Si no hay reglas de sobrescritura configuradas para el bucket, la operación devuelve un código de estado 404.

Permisos

De forma predeterminada, las cuentas de Alibaba Cloud tienen todos los permisos. Los usuarios y roles de Resource Access Management (RAM) no tienen permisos de forma predeterminada. El propietario de la cuenta de Alibaba Cloud o un administrador debe otorgar los permisos mediante una RAM policy o una bucket policy.

API	Acción	Descripción
GetBucketOverwriteConfig	`oss:GetBucketOverwriteConfig`	Obtiene la configuración de sobrescritura de un bucket.

Sintaxis de la solicitud

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

Encabezados de la solicitud

Esta operación utiliza únicamente encabezados de solicitud comunes. Para más información, consulte Common request headers.

Elementos de la solicitud

Esta operación no contiene elementos de solicitud.

Elementos de la respuesta

Nombre	Tipo	Ejemplo	Descripción
OverwriteConfiguration	Contenedor	Ninguna	Nodo raíz de la configuración de sobrescritura. Nodo secundario: Rule. Nodo principal: Ninguno.
Rule	Contenedor	Ninguna	Regla de sobrescritura. Nodos secundarios: ID, Action, Prefix, Suffix y Principals. Nodo principal: OverwriteConfiguration.
ID	Cadena	rule-001	Identificador único de la regla. Nodo secundario: Ninguno. Nodo principal: Rule.
Action	Cadena	forbid	Acción por ejecutar. Solo se admite `forbid`, que impide la sobrescritura de objetos. Nodo secundario: Ninguno. Nodo principal: Rule.
Prefix	Cadena	a/	Prefijo del nombre del objeto. Nodo secundario: Ninguno. Nodo principal: Rule.
Suffix	Cadena	.txt	Sufijo del nombre del objeto. Nodo secundario: Ninguno. Nodo principal: Rule.
Principals	Contenedor	Ninguna	Conjunto de entidades autorizadas. Nodo secundario: Principal. Nodo principal: Rule.
Principal	Cadena	27737962156157xxxx	Entidad autorizada. Nodo secundario: Ninguno. Nodo principal: Principals.

Encabezados de la respuesta

Esta operación utiliza únicamente encabezados de respuesta comunes. Para más información, consulte Common request headers.

Ejemplos

Ejemplo de solicitud

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

Ejemplos de respuesta

Respuesta exitosa (reglas 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>

La siguiente respuesta de ejemplo muestra varios formatos de reglas:

La regla 1 especifica un prefijo, un sufijo y un principal. Prohíbe al usuario de RAM 27737962156157xxxx sobrescribir objetos con el prefijo a/ y el sufijo .txt.
La regla 2 especifica solo un prefijo. Prohíbe a todos los usuarios sobrescribir objetos con el prefijo images/.
La regla 3 especifica solo un sufijo. Prohíbe a todos los usuarios sobrescribir objetos con el sufijo .jpg.
La regla 4 especifica solo un principal. Prohíbe al usuario indicado sobrescribir cualquier objeto del bucket.
Respuesta cuando no hay reglas configuradas (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>