put-bucket-requester-qos-info - Object Storage Service

Memodifikasi konfigurasi pembatasan bandwidth untuk sebuah bucket.

Catatan penggunaan

Penting

Kualitas layanan (QoS) kolam sumber daya dalam pratinjau undangan. Jika throughput bucket Object Storage Service (OSS) di wilayah tertentu lebih besar dari atau sama dengan 500 Gbit/s, hubungi dukungan teknis untuk mengajukan fitur ini.

Secara default, akun Alibaba Cloud memiliki izin untuk mengonfigurasi pembatasan bandwidth pada sebuah bucket. Untuk mengonfigurasi pembatasan bandwidth menggunakan pengguna RAM atau Security Token Service (STS), Anda memerlukan izin oss:PutBucketRequesterQoSInfo. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.
Konfigurasi setiap item tidak boleh melebihi batas pembatasan bandwidth bucket.
Nilai -1 menunjukkan bahwa tidak ada batasan yang diberlakukan pada bidang tersebut. Jika suatu bidang tidak ditentukan, nilai defaultnya adalah -1. Nilai 0 menunjukkan bahwa jenis permintaan akses tertentu dilarang.
Konfigurasi subitem tidak boleh melebihi konfigurasi total sebuah item. Sebagai contoh, jika total bandwidth unggah diatur menjadi 10 Gbit/s, bandwidth unggah melalui jaringan internal tidak boleh melebihi 10 Gbit/s.
Pembatasan bandwidth peminta tidak boleh kurang dari 5 Gbit/s. Sebagai contoh, bandwidth unggah harus lebih besar dari atau sama dengan 5 Gbit/s.
Sebuah bucket mendukung pembatasan bandwidth hingga 300 pengguna RAM.

Sintaksis

ossutil api invoke-operation --op-name put-bucket-requester-qos-info --method PUT --bucket=<bucket-name> --parameters requesterQosInfo --parameters qosRequester=<uid> --body file://<path-to-xml>

Parameter	Tipe	Deskripsi
--bucket	string	Nama bucket.
--parameters	stringArray	Parameter permintaan dalam format k[=v], seperti versionId=123 dan delete.
--body	string	Badan permintaan. file:// menentukan bahwa konfigurasi dibaca dari file, sedangkan - menentukan bahwa konfigurasi dibaca dari input standar.

--body

Parameter --body mendukung format XML. Jika nilai parameter dimulai dengan file://, konfigurasi akan dimuat dari file tertentu.

<QoSConfiguration>
  <TotalUploadBandwidth>integer</TotalUploadBandwidth>
  <IntranetUploadBandwidth>integer</IntranetUploadBandwidth>
  <ExtranetUploadBandwidth>integer</ExtranetUploadBandwidth>
  <TotalDownloadBandwidth>integer</TotalDownloadBandwidth>
  <IntranetDownloadBandwidth>integer</IntranetDownloadBandwidth>
  <ExtranetDownloadBandwidth>integer</ExtranetDownloadBandwidth>
</QoSConfiguration>

Parameter	Tipe	Diperlukan	Contoh	Satuan	Deskripsi
TotalUploadBandwidth	Integer	Ya	10	Gbps	Total bandwidth untuk permintaan unggah. Node induk: QoSConfiguration
IntranetUploadBandwidth	Integer	Ya	-1	Gbps	Bandwidth unggah melalui jaringan internal. Jaringan internal mencakup jaringan klasik dan virtual private clouds (VPC). Satuan: Gbit/s. Node induk: QoSConfiguration
ExtranetUploadBandwidth	Integer	Ya	-1	Gbps	Bandwidth unggah melalui jaringan eksternal. Jaringan eksternal mencakup Internet dan Content Delivery Network (CDN). Node induk: QoSConfiguration
TotalDownloadBandwidth	Integer	Ya	10	Gbps	Total bandwidth untuk permintaan unduhan. Node induk: QoSConfiguration
IntranetDownloadBandwidth	Integer	Ya	-1	Gbps	Bandwidth unduhan melalui jaringan internal. Jaringan internal mencakup jaringan klasik dan VPC. Satuan: Gbit/s. Node induk: QoSConfiguration
ExtranetDownloadBandwidth	Integer	Ya	-1	Gbps	Bandwidth unduhan melalui jaringan eksternal. Jaringan eksternal mencakup Internet dan CDN. Node induk: QoSConfiguration

Catatan

Untuk informasi lebih lanjut tentang opsi baris perintah global yang didukung, lihat Opsi Baris Perintah Global.

Contoh

Tambahkan konfigurasi QoS ke peminta dengan ID 202835923910178018 di bucket bernama examplebucket dengan membuat file konfigurasi XML bernama qos.xml dan menambahkan kode sampel berikut ke file konfigurasi:

<QoSConfiguration>
  <TotalUploadBandwidth>10</TotalUploadBandwidth>
  <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
  <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
  <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
  <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
  <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
</QoSConfiguration>

Berikut adalah deskripsi parameter:

Parameter TotalUploadBandwidth diatur ke 10, yang menunjukkan bahwa total bandwidth unggah adalah 10 Gbit/s. Total bandwidth unggah melalui jaringan internal dan publik tidak boleh melebihi 10 Gbit/s.
Parameter IntranetUploadBandwidth diatur ke -1, yang menunjukkan bahwa tidak ada batasan yang diberlakukan pada bandwidth unggah melalui jaringan internal. Namun, bandwidth unggah melalui jaringan internal harus kurang dari atau sama dengan total bandwidth unggah, yaitu 10 Gbit/s.
Parameter ExtranetUploadBandwidth diatur ke -1, yang menunjukkan bahwa tidak ada batasan yang diberlakukan pada bandwidth unggah melalui jaringan publik. Namun, bandwidth unggah melalui jaringan publik harus kurang dari atau sama dengan total bandwidth unggah, yaitu 10 Gbit/s.
Parameter TotalDownloadBandwidth diatur ke 10, yang menunjukkan bahwa total bandwidth unduhan adalah 10 Gbit/s. Total bandwidth unduhan melalui jaringan internal dan publik tidak boleh melebihi 10 Gbit/s.
Parameter IntranetDownloadBandwidth diatur ke -1, yang menunjukkan bahwa tidak ada batasan yang diberlakukan pada bandwidth unduhan melalui jaringan internal. Namun, bandwidth unduhan melalui jaringan internal harus kurang dari atau sama dengan total bandwidth unduhan, yaitu 10 Gbit/s.
Parameter ExtranetDownloadBandwidth diatur ke -1, yang menunjukkan bahwa tidak ada batasan yang diberlakukan pada bandwidth unduhan melalui jaringan publik. Namun, bandwidth unduhan melalui jaringan publik harus kurang dari atau sama dengan total bandwidth unduhan, yaitu 10 Gbit/s.

Perintah sampel:

ossutil api invoke-operation --op-name put-bucket-requester-qos-info --method PUT --bucket=examplebucket --parameters requesterQosInfo --parameters qosRequester=202835923910178018 --body file://qos.xml