すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:ListBucketAntiDDosInfo

最終更新日:Feb 22, 2024

バケットの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
日付: GMT日付
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
権限付与: SignatureValue 

リクエストヘッダー

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

リクエスト要素

要素

データ型

必須

説明

marker

String

任意

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

説明

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

max-keys

String

必須

100

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

有効値:1~100 。

デフォルト値:100

ListBucketAntiDDosInfoリクエストに含まれるその他の一般的なリクエストヘッダー (ホストや日付など) の詳細については、「一般的なHTTPヘッダー」をご参照ください。

レスポンスヘッダー

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

レスポンス要素

要素

データ型

説明

AntiDDOSListConfiguration

Container

N/A

バケットのAnti-DDoSインスタンスの保護リストを格納するコンテナー。

親ノード: なし

子ノード: マーカー、IsTruncated、およびAntiDDOSConfiguration

Marker

String

nextMarker

指定されたマーカーの後に名前がアルファベット順に表示されるAnti-DDoSインスタンス。

親ノード: AntiDDOSListConfiguration

子ノード: なし

IsTruncated

String

true

すべてのAnti-DDoSインスタンスが返されるかどうかを示します。

  • true: すべてのAnti-DDoSインスタンスが返されます。

  • false: すべてのAnti-DDoSインスタンスが返されるわけではありません。

親ノード: AntiDDOSListConfiguration

子ノード: なし

AntiDDOSConfiguration

Container

N/A

Anti-DDoSインスタンスに関する情報を格納するコンテナー。

親ノード: AntiDDOSListConfiguration

子ノード: InstanceId、Bucket、Owner、Ctime、Mtime、Status、Type、Cnames

InstanceId

String

cbcac8d2-4f75-4d6d-9f2e-c3447f73 ****

Anti-DDoSインスタンスのID。

親ノード: AntiDDOSConfiguration

子ノード: なし

バケット

String

examplebucket

Anti-DDoSインスタンスが作成されるバケットの名前。

親ノード: AntiDDOSConfiguration

子ノード: なし

Owner

String

114893010724 ****

バケット所有者のID。

親ノード: AntiDDOSConfiguration

子ノード: なし

Ctime

String

1626769503

Anti-DDoSインスタンスが作成された時刻。 値はタイムスタンプです。

親ノード: AntiDDOSConfiguration

子ノード: なし

Mtime

String

1626769840

Anti-DDoSインスタンスが最後に更新された時刻。 値はタイムスタンプです。

親ノード: AntiDDOSConfiguration

子ノード: なし

ActiveTime

String

1626769845

Anti-DDoSインスタンスが有効化された時刻。 値はタイムスタンプです。

親ノード: AntiDDOSConfiguration

子ノード: なし

Status

String

防御

Anti-DDoSインスタンスのステータス。

  • イニット

  • 防御

  • HaltDefending

親ノード: AntiDDOSConfiguration

子ノード: なし

データ型

String

AntiDDosPremimum

Anti-DDoSインスタンスのタイプ。 この要素の値はAntiDDosPremimumです。

親ノード: AntiDDOSConfiguration

子ノード: なし

Cnames

Container

N/A

カスタムドメイン名を格納するコンテナー。

親ノード: AntiDDOSConfiguration

子ノード: ドメイン

ドメイン

String

abc1.example.cn

カスタムドメイン名。

  • リクエストの例

GET /?bucketAntiDDos?marker=&max-keys=100 HTTP/1.1
日付: 3月4日金曜日2022 05:34:24 GMT
ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
権限付与: OSS qn6qrrqxo2oawuk53otf ****:ceOEyZavKY4QcjoUWYSpYbJ3 **** 
  • レスポンスの例

HTTP/1.1 200 OK
サーバー: AliyunOSS
日付: 3月4日金曜日2022 05:34:24 GMT
コンテンツ長: 0
接続: キープアライブ
x-oss-request-id: 534B371674E88A4D8906 ****
<?xml version="1.0" encoding="utf-8"?>

<AntiDDOSListConfiguration> 
  <マーカー> nextMarker</Marker>
  <IsTruncated>true</IsTruncated>
  <AntiDDOSConfiguration>      
    <InstanceId>cbcac8d2-4f75-4d6d-9f2e-c3447f73 ****</InstanceId>  
    <所有者> 114893010724 ****</所有者>  
    <Bucket>examplebucket</Bucket>  
    <Ctime>1626769503</Ctime>  
    <Mtime>1626769840</Mtime>  
    <ActiveTime>1626769845</ActiveTime>  
    <ステータス> 防御 </ステータス>  
    <タイプ> AntiDDosPremimum</タイプ>  
    <Cnames> 
      <ドメイン> abc1.example.cn</ドメイン>  
      <ドメイン> abc2.example.cn</ドメイン> 
    </Cnames> 
  </AntiDDOSConfiguration>  
  <AntiDDOSConfiguration>      
    <InstanceId>cbcae8u6-4f75-4d6d-9f2e-c3446g89 ****</InstanceId>  
    <Owner>1148930107246818</Owner>  
    <バケット> test-antiddos2</バケット>  
    <Ctime>1626769993</Ctime>  
    <Mtime>1626769993</Mtime>  
    <ActiveTime>0</ActiveTime>  
    <ステータス> 初期化 </ステータス>  
    <タイプ> AntiDDosPremimum</タイプ>  
    <Cnames> 
      <ドメイン> abc3.example.cn</ドメイン>  
      <ドメイン> abc4.example.cn</ドメイン> 
    </Cnames> 
  </AntiDDOSConfiguration>
</AntiDDOSListConfiguration>