すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:UpdateBucketAntiDDosInfo

最終更新日:Feb 22, 2024

バケットのAnti-DDoSインスタンスのステータスを更新します。

使用上の注意

デフォルトでは、Alibaba Cloudアカウントには、バケットのAnti-DDoSインスタンスのステータスを更新する権限があります。 RAMユーザーまたはSecurity Token Service (STS) を使用してバケットのAnti-DDoSインスタンスのステータスを更新するには、oss:UpdateBucketAntiDDosInfo権限が必要です。 詳細については、「RAMポリシーの一般的な例」をご参照ください。

リクエスト構文

POST /?antiDDos HTTP/1.1
日付: GMT日付
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
権限付与: SignatureValue
x-oss-defender-instance: cbcac8d2-4f75-4d6d-9f2e-c3447f73 ****
x-oss-defender-status: Init
<AntiDDOSConfiguration>
  <Cnames>
    <ドメイン> abc1.example.cn</ドメイン>
    <ドメイン> abc2.example.cn</ドメイン>
  </Cnames>
</AntiDDOSConfiguration> 

リクエストヘッダー

ヘッダー

データ型

必須

説明

x-oss-defender-instance

String

必須

cbcac8d2-4f75-4d6d-9f2e-c3447f73 ****

Anti-DDoSインスタンスのID。

x-oss-defender-status

String

必須

イニット

Anti-DDoSインスタンスの新しいステータス。 有効な値:

  • Init: 保護するカスタムドメイン名を指定する必要があります。

  • 防御: 保護するカスタムドメイン名を指定するかどうかを選択できます。

  • HaltDefending: 保護するカスタムドメイン名を指定する必要はありません。

重要
  • カスタムドメイン名にマップされているCNAMEレコードを変更する場合、このヘッダーの値はAnti-DDoSインスタンスのステータスである必要があります。

  • Anti-DDoSインスタンスでバケットを保護したくない場合は、このヘッダーをHaltDefendingに設定します。

AntiDDOSConfiguration

Container

任意

N/A

Anti-DDoSインスタンスの設定を格納するコンテナー。

Cnames

Container

任意

N/A

Anti-DDoSインスタンスのドメイン名のリストを格納するコンテナー。

ドメイン

String

任意

abc1.example.cn

保護するカスタムドメイン名。 Anti-DDoSインスタンスの保護リストには、バケットごとに最大5つのカスタムドメイン名を追加できます。

UpdateBucketAntiDDosInfoリクエストに含まれるその他の一般的なリクエストヘッダー (ホストや日付など) の詳細については、「一般的なHTTPヘッダー」をご参照ください。

レスポンスヘッダー

UpdateBucketAntiDDosInfoリクエストに対するレスポンスのすべてのヘッダーは、共通のレスポンスヘッダーです。 詳細については、「共通HTTPヘッダー」をご参照ください。

  • リクエストの例

POST /?antiDDos HTTP/1.1
日付: 3月4日金曜日2022 05:34:24 GMT
ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
権限付与: OSS qn6qrrqxo2oawuk53otf ****:ceOEyZavKY4QcjoUWYSpYbJ3 ****
x-oss-defender-instance: cbcac8d2-4f75-4d6d-9f2e-c3447f73 ****
x-oss-defender-status: Init
<AntiDDOSConfiguration>
  <Cnames>
    <ドメイン> abc1.example.cn</ドメイン>
    <ドメイン> abc2.example.cn</ドメイン>
  </Cnames>
</AntiDDOSConfiguration> 
  • レスポンスの例

HTTP/1.1 200 OK
サーバー: AliyunOSS
日付: 3月4日金曜日2022 05:34:24 GMT
コンテンツ長: 0
接続: キープアライブ
x-oss-request-id: 534B371674E88A4D8906 ****