Updates the status of Anti-DDoS instances of a bucket.
Usage notes
By default, an Alibaba Cloud account has the permissions to update the status of Anti-DDoS instances of a bucket. To update the status of Anti-DDoS instances of a bucket by using a RAM user or Security Token Service (STS), you must have the oss:UpdateBucketAntiDDosInfo
permission. For more information, see Common examples of RAM policies.
Request syntax
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>
Request headers
Header | Type | Required | Example | Description |
x-oss-defender-instance | String | Yes | cbcac8d2-4f75-4d6d-9f2e-c3447f73**** | The ID of the Anti-DDoS instance. |
x-oss-defender-status | String | Yes | Init | The new status of the Anti-DDoS instance. Valid values:
Important
|
AntiDDOSConfiguration | Container | No | N/A | The container that stores the configurations of Anti-DDoS instances. |
Cnames | Container | No | N/A | The container that stores the list of domain names of Anti-DDoS instances. |
Domain | String | No | abc1.example.cn | The custom domain names that you want to protect. You can add up to five custom domain names for each bucket to the protection list of an Anti-DDoS instance. |
For more information about other common request headers that are included in an UpdateBucketAntiDDosInfo request, such as Host and Date, see Common HTTP headers.
Response headers
All headers in the response to an UpdateBucketAntiDDosInfo request are common response headers. For more information, see Common HTTP headers.
Examples
Sample requests
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>
Sample responses
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****