全部产品
Search
文档中心

对象存储 OSS:InitBucketAntiDDosInfo

更新时间:Apr 29, 2024

调用InitBucketAntiDDosInfo接口初始化Bucket防护。

注意事项

阿里云账号默认拥有初始化Bucket防护的权限。如果您希望通过RAM用户或者STS的方式初始化Bucket防护,您必须拥有oss:InitBucketAntiDDosInfo权限。具体操作,请参见为RAM用户授权自定义的权限策略

请求语法

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>

请求头

名称

类型

是否必选

示例值

描述

x-oss-defender-instance

字符串

cbcac8d2-4f75-4d6d-9f2e-c3447f73****

高防实例ID。

x-oss-defender-type

字符串

AntiDDosPremimum

高防实例类型。取值固定为

AntiDDosPremimum。

AntiDDOSConfiguration

容器

不涉及

保存高防实例配置信息的容器。

Cnames

容器

不涉及

保存域名信息列表的容器。

Domain

字符串

abc1.example.cn

填写需要更改的待防护自定义域名。每个Bucket最多支持5个待防护的自定义域名。

此接口涉及的其他公共请求头,例如Host、Date等的更多信息,请参见公共请求头(Common Request Headers)

响应头

此接口仅涉及公共响应头。更多信息,请参见公共响应头(Common Response Headers)

示例

  • 请求示例

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
  • 返回示例

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