全部产品
Search
文档中心

Object Storage Service:Cara kerja UpdateBucketAntiDDosInfo

更新时间:Jun 26, 2025

Memperbarui status instansi Anti-DDoS dari sebuah bucket.

Catatan penggunaan

Secara default, akun Alibaba Cloud memiliki izin untuk memperbarui status instansi Anti-DDoS dari sebuah bucket. Untuk memperbarui status tersebut menggunakan RAM user atau Security Token Service (STS), Anda harus memiliki izin oss:UpdateBucketAntiDDosInfo. Untuk informasi lebih lanjut, lihat Contoh Umum Kebijakan RAM.

Sintaks permintaan

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>

Header permintaan

Header

Tipe

Diperlukan

Contoh

Deskripsi

x-oss-defender-instance

String

Ya

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

ID dari instansi Anti-DDoS.

x-oss-defender-status

String

Ya

Init

Status baru dari instansi Anti-DDoS. Nilai yang valid:

  • Init: Anda harus menentukan nama domain kustom yang ingin dilindungi.

  • Defending: Anda dapat memilih apakah akan menentukan nama domain kustom yang ingin dilindungi.

  • HaltDefending: Anda tidak perlu menentukan nama domain kustom yang ingin dilindungi.

Penting
  • Jika Anda mengubah rekaman CNAME yang dipetakan ke nama domain kustom, nilai header ini harus berupa status dari instansi Anti-DDoS.

  • Jika Anda tidak ingin bucket dilindungi oleh instansi Anti-DDoS, atur header ini ke HaltDefending.

AntiDDOSConfiguration

Container

Tidak

N/A

Kontainer yang menyimpan konfigurasi instansi Anti-DDoS.

Cnames

Container

Tidak

N/A

Kontainer yang menyimpan daftar nama domain dari instansi Anti-DDoS.

Domain

String

Tidak

abc1.example.cn

Nama domain kustom yang ingin dilindungi. Anda dapat menambahkan hingga lima nama domain kustom untuk setiap bucket ke dalam daftar perlindungan instansi Anti-DDoS.

Untuk informasi lebih lanjut tentang header permintaan umum lainnya yang termasuk dalam permintaan UpdateBucketAntiDDosInfo, seperti Host dan Date, lihat Header HTTP Umum.

Header respons

Semua header dalam respons terhadap permintaan UpdateBucketAntiDDosInfo adalah header respons umum. Untuk informasi lebih lanjut, lihat Header HTTP Umum.

Contoh

  • Contoh Permintaan

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>
  • Contoh Respons

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