PutBucketQoSInfo - Object Storage Service

Mengonfigurasi aturan pembatasan bandwidth untuk bucket dalam kolam sumber daya.

Catatan penggunaan

QoS kolam sumber daya berada dalam pratinjau undangan. Jika throughput bucket OSS Anda di suatu wilayah telah mencapai atau melebihi 500 Gbit/s, Anda dapat menghubungi dukungan teknis untuk mengajukan fitur ini.
Secara default, Akun Alibaba Cloud memiliki izin untuk mengonfigurasi aturan pembatasan bandwidth untuk bucket dalam kolam sumber daya. Untuk mengonfigurasi aturan tersebut menggunakan Pengguna RAM atau Security Token Service (STS), Anda harus memiliki izin oss:PutBucketQoSInfo. Untuk informasi selengkapnya, lihat Contoh umum kebijakan RAM.

Sintaks

PUT /?qosInfo HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

<?xml version="1.0" encoding="UTF-8"?>
<QoSConfiguration>
  <TotalUploadBandwidth>10</TotalUploadBandwidth>
  <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
  <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
  <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
  <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
  <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
</QoSConfiguration>

Header permintaan

Semua header dalam permintaan PutBucketQoSInfo merupakan header permintaan umum. Untuk informasi selengkapnya, lihat Header permintaan umum.

Elemen permintaan

Catatan

Dalam tabel berikut, nilai default -1 menunjukkan bahwa bandwidth bucket tidak dibatasi. Nilai 0 menunjukkan bahwa tipe bandwidth tersebut tidak didukung. Misalnya, nilai 0 untuk ExtranetUploadBandwidth berarti data tidak dapat diunggah ke bucket yang ditentukan melalui jaringan publik.
Total bandwidth yang ditentukan untuk sebuah bucket tidak boleh melebihi total bandwidth yang ditetapkan untuk kolam sumber daya maupun untuk semua bucket secara keseluruhan. Sebagai contoh, jika total bandwidth unduh semua bucket adalah 100 Gbit/s, maka bandwidth unduh melalui Internet untuk satu bucket tidak boleh melebihi 100 Gbit/s.

Elemen	Tipe	Wajib	Contoh	Deskripsi
QoSConfiguration	Kontainer	Ya	N/A	Kontainer yang menyimpan aturan pembatasan bandwidth. Node induk: none
TotalUploadBandwidth	Integer	Ya	10	Total lebar pita unggah bucket. Satuan: Gbit/s. Node induk: QoSConfiguration
IntranetUploadBandwidth	Integer	Ya	-1	Lebar pita unggah melalui jaringan internal bucket. Jaringan internal mencakup jaringan klasik dan VPC. Satuan: Gbit/s. Node induk: QoSConfiguration
ExtranetUploadBandwidth	Integer	Ya	-1	Lebar pita unggah melalui jaringan publik bucket. Jaringan publik mencakup Internet dan titik akhir percepatan. Satuan: Gbit/s. Node induk: QoSConfiguration
TotalDownloadBandwidth	Integer	Ya	10	Total bandwidth unduh bucket. Satuan: Gbit/s. Node induk: QoSConfiguration
IntranetDownloadBandwidth	Integer	Ya	-1	Bandwidth unduh melalui jaringan internal bucket. Jaringan internal mencakup jaringan klasik dan VPC. Satuan: Gbit/s. Node induk: QoSConfiguration
ExtranetDownloadBandwidth	Integer	Ya	-1	Bandwidth unduh melalui jaringan publik bucket. Jaringan publik mencakup Internet dan titik akhir percepatan. Satuan: Gbit/s. Node induk: QoSConfiguration

Header respons

Semua header dalam respons terhadap permintaan PutBucketQoSInfo merupakan header respons umum. Untuk informasi selengkapnya, lihat Header respons umum.

Contoh

Contoh permintaan

PUT /?qosInfo HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Content-Length: 209
Date: Fri, 27 Dec 2024 03:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

<?xml version="1.0" encoding="UTF-8"?>
<QoSConfiguration>
  <TotalUploadBandwidth>10</TotalUploadBandwidth>
  <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
  <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
  <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
  <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
  <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
</QoSConfiguration>

Contoh respons sukses

HTTP/1.1 200 OK
x-oss-request-id: 534****
Date: Fri, 27 Dec 2024 03:21:12 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

OSS SDK

Anda dapat menggunakan OSS SDK untuk bahasa pemrograman berikut guna memanggil PutBucketQoSInfo:

ossutil

Untuk informasi mengenai perintah ossutil yang sesuai dengan operasi PutBucketQoSInfo, lihat put-bucket-qos-info.