Object Storage Service:リソースプール QoS を使用してクリティカルサービスの帯域幅を保証する

コンソール

リソースプール 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__":
       PutBucketQoSInfo()

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. リソースプール 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. リソースプール 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. リソースプール 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. リソースプール 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. 優先度 QoS 構成ファイル 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 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("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("操作の呼び出しでエラーが発生しました： %v\n", err)
		os.Exit(1)
	}

	// 操作結果を出力します。
	fmt.Println("PutResourcePoolPriorityQoSConfiguration の結果：", res.Status)
}

API

PutResourcePoolPriorityQosConfiguration

ossutil

1. リクエスタ優先度 QoS 構成ファイル 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 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("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("操作の呼び出しでエラーが発生しました： %v\n", err)
		os.Exit(1)
	}

	// 操作結果を出力します。
	fmt.Println("PutResourcePoolRequesterPriorityQoSConfiguration の結果：", res.Status)
}

API

PutResourcePoolRequesterPriorityQosConfiguration