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

コンソール

リソースプール QoSページで、対象のリソースプール名をクリックします。対象のバケットについて、速度制限構成の変更をクリックし、帯域幅の値を設定します。

ossutil

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

1. 帯域幅構成を含むローカル XML ファイル qos.xml を作成します。

   Intranet は内部ネットワーク（VPC）トラフィックを指します。Extranet はパブリックネットワークトラフィックを指します。すべての値は Gbps 単位です。無制限にするには -1 を設定します。

      import alibabacloud_oss_v2 as oss
   
      def put_bucket_qos_info():
          credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
          cfg = oss.config.load_default()
          cfg.credentials_provider = credentials_provider
          cfg.region = "cn-hangzhou"  # ご使用のバケットのリージョンに置き換えてください
   
          client = oss.Client(cfg)
   
          with open('qos.xml', 'r') as f:
              qos_xml_body = f.read()
   
          req = oss.OperationInput(
              op_name='PutBucketQoSInfo',
              method='PUT',
              parameters={'qosInfo': ''},
              headers=None,
              body=qos_xml_body,
              bucket='examplebucket',  # ご使用のバケット名に置き換えてください
          )
   
          resp = client.invoke_operation(req)
          print(resp.status_code)
   
      if __name__ == "__main__":
          put_bucket_qos_info()

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. 上記の ossutil の例と同じ内容で qos.xml を作成します。

2. 構成を適用します：Python

      import alibabacloud_oss_v2 as oss
   
      def put_bucket_qos_info():
          credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
          cfg = oss.config.load_default()
          cfg.credentials_provider = credentials_provider
          cfg.region = "cn-hangzhou"  # ご利用のバケットのリージョンに置き換えてください
   
          client = oss.Client(cfg)
   
          with open('qos.xml', 'r') as f:
              qos_xml_body = f.read()
   
          req = oss.OperationInput(
              op_name='PutBucketQoSInfo',
              method='PUT',
              parameters={'qosInfo': ''},
              headers=None,
              body=qos_xml_body,
              bucket='examplebucket',  # ご利用のバケット名に置き換えてください
          )
   
          resp = client.invoke_operation(req)
          print(resp.status_code)
   
      if __name__ == "__main__":
          put_bucket_qos_info()

API

以下のリクエストボディで PutBucketQoSInfo を呼び出します。

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

コンソール

1. リソースプール QoSページで、対象のリソースプール名をクリックします。BucketGroup の作成をクリックし、名前を入力して帯域幅制限を設定します。

2. グループに追加する各バケットについて、バケットの右側にあるBucketGroup の設定をクリックします。

ossutil

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

1. バケットを BucketGroup に追加します（バケットごとに 1 回実行）。

      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
   
      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

2. （任意）BucketGroup 内のすべてのバケットを一覧表示します。

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

3. BucketGroup の帯域幅制限を含む qos.xml を作成します。

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

4. 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

5. （任意）構成を確認します。

      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

BucketGroup 帯域幅制限は Python SDK V2 および Go SDK V2 でサポートされています。

1. バケットを BucketGroup に追加します：Python

      import alibabacloud_oss_v2 as oss
   
      def put_bucket_resource_pool_bucket_group():
          credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
          cfg = oss.config.load_default()
          cfg.credentials_provider = credentials_provider
          cfg.region = "cn-hangzhou"
   
          client = oss.Client(cfg)
   
          req = oss.OperationInput(
              op_name='PutBucketResourcePoolBucketGroup',
              method='PUT',
              parameters={
                  'resourcePoolBucketGroup': 'example-group',  # ご利用の BucketGroup 名に置き換えてください
                  'resourcePool': 'example-resource-pool',     # ご利用のリソースプール名に置き換えてください
              },
              headers=None,
              body=None,
              bucket='examplebucket',  # ご利用のバケット名に置き換えてください
          )
   
          resp = client.invoke_operation(req)
          print(resp.status_code)
   
      if __name__ == "__main__":
          put_bucket_resource_pool_bucket_group()

2. 帯域幅制限を含む qos.xml を作成します（上記の ossutil の例と同じ内容）。

3. BucketGroup に帯域幅構成を適用します：Python

      import alibabacloud_oss_v2 as oss
   
      def put_resource_pool_bucket_group_qos_info():
          credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
          cfg = oss.config.load_default()
          cfg.credentials_provider = credentials_provider
          cfg.region = "cn-hangzhou"
   
          client = oss.Client(cfg)
   
          with open('qos.xml', 'r') as f:
              qos_xml_body = f.read()
   
          req = oss.OperationInput(
              op_name='PutResourcePoolBucketGroupQoSInfo',
              method='PUT',
              parameters={
                  'resourcePoolBucketGroupQosInfo': '',
                  'resourcePool': 'example-resource-pool',    # ご利用のリソースプール名に置き換えてください
                  'resourcePoolBucketGroup': 'example-group', # ご利用の BucketGroup 名に置き換えてください
              },
              headers=None,
              body=qos_xml_body,
              bucket=None,
          )
   
          resp = client.invoke_operation(req)
          print(resp.status_code)
   
      if __name__ == "__main__":
          put_resource_pool_bucket_group_qos_info()

API

以下のリクエストボディで PutResourcePoolBucketGroupQoSInfo を呼び出します。

<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 を作成します。

      <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. 構成を適用します（examplepool および 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 でサポートされています。

1. 上記の ossutil の例と同じ内容で qos.xml を作成します。

2. RAM ユーザー ID または RAM ロール ID を取得します。

3. 構成を適用します：Python

      import alibabacloud_oss_v2 as oss
   
      def put_resource_pool_requester_qos_info():
          credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
          cfg = oss.config.load_default()
          cfg.credentials_provider = credentials_provider
          cfg.region = "cn-hangzhou"
   
          client = oss.Client(cfg)
   
          with open('qos.xml', 'r') as f:
              qos_xml_body = f.read()
   
          req = oss.OperationInput(
              op_name='PutResourcePoolRequesterQoSInfo',
              method='PUT',
              parameters={
                  'requesterQosInfo': '',
                  'resourcePool': 'example-resource-pool',  # ご利用のリソースプール名に置き換えてください
                  'qosRequester': '2598732222222xxxx',       # RAM ユーザーまたはロール ID に置き換えてください
              },
              headers=None,
              body=qos_xml_body,
              bucket=None,
          )
   
          resp = client.invoke_operation(req)
          print(resp.status_code)
          print(resp.headers)
          print(resp.http_response.content)
   
      if __name__ == "__main__":
          put_resource_pool_requester_qos_info()

API

1. RAM ユーザー ID または RAM ロール ID を取得します。

2. 以下のリクエストボディで PutResourcePoolRequesterQoSInfo を呼び出します。

      <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>
   
        <!-- Priority 3（最高優先度）：コアサービスバケット -->
        <QosPriorityLevelConfiguration>
          <PriorityLevel>3</PriorityLevel>
          <GuaranteedQosConfiguration>
            <TotalUploadBandwidth>50</TotalUploadBandwidth>
            <IntranetUploadBandwidth>20</IntranetUploadBandwidth>
            <ExtranetUploadBandwidth>30</ExtranetUploadBandwidth>
            <TotalDownloadBandwidth>80</TotalDownloadBandwidth>
            <IntranetDownloadBandwidth>30</IntranetDownloadBandwidth>
            <ExtranetDownloadBandwidth>50</ExtranetDownloadBandwidth>
          </GuaranteedQosConfiguration>
          <Subjects>
            <Bucket>critical-bucket</Bucket>
            <BucketGroup>core-group</BucketGroup>
          </Subjects>
        </QosPriorityLevelConfiguration>
   
        <!-- Priority 2：重要サービスバケット -->
        <QosPriorityLevelConfiguration>
          <PriorityLevel>2</PriorityLevel>
          <GuaranteedQosConfiguration>
            <TotalUploadBandwidth>30</TotalUploadBandwidth>
            <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
            <ExtranetUploadBandwidth>20</ExtranetUploadBandwidth>
            <TotalDownloadBandwidth>50</TotalDownloadBandwidth>
            <IntranetDownloadBandwidth>20</IntranetDownloadBandwidth>
            <ExtranetDownloadBandwidth>30</ExtranetDownloadBandwidth>
          </GuaranteedQosConfiguration>
          <Subjects>
            <Bucket>important-bucket</Bucket>
          </Subjects>
        </QosPriorityLevelConfiguration>
      </PriorityQosConfiguration>

2. 構成を適用します（hz-rp-03 はご利用のリソースプール名に置き換えてください）。

      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

Go

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 をご利用のバケットのリージョンに置き換えてください
    cfg := oss.LoadDefaultConfig().
        WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
        WithRegion("cn-hangzhou")

    client := oss.NewClient(cfg)

    resourcePool := "hz-rp-01" // ご利用のリソースプール名に置き換えてください

    qosConf, err := os.ReadFile("priority-qos.xml")
    if err != nil {
        fmt.Printf("failed to read priority-qos.xml: %v\n", err)
        os.Exit(1)
    }

    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",
        Parameters: map[string]string{
            "priorityQos":  "",
            "resourcePool": resourcePool,
        },
        Headers: map[string]string{
            "Content-MD5": calcMd5(qosConf),
        },
        Body:   bytes.NewReader(qosConf),
        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("PutResourcePoolPriorityQoSConfiguration result:", 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>
   
        <!-- Priority 3（最高優先度）：プレミアム顧客 -->
        <QosPriorityLevelConfiguration>
          <PriorityLevel>3</PriorityLevel>
          <GuaranteedQosConfiguration>
            <TotalUploadBandwidth>60</TotalUploadBandwidth>
            <IntranetUploadBandwidth>20</IntranetUploadBandwidth>
            <ExtranetUploadBandwidth>40</ExtranetUploadBandwidth>
            <TotalDownloadBandwidth>100</TotalDownloadBandwidth>
            <IntranetDownloadBandwidth>40</IntranetDownloadBandwidth>
            <ExtranetDownloadBandwidth>60</ExtranetDownloadBandwidth>
          </GuaranteedQosConfiguration>
          <Subjects>
            <Requester>123456789012****</Requester>
            <Requester>234567890123****</Requester>
          </Subjects>
        </QosPriorityLevelConfiguration>
   
        <!-- Priority 2：スタンダード顧客 -->
        <QosPriorityLevelConfiguration>
          <PriorityLevel>2</PriorityLevel>
          <GuaranteedQosConfiguration>
            <TotalUploadBandwidth>30</TotalUploadBandwidth>
            <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
            <ExtranetUploadBandwidth>20</ExtranetUploadBandwidth>
            <TotalDownloadBandwidth>50</TotalDownloadBandwidth>
            <IntranetDownloadBandwidth>20</IntranetDownloadBandwidth>
            <ExtranetDownloadBandwidth>30</ExtranetDownloadBandwidth>
          </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

Go

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() {
    cfg := oss.LoadDefaultConfig().
        WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
        WithRegion("cn-hangzhou") // ご利用のリージョンに置き換えてください

    client := oss.NewClient(cfg)

    resourcePool := "hz-rp-01" // ご利用のリソースプール名に置き換えてください

    qosConf, err := os.ReadFile("requester-priority-qos.xml")
    if err != nil {
        fmt.Printf("failed to read requester-priority-qos.xml: %v\n", err)
        os.Exit(1)
    }

    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",
        Parameters: map[string]string{
            "requesterPriorityQos": "",
            "resourcePool":         resourcePool,
        },
        Headers: map[string]string{
            "Content-MD5": calcMd5(qosConf),
        },
        Body:   bytes.NewReader(qosConf),
        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("PutResourcePoolRequesterPriorityQoSConfiguration result:", res.Status)
}

API

PutResourcePoolRequesterPriorityQosConfiguration