GetBucketOverwriteConfig - Object Storage Service - Alibaba Cloud ドキュメントセンター

GetBucketOverwriteConfig 操作を呼び出して、バケットの上書き構成を取得します。

注意事項

バケットに上書き構成がない場合、この操作は 404 状態コードを返します。

権限

デフォルトでは、Alibaba Cloud アカウントはすべての権限を持ちます。 Resource Access Management (RAM) ユーザーおよび RAM ロールは、デフォルトでは権限を持ちません。 Alibaba Cloud アカウントのオーナーまたは管理者は、RAM ポリシーまたはバケットポリシーを使用して権限を付与する必要があります。

API	Action	説明
GetBucketOverwriteConfig	`oss:GetBucketOverwriteConfig`	バケットの上書き構成を取得します。

リクエスト構文

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

リクエストヘッダー

この操作は、共通リクエストヘッダーのみを使用します。詳細については、「共通リクエストヘッダー」をご参照ください。

リクエスト要素

この操作にはリクエスト要素は含まれていません。

応答要素

名前	タイプ	例	説明
OverwriteConfiguration	コンテナ	なし	ルールのルートノードは上書きできません。子ノード: ルール親ノード: なし
Rule	コンテナ	なし	上書きルール。子ノード： ID、Action、Prefix、Suffix、Principals 親ノード： OverwriteConfiguration
ID	文字列	rule-001	ルールの一意の識別子。子ノード：なし親ノード： Rule
Action	文字列	forbid	操作タイプ。 `forbid` のみがサポートされています。 `forbid` はオブジェクトが上書きされるのを防ぎます。子ノード：なし親ノード： Rule
Prefix	文字列	a/	オブジェクト名のプレフィックス。子ノード：なし親ノード： Rule
Suffix	文字列	.txt	オブジェクト名のサフィックス。子ノード：なし親ノード： Rule
Principals	コンテナ	なし	認可されたエンティティのコレクション。子ノード： Principal 親ノード： Rule
Principal	文字列	27737962156157xxxx	認可されたエンティティ。子ノード：なし親ノード： Principals

応答ヘッダー

この操作は、共通応答ヘッダーのみを使用します。詳細については、「共通応答ヘッダー」をご参照ください。

例

リクエスト例

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>

この例では、いくつかの可能なルールフォーマットを示します：

ルール 1 には、指定されたプレフィックス、サフィックス、およびプリンシパルが含まれています。このルールは、RAM ユーザー 27737962156157xxxx がプレフィックス `a/` とサフィックス `.txt` を持つオブジェクトを上書きすることを禁止します。
ルール 2 はプレフィックスのみを指定します。このルールは、すべてのユーザーがプレフィックス `images/` を持つオブジェクトを上書きすることを禁止します。
ルール 3 はサフィックスのみを指定します。このルールは、すべてのユーザーがサフィックス `.jpg` を持つオブジェクトを上書きすることを禁止します。
ルール 4 はプリンシパルのみを指定します。このルールは、指定されたユーザーがバケット内のオブジェクトを上書きすることを禁止します。
ルールが構成されていない場合の応答 (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>