GetBucketOverwriteConfig - Object Storage Service

調用GetBucketOverwriteConfig介面擷取儲存空間（Bucket）的不覆蓋寫規則配置。

注意事項

如果Bucket未配置不覆蓋寫規則，則返回404狀態代碼。

許可權說明

阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權，需要阿里雲帳號或帳號管理員通過RAM Policy或Bucket Policy授予操作許可權。

API	Action	說明
GetBucketOverwriteConfig	`oss:GetBucketOverwriteConfig`	擷取Bucket的不覆蓋寫規則配置。

請求文法

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

要求標頭

此介面除支援公用要求標頭外，無特有要求標頭。更多資訊，請參見公用HTTP頭定義。

請求元素

此介面不包含請求元素。

響應元素

名稱	類型	樣本值	描述
OverwriteConfiguration	容器	無	不覆蓋寫規則的根節點。子節點：Rule 父節點：無
Rule	容器	無	不覆蓋寫規則項。子節點：ID、Action、Prefix、Suffix、Principals 父節點：OverwriteConfiguration
ID	字串	rule-001	規則的唯一識別碼。子節點：無父節點：Rule
Action	字串	forbid	操作類型。當前只支援forbid（禁止覆蓋寫）。子節點：無父節點：Rule
Prefix	字串	a/	Object名稱的首碼。子節點：無父節點：Rule
Suffix	字串	.txt	Object名稱的尾碼。子節點：無父節點：Rule
Principals	容器	無	授權主體集合。子節點：Principal 父節點：Rule
Principal	字串	27737962156157xxxx	授權主體。子節點：無父節點：Principals

回應標頭

此介面僅涉及公用回應標頭。更多資訊，請參見公用HTTP頭定義。

樣本

請求樣本

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

返回樣本

成功返回（已配置規則）

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>

這個樣本中展現了部分規則可能的樣式：

Rule1包含指定前尾碼和Principal，表示子使用者27737962156157xxxx被禁止對首碼為a/、尾碼為.txt的Object執行覆蓋寫操作。
Rule2僅指定首碼，表示所有使用者被禁止對首碼為images/的Object執行覆蓋寫操作。
Rule3僅指定尾碼，表示所有使用者被禁止對尾碼為.jpg的Object執行覆蓋寫操作。
Rule4僅指定Principal，表示Principal指定的使用者會被禁止對Bucket中所有的Object執行覆蓋寫操作。
未配置規則返回（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>