使用UpdateBucketAntiDDosInfo更新Bucket防护状态-对象存储-阿里云

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