調用ListBucketAntiDDosInfo接口獲取Bucket防護信息列表。
注意事項
阿里云賬號默認擁有獲取Bucket防護信息列表的權限。如果您希望通過RAM用戶或者STS的方式獲取Bucket防護信息列表，您必須擁有oss:ListBucketAntiDDosInfo權限。具體操作，請參見為RAM用戶授權自定義的權限策略。
請求語法
GET /?bucketAntiDDos?marker=&max-keys=100 HTTP/1.1
Date: GMT Date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue請求頭
此接口僅涉及公共請求頭。更多信息，請參見公共請求頭（Common Request Headers）。
請求元素
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
marker | 字符串 | 否 | 設定從marker之后按字母排序開始返回高防實例。 說明 第一次請求時可以將marker設置為空字符串。如果返回結果中IsTruncated存在且為true，則需要將返回結果中的marker字段作為參數進行下一次請求。 | |
max-keys | 字符串 | 是 | 100 | 指定返回的高防實例最大數量。 取值：[1,100] 默認值：100 |
此接口涉及的其他公共請求頭，例如Host、Date等的更多信息，請參見公共請求頭（Common Request Headers）。
響應頭
此接口僅涉及公共響應頭。更多信息，請參見公共響應頭（Common Response Headers）。
響應元素
名稱 | 類型 | 示例值 | 描述 |
AntiDDOSListConfiguration | 容器 | 不涉及 | 保存Bucket防護信息列表的容器。、 父節點：無 子節點：Marker、IsTruncated、AntiDDOSConfiguration |
Marker | 字符串 | nextMarker | 返回字母排序在指定marker之后的高防實例。 父節點：AntiDDOSListConfiguration 子節點：無 |
IsTruncated | 字符串 | true | 是否已返回所有高防實例。
父節點：AntiDDOSListConfiguration 子節點：無 |
AntiDDOSConfiguration | 容器 | 不涉及 | 保存高防實例信息的容器。 父節點：AntiDDOSListConfiguration 子節點：InstanceId、Bucket、Owner、Ctime、Mtime、Status、Type、Cnames |
InstanceId | 字符串 | cbcac8d2-4f75-4d6d-9f2e-c3447f73**** | 高防實例ID。 父節點：AntiDDOSConfiguration 子節點：無 |
Bucket | 字符串 | examplebucket | 防護的Bucket名稱。 父節點：AntiDDOSConfiguration 子節點：無 |
Owner | 字符串 | 114893010724**** | Bucket擁有者的UID。 父節點：AntiDDOSConfiguration 子節點：無 |
Ctime | 字符串 | 1626769503 | 高防實例創建時間，格式為時間戳。 父節點：AntiDDOSConfiguration 子節點：無 |
Mtime | 字符串 | 1626769840 | 高防實例更新時間，格式為時間戳。 父節點：AntiDDOSConfiguration 子節點：無 |
ActiveTime | 字符串 | 1626769845 | 高防實例激活時間，格式為時間戳。 父節點：AntiDDOSConfiguration 子節點：無 |
Status | 字符串 | Defending | 高防實例所處狀態。
父節點：AntiDDOSConfiguration 子節點：無 |
Type | 字符串 | AntiDDosPremimum | 高防實例類型。固定值為AntiDDosPremimum。 父節點：AntiDDOSConfiguration 子節點：無 |
Cnames | 容器 | 保存自定義域名的容器。 父節點：AntiDDOSConfiguration 子節點：Domain | |
Domain | 字符串 | abc1.example.cn | 自定義域名。 |
示例
請求示例
GET /?bucketAntiDDos?marker=&max-keys=100 HTTP/1.1
Date: Fri, 04 Mar 2022 05:34:24 GMT
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************返回示例
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****
<?xml version="1.0" encoding="utf-8"?>
<AntiDDOSListConfiguration>
<Marker>nextMarker</Marker>
<IsTruncated>true</IsTruncated>
<AntiDDOSConfiguration>
<InstanceId>cbcac8d2-4f75-4d6d-9f2e-c3447f73****</InstanceId>
<Owner>114893010724****</Owner>
<Bucket>examplebucket</Bucket>
<Ctime>1626769503</Ctime>
<Mtime>1626769840</Mtime>
<ActiveTime>1626769845</ActiveTime>
<Status>Defending</Status>
<Type>AntiDDosPremimum</Type>
<Cnames>
<Domain>abc1.example.cn</Domain>
<Domain>abc2.example.cn</Domain>
</Cnames>
</AntiDDOSConfiguration>
<AntiDDOSConfiguration>
<InstanceId>cbcae8u6-4f75-4d6d-9f2e-c3446g89****</InstanceId>
<Owner>1148930107246818</Owner>
<Bucket>test-antiddos2</Bucket>
<Ctime>1626769993</Ctime>
<Mtime>1626769993</Mtime>
<ActiveTime>0</ActiveTime>
<Status>Init</Status>
<Type>AntiDDosPremimum</Type>
<Cnames>
<Domain>abc3.example.cn</Domain>
<Domain>abc4.example.cn</Domain>
</Cnames>
</AntiDDOSConfiguration>
</AntiDDOSListConfiguration>