ListBucketAntiDDosInfo - Object Storage Service

調用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	是否已返回所有高防執行個體。 true：本次請求未返回所有高防執行個體。 false：本次請求已返回所有高防執行個體。父節點：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	高防執行個體所處狀態。 Init：初始化防護狀態。 Defending：防護中狀態。 HaltDefending：解除防護狀態。父節點：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>