Todos os produtos
Search
Central de documentação

Object Storage Service:Inicializa instâncias Anti-DDoS para um bucket

Última atualização: Jul 08, 2026

Use a operação InitBucketAntiDDosInfo para inicializar a proteção Anti-DDoS de um bucket.

Observações de uso

Por padrão, uma conta Alibaba Cloud tem permissão para executar esta operação. Para executá-la com um usuário RAM ou Security Token Service (STS), você precisa da permissão oss:InitBucketAntiDDosInfo. Para mais informações, consulte conceder uma política personalizada.

Sintaxe da solicitação

PUT /?antiDDos HTTP/1.1
Date:  GMT Date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
x-oss-defender-instance: cbcac8d2-4f75-4d6d-9f2e-c3447f73****
x-oss-defender-type: AntiDDosPremimum
<AntiDDOSConfiguration>
  <Cnames>
    <Domain>abc1.example.cn</Domain>
    <Domain>abc2.example.cn</Domain>
  </Cnames>
</AntiDDOSConfiguration>

Cabeçalhos da solicitação

Cabeçalho

Tipo

Obrigatório

Exemplo

Descrição

x-oss-defender-instance

String

Sim

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

ID da instância Anti-DDoS.

x-oss-defender-type

String

Sim

AntiDDosPremimum

Tipo da instância Anti-DDoS. Defina o valor como

AntiDDosPremimum.

AntiDDOSConfiguration

Container

Não

N/A

Contêiner das configurações da instância Anti-DDoS.

Cnames

Container

Não

N/A

Contêiner dos nomes de domínio.

Domain

String

Não

abc1.example.cn

Nomes de domínio personalizados a proteger. Adicione até cinco nomes de domínio personalizados por bucket à lista de proteção de uma instância Anti-DDoS.

Para obter mais informações sobre cabeçalhos comuns incluídos nesta solicitação, como Host e Date, consulte Cabeçalhos HTTP comuns.

Cabeçalhos da resposta

A resposta à solicitação InitBucketAntiDDosInfo contém apenas cabeçalhos de resposta comuns. Para obter mais informações, consulte Cabeçalhos HTTP comuns.

Exemplos

  • Exemplo de solicitação

PUT /?antiDDos HTTP/1.1
Date: Thu, 17 Apr 2025 05:34:24 GMT
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
x-oss-defender-instance: cbcac8d2-4f75-4d6d-9f2e-c3447f73****
x-oss-defender-type: AntiDDosPremimum
  • Exemplo de resposta de sucesso

HTTP/1.1 200 OK
Server: AliyunOSS
Date: Fri, 04 Mar 2022 05:34:24 GMT
Content-Length: 0
Connection: keep-alive
x-oss-request-id: 534B371674E88A4D8906****
x-oss-defender-instance: cbcac8d2-4f75-4d6d-9f2e-c3447f73****
x-oss-server-time: 130