Object Storage Service：使用資源集區QoS保障關鍵業務頻寬

控制台

在資源集區QoS頁面，單擊目標資源集區名稱，然後單擊資源集區內目標Bucket右側的修改流控配置，按照以上要求設定Bucket頻寬。

ossutil

使用前，需安裝ossutil。

1. 通過本地XML設定檔（qos.xml）配置指定Bucket的頻寬上限。

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

2. 為指定Bucket（樣本值為examplebucket）添加以上頻寬配置。

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

3. 查看Bucket的頻寬配置。

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

SDK

目前僅支援通過Python SDK V2和Go SDK V2為Bucket設定頻寬上限。

1. 通過本地qos.xml檔案配置Bucket的頻寬上限。

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

2. 為指定Bucket設定以上頻寬配置。

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutBucketQoSInfo():
      # 從環境變數中載入憑證資訊，用於身分識別驗證
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # 載入預設配置並擷取設定物件
       cfg = oss.config.load_default()
   
       # 設定憑證提供者
       cfg.credentials_provider = credentials_provider
   
       # 填寫Bucket所在地區。以華東1（杭州）為例，Region填寫為cn-hangzhou
       cfg.region = "cn-hangzhou"
   
       # 使用設定物件初始化OSS用戶端
       client = oss.Client(cfg)
   
       # 初始化qos_xml_body為空白字串
       qos_xml_body = ""
   
       # 開啟名為'qos.xml'的檔案，並讀取其中的內容到qos_xml_body變數中
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # 構造一個操作輸入請求對象，用於設定儲存空間的QoS資訊
       req = oss.OperationInput(
           op_name = 'PutBucketQoSInfo',  # 操作名稱，這裡是指定設定儲存空間QoS資訊的操作
           method = 'PUT',  # HTTP方法類型，此處為PUT，表示更新資源
           parameters = {
               'qosInfo': '',  # 這裡是參數列表，指定要設定的是QoS資訊
           },
           headers = None,  # 要求標頭資訊，如果不需要特殊設定則可以為None
           body = qos_xml_body,  # 請求體，包含之前從'qos.xml'檔案讀取的內容
           bucket = 'examplebucket',  # 目標儲存空間的名稱
       )
   
       # 調用用戶端的invoke_operation方法執行請求，並接收響應
       resp = client.invoke_operation(req)
   
       # 列印響應的狀態代碼
       print(resp.status_code)
   
       # 列印響應的頭部資訊
       print(resp.headers)
       
   if __name__ == "__main__":
       PutBucketQoSInfo()

API

調用PutBucketQoSInfo按以下樣本限制Bucket頻寬。

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

控制台

1. 查看RAM使用者ID。

2. 在資源集區QoS頁面，單擊目標資源集區名稱，然後單擊資源集區內目標Bucket右側的配置要求者流控，按照以上要求設定RAM使用者訪問Bucket的頻寬。

ossutil

使用前，需安裝ossutil。

以下樣本用於限制RAM使用者訪問資源集區內某個Bucket的頻寬：

1. 通過本地XML設定檔（qos.xml）配置指定RAM使用者訪問資源集區內某個Bucket的頻寬上限。

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

2. 查看RAM使用者ID。

3. 為訪問Bucket（樣本值為examplebucket）的RAM使用者（UID為266xxxx）添加以上頻寬配置。

   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. （可選）擷取該RAM使用者訪問資源集區內某個Bucket的頻寬配置。

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

SDK

目前僅支援通過Python SDK V2和Go SDK V2限制RAM使用者訪問Bucket的頻寬上限。

1. 通過本地qos.xml檔案配置指定RAM使用者訪問資源集區內某個Bucket的頻寬上限。

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

2. 查看RAM使用者ID。

3. 為訪問Bucket的RAM使用者佈建以上頻寬配置。

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutBucketRequesterQoSInfo():
       # 從環境變數中載入憑證資訊，用於身分識別驗證
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # 載入預設配置並擷取設定物件
       cfg = oss.config.load_default()
   
       # 設定憑證提供者
       cfg.credentials_provider = credentials_provider
   
       # 填寫Bucket所在地區。以華東1（杭州）為例，Region填寫為cn-hangzhou
       cfg.region = "cn-hangzhou"
   
       # 使用設定物件初始化OSS用戶端
       client = oss.Client(cfg)
   
       # 初始化qos_xml_body為空白字串
       qos_xml_body = ""
   
       # 開啟名為'qos.xml'的檔案，並讀取其中的內容到qos_xml_body變數中
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # 構造一個操作輸入請求對象，用於設定儲存空間的要求者QoS資訊
       req = oss.OperationInput(
           op_name = 'PutBucketRequesterQoSInfo',  # 操作名稱，這裡是指定設定儲存空間要求者QoS資訊的操作
           method = 'PUT',  # HTTP方法類型，此處為PUT，表示更新資源
           parameters = {
               'requesterQosInfo': '',  # 參數列表，指定要設定的是要求者QoS資訊
               'qosRequester': '2598732222222xxxx',  # 要求者的唯一識別碼，用於區分不同的要求者
           },
           headers = None,  # 要求標頭資訊，如果不需要特殊設定則可以為None
           body = qos_xml_body,  # 請求體，包含之前從'qos.xml'檔案讀取的內容
           bucket = 'examplebucket',  # 目標儲存空間的名稱
       )
   
       # 調用用戶端的invoke_operation方法執行請求，並接收響應
       resp = client.invoke_operation(req)
   
       # 列印響應的狀態代碼
       print(resp.status_code)
   
       # 列印響應的頭部資訊
       print(resp.headers)
   
       # 列印響應的內容（HTTP響應體），通常包含請求返回的具體資料
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutBucketRequesterQoSInfo()

API

1. 查看RAM使用者ID。

2. 調用PutBucketRequesterQoSInfo按以下樣本限制RAM使用者訪問Bucket的頻寬。

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

控制台

1. 查看RAM角色ID。

2. 在資源集區QoS頁面，單擊目標資源集區名稱，然後單擊資源集區內目標Bucket右側的配置要求者流控，按照以上要求設定Bucket要求者頻寬。

ossutil

使用前，需安裝ossutil。

1. 通過本地XML設定檔（qos.xml）配置該角色訪問指定Bucket的頻寬上限。

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

2. 查看RAM角色ID。

3. 為該角色（角色ID為362xxxx）添加訪問指定Bucket（樣本值為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. （可選）列舉資源集區所有RAM角色的頻寬配置。

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

SDK

目前僅支援通過Python SDK V2和Go SDK V2限制RAM角色訪問Bucket的頻寬上限。

1. 通過本地qos.xml檔案配置指定RAM使用者訪問資源集區內某個Bucket的頻寬上限。

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

2. 查看RAM角色ID。

3. 為RAM角色設定以上頻寬配置。

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutBucketRequesterQoSInfo():
       # 從環境變數中載入憑證資訊，用於身分識別驗證
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # 載入預設配置並擷取設定物件
       cfg = oss.config.load_default()
   
       # 設定憑證提供者
       cfg.credentials_provider = credentials_provider
   
       # 填寫Bucket所在地區。以華東1（杭州）為例，Region填寫為cn-hangzhou
       cfg.region = "cn-hangzhou"
   
       # 使用設定物件初始化OSS用戶端
       client = oss.Client(cfg)
   
       # 初始化qos_xml_body為空白字串
       qos_xml_body = ""
   
       # 開啟名為'qos.xml'的檔案，並讀取其中的內容到qos_xml_body變數中
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # 構造一個操作輸入請求對象，用於設定儲存空間的要求者QoS資訊
       req = oss.OperationInput(
           op_name = 'PutBucketRequesterQoSInfo',  # 操作名稱，這裡是指定設定儲存空間要求者QoS資訊的操作
           method = 'PUT',  # HTTP方法類型，此處為PUT，表示更新資源
           parameters = {
               'requesterQosInfo': '',  # 參數列表，指定要設定的是要求者QoS資訊
               'qosRequester': '2598732222222xxxx',  # 要求者的唯一識別碼，用於區分不同的要求者
           },
           headers = None,  # 要求標頭資訊，如果不需要特殊設定則可以為None
           body = qos_xml_body,  # 請求體，包含之前從'qos.xml'檔案讀取的內容
           bucket = 'examplebucket',  # 目標儲存空間的名稱
       )
   
       # 調用用戶端的invoke_operation方法執行請求，並接收響應
       resp = client.invoke_operation(req)
   
       # 列印響應的狀態代碼
       print(resp.status_code)
   
       # 列印響應的頭部資訊
       print(resp.headers)
   
       # 列印響應的內容（HTTP響應體），通常包含請求返回的具體資料
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutBucketRequesterQoSInfo()

API

1. 查看RAM角色ID。

2. 調用PutBucketRequesterQoSInfo按以下樣本限制RAM角色訪問Bucket的頻寬。

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

控制台

1. 在資源集區QoS頁面，單擊目標資源集區名稱，然後單擊建立BucketGroup，定義BucketGroup名稱並按照要求設定BucketGroup頻寬。

2. 在目標資源集區頁面，單擊目標Bucket右側的配置BucketGroup，將低優先順序Bucket加入BucketGroup。

ossutil

使用前，需安裝ossutil。

1. 將scheduled-posts 和 archived-comments兩個Bucket加入BucketGroup。

   1. 將scheduled-posts加入BucketGroup。

      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. 將archived-comments加入BucketGroup。

      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. （可選）擷取BucketGroup中添加的Bucket列表。

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

2. 通過本地XML設定檔（qos.xml）配置資源集區內指定BucketGroup的頻寬上限。

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

3. 為BucketGroup配置頻寬。

   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. （可選）擷取BucketGroup的頻寬配置。

   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

目前僅支援通過Python SDK V2和Go SDK V2限制BucketGroup的頻寬上限。

1. 將資源集區內的兩個Bucket分別加入BucketGroup。

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutBucketResourcePoolBucketGroup():
       # 從環境變數中載入憑證資訊，用於身分識別驗證
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # 載入預設配置並擷取設定物件
       cfg = oss.config.load_default()
   
       # 設定憑證提供者
       cfg.credentials_provider = credentials_provider
   
       # 填寫Bucket所在地區。以華東1（杭州）為例，Region填寫為cn-hangzhou
       cfg.region = "cn-hangzhou"
   
       # 使用設定物件初始化OSS用戶端
       client = oss.Client(cfg)
   
       # 構造一個操作輸入請求對象，用於將儲存空間添加到指定的資源集區儲存空間組
       req = oss.OperationInput(
           op_name = 'PutBucketResourcePoolBucketGroup',  # 操作名稱，這裡是指定將儲存空間添加到資源集區儲存空間組的操作
           method = 'PUT',  # HTTP方法類型，此處為PUT，表示更新資源
           parameters = {
               'resourcePoolBucketGroup': 'example-group',  # 儲存空間組的唯一識別碼，用於區分不同的儲存空間組
               'resourcePool': 'example-resource-pool',               # 資源集區的唯一識別碼，用於區分不同的資源集區
           },
           headers = None,  # 要求標頭資訊，如果不需要特殊設定則可以為None
           body = None,  # 請求體，由於是PUT請求且無需傳遞額外資料，因此為None
           bucket = 'examplebucket',  # 目標儲存空間的名稱，表示要將該儲存空間添加到指定的資源集區儲存空間組
       )
   
       # 調用用戶端的invoke_operation方法執行請求，並接收響應
       resp = client.invoke_operation(req)
   
       # 列印響應的狀態代碼
       print(resp.status_code)
   
       # 列印響應的頭部資訊
       print(resp.headers)
   
       # 列印響應的內容（HTTP響應體），通常包含請求返回的具體資料
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutBucketResourcePoolBucketGroup()

2. 通過本地XML設定檔（qos.xml）配置資源集區內指定BucketGroup的頻寬上限。

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

3. 為BucketGroup配置頻寬。

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutResourcePoolBucketGroupQoSInfo():
       # 從環境變數中載入憑證資訊，用於身分識別驗證
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # 載入預設配置並擷取設定物件
       cfg = oss.config.load_default()
   
       # 設定憑證提供者
       cfg.credentials_provider = credentials_provider
   
       # 填寫Bucket所在地區。以華東1（杭州）為例，Region填寫為cn-hangzhou
       cfg.region = "cn-hangzhou"
   
       # 使用設定物件初始化OSS用戶端
       client = oss.Client(cfg)
   
       # 初始化qos_xml_body為空白字串
       qos_xml_body = ""
   
       # 開啟名為'qos.xml'的檔案，並讀取其中的內容到qos_xml_body變數中
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # 構造一個操作輸入請求對象，用於設定資源集區儲存空間組的QoS資訊
       req = oss.OperationInput(
           op_name = 'PutResourcePoolBucketGroupQoSInfo',  # 操作名稱，這裡是指定設定資源集區儲存空間組QoS資訊的操作
           method = 'PUT',  # HTTP方法類型，此處為PUT，表示更新資源
           parameters = {
               'resourcePoolBucketGroupQosInfo': '',  # 參數列表，指定要設定的是資源集區儲存空間組QoS資訊
               'resourcePool': 'example-resource-pool',           # 資源集區的唯一識別碼，用於區分不同的資源集區
               'resourcePoolBucketGroup': 'example-group',  # 儲存空間組的唯一識別碼，用於區分不同的儲存空間組
           },
           headers = None,  # 要求標頭資訊，如果不需要特殊設定則可以為None
           body = qos_xml_body,  # 請求體，包含之前從'qos.xml'檔案讀取的內容
           bucket = None,  # 目標儲存空間的名稱，這裡不需要指定具體的儲存空間，因此為None
       )
   
       # 調用用戶端的invoke_operation方法執行請求，並接收響應
       resp = client.invoke_operation(req)
   
       # 列印響應的狀態代碼
       print(resp.status_code)
   
       # 列印響應的頭部資訊
       print(resp.headers)
   
       # 列印響應的內容（HTTP響應體），通常包含請求返回的具體資料
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutResourcePoolBucketGroupQoSInfo()

API

調用PutResourcePoolBucketGroupQoSInfo按以下樣本限制BucketGroup的頻寬。

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

控制台

1. 查看RAM使用者ID或RAM角色ID。

2. 在資源集區QoS頁面，單擊目標資源集區名稱。在資源集區要求者列表頁簽，單擊目標RAM使用者或者RAM角色右側的修改流控配置，按照要求設定資源集區要求者頻寬。

ossutil

使用前，需安裝ossutil。

1. 通過本地XML設定檔（qos.xml）為RAM使用者或者RAM角色配置訪問資源集區的頻寬上限。

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

2. 查看RAM使用者ID或RAM角色ID。

3. 為RAM使用者（UID為266xxxx）添加以上頻寬配置。

   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. （可選）列舉資源集區所有RAM使用者的頻寬配置。

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

SDK

目前僅支援通過Python SDK V2和Go SDK V2限制RAM使用者或RAM角色訪問資源集區的頻寬上限。

1. 通過本地qos.xml檔案配置指定RAM使用者或RAM角色訪問資源集區的頻寬上限。

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

2. 查看RAM使用者ID或RAM角色ID。

3. 為RAM使用者或RAM角色設定以上頻寬配置。

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutResourcePoolRequesterQoSInfo():
       # 從環境變數中載入憑證資訊，用於身分識別驗證
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # 載入預設配置並擷取設定物件
       cfg = oss.config.load_default()
   
       # 設定憑證提供者
       cfg.credentials_provider = credentials_provider
   
       # 填寫Bucket所在地區。以華東1（杭州）為例，Region填寫為cn-hangzhou
       cfg.region = "cn-hangzhou"
   
       # 使用設定物件初始化OSS用戶端
       client = oss.Client(cfg)
   
       # 初始化qos_xml_body為空白字串
       qos_xml_body = ""
   
       # 開啟名為'qos.xml'的檔案，並讀取其中的內容到qos_xml_body變數中
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # 構造一個操作輸入請求對象，用於設定資源集區要求者的QoS資訊
       req = oss.OperationInput(
           op_name = 'PutResourcePoolRequesterQoSInfo',  # 操作名稱，這裡是指定設定資源集區要求者QoS資訊的操作
           method = 'PUT',  # HTTP方法類型，此處為PUT，表示更新資源
           parameters = {
               'requesterQosInfo': '',  # 參數列表，指定要設定的是要求者QoS資訊
               'resourcePool': 'example-resource-pool',  # 資源集區的唯一識別碼，用於區分不同的資源集區
               'qosRequester': '2598732222222xxxx',  # 要求者的唯一識別碼，用於區分不同的要求者
           },
           headers = None,  # 要求標頭資訊，如果不需要特殊設定則可以為None
           body = qos_xml_body,  # 請求體，包含之前從'qos.xml'檔案讀取的內容
           bucket = None,  # 目標儲存空間的名稱，這裡不需要指定具體的儲存空間，因此為None
       )
   
       # 調用用戶端的invoke_operation方法執行請求，並接收響應
       resp = client.invoke_operation(req)
   
       # 列印響應的狀態代碼
       print(resp.status_code)
   
       # 列印響應的頭部資訊
       print(resp.headers)
   
       # 列印響應的內容（HTTP響應體），通常包含請求返回的具體資料
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutResourcePoolRequesterQoSInfo()

API

1. 查看RAM使用者ID或RAM角色ID。

2. 調用PutResourcePoolRequesterQoSInfo按以下樣本限制RAM使用者或RAM角色訪問資源集區的頻寬。

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

ossutil

1. 建立優先順序設定檔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. 應用配置。

   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. 擷取並驗證配置。

   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() {
	// 填寫Bucket所在地區。以華東1（杭州）為例，Region填寫為cn-hangzhou。
	var region = "cn-hangzhou"

	// 載入預設配置並設定憑證提供者和地區
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region)

	// 建立OSS用戶端
	client := oss.NewClient(cfg)

	// 定義資源集區名稱
	resourcePool := "hz-rp-01"

	// 讀取優先順序QoS設定檔內容
	qosConf, err := os.ReadFile("priority-qos.xml")
	if err != nil {
		// 如果讀取QoS設定檔時發生錯誤，則列印錯誤資訊並退出程式
		fmt.Printf("failed to read qos.xml: %v\n", err)
		os.Exit(1)
	}

	// 計算輸入資料的MD5值，並將其轉換為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))
	}

	// 建立操作輸入參數，包括操作名稱、方法類型、參數等
	input := &oss.OperationInput{
		OpName: "PutResourcePoolPriorityQoSConfiguration", // 操作名稱
		Method: "PUT",                                     // HTTP方法類型
		Parameters: map[string]string{
			"priorityQos":  "",           // 優先順序QoS資訊相關參數
			"resourcePool": resourcePool, // 資源集區名稱
		},
		Headers: map[string]string{
			"Content-MD5": calcMd5(qosConf), // 佈建要求體的MD5校正碼，用於驗證資料完整性
		},
		Body:   bytes.NewReader(qosConf), // 請求體，包含QoS配置內容
		Bucket: nil,                      // 此操作不針對特定儲存空間
	}

	// 執行操作請求，並接收響應結果或錯誤
	res, err := client.InvokeOperation(context.TODO(), input)
	if err != nil {
		// 如果發生錯誤，則列印錯誤資訊並退出程式
		fmt.Printf("invoke operation got error: %v\n", err)
		os.Exit(1)
	}

	// 列印操作結果
	fmt.Println("The result of PutResourcePoolPriorityQoSConfiguration:", res.Status)
}

API

PutResourcePoolPriorityQosConfiguration

ossutil

1. 建立要求者優先順序設定檔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. 應用配置

   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. （可選）擷取並驗證配置。

   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() {
	// 填寫Bucket所在地區。以華東1（杭州）為例，Region填寫為cn-hangzhou。
	var region = "cn-hangzhou"

	// 載入預設配置並設定憑證提供者和地區
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region)

	// 建立OSS用戶端
	client := oss.NewClient(cfg)

	// 定義資源集區名稱
	resourcePool := "hz-rp-01"

	// 讀取要求者優先順序QoS設定檔內容
	qosConf, err := os.ReadFile("requester-priority-qos.xml")
	if err != nil {
		// 如果讀取QoS設定檔時發生錯誤，則列印錯誤資訊並退出程式
		fmt.Printf("failed to read qos.xml: %v\n", err)
		os.Exit(1)
	}

	// 計算輸入資料的MD5值，並將其轉換為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))
	}

	// 建立操作輸入參數，包括操作名稱、方法類型、參數等
	input := &oss.OperationInput{
		OpName: "PutResourcePoolRequesterPriorityQoSConfiguration", // 操作名稱
		Method: "PUT",                                              // HTTP方法類型
		Parameters: map[string]string{
			"requesterPriorityQos": "", // 要求者優先順序QoS資訊相關參數
			"resourcePool":         resourcePool, // 資源集區名稱
		},
		Headers: map[string]string{
			"Content-MD5": calcMd5(qosConf), // 佈建要求體的MD5校正碼，用於驗證資料完整性
		},
		Body:   bytes.NewReader(qosConf), // 請求體，包含QoS配置內容
		Bucket: nil,                      // 此操作不針對特定儲存空間
	}

	// 執行操作請求，並接收響應結果或錯誤
	res, err := client.InvokeOperation(context.TODO(), input)
	if err != nil {
		// 如果發生錯誤，則列印錯誤資訊並退出程式
		fmt.Printf("invoke operation got error: %v\n", err)
		os.Exit(1)
	}

	// 列印操作結果
	fmt.Println("The result of PutResourcePoolRequesterPriorityQoSConfiguration:", res.Status)
}

API

PutResourcePoolRequesterPriorityQosConfiguration