Object Storage Service：Gunakan QoS kolam sumber daya untuk menjamin bandwidth bagi layanan kritis

Konsol

Pada halaman Resource Pool QoS, klik nama kolam sumber daya target. Untuk bucket target, klik Modify Throttling Configuration di sebelah kanan dan tetapkan bandwidth sesuai kebutuhan.

ossutil

Sebelum memulai, instal ossutil.

1. Anda dapat mengonfigurasi batas bandwidth untuk bucket tertentu menggunakan file konfigurasi XML lokal bernama qos.xml.

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

2. Untuk menambahkan konfigurasi bandwidth di atas ke bucket tertentu, jalankan perintah berikut. Dalam contoh ini, bucket bernama examplebucket.

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

3. Untuk melihat konfigurasi bandwidth bucket tersebut, jalankan perintah berikut.

   ossutil api invoke-operation --op-name get-bucket-qos-info --method GET --bucket examplebucket --parameters qosInfo

SDK

Saat ini, Anda hanya dapat menetapkan batas bandwidth untuk bucket menggunakan Python SDK V2 dan Go SDK V2.

1. Anda dapat mengonfigurasi batas bandwidth untuk bucket menggunakan file lokal qos.xml.

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

2. Untuk menetapkan konfigurasi bandwidth di atas ke bucket tertentu, gunakan kode berikut.

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutBucketQoSInfo():
      # Dapatkan kredensial akses dari variabel lingkungan untuk autentikasi
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # Muat konfigurasi default dan dapatkan file konfigurasi.
       cfg = oss.config.load_default()
   
       # Tentukan penyedia kredensial.
       cfg.credentials_provider = credentials_provider
   
       # Tentukan wilayah tempat bucket berada. Misalnya, jika bucket Anda berada di wilayah China (Hangzhou), atur wilayah menjadi cn-hangzhou.
       cfg.region = "cn-hangzhou"
   
       # Inisialisasi instans OSSClient menggunakan file konfigurasi.
       client = oss.Client(cfg)
   
       # Atur qos_xml_body menjadi string kosong.
       qos_xml_body = ""
   
       # Buka file bernama qos.xml dan baca isinya ke dalam variabel qos_xml_body.
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # Tentukan parameter input untuk operasi PutBucketQoSInfo guna menentukan aturan QoS untuk bucket.
       req = oss.OperationInput(
           op_name = 'PutBucketQoSInfo',  # Nama operasi, menentukan operasi untuk mengatur informasi QoS bucket
           method = 'PUT',  # Jenis metode HTTP. Dalam contoh ini, PUT digunakan untuk memperbarui resource.
           parameters = {
               'qosInfo': '',  # Parameter terkait QoS.
           },
           headers = None,  # Header permintaan. Jika Anda tidak perlu menentukan header tambahan, biarkan field kosong.
           body = qos_xml_body,  # Badan permintaan, yang berisi konten yang dibaca dari file qos.xml.
           bucket = 'examplebucket',  # Nama bucket.
       )
   
       # Gunakan metode invoke_operation dari client untuk menjalankan permintaan dan mendapatkan respons atau pesan error.
       resp = client.invoke_operation(req)
   
       # Tampilkan kode status HTTP yang dikembalikan.
       print(resp.status_code)
   
       # Tampilkan header respons.
       print(resp.headers)
   
   if __name__ == "__main__":
       GetBucketQoSInfo()

API

Anda dapat memanggil operasi PutBucketQoSInfo untuk membatasi bandwidth bucket, seperti ditunjukkan pada contoh berikut.

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

Konsol

1. Pertama, lihat RAM user ID.

2. Pada halaman Resource Pool QoS, klik nama kolam sumber daya target. Lalu, klik Configure Requester Throttling di sebelah kanan bucket target. Tetapkan bandwidth yang diperlukan untuk Pengguna RAM mengakses bucket tersebut.

ossutil

Sebelum memulai, instal ossutil.

Contoh berikut menunjukkan cara membatasi bandwidth untuk Pengguna RAM mengakses bucket dalam kolam sumber daya:

1. Anda dapat mengonfigurasi batas bandwidth untuk Pengguna RAM tertentu mengakses bucket dalam kolam sumber daya menggunakan file konfigurasi XML lokal bernama qos.xml.

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

2. Lihat RAM user ID.

3. Untuk menambahkan konfigurasi bandwidth di atas untuk Pengguna RAM (UID 266xxxx) yang mengakses bucket tersebut, jalankan perintah berikut. Dalam contoh ini, bucket bernama examplebucket.

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

4. (Opsional) Untuk mengambil konfigurasi bandwidth untuk Pengguna RAM mengakses bucket dalam kolam sumber daya, jalankan perintah berikut.

   ossutil api invoke-operation --op-name get-bucket-requester-qos-info --method GET --bucket=examplebucket --parameters requesterQosInfo --parameters qosRequester=266xxxx

SDK

Saat ini, Anda hanya dapat membatasi bandwidth untuk Pengguna RAM mengakses bucket menggunakan Python SDK V2 dan Go SDK V2.

1. Anda dapat mengonfigurasi batas bandwidth untuk Pengguna RAM tertentu mengakses bucket dalam kolam sumber daya menggunakan file lokal qos.xml.

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

2. Lihat RAM user ID.

3. Tetapkan konfigurasi bandwidth di atas untuk Pengguna RAM yang mengakses bucket tersebut.

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutBucketRequesterQoSInfo():
       # Dapatkan kredensial akses dari variabel lingkungan untuk autentikasi.
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # Muat konfigurasi default dan dapatkan file konfigurasi.
       cfg = oss.config.load_default()
   
       # Tentukan penyedia kredensial.
       cfg.credentials_provider = credentials_provider
   
       # Tentukan wilayah tempat bucket berada. Misalnya, jika bucket Anda berada di wilayah China (Hangzhou), atur wilayah menjadi cn-hangzhou.
       cfg.region = "cn-hangzhou"
   
       # Inisialisasi instans OSSClient menggunakan file konfigurasi.
       client = oss.Client(cfg)
   
       # Atur qos_xml_body menjadi string kosong.
       qos_xml_body = ""
   
       # Buka file bernama qos.xml dan baca isinya ke dalam variabel qos_xml_body.
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # Tentukan parameter input untuk operasi PutBucketRequesterQoSInfo guna mengonfigurasi aturan pembatasan untuk peminta yang mengakses bucket.
       req = oss.OperationInput(
           op_name = 'PutBucketRequesterQoSInfo',  # Nama operasi.
           method = 'PUT',  # Jenis metode HTTP. Dalam contoh ini, PUT digunakan.
           parameters = {
               'requesterQosInfo': '',  # Parameter terkait QoS.
               'qosRequester': '2598732222222xxxx',  # Pengidentifikasi unik untuk peminta, yang digunakan untuk membedakan peminta berbeda.
           },
           headers = None,  # Header permintaan. Jika Anda tidak perlu menentukan header tambahan, biarkan field kosong.
           body = qos_xml_body,  # Badan permintaan, yang berisi konten yang dibaca dari file qos.xml.
           bucket = 'examplebucket',  # Nama bucket.
       )
   
       # Gunakan metode invoke_operation dari client untuk mengeksekusi permintaan dan mendapatkan respons.
       resp = client.invoke_operation(req)
   
       # Tampilkan kode status HTTP yang dikembalikan.
       print(resp.status_code)
   
       # Tampilkan header respons.
       print(resp.headers)
   
       # Tampilkan badan respons, yang biasanya berisi data spesifik yang dikembalikan oleh permintaan.
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutBucketRequesterQoSInfo()

API

1. Lihat RAM user ID.

2. Panggil operasi PutBucketRequesterQoSInfo untuk membatasi bandwidth Pengguna RAM mengakses bucket, seperti ditunjukkan pada contoh berikut.

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

Konsol

1. Lihat RAM role ID.

2. Pada halaman Resource Pool QoS, klik nama kolam sumber daya target. Lalu, klik Configure Requester Throttling untuk bucket target dan tetapkan bandwidth yang diperlukan.

ossutil

Sebelum memulai, instal ossutil.

1. Anda dapat mengonfigurasi batas bandwidth untuk peran ini mengakses bucket tertentu menggunakan file konfigurasi XML lokal bernama qos.xml.

   <QoSConfiguration>
     <TotalUploadBandwidth>100</TotalUploadBandwidth>
     <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
     <ExtranetUploadBandwidth>20</ExtranetUploadBandwidth>
     <TotalDownloadBandwidth>100</TotalDownloadBandwidth>
     <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
     <ExtranetDownloadBandwidth>40</ExtranetDownloadBandwidth>
   </QoSConfiguration>

2. Lihat RAM role ID.

3. Untuk menambahkan konfigurasi bandwidth untuk peran ini (ID peran 362xxxx) mengakses bucket tertentu, jalankan perintah berikut. Dalam contoh ini, bucket bernama examplebucket.

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

4. (Opsional) Untuk menampilkan daftar konfigurasi bandwidth semua peran RAM dalam kolam sumber daya, jalankan perintah berikut.

   ossutil api invoke-operation --op-name list-resource-pool-requester-qos-infos --method GET --parameters resourcePool=examplePool  --parameters requesterQosInfo

SDK

Saat ini, Anda hanya dapat membatasi bandwidth untuk peran RAM mengakses bucket menggunakan Python SDK V2 dan Go SDK V2.

1. Anda dapat mengonfigurasi batas bandwidth untuk Pengguna RAM tertentu mengakses bucket dalam kolam sumber daya menggunakan file lokal qos.xml.

   <QoSConfiguration>
     <TotalUploadBandwidth>100</TotalUploadBandwidth>
     <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
     <ExtranetUploadBandwidth>20</ExtranetUploadBandwidth>
     <TotalDownloadBandwidth>100</TotalDownloadBandwidth>
     <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
     <ExtranetDownloadBandwidth>40</ExtranetDownloadBandwidth>
   </QoSConfiguration>

2. Lihat RAM role ID.

3. Tetapkan konfigurasi bandwidth di atas untuk peran RAM tersebut.

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutBucketRequesterQoSInfo():
       # Dapatkan kredensial akses dari variabel lingkungan untuk autentikasi.
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # Muat konfigurasi default dan dapatkan file konfigurasi.
       cfg = oss.config.load_default()
   
       # Tentukan penyedia kredensial.
       cfg.credentials_provider = credentials_provider
   
       # Tentukan wilayah tempat bucket berada. Misalnya, jika bucket Anda berada di wilayah China (Hangzhou), atur wilayah menjadi cn-hangzhou.
       cfg.region = "cn-hangzhou"
   
       # Inisialisasi instans OSSClient menggunakan file konfigurasi.
       client = oss.Client(cfg)
   
       # Atur qos_xml_body menjadi string kosong.
       qos_xml_body = ""
   
       # Buka file bernama qos.xml dan baca isinya ke dalam variabel qos_xml_body.
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # Tentukan parameter input untuk operasi PutBucketRequesterQoSInfo guna mengonfigurasi aturan pembatasan untuk peminta yang mengakses bucket.
       req = oss.OperationInput(
           op_name = 'PutBucketRequesterQoSInfo',  # Nama operasi.
           method = 'PUT',  # Jenis metode HTTP. Dalam contoh ini, PUT digunakan.
           parameters = {
               'requesterQosInfo': '',  # Parameter terkait QoS.
               'qosRequester': '2598732222222xxxx',  # Pengidentifikasi unik untuk peminta, yang digunakan untuk membedakan peminta berbeda.
           },
           headers = None,  # Header permintaan. Jika Anda tidak perlu menentukan header tambahan, biarkan field kosong.
           body = qos_xml_body,  # Badan permintaan, yang berisi konten yang dibaca dari file qos.xml.
           bucket = 'examplebucket',  # Nama bucket.
       )
   
       # Gunakan metode invoke_operation dari client untuk mengeksekusi permintaan dan mendapatkan respons.
       resp = client.invoke_operation(req)
   
       # Tampilkan kode status HTTP yang dikembalikan.
       print(resp.status_code)
   
       # Tampilkan header respons.
       print(resp.headers)
   
       # Tampilkan badan respons, yang biasanya berisi data spesifik yang dikembalikan oleh permintaan.
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutBucketRequesterQoSInfo()

API

1. Lihat RAM role ID.

2. Panggil operasi PutBucketRequesterQoSInfo untuk membatasi bandwidth peran RAM mengakses bucket, seperti ditunjukkan pada contoh berikut.

   <QoSConfiguration>
     <TotalUploadBandwidth>100</TotalUploadBandwidth>
     <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
     <ExtranetUploadBandwidth>20</ExtranetUploadBandwidth>
     <TotalDownloadBandwidth>100</TotalDownloadBandwidth>
     <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
     <ExtranetDownloadBandwidth>40</ExtranetDownloadBandwidth>
   </QoSConfiguration>

Konsol

1. Pada halaman Resource Pool QoS, klik nama kolam sumber daya target. Lalu, klik Create BucketGroup, masukkan nama untuk BucketGroup tersebut, dan tetapkan bandwidth yang diperlukan.

2. Pada halaman kolam sumber daya target, klik Configure BucketGroup di sebelah kanan bucket target untuk menambahkan bucket berprioritas rendah ke grup tersebut.

ossutil

Sebelum memulai, instal ossutil.

1. Untuk menambahkan bucket scheduled-posts dan archived-comments ke BucketGroup:

   1. Untuk menambahkan bucket scheduled-posts ke BucketGroup, jalankan perintah berikut.

      ossutil api invoke-operation --op-name put-bucket-resource-pool-bucket-group --method PUT --bucket scheduled-posts --parameters resourcePool=pool-for-ai --parameters resourcePoolBucketGroup=test-group

   2. Untuk menambahkan bucket archived-comments ke BucketGroup, jalankan perintah berikut.

      ossutil api invoke-operation --op-name put-bucket-resource-pool-bucket-group --method PUT --bucket archived-comments --parameters resourcePool=pool-for-ai --parameters resourcePoolBucketGroup=test-group

   3. (Opsional) Untuk mengambil daftar bucket yang ditambahkan ke BucketGroup, jalankan perintah berikut.

      ossutil api invoke-operation --op-name list-resource-pool-bucket-groups --method GET --parameters resourcePool=pool-for-ai --parameters resourcePoolBucketGroup

2. Anda dapat mengonfigurasi batas bandwidth untuk BucketGroup tertentu dalam kolam sumber daya menggunakan file konfigurasi XML lokal bernama qos.xml.

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

3. Untuk mengonfigurasi bandwidth untuk BucketGroup tersebut, jalankan perintah berikut.

   ossutil api invoke-operation --op-name put-resource-pool-bucket-group-qos-info --method PUT --parameters resourcePoolBucketGroupQosInfo --parameters resourcePool pool-for-ai --parameters resourcePoolBucketGroup offline-group --body=file://qos.xml

4. (Opsional) Untuk mengambil konfigurasi bandwidth BucketGroup tersebut, jalankan perintah berikut.

   ossutil api invoke-operation --op-name get-resource-pool-bucket-group-qos-info --method GET --parameters resourcePool=pool-for-ai --parameters resourcePoolBucketGroup=offline-group --parameters resourcePoolBucketGroupQoSInfo

SDK

Saat ini, Anda hanya dapat membatasi bandwidth BucketGroup menggunakan Python SDK V2 dan Go SDK V2.

1. Tambahkan dua bucket dari kolam sumber daya ke BucketGroup.

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutBucketResourcePoolBucketGroup():
       # Dapatkan kredensial akses dari variabel lingkungan untuk autentikasi.
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # Muat konfigurasi default dan dapatkan file konfigurasi.
       cfg = oss.config.load_default()
   
       # Tentukan penyedia kredensial.
       cfg.credentials_provider = credentials_provider
   
       # Tentukan wilayah tempat bucket berada. Misalnya, jika bucket Anda berada di wilayah China (Hangzhou), atur wilayah menjadi cn-hangzhou.
       cfg.region = "cn-hangzhou"
   
       # Inisialisasi instans OSSClient menggunakan file konfigurasi.
       client = oss.Client(cfg)
   
       # Tentukan parameter input untuk operasi PutBucketResourcePoolBucketGroup.
       req = oss.OperationInput(
           op_name = 'PutBucketResourcePoolBucketGroup',  # Nama operasi.
           method = 'PUT',  # Jenis metode HTTP. Dalam contoh ini, PUT digunakan.
           parameters = {
               'resourcePoolBucketGroup': 'example-group',  # Nama grup bucket dalam kolam sumber daya.
               'resourcePool': 'example-resource-pool',               # Nama kolam sumber daya.
           },
           headers = None,  # Header permintaan. Jika Anda tidak perlu menentukan header tambahan, biarkan field kosong.
           body = None,  # Badan permintaan, yang biasanya tidak diperlukan untuk permintaan PUT.
           bucket = 'examplebucket',  # Nama bucket.
       )
   
       # Gunakan metode invoke_operation dari client untuk mengeksekusi permintaan dan mendapatkan respons.
       resp = client.invoke_operation(req)
   
       # Tampilkan kode status HTTP yang dikembalikan.
       print(resp.status_code)
   
       # Tampilkan header respons.
       print(resp.headers)
   
       # Tampilkan badan respons, yang biasanya berisi data spesifik yang dikembalikan oleh permintaan.
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutBucketResourcePoolBucketGroup()

2. Anda dapat mengonfigurasi batas bandwidth untuk BucketGroup tertentu dalam kolam sumber daya menggunakan file konfigurasi XML lokal bernama qos.xml.

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

3. Konfigurasikan bandwidth untuk BucketGroup tersebut.

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutResourcePoolBucketGroupQoSInfo():
       # Dapatkan kredensial akses dari variabel lingkungan untuk autentikasi.
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # Muat konfigurasi default dan dapatkan file konfigurasi.
       cfg = oss.config.load_default()
   
       # Tentukan penyedia kredensial.
       cfg.credentials_provider = credentials_provider
   
       # Tentukan wilayah tempat bucket berada. Misalnya, jika bucket Anda berada di wilayah China (Hangzhou), atur wilayah menjadi cn-hangzhou.
       cfg.region = "cn-hangzhou"
   
       # Inisialisasi instans OSSClient menggunakan file konfigurasi.
       client = oss.Client(cfg)
   
       # Atur qos_xml_body menjadi string kosong.
       qos_xml_body = ""
   
       # Buka dan baca file qos.xml lalu tulis isinya ke dalam variabel qos_xml_body.
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # Tentukan parameter input untuk operasi PutResourcePoolBucketGroupQoSInfo.
       req = oss.OperationInput(
           op_name = 'PutResourcePoolBucketGroupQoSInfo',  # Nama operasi.
           method = 'PUT',  # Jenis metode HTTP. Dalam contoh ini, PUT digunakan.
           parameters = {
               'resourcePoolBucketGroupQosInfo': '',  # Parameter terkait QoS.
               'resourcePool': 'example-resource-pool',           # Nama kolam sumber daya
               'resourcePoolBucketGroup': 'example-group',  # Nama grup bucket.
           },
           headers = None,  # Header permintaan. Jika Anda tidak perlu menentukan header tambahan, biarkan field kosong.
           body = qos_xml_body,  # Badan permintaan, yang berisi konten yang dibaca dari file qos.xml.
           bucket = None,  # Nama bucket, yang tidak diperlukan untuk permintaan PUT. Operasi ini tidak dilakukan pada bucket tertentu.
       )
   
       # Gunakan metode invoke_operation dari client untuk mengeksekusi permintaan dan mendapatkan respons.
       resp = client.invoke_operation(req)
   
       # Tampilkan kode status HTTP yang dikembalikan.
       print(resp.status_code)
   
       # Tampilkan header respons.
       print(resp.headers)
   
       # Tampilkan badan respons, yang biasanya berisi data spesifik yang dikembalikan oleh permintaan.
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutResourcePoolBucketGroupQoSInfo()

API

Panggil operasi PutResourcePoolBucketGroupQoSInfo untuk membatasi bandwidth BucketGroup, seperti ditunjukkan pada contoh berikut.

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

Konsol

1. Lihat RAM user ID atau RAM role ID.

2. Pada halaman Resource Pool QoS, klik nama kolam sumber daya target. Pada tab Resource Pool Requester List, klik Modify Throttling Configuration untuk Pengguna RAM atau Peran RAM target guna menetapkan bandwidth untuk peminta kolam sumber daya tersebut.

ossutil

Sebelum memulai, instal ossutil.

1. Anda dapat mengonfigurasi batas bandwidth untuk Pengguna RAM atau Peran RAM mengakses kolam sumber daya menggunakan file konfigurasi XML lokal bernama qos.xml.

   <QoSConfiguration>
     <TotalUploadBandwidth>100</TotalUploadBandwidth>
     <IntranetUploadBandwidth>50</IntranetUploadBandwidth>
     <ExtranetUploadBandwidth>50</ExtranetUploadBandwidth>
     <TotalDownloadBandwidth>200</TotalDownloadBandwidth>
     <IntranetDownloadBandwidth>150</IntranetDownloadBandwidth>
     <ExtranetDownloadBandwidth>50</ExtranetDownloadBandwidth>
   </QoSConfiguration>

2. Lihat RAM user ID atau RAM role ID.

3. Untuk menambahkan konfigurasi bandwidth di atas untuk Pengguna RAM (UID 266xxxx), jalankan perintah berikut.

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

4. (Opsional) Untuk menampilkan daftar konfigurasi bandwidth semua Pengguna RAM dalam kolam sumber daya, jalankan perintah berikut.

   ossutil api invoke-operation --op-name list-resource-pool-requester-qos-infos --method GET --parameters resourcePool=examplePool  --parameters requesterQosInfo

SDK

Saat ini, Anda hanya dapat membatasi bandwidth untuk Pengguna RAM atau Peran RAM mengakses kolam sumber daya menggunakan Python SDK V2 dan Go SDK V2.

1. Anda dapat mengonfigurasi batas bandwidth untuk Pengguna RAM atau Peran RAM tertentu mengakses kolam sumber daya menggunakan file lokal qos.xml.

   <QoSConfiguration>
     <TotalUploadBandwidth>100</TotalUploadBandwidth>
     <IntranetUploadBandwidth>50</IntranetUploadBandwidth>
     <ExtranetUploadBandwidth>50</ExtranetUploadBandwidth>
     <TotalDownloadBandwidth>200</TotalDownloadBandwidth>
     <IntranetDownloadBandwidth>150</IntranetDownloadBandwidth>
     <ExtranetDownloadBandwidth>50</ExtranetDownloadBandwidth>
   </QoSConfiguration>

2. Lihat RAM user ID atau RAM role ID.

3. Tetapkan konfigurasi bandwidth di atas untuk Pengguna RAM atau Peran RAM tersebut.

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutResourcePoolRequesterQoSInfo():
       # Dapatkan kredensial akses dari variabel lingkungan untuk autentikasi.
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # Muat konfigurasi default dan dapatkan file konfigurasi.
       cfg = oss.config.load_default()
   
       # Tentukan penyedia kredensial.
       cfg.credentials_provider = credentials_provider
   
       # Tentukan wilayah tempat bucket berada. Misalnya, jika bucket Anda berada di wilayah China (Hangzhou), atur wilayah menjadi cn-hangzhou.
       cfg.region = "cn-hangzhou"
   
       # Inisialisasi instans OSSClient menggunakan file konfigurasi.
       client = oss.Client(cfg)
   
       # Inisialisasi qos_xml_body sebagai string kosong
       qos_xml_body = ""
   
       # Buka file bernama qos.xml dan baca isinya ke dalam variabel qos_xml_body.
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # Tentukan parameter input untuk operasi PutResourcePoolRequesterQoSInfo.
       req = oss.OperationInput(
           op_name = 'PutResourcePoolRequesterQoSInfo',  # Nama operasi.
           method = 'PUT',  # Jenis metode HTTP. Dalam contoh ini, PUT digunakan.
           parameters = {
               'requesterQosInfo': '',  # Parameter terkait QoS.
               'resourcePool': 'example-resource-pool',  # Nama kolam sumber daya.
               'qosRequester': '2598732222222xxxx',  # ID peminta.
           },
           headers = None,  # Header permintaan. Jika Anda tidak perlu menentukan header tambahan, biarkan field kosong.
           body = qos_xml_body,  # Badan permintaan, yang berisi konten yang dibaca dari file qos.xml.
           bucket = None,  # Nama bucket, yang tidak diperlukan untuk permintaan PUT. Operasi ini tidak dilakukan pada bucket tertentu.
       )
   
       # Gunakan metode invoke_operation dari client untuk mengeksekusi permintaan dan mendapatkan respons.
       resp = client.invoke_operation(req)
   
       # Tampilkan kode status HTTP yang dikembalikan.
       print(resp.status_code)
   
       # Tampilkan header respons.
       print(resp.headers)
   
       # Tampilkan badan respons, yang biasanya berisi data spesifik yang dikembalikan oleh permintaan.
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutResourcePoolRequesterQoSInfo()

API

1. Lihat RAM user ID atau RAM role ID.

2. Panggil operasi PutResourcePoolRequesterQoSInfo untuk membatasi bandwidth Pengguna RAM atau Peran RAM mengakses kolam sumber daya, seperti ditunjukkan pada contoh berikut.

   <QoSConfiguration>
     <TotalUploadBandwidth>100</TotalUploadBandwidth>
     <IntranetUploadBandwidth>50</IntranetUploadBandwidth>
     <ExtranetUploadBandwidth>50</ExtranetUploadBandwidth>
     <TotalDownloadBandwidth>200</TotalDownloadBandwidth>
     <IntranetDownloadBandwidth>150</IntranetDownloadBandwidth>
     <ExtranetDownloadBandwidth>50</ExtranetDownloadBandwidth>
   </QoSConfiguration>

ossutil

1. Pertama, buat file konfigurasi prioritas bernama priority-qos.xml.

   <PriorityQosConfiguration>
     <PriorityCount>3</PriorityCount>
     <DefaultPriorityLevel>1</DefaultPriorityLevel>
     
     <DefaultGuaranteedQosConfiguration>
       <TotalUploadBandwidth>10</TotalUploadBandwidth>
       <IntranetUploadBandwidth>5</IntranetUploadBandwidth>
       <ExtranetUploadBandwidth>5</ExtranetUploadBandwidth>
       <TotalDownloadBandwidth>20</TotalDownloadBandwidth>
       <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth>
       <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth>
     </DefaultGuaranteedQosConfiguration>
     
     <QosPriorityLevelConfiguration>
       <PriorityLevel>3</PriorityLevel>
       <GuaranteedQosConfiguration>
         <TotalUploadBandwidth>50</TotalUploadBandwidth>
         <TotalDownloadBandwidth>80</TotalDownloadBandwidth>
         <ExtranetUploadBandwidth>30</ExtranetUploadBandwidth>
         <IntranetUploadBandwidth>20</IntranetUploadBandwidth>
         <ExtranetDownloadBandwidth>50</ExtranetDownloadBandwidth>
         <IntranetDownloadBandwidth>30</IntranetDownloadBandwidth>
       </GuaranteedQosConfiguration>
       <Subjects>
         <Bucket>critical-bucket</Bucket>
         <BucketGroup>core-group</BucketGroup>
       </Subjects>
     </QosPriorityLevelConfiguration>
     
     <QosPriorityLevelConfiguration>
       <PriorityLevel>2</PriorityLevel>
       <GuaranteedQosConfiguration>
         <TotalUploadBandwidth>30</TotalUploadBandwidth>
         <TotalDownloadBandwidth>50</TotalDownloadBandwidth>
         <ExtranetUploadBandwidth>20</ExtranetUploadBandwidth>
         <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
         <ExtranetDownloadBandwidth>30</ExtranetDownloadBandwidth>
         <IntranetDownloadBandwidth>20</IntranetDownloadBandwidth>
       </GuaranteedQosConfiguration>
       <Subjects>
         <Bucket>important-bucket</Bucket>
       </Subjects>
     </QosPriorityLevelConfiguration>
   </PriorityQosConfiguration>

2. Konfigurasi Aplikasi

   ossutil api invoke-operation --op-name put-resource-pool-priority-qos-configuration --method PUT --parameters resourcePool=hz-rp-03 --parameters priorityQos --body=file://priority-qos.xml

3. Anda dapat mengambil dan memverifikasi konfigurasi tersebut.

   ossutil api invoke-operation --op-name get-resource-pool-priority-qos-configuration --method GET --parameters resourcePool=hz-rp-03 --parameters priorityQos

SDK

package main

import (
	"bytes"
	"context"
	"crypto/md5"
	"encoding/base64"
	"fmt"
	"os"

	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)

func PutResourcePoolPriorityQosConfiguration() {
	// Tentukan wilayah tempat bucket berada. Misalnya, atur wilayah menjadi cn-hangzhou untuk China (Hangzhou).
	var region = "cn-hangzhou"

	// Muat konfigurasi default dan atur penyedia kredensial serta wilayah.
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region)

	// Buat client OSS.
	client := oss.NewClient(cfg)

	// Definisikan nama kolam sumber daya.
	resourcePool := "hz-rp-01"

	// Baca konten file konfigurasi QoS prioritas.
	qosConf, err := os.ReadFile("priority-qos.xml")
	if err != nil {
		// Jika terjadi error saat membaca file konfigurasi QoS, cetak pesan error dan keluar dari program.
		fmt.Printf("failed to read qos.xml: %v\n", err)
		os.Exit(1)
	}

	// Hitung hash MD5 dari data input dan ubah menjadi string yang dienkripsi Base64.
	calcMd5 := func(input []byte) string {
		if len(input) == 0 {
			return "1B2M2Y8AsgTpgAmY7PhCfg=="
		}
		h := md5.New()
		h.Write(input)
		return base64.StdEncoding.EncodeToString(h.Sum(nil))
	}

	// Buat parameter input untuk operasi, termasuk aksi, jenis metode, dan parameter.
	input := &oss.OperationInput{
		OpName: "PutResourcePoolPriorityQoSConfiguration", // Aksi
		Method: "PUT",                                     // Metode HTTP
		Parameters: map[string]string{
			"priorityQos":  "",           // Parameter terkait QoS prioritas.
			"resourcePool": resourcePool, // Nama kolam sumber daya
		},
		Headers: map[string]string{
			"Content-MD5": calcMd5(qosConf), // Atur header Content-MD5 untuk badan permintaan guna memastikan integritas data.
		},
		Body:   bytes.NewReader(qosConf), // Badan permintaan yang berisi konfigurasi QoS.
		Bucket: nil,                      // Operasi ini tidak menargetkan bucket tertentu.
	}

	// Eksekusi operasi dan terima respons atau error.
	res, err := client.InvokeOperation(context.TODO(), input)
	if err != nil {
		// Jika terjadi error, cetak pesan error dan keluar dari program.
		fmt.Printf("invoke operation got error: %v\n", err)
		os.Exit(1)
	}

	// Cetak hasil operasi.
	fmt.Println("The result of PutResourcePoolPriorityQoSConfiguration:", res.Status)
}

API

PutResourcePoolPriorityQosConfiguration

ossutil

1. Pertama, buat file konfigurasi prioritas peminta bernama requester-priority-qos.xml.

   <PriorityQosConfiguration>
     <PriorityCount>3</PriorityCount>
     <DefaultPriorityLevel>1</DefaultPriorityLevel>
     
     <DefaultGuaranteedQosConfiguration>
       <TotalUploadBandwidth>10</TotalUploadBandwidth>
       <IntranetUploadBandwidth>5</IntranetUploadBandwidth>
       <ExtranetUploadBandwidth>5</ExtranetUploadBandwidth>
       <TotalDownloadBandwidth>20</TotalDownloadBandwidth>
       <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth>
       <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth>
     </DefaultGuaranteedQosConfiguration>
     
     <QosPriorityLevelConfiguration>
       <PriorityLevel>3</PriorityLevel>
       <GuaranteedQosConfiguration>
         <TotalUploadBandwidth>60</TotalUploadBandwidth>
         <TotalDownloadBandwidth>100</TotalDownloadBandwidth>
         <ExtranetUploadBandwidth>40</ExtranetUploadBandwidth>
         <IntranetUploadBandwidth>20</IntranetUploadBandwidth>
         <ExtranetDownloadBandwidth>60</ExtranetDownloadBandwidth>
         <IntranetDownloadBandwidth>40</IntranetDownloadBandwidth>
       </GuaranteedQosConfiguration>
       <Subjects>
         <Requester>123456789012****</Requester>
         <Requester>234567890123****</Requester>
       </Subjects>
     </QosPriorityLevelConfiguration>
     
     <QosPriorityLevelConfiguration>
       <PriorityLevel>2</PriorityLevel>
       <GuaranteedQosConfiguration>
         <TotalUploadBandwidth>30</TotalUploadBandwidth>
         <TotalDownloadBandwidth>50</TotalDownloadBandwidth>
         <ExtranetUploadBandwidth>20</ExtranetUploadBandwidth>
         <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
         <ExtranetDownloadBandwidth>30</ExtranetDownloadBandwidth>
         <IntranetDownloadBandwidth>20</IntranetDownloadBandwidth>
       </GuaranteedQosConfiguration>
       <Subjects>
         <Requester>345678901234****</Requester>
       </Subjects>
     </QosPriorityLevelConfiguration>
   </PriorityQosConfiguration>

2. Konfigurasi Aplikasi

   ossutil api invoke-operation --op-name put-resource-pool-requester-priority-qos-configuration --method PUT --parameters resourcePool=hz-rp-03 --parameters requesterPriorityQos --body=file://requester-priority-qos.xml

3. (Opsional) Untuk mengambil dan memverifikasi konfigurasi, jalankan perintah berikut.

   ossutil api invoke-operation --op-name get-resource-pool-requester-priority-qos-configuration --method GET --parameters resourcePool=hz-rp-03 --parameters requesterPriorityQos

SDK

package main

import (
	"bytes"
	"context"
	"crypto/md5"
	"encoding/base64"
	"fmt"
	"os"

	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)

func PutResourcePoolRequesterPriorityQosConfiguration() {
	// Tentukan wilayah tempat bucket berada. Misalnya, atur wilayah menjadi cn-hangzhou untuk China (Hangzhou).
	var region = "cn-hangzhou"

	// Muat konfigurasi default dan atur penyedia kredensial serta wilayah.
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region)

	// Buat client OSS.
	client := oss.NewClient(cfg)

	// Definisikan nama kolam sumber daya.
	resourcePool := "hz-rp-01"

	// Baca konten file konfigurasi QoS prioritas peminta.
	qosConf, err := os.ReadFile("requester-priority-qos.xml")
	if err != nil {
		// Jika terjadi error saat membaca file konfigurasi QoS, cetak pesan error dan keluar dari program.
		fmt.Printf("failed to read qos.xml: %v\n", err)
		os.Exit(1)
	}

	// Hitung hash MD5 dari data input dan ubah menjadi string yang dienkripsi Base64.
	calcMd5 := func(input []byte) string {
		if len(input) == 0 {
			return "1B2M2Y8AsgTpgAmY7PhCfg=="
		}
		h := md5.New()
		h.Write(input)
		return base64.StdEncoding.EncodeToString(h.Sum(nil))
	}

	// Buat parameter input untuk operasi, termasuk aksi, jenis metode, dan parameter.
	input := &oss.OperationInput{
		OpName: "PutResourcePoolRequesterPriorityQoSConfiguration", // Aksi
		Method: "PUT",                                              // Metode HTTP
		Parameters: map[string]string{
			"requesterPriorityQos": "", // Parameter terkait QoS prioritas peminta.
			"resourcePool":         resourcePool, // Nama kolam sumber daya
		},
		Headers: map[string]string{
			"Content-MD5": calcMd5(qosConf), // Atur header Content-MD5 untuk badan permintaan guna memastikan integritas data.
		},
		Body:   bytes.NewReader(qosConf), // Badan permintaan yang berisi konfigurasi QoS.
		Bucket: nil,                      // Operasi ini tidak menargetkan bucket tertentu.
	}

	// Eksekusi operasi dan terima respons atau error.
	res, err := client.InvokeOperation(context.TODO(), input)
	if err != nil {
		// Jika terjadi error, cetak pesan error dan keluar dari program.
		fmt.Printf("invoke operation got error: %v\n", err)
		os.Exit(1)
	}

	// Cetak hasil operasi.
	fmt.Println("The result of PutResourcePoolRequesterPriorityQoSConfiguration:", res.Status)
}

API

PutResourcePoolRequesterPriorityQosConfiguration