Ubah konfigurasi prioritas dan Quality of Service (QoS) untuk bucket dan kelompok bucket dalam resource pool OSS. Hal ini memastikan bahwa komitmen bandwidth minimum dan aturan prioritas sesuai dengan batas resource pool. - Object Storage Service

Panggil operasi PutResourcePoolPriorityQosConfiguration untuk mengubah konfigurasi prioritas dan Quality of Service (QoS) untuk bucket dan kelompok bucket dalam sebuah resource pool.

Perhatian

Jumlah level prioritas harus berada dalam rentang 3 hingga 10.
Level prioritas dimulai dari 1, dengan angka yang lebih tinggi menunjukkan prioritas yang lebih tinggi.
Jika Anda tidak mengonfigurasi komitmen bandwidth minimum default (DefaultGuaranteedQosConfiguration), Anda harus menetapkan komitmen tersebut untuk setiap level prioritas. Jika nilai default telah dikonfigurasi, level prioritas yang tidak memiliki komitmen spesifik akan menggunakan nilai default tersebut.
Jumlah total item komitmen bandwidth minimum (misalnya, TotalUploadBandwidth) di semua level prioritas tidak boleh melebihi nilai item yang sesuai dalam resource pool.
Komitmen bandwidth minimum untuk suatu level prioritas hanya dapat diatur ke -1 jika nilai item yang sesuai dalam resource pool juga -1.
Jika suatu bucket dan kelompok bucket-nya memiliki konfigurasi prioritas yang berbeda, konfigurasi prioritas dari kelompok bucket akan diutamakan.

Sintaks permintaan

PUT /?priorityQos&resourcePool=ResourcePoolName
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Type: application/xml
Content-Length: content length

Elemen permintaan

Name	Type	Parameter Position	Description
resourcePool	string	Query	Nama resource pool target.
PriorityQosConfiguration	container	Body	Kontainer untuk konfigurasi pembatasan prioritas kolam sumber daya. Parent node: None
PriorityCount	Integer	-	Jumlah level prioritas. Nilai yang valid: 3 hingga 10. Parent node: PriorityQosConfiguration
DefaultPriorityLevel	Integer	-	Tingkat prioritas default. Nilai yang valid: 1 hingga PriorityCount. Parent node: PriorityQosConfiguration
DefaultGuaranteedQosConfiguration	container	-	Komitmen bandwidth minimum default. Jika node ini tidak dikonfigurasi, Anda harus mengonfigurasi komitmen bandwidth minimum untuk setiap level prioritas. Jika node ini dikonfigurasi, level prioritas tanpa komitmen spesifik akan menggunakan nilai default ini. Parent node: PriorityQosConfiguration
QosPriorityLevelConfiguration	container	-	Container untuk konfigurasi pembatasan suatu level prioritas tertentu. Parent node: PriorityQosConfiguration
PriorityLevel	Integer	-	Tingkat prioritas. Nilai yang valid: 1 hingga PriorityCount. Parent node: QosPriorityLevelConfiguration
GuaranteedQosConfiguration	container	-	Container untuk komitmen bandwidth minimum pada level prioritas tertentu. Parent node: QosPriorityLevelConfiguration
TotalUploadBandwidth	Integer	-	Komitmen bandwidth unggah minimum total. Satuan: Gbps. Parent node: DefaultGuaranteedQosConfiguration atau GuaranteedQosConfiguration
IntranetUploadBandwidth	Integer	-	Komitmen bandwidth unggah minimum untuk jaringan internal. Satuan: Gbps. Ini mencakup permintaan dari jaringan internal seperti classic network dan VPC. Parent node: DefaultGuaranteedQosConfiguration atau GuaranteedQosConfiguration
ExtranetUploadBandwidth	Integer	-	Komitmen bandwidth unggah minimum untuk jaringan publik. Satuan: Gbps. Ini mencakup permintaan dari jaringan publik seperti Internet dan CDN. Parent node: DefaultGuaranteedQosConfiguration atau GuaranteedQosConfiguration
TotalDownloadBandwidth	Integer	-	Komitmen bandwidth unduh minimum total. Satuan: Gbps. Parent node: DefaultGuaranteedQosConfiguration atau GuaranteedQosConfiguration
IntranetDownloadBandwidth	Integer	-	Komitmen bandwidth unduh minimum untuk jaringan internal. Satuan: Gbps. Ini mencakup permintaan dari jaringan internal seperti classic network dan VPC. Parent node: DefaultGuaranteedQosConfiguration atau GuaranteedQosConfiguration
ExtranetDownloadBandwidth	Integer	-	Komitmen bandwidth unduh minimum untuk jaringan publik. Satuan: Gbps. Ini mencakup permintaan dari jaringan publik seperti Internet dan CDN. Parent node: DefaultGuaranteedQosConfiguration atau GuaranteedQosConfiguration
Subjects	container	-	Kontainer untuk objek pembatasan. Objek pembatasan mencakup bucket dan kelompok bucket. Parent node: QosPriorityLevelConfiguration
Bucket	string	-	Nama bucket. Parent node: Subjects
BucketGroup	string	-	Nama kelompok bucket. Parent node: Subjects

Contoh

Contoh permintaan

PUT /?priorityQos&resourcePool=ResoucePoolName
Host: oss-cn-shanghai.aliyuncs.com
Date: Fri, 10 Oct 2025 07:38:42 GMT
Content-Type: application/xml
Content-Length: content length

<PriorityQosConfiguration>
  <PriorityCount>4</PriorityCount>
  <DefaultPriorityLevel>3</DefaultPriorityLevel>
  <DefaultGuaranteedQosConfiguration>
    <TotalUploadBandwidth>10</TotalUploadBandwidth>
    <IntranetUploadBandwidth>20</IntranetUploadBandwidth>
    <ExtranetUploadBandwidth>30</ExtranetUploadBandwidth>
    <TotalDownloadBandwidth>40</TotalDownloadBandwidth>
    <IntranetDownloadBandwidth>50</IntranetDownloadBandwidth>
    <ExtranetDownloadBandwidth>60</ExtranetDownloadBandwidth>
  </DefaultGuaranteedQosConfiguration>
  <QosPriorityLevelConfiguration>
    <PriorityLevel>1</PriorityLevel>
    <GuaranteedQosConfiguration>
      <TotalUploadBandwidth>20</TotalUploadBandwidth>
      <ToTalDownloadBandwidth>20</ToTalDownloadBandwidth>
      <ExtranetUploadBandwidth>10</ExtranetUploadBandwidth>
      <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
      <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth>
      <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth>
    </GuaranteedQosConfiguration>
  </QosPriorityLevelConfiguration>
  <QosPriorityLevelConfiguration>
    <PriorityLevel>2</PriorityLevel>
    <GuaranteedQosConfiguration>
      <TotalUploadBandwidth>20</TotalUploadBandwidth>
      <ToTalDownloadBandwidth>20</ToTalDownloadBandwidth>
      <ExtranetUploadBandwidth>10</ExtranetUploadBandwidth>
      <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
      <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth>
      <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth>
    </GuaranteedQosConfiguration>
    <Subjects>
      <BucketGroup>bucketGroup-02</BucketGroup>
      <Bucket>bucket-02</Bucket>
    </Subjects>
  </QosPriorityLevelConfiguration>
</PriorityQosConfiguration>

Contoh respons

HTTP/1.1 200 OK
Date: Fri, 10 Oct 2025 07:38:42 GMT
Content-Length: 0

SDK

Operasi PutResourcePoolPriorityQosConfiguration tersedia di SDK berikut:

Go V2

Alat baris perintah ossutil

Untuk informasi selengkapnya tentang perintah ossutil yang sesuai, lihat put-resource-pool-priority-qos-configuration.