Como funciona o UpdateBucketAntiDDosInfo - Object Storage Service: Central de Documentação do Alibaba Cloud

Atualiza o status de proteção Anti-DDoS de um bucket.

Observações de uso

Por padrão, a conta Alibaba Cloud tem permissão para atualizar o status de proteção Anti-DDoS de um bucket. Para executar essa operação como usuário RAM ou com o Security Token Service (STS), você precisa da permissão oss:UpdateBucketAntiDDosInfo. Para mais informações, consulte Exemplos comuns de políticas do RAM.

Sintaxe da solicitação

POST /?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-status: Init
<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-status	String	Sim	Init	Novo status da instância Anti-DDoS. Valores válidos: Init: especifica o nome de domínio personalizado a proteger. Defending: opcionalmente, especifica o nome de domínio personalizado a proteger. HaltDefending: não requer nome de domínio personalizado. Importante Ao alterar o registro CNAME mapeado para o nome de domínio personalizado, defina este cabeçalho com o status atual da instância Anti-DDoS. Para remover a proteção Anti-DDoS de um bucket, defina este cabeçalho como HaltDefending.
AntiDDOSConfiguration	Container	Não	N/A	Contêiner das configurações da instância Anti-DDoS.
Cnames	Container	Não	N/A	Contêiner da lista de nomes de domínio das instâncias Anti-DDoS.
Domain	String	Não	abc1.example.cn	Nomes de domínio personalizados a proteger. Cada bucket aceita até cinco nomes de domínio personalizados na lista de proteção de uma instância Anti-DDoS.

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

Cabeçalhos da resposta

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

Exemplos

Exemplos de solicitações

POST /?antiDDos 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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
x-oss-defender-instance: cbcac8d2-4f75-4d6d-9f2e-c3447f73****
x-oss-defender-status: Init
<AntiDDOSConfiguration>
  <Cnames>
    <Domain>abc1.example.cn</Domain>
    <Domain>abc2.example.cn</Domain>
  </Cnames>
</AntiDDOSConfiguration>

Exemplos de respostas

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****