All Products
Search

This Product

    Object Storage Service:Initializes Anti-DDoS instances for a bucket

    Document Center

    Object Storage Service:Initializes Anti-DDoS instances for a bucket

    Last Updated:Jun 26, 2026

    You can call the InitBucketAntiDDosInfo operation to initialize Anti-DDoS protection for a bucket.

    Usage notes

    An Alibaba Cloud account has the permissions to perform this operation by default. To perform this operation by using a RAM user or Security Token Service (STS), you must have the oss:InitBucketAntiDDosInfo permission. For more information, see grant a custom policy.

    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 for Anti-DDoS instance configurations.

    Cnames

    Container

    No

    N/A

    The container for domain names.

    Domain

    String

    No

    abc1.example.cn

    The custom domain names to protect. You can add up to five custom domain names per bucket to the protection list of an Anti-DDoS instance.

    For more information about common request headers included in this request, such as Host and Date, see Common HTTP headers.

    Response headers

    The response to an InitBucketAntiDDosInfo request contains only common response headers. For more information, see Common HTTP headers.

    Examples

    • Sample request

    PUT /?antiDDos HTTP/1.1
Date: Thu, 17 Apr 2025 05:34:24 GMT
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
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