調用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 | 更新高防執行個體狀態。取值如下:
重要
|
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****