ListBucketAntiDDosInfo でバケットの Anti-DDoS 保護リストをクエリ - OSS

バケットの Anti-DDoS インスタンスの対策リストをクエリします。

使用方法

デフォルトでは、Alibaba Cloud アカウントには、バケットの Anti-DDoS インスタンスの対策リストをクエリする権限があります。 RAM ユーザーまたは Security Token Service ( STS ) を使用してバケットの Anti-DDoS インスタンスの対策リストをクエリするには、oss:ListBucketAntiDDosInfo 権限が必要です。詳細については、「RAM ポリシーの一般的な例」をご参照ください。

リクエスト構文

GET /?bucketAntiDDos?marker=&max-keys=100 HTTP/1.1
Date:  GMT 日付
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

リクエストヘッダー

ListBucketAntiDDosInfo リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。詳細については、「共通の HTTP ヘッダー」をご参照ください。

リクエスト要素

要素

タイプ

必須

例

説明

marker

文字列

いいえ

リストの開始後に続く Anti-DDoS インスタンスの名前。この要素が指定されている場合、名前がマーカー値のアルファベット順になっている Anti-DDoS インスタンスが返されます。

説明

最初のリクエストでは、マーカーを空の文字列に設定できます。レスポンスで IsTruncated 要素の値が true の場合、レスポンスのマーカー値を使用して次のリクエストを実行する必要があります。

max-keys

文字列

はい

100

返される Anti-DDoS インスタンスの最大数。

有効な値：1 ～ 100

デフォルト値：100

Host や Date など、ListBucketAntiDDosInfo リクエストに含まれるその他の共通リクエストヘッダーについては、「共通の HTTP ヘッダー」をご参照ください。

レスポンスヘッダー

ListBucketAntiDDosInfo リクエストへのレスポンスのすべてのヘッダーは、共通のレスポンスヘッダーです。詳細については、「共通の HTTP ヘッダー」をご参照ください。

レスポンス要素

要素	タイプ	例	説明
AntiDDOSListConfiguration	コンテナー	N/A	バケットの Anti-DDoS インスタンスの対策リストを格納するコンテナー。親ノード：なし子ノード：Marker、IsTruncated、AntiDDOSConfiguration
Marker	文字列	nextMarker	指定されたマーカーのアルファベット順になっている Anti-DDoS インスタンス。親ノード：AntiDDOSListConfiguration 子ノード：なし
IsTruncated	文字列	true	すべての Anti-DDoS インスタンスが返されるかどうかを示します。 true：すべての Anti-DDoS インスタンスが返されます。 false：すべての Anti-DDoS インスタンスが返されるわけではありません。親ノード：AntiDDOSListConfiguration 子ノード：なし
AntiDDOSConfiguration	コンテナー	N/A	Anti-DDoS インスタンスに関する情報を格納するコンテナー。親ノード：AntiDDOSListConfiguration 子ノード：InstanceId、Bucket、Owner、Ctime、Mtime、Status、Type、Cnames
InstanceId	文字列	cbcac8d2-4f75-4d6d-9f2e-c3447f73****	Anti-DDoS インスタンスの ID。親ノード：AntiDDOSConfiguration 子ノード：なし
Bucket	文字列	examplebucket	Anti-DDoS インスタンスが作成されるバケットの名前。親ノード：AntiDDOSConfiguration 子ノード：なし
Owner	文字列	114893010724****	バケットオーナーの ID。親ノード：AntiDDOSConfiguration 子ノード：なし
Ctime	文字列	1626769503	Anti-DDoS インスタンスが作成された時刻。値はタイムスタンプです。親ノード：AntiDDOSConfiguration 子ノード：なし
Mtime	文字列	1626769840	Anti-DDoS インスタンスが最後に更新された時刻。値はタイムスタンプです。親ノード：AntiDDOSConfiguration 子ノード：なし
ActiveTime	文字列	1626769845	Anti-DDoS インスタンスがアクティブ化された時刻。値はタイムスタンプです。親ノード：AntiDDOSConfiguration 子ノード：なし
Status	文字列	Defending	Anti-DDoS インスタンスのステータス。 Init Defending HaltDefending 親ノード：AntiDDOSConfiguration 子ノード：なし
Type	文字列	AntiDDosPremimum	Anti-DDoS インスタンスのタイプ。この要素の値は AntiDDosPremimum です。親ノード：AntiDDOSConfiguration 子ノード：なし
Cnames	コンテナー	N/A	カスタムドメイン名を格納するコンテナー。親ノード：AntiDDOSConfiguration 子ノード：Domain
Domain	文字列	abc1.example.cn	カスタムドメイン名。

例

リクエストの例

GET /?bucketAntiDDos?marker=&max-keys=100 HTTP/1.1
Date: Thu, 17 Apr 2025 05:34:24 GMT
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218

レスポンスの例

HTTP/1.1 200 OK
Server: AliyunOSS
Date: Thu, 17 Apr 2025 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>