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__":
       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. リソースプールの 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) に上記の帯域幅設定を追加するには、次のコマンドを実行します。この例では、バケット名は 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 という名前のローカル 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 設定ファイルを使用して、このロールが特定のバケットにアクセスするための帯域幅制限を設定できます。

   <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) が特定のバケットにアクセスするための帯域幅設定を追加するには、次のコマンドを実行します。この例では、バケット名は 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 という名前のローカル 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 の作成] をクリックし、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. リソースプールから 2 つのバケットを 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) に上記の帯域幅設定を追加するには、次のコマンドを実行します。

   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 という名前のローカル 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 という名前の優先度設定ファイルを作成します。

   <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() {
	// バケットが配置されているリージョンを指定します。たとえば、中国 (杭州) の場合は 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), // データ整合性を確保するために、リクエストボディの Content-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() {
	// バケットが配置されているリージョンを指定します。たとえば、中国 (杭州) の場合は 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), // データ整合性を確保するために、リクエストボディの Content-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