Initializes Anti-DDoS instances for a bucket.
Usage notes
By default, an Alibaba Cloud account has the permissions to initialize Anti-DDoS instances for a bucket. To initialize Anti-DDoS instances for a bucket by using a RAM user or Security Token Service (STS), you must have the oss:InitBucketAntiDDosInfo
permission. For more information, see Common examples of RAM policies.
Request syntax
PUT /?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-type: AntiDDosPremimum
<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-type | String | Yes | AntiDDosPremimum | The type of the Anti-DDoS instance. Set the value to AntiDDosPremimum. |
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. |
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 InitBucketAntiDDosInfo request, such as Host and Date, see Common HTTP headers.
Response headers
All headers in the response to an InitBucketAntiDDosInfo request are common response headers. For more information about common response headers, see Common HTTP headers.
Examples
Sample request
PUT /?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-type: AntiDDosPremimum
Sample success response
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****
x-oss-defender-instance: cbcac8d2-4f75-4d6d-9f2e-c3447f73****
x-oss-server-time: 130