调用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****