バケットの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インスタンスが返されるかどうかを示します。
親ノード: 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インスタンスのステータス。
親ノード: AntiDDOSConfiguration 子ノード: なし |
データ型 | String | AntiDDosPremimum | Anti-DDoSインスタンスのタイプ。 この要素の値はAntiDDosPremimumです。 親ノード: AntiDDOSConfiguration 子ノード: なし |
Cnames | Container | カスタムドメイン名を格納するコンテナー。 親ノード: 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>