ListBucketRequesterQoSInfos - Object Storage Service

Meminta konfigurasi throttling untuk semua requester dalam sebuah bucket.

Catatan penggunaan

Resource pool QoS sedang dalam pratinjau undangan. Jika throughput bucket OSS Anda di suatu wilayah telah mencapai atau melebihi 500 Gbit/s, Anda dapat menghubungi dukungan teknis untuk mengajukan fitur ini.
Secara default, akun Alibaba Cloud memiliki izin untuk meminta konfigurasi throttling untuk semua requester dalam sebuah bucket. Untuk meminta konfigurasi throttling menggunakan pengguna RAM atau Security Token Service (STS), Anda harus memiliki izin oss:ListBucketRequesterQoSInfo. Untuk informasi lebih lanjut, lihat Contoh Umum Kebijakan RAM.

Sintaks

GET /?requesterQosInfo&max-keys=10&continuation-token=207xxxx
Host: BucketName.oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Header permintaan

Semua header dalam permintaan ListBucketRequesterQoSInfos adalah header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

Elemen permintaan

Elemen	Tipe	Diperlukan	Contoh	Deskripsi
max-keys	String	Tidak	10	Jumlah maksimum requester yang ingin Anda minta konfigurasi throttlingnya.
continuation-token	String	Tidak	207xxxx	Requester dari mana konfigurasi throttling dikembalikan.

Header respons

Semua header dalam respons terhadap permintaan ListBucketRequesterQoSInfos adalah header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.

Elemen respons

Elemen	Tipe	Contoh	Deskripsi
ListBucketRequesterQoSInfosResult	Container	N/A	Kontainer yang menyimpan hasil permintaan. Node induk: tidak ada
Bucket	String	oss-example	Nama bucket. Node induk: ListBucketRequesterQoSInfosResult
ContinuationToken	String	207xxxx	ContinuationToken yang digunakan dalam permintaan ListBucketRequesterQoSInfos ini. Node induk: ListBucketRequesterQoSInfosResult
NextContinuationToken	String	262xxxx	Menunjukkan bahwa permintaan ListBucketRequesterQoSInfos ini berisi hasil selanjutnya. Nilai NextContinuationToken digunakan sebagai nilai ContinuationToken untuk meminta hasil selanjutnya. Node induk: ListBucketRequesterQoSInfosResult
IsTruncated	Boolean	true	Menunjukkan apakah hasil yang diminta dipotong. true menunjukkan bahwa tidak semua hasil dikembalikan kali ini. false menunjukkan bahwa semua hasil dikembalikan kali ini. Node induk: ListBucketRequesterQoSInfosResult
RequesterQoSInfo	Container	N/A	Kontainer yang menyimpan konfigurasi throttling requester. Node induk: RequesterQoSInfo
Requester	String	266xxxx	ID pengguna (UID) requester. Node induk: RequesterQoSInfo
QoSConfiguration	Container	N/A	Kontainer yang menyimpan konfigurasi throttling requester. Node induk: RequesterQoSInfo
TotalUploadBandwidth	Integer	10	Total bandwidth upload requester untuk bucket. Satuan: Gbit/s. Node induk: QoSConfiguration
IntranetUploadBandwidth	Integer	-1	Bandwidth upload jaringan internal requester untuk bucket. Jaringan internal termasuk jaringan klasik dan virtual private cloud (VPC). Satuan: Gbit/s. Node induk: QoSConfiguration
ExtranetUploadBandwidth	Integer	-1	Bandwidth upload jaringan publik requester untuk bucket. Jaringan publik termasuk Internet dan titik akhir akselerasi. Satuan: Gbit/s. Node induk: QoSConfiguration
TotalDownloadBandwidth	Integer	10	Total bandwidth download requester untuk bucket. Satuan: Gbit/s. Node induk: QoSConfiguration
IntranetDownloadBandwidth	Integer	-1	Bandwidth download jaringan internal requester untuk bucket. Jaringan internal termasuk jaringan klasik dan VPC. Satuan: Gbit/s. Node induk: QoSConfiguration
ExtranetDownloadBandwidth	Integer	-1	Bandwidth download jaringan publik requester untuk bucket. Jaringan publik termasuk Internet dan titik akhir akselerasi. Satuan: Gbit/s. Node induk: QoSConfiguration

Contoh

Permintaan Contoh

GET /?requesterQosInfo&max-keys=2&continuation-token=207xxxx
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 27 Dec 2024 03:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Respons Contoh

HTTP/1.1 200 OK
Date: Fri, 27 Dec 2024 03:21:12 GMT
Content-Length: 1385
x-oss-request-id: 534****

<ListBucketRequesterQoSInfosResult>
  <Bucket>BucketName</Bucket>
  <ContinuationToken>207xxxx</ContinuationToken>
  <NextContinuationToken>262xxxx</NextContinuationToken>
  <IsTruncated>true</IsTruncated>
  <RequesterQoSInfo>
    <Requester>266xxxx</Requester>
    <QoSConfiguration>
      <TotalUploadBandwidth>10</TotalUploadBandwidth>
      <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
      <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
      <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
      <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
      <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
    </QoSConfiguration>
  </RequesterQoSInfo>
  <RequesterQoSInfo>
    <Requester>276xxxx</Requester>
    <QoSConfiguration>
      <TotalUploadBandwidth>10</TotalUploadBandwidth>
      <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
      <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
      <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
      <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
      <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
    </QoSConfiguration>
  </RequesterQoSInfo>
</ListBucketRequesterQoSInfosResult>

OSS SDKs

Anda dapat menggunakan OSS SDKs untuk bahasa pemrograman berikut untuk memanggil ListBucketRequesterQoSInfos:

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi ListBucketRequesterQoSInfos, lihat list-bucket-requester-qos-infos.