Gunakan PutBucketRequesterQoSInfo untuk mengonfigurasi aturan pembatasan kecepatan bagi pengguna yang mengakses bucket dalam kumpulan sumber daya.
Catatan
Fitur QoS Kumpulan Sumber Daya saat ini dalam pratinjau undangan. Jika throughput bucket OSS Anda di suatu wilayah telah mencapai atau melebihi 500 Gbit/s, hubungi dukungan teknis untuk mengajukan fitur ini.
Secara default, akun Alibaba Cloud memiliki izin untuk mengonfigurasi aturan pembatasan kecepatan bagi pengguna yang mengakses bucket. Namun, konfigurasi sebagai pengguna RAM atau menggunakan Security Token Service (STS) memerlukan izin
oss:PutBucketRequesterQoSInfo. Untuk detail lebih lanjut, lihat Contoh kebijakan RAM.
Sintaksis
PUT /?requesterQosInfo&qosRequester=uid
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
<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 PutBucketRequesterQoSInfo adalah header umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.
Parameter permintaan
Dalam tabel berikut, nilai default -1 menunjukkan bahwa bandwidth bucket tidak dibatasi. Nilai 0 menunjukkan bahwa tipe bandwidth tidak didukung. Sebagai contoh, nilai 0 untuk ExtranetUploadBandwidth berarti data tidak dapat diunggah ke bucket tertentu melalui jaringan publik.
Ambang batas bandwidth total yang dikonfigurasi untuk pengguna tidak boleh melebihi bandwidth total yang ditentukan untuk kumpulan sumber daya. Sebagai contoh, jika bandwidth unduhan total semua bucket adalah 100 Gbit/s, bandwidth unduhan melalui Internet untuk pengguna tidak boleh melebihi 100 Gbit/s.
Ambang batas bandwidth untuk setiap item yang ditentukan untuk pengguna tidak boleh kurang dari 5 Gbit/s.
Parameter | Tipe | Wajib | Contoh | Deskripsi |
qosRequester | String | Ya | 300xxxx | ID Pengguna (UID) dari pengguna. Node induk: tidak ada |
QoSConfiguration | Container | Ya | N/A | Container yang menyimpan hasil. Node induk: tidak ada |
TotalUploadBandwidth | Integer | Ya | 10 | Bandwidth unggah total pengguna untuk bucket. Satuan: Gbit/s. Node induk: QoSConfiguration |
IntranetUploadBandwidth | Integer | Ya | -1 | Bandwidth unggah melalui jaringan internal pengguna untuk bucket. Jaringan internal mencakup jaringan klasik dan virtual private cloud (VPC). Satuan: Gbit/s. Node induk: QoSConfiguration |
ExtranetUploadBandwidth | Integer | Ya | -1 | Bandwidth unggah melalui jaringan publik pengguna untuk bucket. Jaringan publik mencakup Internet dan titik akhir akselerasi. Satuan: Gbit/s. Node induk: QoSConfiguration |
TotalDownloadBandwidth | Integer | Ya | 10 | Bandwidth unduhan total pengguna untuk bucket. Satuan: Gbit/s. Node induk: QoSConfiguration |
IntranetDownloadBandwidth | Integer | Ya | -1 | Bandwidth unduhan melalui jaringan internal pengguna untuk bucket. Jaringan internal mencakup jaringan klasik dan VPC. Satuan: Gbit/s. Node induk: QoSConfiguration |
ExtranetDownloadBandwidth | Integer | Ya | -1 | Bandwidth unduhan melalui jaringan publik pengguna untuk bucket. Jaringan publik mencakup Internet dan titik akhir akselerasi. Satuan: Gbit/s. Node induk: QoSConfiguration |
Header respons
Semua header dalam respons terhadap permintaan PutBucketRequesterQoSInfo adalah header umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.
Contoh
Permintaan Contoh
PUT /?requesterQosInfo&qosRequester=300xxxx 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>Respons Contoh
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
SDK OSS
Anda dapat menggunakan SDK OSS untuk bahasa pemrograman berikut untuk memanggil PutBucketRequesterQoSInfo:
ossutil
Untuk informasi tentang perintah ossutil yang sesuai dengan operasi PutBucketRequesterQoSInfo, lihat put-bucket-requester-qos-info.