Interroger la liste de protection Anti-DDoS d'un compartiment en appelant ListBucketAntiDDosInfo - Object Storage Service

Interroge la liste de protection Anti-DDoS d'un compartiment.

Notes d'utilisation

Par défaut, un compte Alibaba Cloud dispose des autorisations nécessaires pour interroger la liste de protection Anti-DDoS d'un compartiment. Pour exécuter cette opération en tant qu'utilisateur RAM ou via Security Token Service (STS), vous devez disposer de l'autorisation oss:ListBucketAntiDDosInfo. Pour plus d'informations, consultez la section Exemples courants de politiques RAM.

Syntaxe de la requête

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

En-têtes de requête

Une requête ListBucketAntiDDosInfo utilise uniquement des en-têtes de requête communs. Pour plus d'informations, consultez la section En-têtes HTTP communs.

Éléments de requête

Élément

Type

Obligatoire

Exemple

Description

marker

String

Non

Nom de l'instance Anti-DDoS à partir duquel la liste commence. Si ce paramètre est spécifié, seules les instances Anti-DDoS dont les noms sont classés alphabétiquement après la valeur marker sont renvoyées.

Remarque

Définissez le paramètre marker sur une chaîne vide pour la première requête. Si IsTruncated est défini sur true dans la réponse, utilisez la valeur marker renvoyée pour la requête suivante.

max-keys

String

Oui

100

Nombre maximal d'instances Anti-DDoS à renvoyer.

Valeurs valides : 1 à 100

Valeur par défaut : 100

Pour plus d'informations sur les en-têtes de requête communs tels que Host et Date, consultez la section En-têtes HTTP communs.

En-têtes de réponse

La réponse à une requête ListBucketAntiDDosInfo utilise uniquement des en-têtes de réponse communs. Pour plus d'informations, consultez la section En-têtes HTTP communs.

Éléments de réponse

Élément	Type	Exemple	Description
AntiDDOSListConfiguration	Container	N/A	Conteneur pour la liste de protection Anti-DDoS d'un compartiment. Nœuds parents : aucun Nœuds enfants : Marker, IsTruncated et AntiDDOSConfiguration
Marker	String	nextMarker	Nom de l'instance Anti-DDoS utilisé comme marqueur de pagination. Nœud parent : AntiDDOSListConfiguration Nœuds enfants : aucun
IsTruncated	String	true	Indique si toutes les instances Anti-DDoS sont renvoyées. true : Toutes les instances Anti-DDoS sont renvoyées. false : Toutes les instances Anti-DDoS ne sont pas renvoyées. Nœud parent : AntiDDOSListConfiguration Nœuds enfants : aucun
AntiDDOSConfiguration	Container	N/A	Conteneur pour les détails de l'instance Anti-DDoS. Nœud parent : AntiDDOSListConfiguration Nœuds enfants : InstanceId, Bucket, Owner, Ctime, Mtime, Status, Type et Cnames
InstanceId	String	cbcac8d2-4f75-4d6d-9f2e-c3447f73****	ID de l'instance Anti-DDoS. Nœuds parents : AntiDDOSConfiguration Nœuds enfants : aucun
Bucket	String	examplebucket	Nom du compartiment associé à l'instance Anti-DDoS. Nœuds parents : AntiDDOSConfiguration Nœuds enfants : aucun
Owner	String	114893010724****	ID du propriétaire du compartiment. Nœuds parents : AntiDDOSConfiguration Nœuds enfants : aucun
Ctime	String	1626769503	Heure de création de l'instance Anti-DDoS. La valeur est un horodatage. Nœuds parents : AntiDDOSConfiguration Nœuds enfants : aucun
Mtime	String	1626769840	Heure de la dernière mise à jour de l'instance Anti-DDoS. La valeur est un horodatage. Nœuds parents : AntiDDOSConfiguration Nœuds enfants : aucun
ActiveTime	String	1626769845	Heure d'activation de l'instance Anti-DDoS. La valeur est un horodatage. Nœuds parents : AntiDDOSConfiguration Nœuds enfants : aucun
Status	String	Defending	Statut de l'instance Anti-DDoS. Init Defending HaltDefending Nœuds parents : AntiDDOSConfiguration Nœuds enfants : aucun
Type	String	AntiDDosPremimum	Type de l'instance Anti-DDoS. Valeur valide : AntiDDosPremimum. Nœuds parents : AntiDDOSConfiguration Nœuds enfants : aucun
Cnames	Container	N/A	Conteneur pour les noms de domaine personnalisés. Nœuds parents : AntiDDOSConfiguration Nœuds enfants : Domain
Domain	String	abc1.example.cn	Noms de domaine personnalisés.

Exemples

Exemple de requête

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

Exemple de réponse

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>