put-bucket-qos-info - Object Storage Service

Mengonfigurasi informasi Quality of Service (QoS) untuk sebuah bucket.

Catatan penggunaan

Penting

Fitur QoS kolam sumber daya dalam pratinjau undangan. Jika throughput bucket Object Storage Service (OSS) di wilayah tertentu mencapai atau melebihi 500 Gbit/s, hubungi dukungan teknis untuk mengajukan fitur tersebut.

Secara default, akun Alibaba Cloud memiliki izin untuk mengonfigurasi informasi QoS untuk sebuah bucket. Untuk menggunakan Pengguna Resource Access Management (RAM) atau Security Token Service (STS), Anda memerlukan izin oss:PutBucketQoSInfo. Untuk detail lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.
Anda hanya dapat mengonfigurasi pembatasan bandwidth untuk bucket yang ditambahkan ke kolam sumber daya. Ambang batas bandwidth setiap item konfigurasi untuk sebuah bucket tidak boleh melebihi ambang batas bandwidth kolam sumber daya tempat bucket tersebut berada.
Nilai -1 menunjukkan bahwa tidak ada batasan yang diberlakukan pada bidang tersebut. Jika sebuah bidang tidak ditentukan, nilai defaultnya adalah -1. Nilai 0 menunjukkan bahwa jenis permintaan akses tertentu dilarang.
Bandwidth subitem tidak boleh melebihi total bandwidth item. Sebagai contoh, jika total bandwidth unggah diatur menjadi 10 Gbit/s, bandwidth unggah melalui jaringan internal tidak boleh melebihi 10 Gbit/s.

Sintaksis

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

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>

Tabel berikut menjelaskan parameter yang diperlukan dalam file konfigurasi.

Parameter	Tipe	Diperlukan	Contoh	Satuan	Deskripsi
TotalUploadBandwidth	Integer	Ya	10	Gbit/s	Total bandwidth unggah. Node induk: QoSConfiguration.
IntranetUploadBandwidth	Integer	Ya	-1	Gbit/s	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	Gbit/s	Bandwidth unggah melalui jaringan eksternal. Jaringan eksternal mencakup Internet dan Content Delivery Network (CDN) Alibaba Cloud. Node induk: QoSConfiguration.
TotalDownloadBandwidth	Integer	Ya	10	Gbit/s	Total bandwidth unduh. Node induk: QoSConfiguration.
IntranetDownloadBandwidth	Integer	Ya	-1	Gbit/s	Bandwidth unduh melalui jaringan internal. Jaringan internal mencakup jaringan klasik dan VPC. Satuan: Gbit/s. Node induk: QoSConfiguration.
ExtranetDownloadBandwidth	Integer	Ya	-1	Gbit/s	Bandwidth unduh melalui jaringan eksternal. Jaringan eksternal mencakup Internet dan CDN. Node induk: QoSConfiguration.

Catatan

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

Contoh

Tambahkan konfigurasi QoS ke bucket bernama examplebucket dengan membuat file konfigurasi XML bernama qos.xml dan menambahkan kode contoh 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 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.

Contoh perintah:

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