Consulte a lista de proteção Anti-DDoS de um bucket chamando ListBucketAntiDDosInfo - Object Storage Service: Central de Documentação do Alibaba Cloud

Consulta a lista de proteção Anti-DDoS de um bucket.

Observações de uso

Por padrão, uma conta Alibaba Cloud tem permissão para consultar a lista de proteção Anti-DDoS de um bucket. Para executar essa operação como usuário RAM ou usando o Security Token Service (STS), é necessário ter a permissão oss:ListBucketAntiDDosInfo. Para mais informações, consulte Exemplos comuns de políticas RAM.

Sintaxe da solicitação

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

Cabeçalhos da solicitação

Uma solicitação ListBucketAntiDDosInfo utiliza apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Cabeçalhos HTTP comuns.

Elementos da solicitação

Elemento

Tipo

Obrigatório

Exemplo

Descrição

marker

String

Não

Nome da instância Anti-DDoS a partir da qual a lista começa. Se especificado, a resposta retorna apenas as instâncias Anti-DDoS cujos nomes vêm depois do valor do marker em ordem alfabética.

Nota

Defina o marker como uma string vazia na primeira solicitação. Se IsTruncated for true na resposta, use o valor de marker retornado na próxima solicitação.

max-keys

String

Sim

100

Número máximo de instâncias Anti-DDoS a retornar.

Valores válidos: 1 a 100

Valor padrão: 100

Para mais detalhes sobre cabeçalhos de solicitação comuns, como Host e Date, consulte Cabeçalhos HTTP comuns.

Cabeçalhos da resposta

A resposta de uma solicitação ListBucketAntiDDosInfo usa apenas cabeçalhos de resposta comuns. Para mais informações, consulte Cabeçalhos HTTP comuns.

Elementos da resposta

Elemento	Tipo	Exemplo	Descrição
AntiDDOSListConfiguration	Container	N/A	Contêiner da lista de proteção Anti-DDoS de um bucket. Nós pai: nenhum Nós filho: Marker, IsTruncated e AntiDDOSConfiguration
Marker	String	nextMarker	Nome da instância Anti-DDoS usado como marcador de paginação. Nó pai: AntiDDOSListConfiguration Nós filho: nenhum
IsTruncated	String	true	Indica se todas as instâncias Anti-DDoS foram retornadas. true: Todas as instâncias Anti-DDoS foram retornadas. false: Nem todas as instâncias Anti-DDoS foram retornadas. Nó pai: AntiDDOSListConfiguration Nós filho: nenhum
AntiDDOSConfiguration	Container	N/A	Contêiner com os detalhes da instância Anti-DDoS. Nó pai: AntiDDOSListConfiguration Nós filho: InstanceId, Bucket, Owner, Ctime, Mtime, Status, Type e Cnames
InstanceId	String	cbcac8d2-4f75-4d6d-9f2e-c3447f73****	ID da instância Anti-DDoS. Nós pai: AntiDDOSConfiguration Nós filho: nenhum
Bucket	String	examplebucket	Nome do bucket associado à instância Anti-DDoS. Nós pai: AntiDDOSConfiguration Nós filho: nenhum
Owner	String	114893010724****	ID do proprietário do bucket. Nós pai: AntiDDOSConfiguration Nós filho: nenhum
Ctime	String	1626769503	Horário de criação da instância Anti-DDoS. O valor é um timestamp. Nós pai: AntiDDOSConfiguration Nós filho: nenhum
Mtime	String	1626769840	Horário da última atualização da instância Anti-DDoS. O valor é um timestamp. Nós pai: AntiDDOSConfiguration Nós filho: nenhum
ActiveTime	String	1626769845	Horário de ativação da instância Anti-DDoS. O valor é um timestamp. Nós pai: AntiDDOSConfiguration Nós filho: nenhum
Status	String	Defending	Status da instância Anti-DDoS. Init Defending HaltDefending Nós pai: AntiDDOSConfiguration Nós filho: nenhum
Type	String	AntiDDosPremimum	Tipo da instância Anti-DDoS. Valor válido: AntiDDosPremimum. Nós pai: AntiDDOSConfiguration Nós filho: nenhum
Cnames	Container	N/A	Contêiner dos nomes de domínio personalizados. Nós pai: AntiDDOSConfiguration Nós filho: Domain
Domain	String	abc1.example.cn	Nomes de domínio personalizados.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas

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>