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

Object Storage Service:UpdateBucketAntiDDosInfo

最終更新日:Jun 09, 2025

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

使用方法

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

リクエスト構文

POST /?antiDDos HTTP/1.1
Date:  GMT Date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
x-oss-defender-instance: cbcac8d2-4f75-4d6d-9f2e-c3447f73****
x-oss-defender-status: Init
<AntiDDOSConfiguration>
  <Cnames>
    <Domain>abc1.example.cn</Domain>
    <Domain>abc2.example.cn</Domain>
  </Cnames>
</AntiDDOSConfiguration>

リクエストヘッダー

ヘッダー

タイプ

必須

説明

x-oss-defender-instance

String

はい

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

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

x-oss-defender-status

String

はい

Init

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

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

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

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

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

  • バケットが Anti-DDoS インスタンスによって保護されないようにするには、このヘッダーを HaltDefending に設定します。

AntiDDOSConfiguration

コンテナー

いいえ

該当なし

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

Cnames

コンテナー

いいえ

該当なし

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

Domain

String

いいえ

abc1.example.cn

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

Host や Date など、UpdateBucketAntiDDosInfo リクエストに含まれるその他の一般的なリクエストヘッダーについては、「共通の HTTP ヘッダー」をご参照ください。

レスポンスヘッダー

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

  • リクエストの例

POST /?antiDDos HTTP/1.1
Date: Thu, 17 Apr 2025 05:34:24 GMT
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
x-oss-defender-instance: cbcac8d2-4f75-4d6d-9f2e-c3447f73****
x-oss-defender-status: Init
<AntiDDOSConfiguration>
  <Cnames>
    <Domain>abc1.example.cn</Domain>
    <Domain>abc2.example.cn</Domain>
  </Cnames>
</AntiDDOSConfiguration>
  • レスポンスの例

HTTP/1.1 200 OK
Server: AliyunOSS
Date: Fri, 04 Mar 2022 05:34:24 GMT
Content-Length: 0
Connection: keep-alive
x-oss-request-id: 534B371674E88A4D8906****