全部產品
Search
文件中心

Object Storage Service:UpdateBucketAntiDDosInfo

更新時間:Jun 19, 2024

調用UpdateBucketAntiDDosInfo介面更新Bucket防護狀態。

注意事項

阿里雲帳號預設擁有更新Bucket防護狀態的許可權。如果您希望通過RAM使用者或者STS的方式更新Bucket防護狀態,您必須擁有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

字串

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

高防執行個體ID。

x-oss-defender-status

字串

Init

更新高防執行個體狀態。取值如下:

  • Init:初始化防護狀態。該狀態下需要傳入待防護的自訂網域名。

  • Defending:防護中狀態。該狀態下可以選擇是否傳入待防護的自訂網域名。

  • HaltDefending:解除防護狀態。該狀態下不需要傳入待防護的自訂網域名。

重要
  • 如果您只修改綁定的Cname,則該欄位取值必須和當前高防執行個體狀態相同。

  • 如果您希望解除Bucket和高防的綁定關係,則該欄位取值必須為HaltDefending。

AntiDDOSConfiguration

容器

不涉及

儲存高防執行個體配置資訊的容器。

Cnames

容器

不涉及

儲存網域名稱資訊列表的容器。

Domain

字串

abc1.example.cn

填寫需要更改的待防護自訂網域名。每個Bucket最多支援5個待防護的自訂網域名。

此介面涉及的其他公用要求標頭,例如Host、Date等的更多資訊,請參見公用要求標頭(Common Request Headers)

回應標頭

此介面僅涉及公用回應標頭。更多資訊,請參見公用回應標頭(Common Response Headers)

樣本

  • 請求樣本

POST /?antiDDos HTTP/1.1
Date:  Fri, 04 Mar 2022 05:34:24 GMT
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************
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****