調用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>