Object Storage Service:リソースプール QoS を使用して、重要サービスの帯域幅を保証する

コンソール

Resource Pool QoS ページで、対象のリソースプール名をクリックします。次に、対象バケットの右側にある フロー制御の変更 をクリックし、必要に応じてバケット帯域幅を設定します。

ossutil

開始する前に、ossutil をインストールしてください。

1. qos.xml という名前のローカル XML ファイルでバケットの帯域幅制限を設定します。

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

2. 帯域幅構成を特定のバケットに適用します。次のコマンドは、examplebucket という名前のバケットに構成を適用します。

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

3. バケットの帯域幅構成を表示します。

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

SDK

Python SDK V2 および Go SDK V2 のみを使用して、バケットの帯域幅制限を設定できます。

1. qos.xml という名前のローカルファイルでバケットの帯域幅制限を設定します。

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

2. 帯域幅構成を特定のバケットに適用します。

   Python

   import alibabacloud_oss_v2 as oss
   
   def PutBucketQoSInfo():
      # 認証のために環境変数からアクセス認証情報を取得します。
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # デフォルト設定を読み込み、設定ファイルを取得します。
       cfg = oss.config.load_default()
   
       # 認証情報プロバイダーを指定します。
       cfg.credentials_provider = credentials_provider
   
       # バケットが配置されているリージョンを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合は、リージョンを cn-hangzhou に設定します。
       cfg.region = "cn-hangzhou"
   
       # 設定ファイルを使用して OSSClient インスタンスを初期化します。
       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()
   
       # PutBucketQoSInfo 操作の入力パラメーターを指定して、バケットの QoS ルールを設定します。
       req = oss.OperationInput(
           op_name = 'PutBucketQoSInfo',  # 操作名。バケット QoS 情報を設定する操作を指定します。
           method = 'PUT',  # HTTP メソッドの種類。この例では、リソースを更新するために PUT を使用します。
           parameters = {
               'qosInfo': '',  # QoS 関連のパラメーター。
           },
           headers = None,  # リクエストヘッダー。追加のヘッダーを指定する必要がない場合は、フィールドを空のままにします。
           body = qos_xml_body,  # リクエストボディ。qos.xml ファイルから読み込んだ内容を含みます。
           bucket = 'examplebucket',  # バケット名。
       )
   
       # クライアントの invoke_operation メソッドを使用してリクエストを実行し、レスポンスまたはエラーメッセージを取得します。
       resp = client.invoke_operation(req)
   
       # 返された HTTP ステータスコードを表示します。
       print(resp.status_code)
   
       # レスポンスヘッダーを表示します。
       print(resp.headers)
   
   if __name__ == "__main__":
       GetBucketQoSInfo()

API

次のリクエストボディを使用して PutBucketQoSInfo 操作を呼び出し、バケットの帯域幅を制限します。

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

コンソール

1. RAM ユーザー ID を取得します。

2. Resource Pool QoS ページで、対象のリソースプール名をクリックします。次に、対象バケットの右側にある リクエスト元ごとのフロー制御 をクリックし、RAM ユーザーがバケットにアクセスする際に必要な帯域幅を設定します。

ossutil

開始する前に、ossutil をインストールしてください。

次の例は、リソースプール内のバケットにアクセスする RAM ユーザーの帯域幅を制限する方法を示しています。

1. qos.xml という名前のローカル XML ファイルで、リソースプール内のバケットにアクセスする RAM ユーザーの帯域幅制限を設定します。

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

2. RAM ユーザー ID を取得します。

3. 帯域幅構成を RAM ユーザーに適用します。次のコマンドは、UID が 266xxxx の RAM ユーザーが 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. （オプション）RAM ユーザーの帯域幅構成を表示します。

   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 ユーザーの帯域幅を制限できます。

1. qos.xml という名前のローカルファイルで、リソースプール内のバケットにアクセスする RAM ユーザーの帯域幅制限を設定します。

   <QoSConfiguration>
     <TotalUploadBandwidth>100</TotalUploadBandwidth>
     <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
     <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
     <TotalDownloadBandwidth>100</TotalDownloadBandwidth>
     <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
     <ExtranetDownloadBandwidth>-1</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
   
       # バケットが配置されているリージョンを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合は、リージョンを cn-hangzhou に設定します。
       cfg.region = "cn-hangzhou"
   
       # 設定ファイルを使用して OSSClient インスタンスを初期化します。
       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()
   
       # バケットにアクセスするリクエスターの速度制限ルールを設定するための PutBucketRequesterQoSInfo 操作の入力パラメーターを指定します。
       req = oss.OperationInput(
           op_name = 'PutBucketRequesterQoSInfo',  # 操作名。
           method = 'PUT',  # HTTP メソッドの種類。この例では PUT を使用します。
           parameters = {
               'requesterQosInfo': '',  # QoS 関連のパラメーター。
               'qosRequester': '2598732222222xxxx',  # リクエスターを識別するための一意の識別子。異なるリクエスターを区別するために使用されます。
           },
           headers = None,  # リクエストヘッダー。追加のヘッダーを指定する必要がない場合は、フィールドを空のままにします。
           body = qos_xml_body,  # リクエストボディ。qos.xml ファイルから読み込んだ内容を含みます。
           bucket = 'examplebucket',  # バケット名。
       )
   
       # クライアントの invoke_operation メソッドを使用してリクエストを実行し、レスポンスを取得します。
       resp = client.invoke_operation(req)
   
       # 返された HTTP ステータスコードを表示します。
       print(resp.status_code)
   
       # レスポンスヘッダーを表示します。
       print(resp.headers)
   
       # レスポンスボディを表示します。通常、リクエストによって返された具体的なデータが含まれます。
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutBucketRequesterQoSInfo()

API

1. RAM ユーザー ID を取得します。

2. 次のリクエストボディを使用して PutBucketRequesterQoSInfo 操作を呼び出し、バケットにアクセスする RAM ユーザーの帯域幅を制限します。

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

コンソール

1. RAM ロール ID を取得します。

2. Resource Pool QoS ページで、対象のリソースプール名をクリックします。次に、対象バケットの右側にある リクエスト元ごとのフロー制御 をクリックし、必要なリクエスターバンド幅を設定します。

ossutil

開始する前に、ossutil をインストールしてください。

1. qos.xml という名前のローカル XML ファイルで、特定のバケットにアクセスする RAM ロールの帯域幅制限を設定します。

   <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 ロールに適用します。次のコマンドは、ID が 362xxxx の RAM ロールが 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 ロールの帯域幅を制限できます。

1. qos.xml という名前のローカルファイルで、リソースプール内のバケットにアクセスする RAM ロールの帯域幅制限を設定します。

   <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
   
       # バケットが配置されているリージョンを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合は、リージョンを cn-hangzhou に設定します。
       cfg.region = "cn-hangzhou"
   
       # 設定ファイルを使用して OSSClient インスタンスを初期化します。
       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()
   
       # バケットにアクセスするリクエスターの速度制限ルールを設定するための PutBucketRequesterQoSInfo 操作の入力パラメーターを指定します。
       req = oss.OperationInput(
           op_name = 'PutBucketRequesterQoSInfo',  # 操作名。
           method = 'PUT',  # HTTP メソッドの種類。この例では PUT を使用します。
           parameters = {
               'requesterQosInfo': '',  # QoS 関連のパラメーター。
               'qosRequester': '2598732222222xxxx',  # リクエスターを識別するための一意の識別子。異なるリクエスターを区別するために使用されます。
           },
           headers = None,  # リクエストヘッダー。追加のヘッダーを指定する必要がない場合は、フィールドを空のままにします。
           body = qos_xml_body,  # リクエストボディ。qos.xml ファイルから読み込んだ内容を含みます。
           bucket = 'examplebucket',  # バケット名。
       )
   
       # クライアントの invoke_operation メソッドを使用してリクエストを実行し、レスポンスを取得します。
       resp = client.invoke_operation(req)
   
       # 返された HTTP ステータスコードを表示します。
       print(resp.status_code)
   
       # レスポンスヘッダーを表示します。
       print(resp.headers)
   
       # レスポンスボディを表示します。通常、リクエストによって返された具体的なデータが含まれます。
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutBucketRequesterQoSInfo()

API

1. RAM ロール ID を取得します。

2. 次のリクエストボディを使用して PutBucketRequesterQoSInfo 操作を呼び出し、バケットにアクセスする RAM ロールの帯域幅を制限します。

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

コンソール

1. Resource Pool QoS ページで、対象のリソースプール名をクリックします。次に、バケットグループの作成 をクリックし、BucketGroup の名前を定義して必要な帯域幅を設定します。

2. 対象のリソースプールページで、対象バケットの右側にある バケットグループ をクリックし、低優先度のバケットを BucketGroup に追加します。

ossutil

開始する前に、ossutil をインストールしてください。

1. 次のコマンドは、scheduled-posts バケットおよび archived-comments バケットを 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 内のバケット一覧を取得します。

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

2. qos.xml という名前のローカル 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. リソースプールからバケットを 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
   
       # バケットが配置されているリージョンを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合は、リージョンを cn-hangzhou に設定します。
       cfg.region = "cn-hangzhou"
   
       # 設定ファイルを使用して OSSClient インスタンスを初期化します。
       client = oss.Client(cfg)
   
       # PutBucketResourcePoolBucketGroup 操作の入力パラメーターを指定します。
       req = oss.OperationInput(
           op_name = 'PutBucketResourcePoolBucketGroup',  # 操作名。
           method = 'PUT',  # HTTP メソッドの種類。この例では PUT を使用します。
           parameters = {
               'resourcePoolBucketGroup': 'example-group',  # リソースプール内のバケットグループ名。
               'resourcePool': 'example-resource-pool',               # リソースプール名。
           },
           headers = None,  # リクエストヘッダー。追加のヘッダーを指定する必要がない場合は、フィールドを空のままにします。
           body = None,  # リクエストボディ。通常、PUT リクエストでは不要です。
           bucket = 'examplebucket',  # バケット名。
       )
   
       # クライアントの invoke_operation メソッドを使用してリクエストを実行し、レスポンスを取得します。
       resp = client.invoke_operation(req)
   
       # 返された HTTP ステータスコードを表示します。
       print(resp.status_code)
   
       # レスポンスヘッダーを表示します。
       print(resp.headers)
   
       # レスポンスボディを表示します。通常、リクエストによって返された具体的なデータが含まれます。
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutBucketResourcePoolBucketGroup()

2. qos.xml という名前のローカル 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
   
       # バケットが配置されているリージョンを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合は、リージョンを cn-hangzhou に設定します。
       cfg.region = "cn-hangzhou"
   
       # 設定ファイルを使用して OSSClient インスタンスを初期化します。
       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()
   
       # PutResourcePoolBucketGroupQoSInfo 操作の入力パラメーターを指定します。
       req = oss.OperationInput(
           op_name = 'PutResourcePoolBucketGroupQoSInfo',  # 操作名。
           method = 'PUT',  # HTTP メソッドの種類。この例では PUT を使用します。
           parameters = {
               'resourcePoolBucketGroupQosInfo': '',  # QoS 関連のパラメーター。
               'resourcePool': 'example-resource-pool',           #  リソースプール名
               'resourcePoolBucketGroup': 'example-group',  # バケットグループ名。
           },
           headers = None,  # リクエストヘッダー。追加のヘッダーを指定する必要がない場合は、フィールドを空のままにします。
           body = qos_xml_body,  # リクエストボディ。qos.xml ファイルから読み込んだ内容を含みます。
           bucket = None,  # バケット名。PUT リクエストでは不要です。この操作は特定のバケットに対して実行されません。
       )
   
       # クライアントの invoke_operation メソッドを使用してリクエストを実行し、レスポンスを取得します。
       resp = client.invoke_operation(req)
   
       # 返された HTTP ステータスコードを表示します。
       print(resp.status_code)
   
       # レスポンスヘッダーを表示します。
       print(resp.headers)
   
       # レスポンスボディを表示します。通常、リクエストによって返された具体的なデータが含まれます。
       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. Resource Pool QoS ページで、対象のリソースプール名をクリックします。リクエスト元ごとのフロー制御 タブで、対象の RAM ユーザーまたは RAM ロールの右側にある フロー制御の変更 をクリックし、必要なリクエスターバンド幅を設定します。

ossutil

開始する前に、ossutil をインストールしてください。

1. qos.xml という名前のローカル 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 の RAM ユーザーに構成を適用します。

   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
   
       # バケットが配置されているリージョンを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合は、リージョンを cn-hangzhou に設定します。
       cfg.region = "cn-hangzhou"
   
       # 設定ファイルを使用して OSSClient インスタンスを初期化します。
       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()
   
       # PutResourcePoolRequesterQoSInfo 操作の入力パラメーターを指定します。
       req = oss.OperationInput(
           op_name = 'PutResourcePoolRequesterQoSInfo',  # 操作名。
           method = 'PUT',  # HTTP メソッドの種類。この例では PUT を使用します。
           parameters = {
               'requesterQosInfo': '',  # QoS 関連のパラメーター。
               'resourcePool': 'example-resource-pool',  # リソースプール名。
               'qosRequester': '2598732222222xxxx',  # リクエスターの ID。
           },
           headers = None,  # リクエストヘッダー。追加のヘッダーを指定する必要がない場合は、フィールドを空のままにします。
           body = qos_xml_body,  # リクエストボディ。qos.xml ファイルから読み込んだ内容を含みます。
           bucket = None,  # バケット名。PUT リクエストでは不要です。操作は特定のバケットに対して実行されません。
       )
   
       # クライアントの invoke_operation メソッドを使用してリクエストを実行し、レスポンスを取得します。
       resp = client.invoke_operation(req)
   
       # 返された HTTP ステータスコードを表示します。
       print(resp.status_code)
   
       # レスポンスヘッダーを表示します。
       print(resp.headers)
   
       # レスポンスボディを表示します。通常、リクエストによって返された具体的なデータが含まれます。
       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 という名前の優先度 QoS 構成ファイルを作成します。

   <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 main() {
	// バケットが配置されているリージョンを指定します。たとえば、中国 (杭州) の場合はリージョンを 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 という名前のリクエスタープライオリティ QoS 構成ファイルを作成します。

   <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 main() {
	// バケットが配置されているリージョンを指定します。たとえば、中国 (杭州) の場合はリージョンを 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