Object Storage Service:GetBucketOverwriteConfig

Notes

Si aucune règle de remplacement n'est configurée pour le bucket, l'opération renvoie un code d'état 404.

Permissions

Par défaut, les comptes Alibaba Cloud disposent de toutes les autorisations. Les utilisateurs RAM et les rôles RAM ne disposent d'aucune autorisation par défaut. Le propriétaire du compte Alibaba Cloud ou un administrateur doit accorder des autorisations à l'aide d'une politique RAM ou d'une politique de bucket.

Syntaxe de la requête

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

En-têtes de requête

Cette opération utilise uniquement des en-têtes de requête communs. Pour plus d'informations, consultez la section En-têtes de requête communs.

Éléments de requête

Cette opération ne contient aucun élément de requête.

Éléments de réponse

En-têtes de réponse

Cette opération utilise uniquement des en-têtes de réponse communs. Pour plus d'informations, consultez la section En-têtes de réponse communs.

Exemples

• Exemple de requête

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

• Exemples de réponses

  • Réponse réussie (des règles sont configurées)

  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>

  L'exemple de réponse suivant illustre plusieurs formats de règles :

  • La règle 1 spécifie un préfixe, un suffixe et une entité principale. Elle interdit à l'utilisateur RAM 27737962156157xxxx de remplacer les objets dont le préfixe est a/ et le suffixe .txt.

  • La règle 2 spécifie uniquement un préfixe. Elle interdit à tous les utilisateurs de remplacer les objets dont le préfixe est images/.

  • La règle 3 spécifie uniquement un suffixe. Elle interdit à tous les utilisateurs de remplacer les objets dont le suffixe est .jpg.

  • La règle 4 spécifie uniquement une entité principale. Elle interdit à l'utilisateur spécifié de remplacer n'importe quel objet dans le bucket.

  • Réponse lorsque aucune règle n'est configurée (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>