put-resource-pool-requester-qos-info - Object Storage Service

Konfigurasikan pembatasan bandwidth untuk pengguna RAM di dalam resource pool.

Catatan

Penting

Kualitas layanan (QoS) resource pool saat ini dalam versi 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 bagi pengguna RAM di dalam resource pool. Untuk mengonfigurasi pembatasan bandwidth menggunakan pengguna RAM lain atau Security Token Service (STS), Anda memerlukan izin oss:PutResourcePoolRequesterQoSInfo. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.
Konfigurasi setiap item tidak boleh melebihi batasan 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 requester 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 untuk hingga 300 pengguna RAM.

Sintaksis

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

Parameter	Tipe	Deskripsi
--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 unggah. Node induk: QoSConfiguration
IntranetUploadBandwidth	Integer	Ya	-1	Gbps	Bandwidth unggah melalui jaringan internal. Jaringan internal mencakup jaringan klasik dan VPC. Satuan: Gbit/s. Node induk: QoSConfiguration
ExtranetUploadBandwidth	Integer	Ya	-1	Gbps	Bandwidth unggah melalui jaringan eksternal. Jaringan eksternal mencakup Internet dan CDN. Node induk: QoSConfiguration
TotalDownloadBandwidth	Integer	Ya	10	Gbps	Total bandwidth unduh. Node induk: QoSConfiguration
IntranetDownloadBandwidth	Integer	Ya	-1	Gbps	Bandwidth unduh melalui jaringan internal. Jaringan internal mencakup jaringan klasik dan VPC. Satuan: Gbit/s. Node induk: QoSConfiguration
ExtranetDownloadBandwidth	Integer	Ya	-1	Gbps	Bandwidth unduh 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 requester dengan ID 202835923910178019 di dalam resource pool bernama examplePool dengan membuat file konfigurasi XML bernama qos.xml dan menambahkan kode sampel berikut ke dalam file konfigurasi:

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

Berikut ini penjelasan parameter:

Parameter TotalUploadBandwidth disetel 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 disetel 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 disetel 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 disetel ke 10, yang menunjukkan bahwa total bandwidth unduh adalah 10 Gbit/s. Total bandwidth unduh melalui jaringan internal dan publik tidak boleh melebihi 10 Gbit/s.
Parameter IntranetDownloadBandwidth disetel ke -1, yang menunjukkan bahwa tidak ada batasan yang diberlakukan pada bandwidth unduh melalui jaringan internal. Namun, bandwidth unduh melalui jaringan internal harus kurang dari atau sama dengan total bandwidth unduh yaitu 10 Gbit/s.
Parameter ExtranetDownloadBandwidth disetel ke -1, yang menunjukkan bahwa tidak ada batasan yang diberlakukan pada bandwidth unduh melalui jaringan publik. Namun, bandwidth unduh melalui jaringan publik harus kurang dari atau sama dengan total bandwidth unduh yaitu 10 Gbit/s.

Perintah sampel:

ossutil api invoke-operation --op-name put-resource-pool-requester-qos-info --method PUT --parameters resourcePool=examplePool --parameters qosRequester=202835923910178019 --parameters requesterQosInfo --body=file://qos.xml