全部產品
Search
文件中心

Object Storage Service:ListBucketAntiDDosInfo

更新時間:Jun 19, 2024

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