Object Storage Service:Use resource pool QoS to guarantee bandwidth for critical services

Console

Na página Resource Pool QoS, clique em Modify Throttling Configurations à direita do bucket alvo e defina a largura de banda do bucket conforme necessário.

ossutil

Antes de começar, Instale o ossutil.

1. Configure o limite de largura de banda para o bucket com um arquivo XML local chamado qos.xml.

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

2. Aplique a configuração de largura de banda a um bucket específico. O comando a seguir aplica a configuração a um bucket chamado examplebucket.

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

3. Visualize a configuração de largura de banda do bucket.

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

SDK

Defina o limite de largura de banda para um bucket usando apenas o Python SDK V2 e o Go SDK V2.

1. Configure o limite de largura de banda para o bucket com um arquivo local chamado qos.xml.

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

2. Aplique a configuração de largura de banda a um bucket específico.

   import alibabacloud_oss_v2 as oss
   
   def PutBucketQoSInfo():
      # Obtain access credentials from environment variables for authentication
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # Load default configurations and obtain the configuration file.
       cfg = oss.config.load_default()
   
       # Specify the credential provider.
       cfg.credentials_provider = credentials_provider
   
       # Specify the region in which the bucket is located. For example, if your bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou.
       cfg.region = "cn-hangzhou"
   
       # Initialize the OSSClient instance by using the configuration file.
       client = oss.Client(cfg)
   
       # Set qos_xml_body to an empty string.
       qos_xml_body = ""
   
       # Open the file named qos.xml and read its content into the qos_xml_body variable.
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # Specify input parameters for the PutBucketQoSInfo operation to specify the QoS rules for the bucket.
       req = oss.OperationInput(
           op_name = 'PutBucketQoSInfo',  # Operation name, specifying the operation to set bucket QoS information
           method = 'PUT',  # The type of the HTTP method. In this example, PUT is used to update resources.
           parameters = {
               'qosInfo': '',  # The QoS-related parameters.
           },
           headers = None,  # The request headers. If you do not need to specify additional headers, leave the field empty.
           body = qos_xml_body,  # The request body, which contains the content read from the qos.xml file.
           bucket = 'examplebucket',  # The name of the bucket.
       )
   
       # Use the invoke_operation method of the client to run the request and obtain the response or error message.
       resp = client.invoke_operation(req)
   
       # Display the returned HTTP status code.
       print(resp.status_code)
   
       # Display the response headers.
       print(resp.headers)
   
   if __name__ == "__main__":
       PutBucketQoSInfo()

API

Chame a operação PutBucketQoSInfo com o seguinte corpo de solicitação para limitar a largura de banda de um bucket.

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

Console

1. Obtenha o ID do usuário RAM.

2. Na página Resource Pool QoS, clique em Configure Bandwidth Throttling Rules à direita do bucket alvo e defina a largura de banda necessária para o usuário RAM acessar o bucket.

ossutil

Antes de começar, Instale o ossutil.

O exemplo a seguir mostra como limitar a largura de banda para um usuário RAM que acessa um bucket em um pool de recursos.

1. Configure o limite de largura de banda para um usuário RAM que acessa um bucket no pool de recursos com um arquivo XML local chamado qos.xml.

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

2. Obtenha o ID do usuário RAM.

3. Aplique a configuração de largura de banda a um usuário RAM. O comando a seguir aplica a configuração ao usuário RAM com o UID 266xxxx que acessa o bucket 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. (Opcional) Visualize a configuração de largura de banda para o usuário RAM.

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

SDK

Limite a largura de banda para um usuário RAM que acessa um bucket usando apenas o Python SDK V2 e o Go SDK V2.

1. Configure o limite de largura de banda para um usuário RAM que acessa um bucket no pool de recursos com um arquivo local chamado qos.xml.

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

2. Obtenha o ID do usuário RAM.

3. Aplique a configuração de largura de banda ao usuário RAM que acessa o bucket.

   import alibabacloud_oss_v2 as oss
   
   def PutBucketRequesterQoSInfo():
       # Obtain access credentials from environment variables for authentication.
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # Load default configurations and obtain the configuration file.
       cfg = oss.config.load_default()
   
       # Specify the credential provider.
       cfg.credentials_provider = credentials_provider
   
       # Specify the region in which the bucket is located. For example, if your bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou.
       cfg.region = "cn-hangzhou"
   
       # Initialize the OSSClient instance by using the configuration file.
       client = oss.Client(cfg)
   
       # Set qos_xml_body to an empty string.
       qos_xml_body = ""
   
       # Open a file named qos.xml and read its content into the qos_xml_body variable.
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # Specify input parameters for the PutBucketRequesterQoSInfo operation to configure throttling rules for a requester accessing a bucket.
       req = oss.OperationInput(
           op_name = 'PutBucketRequesterQoSInfo',  # The name of the operation.
           method = 'PUT',  # The type of the HTTP method. In this example, PUT is used.
           parameters = {
               'requesterQosInfo': '',  # The QoS-related parameters.
               'qosRequester': '2598732222222xxxx',  # The unique identifier for the requester, which is used to distinguish different requesters.
           },
           headers = None,  # The request headers. If you do not need to specify additional headers, leave the field empty.
           body = qos_xml_body,  # The request body, which contains the content read from the qos.xml file.
           bucket = 'examplebucket',  # The name of the bucket.
       )
   
       # Use the invoke_operation method of the client to execute the request and obtain the response.
       resp = client.invoke_operation(req)
   
       # Display the returned HTTP status code.
       print(resp.status_code)
   
       # Display the response headers.
       print(resp.headers)
   
       # Display the response body, which typically contains the specific data returned by the request.
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutBucketRequesterQoSInfo()

API

1. Obtenha o ID do usuário RAM.

2. Chame a operação PutBucketRequesterQoSInfo com o seguinte corpo de solicitação para limitar a largura de banda de um usuário RAM que acessa um bucket.

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

Console

1. Obtenha o ID da função RAM.

2. Na página Resource Pool QoS, clique em Configure Bandwidth Throttling Rules à direita do bucket alvo e defina a largura de banda do solicitante conforme necessário.

ossutil

Antes de começar, Instale o ossutil.

1. Configure o limite de largura de banda para a função RAM que acessa um bucket específico com um arquivo XML local chamado qos.xml.

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

2. Obtenha o ID da função RAM.

3. Aplique a configuração de largura de banda a uma função RAM. O comando a seguir aplica a configuração à função RAM com o ID 362xxxx que acessa o bucket examplebucket.

   ossutil api invoke-operation --op-name put-bucket-requester-qos-info --method PUT --bucket=examplebucket --parameters requesterQosInfo --parameters qosRequester=362xxxx --body file://qos.xml

4. (Opcional) Liste as configurações de largura de banda para todas as funções RAM no pool de recursos.

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

SDK

Limite a largura de banda para uma função RAM que acessa um bucket usando apenas o Python SDK V2 e o Go SDK V2.

1. Configure o limite de largura de banda para a função RAM que acessa um bucket no pool de recursos com um arquivo local chamado qos.xml.

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

2. Obtenha o ID da função RAM.

3. Aplique a configuração de largura de banda à função RAM.

   import alibabacloud_oss_v2 as oss
   
   def PutBucketRequesterQoSInfo():
       # Obtain access credentials from environment variables for authentication.
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # Load default configurations and obtain the configuration file.
       cfg = oss.config.load_default()
   
       # Specify the credential provider.
       cfg.credentials_provider = credentials_provider
   
       # Specify the region in which the bucket is located. For example, if your bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou.
       cfg.region = "cn-hangzhou"
   
       # Initialize the OSSClient instance by using the configuration file.
       client = oss.Client(cfg)
   
       # Set qos_xml_body to an empty string.
       qos_xml_body = ""
   
       # Open a file named qos.xml and read its content into the qos_xml_body variable.
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # Specify input parameters for the PutBucketRequesterQoSInfo operation to configure throttling rules for a requester accessing a bucket.
       req = oss.OperationInput(
           op_name = 'PutBucketRequesterQoSInfo',  # The name of the operation.
           method = 'PUT',  # The type of the HTTP method. In this example, PUT is used.
           parameters = {
               'requesterQosInfo': '',  # The QoS-related parameters.
               'qosRequester': '2598732222222xxxx',  # The unique identifier for the requester, which is used to distinguish different requesters.
           },
           headers = None,  # The request headers. If you do not need to specify additional headers, leave the field empty.
           body = qos_xml_body,  # The request body, which contains the content read from the qos.xml file.
           bucket = 'examplebucket',  # The name of the bucket.
       )
   
       # Use the invoke_operation method of the client to execute the request and obtain the response.
       resp = client.invoke_operation(req)
   
       # Display the returned HTTP status code.
       print(resp.status_code)
   
       # Display the response headers.
       print(resp.headers)
   
       # Display the response body, which typically contains the specific data returned by the request.
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutBucketRequesterQoSInfo()

API

1. Obtenha o ID da função RAM.

2. Chame a operação PutBucketRequesterQoSInfo com o seguinte corpo de solicitação para limitar a largura de banda de uma função RAM que acessa um bucket.

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

Console

1. Na página Resource Pool QoS, clique em Create A Bucket Group, defina um nome para o BucketGroup e configure a largura de banda necessária.

2. Na página do pool de recursos alvo, clique em Create Bucket Group à direita de um bucket alvo para adicionar o bucket de baixa prioridade ao BucketGroup.

ossutil

Antes de começar, Instale o ossutil.

1. Os comandos a seguir adicionam os buckets scheduled-posts e archived-comments a um BucketGroup.

   1. Adicione o bucket scheduled-posts ao 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. Adicione o bucket archived-comments ao 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. (Opcional) Obtenha a lista de buckets no BucketGroup.

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

2. Configure o limite de largura de banda para um BucketGroup específico no pool de recursos com um arquivo XML local chamado qos.xml.

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

3. Aplique a configuração de largura de banda ao 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. (Opcional) Obtenha a configuração de largura de banda do 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

Limite a largura de banda de um BucketGroup usando apenas o Python SDK V2 e o Go SDK V2.

1. Adicione buckets de um pool de recursos a um BucketGroup.

   import alibabacloud_oss_v2 as oss
   
   def PutBucketResourcePoolBucketGroup():
       # Obtain access credentials from environment variables for authentication.
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # Load default configurations and obtain the configuration file.
       cfg = oss.config.load_default()
   
       # Specify the credential provider.
       cfg.credentials_provider = credentials_provider
   
       # Specify the region in which the bucket is located. For example, if your bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou.
       cfg.region = "cn-hangzhou"
   
       # Initialize the OSSClient instance by using the configuration file.
       client = oss.Client(cfg)
   
       # Specify input parameters for the PutBucketResourcePoolBucketGroup operation.
       req = oss.OperationInput(
           op_name = 'PutBucketResourcePoolBucketGroup',  # The name of the operation.
           method = 'PUT',  # The type of the HTTP method type. In this example, PUT is used.
           parameters = {
               'resourcePoolBucketGroup': 'example-group',  # The name of the bucket group in the resource pool.
               'resourcePool': 'example-resource-pool',               # The name of the resource pool.
           },
           headers = None,  # The request headers. If you do not need to specify additional headers, leave the field empty.
           body = None,  # The request body, which is typically not required for PUT requests.
           bucket = 'examplebucket',  # The name of the bucket.
       )
   
       # Use the invoke_operation method of the client to execute the request and obtain the response.
       resp = client.invoke_operation(req)
   
       # Display the returned HTTP status code.
       print(resp.status_code)
   
       # Display the response headers.
       print(resp.headers)
   
       # Display the response body, which typically contains the specific data returned by the request.
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutBucketResourcePoolBucketGroup()

2. Configure o limite de largura de banda para um BucketGroup específico no pool de recursos com um arquivo XML local chamado qos.xml.

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

3. Aplique a configuração de largura de banda ao BucketGroup.

   import alibabacloud_oss_v2 as oss
   
   def PutResourcePoolBucketGroupQoSInfo():
       # Obtain access credentials from environment variables for authentication.
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # Load default configurations and obtain the configuration file.
       cfg = oss.config.load_default()
   
       # Specify the credential provider.
       cfg.credentials_provider = credentials_provider
   
       # Specify the region in which the bucket is located. For example, if your bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou.
       cfg.region = "cn-hangzhou"
   
       # Initialize the OSSClient instance by using the configuration file.
       client = oss.Client(cfg)
   
       # Set qos_xml_body to an empty string.
       qos_xml_body = ""
   
       # Open and read the qos.xml file and write its content into the qos_xml_body variable.
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # Specify input parameters for the PutResourcePoolBucketGroupQoSInfo operation.
       req = oss.OperationInput(
           op_name = 'PutResourcePoolBucketGroupQoSInfo',  # The name of the operation.
           method = 'PUT',  # The type of the HTTP method type. In this example, PUT is used.
           parameters = {
               'resourcePoolBucketGroupQosInfo': '',  # The QoS-related parameters.
               'resourcePool': 'example-resource-pool',           #  The name of the resource pool
               'resourcePoolBucketGroup': 'example-group',  # The name of the bucket group.
           },
           headers = None,  # The request headers. If you do not need to specify additional headers, leave the field empty.
           body = qos_xml_body,  # The request body, which contains the content read from the qos.xml file.
           bucket = None,  # The name of the bucket, which is not required for PUT requests. This operation is not performed on a specific bucket.
       )
   
       # Use the invoke_operation method of the client to execute the request and obtain the response.
       resp = client.invoke_operation(req)
   
       # Display the returned HTTP status code.
       print(resp.status_code)
   
       # Display the response headers.
       print(resp.headers)
   
       # Display the response body, which typically contains the specific data returned by the request.
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutResourcePoolBucketGroupQoSInfo()

API

Chame a operação PutResourcePoolBucketGroupQoSInfo com o seguinte corpo de solicitação para limitar a largura de banda de um BucketGroup.

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

Console

1. Obtenha o ID do usuário RAM ou o ID da função RAM.

2. Na página Resource Pool QoS, clique em Modify Throttling Configurations à direita do usuário RAM ou função RAM alvo e defina a largura de banda do solicitante conforme necessário.

ossutil

Antes de começar, Instale o ossutil.

1. Configure o limite de largura de banda para um usuário RAM ou função RAM que acessa o pool de recursos com um arquivo XML local chamado qos.xml.

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

2. Obtenha o ID do usuário RAM ou o ID da função RAM.

3. Aplique a configuração de largura de banda a um usuário RAM. O comando a seguir aplica a configuração ao usuário RAM com o 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. (Opcional) Liste as configurações de largura de banda para todos os usuários RAM no pool de recursos.

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

SDK

Limite a largura de banda para um usuário RAM ou função RAM que acessa um pool de recursos usando apenas o Python SDK V2 e o Go SDK V2.

1. Configure o limite de largura de banda para um usuário RAM ou função RAM específico que acessa o pool de recursos com um arquivo local chamado qos.xml.

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

2. Obtenha o ID do usuário RAM ou o ID da função RAM.

3. Aplique a configuração de largura de banda ao usuário RAM ou função RAM.

   import alibabacloud_oss_v2 as oss
   
   def PutResourcePoolRequesterQoSInfo():
       # Obtain access credentials from environment variables for authentication.
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
   
       # Load default configurations and obtain the configuration file.
       cfg = oss.config.load_default()
   
       # Specify the credential provider.
       cfg.credentials_provider = credentials_provider
   
       # Specify the region in which the bucket is located. For example, if your bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou.
       cfg.region = "cn-hangzhou"
   
       # Initialize the OSSClient instance by using the configuration file.
       client = oss.Client(cfg)
   
       # Initialize qos_xml_body as an empty string
       qos_xml_body = ""
   
       # Open a file named qos.xml and read its content into the qos_xml_body variable.
       with open('qos.xml', 'r') as qos_file:
           qos_xml_body = qos_file.read()
   
       # Specify input parameters for the PutResourcePoolRequesterQoSInfo operation.
       req = oss.OperationInput(
           op_name = 'PutResourcePoolRequesterQoSInfo',  # The name of the operation.
           method = 'PUT',  # The type of the HTTP method type. In this example, PUT is used.
           parameters = {
               'requesterQosInfo': '',  # The QoS-related parameters.
               'resourcePool': 'example-resource-pool',  # The name of the resource pool.
               'qosRequester': '2598732222222xxxx',  # The ID of the requester.
           },
           headers = None,  # The request headers. If you do not need to specify additional headers, leave the field empty.
           body = qos_xml_body,  # The request body, which contains the content read from the qos.xml file.
           bucket = None,  # The name of the bucket, which is not required for PUT requests. The operation is not performed on a specific bucket.
       )
   
       # Use the invoke_operation method of the client to execute the request and obtain the response.
       resp = client.invoke_operation(req)
   
       # Display the returned HTTP status code.
       print(resp.status_code)
   
       # Display the response headers.
       print(resp.headers)
   
       # Display the response body, which typically contains the specific data returned by the request.
       print(resp.http_response.content)
   
   if __name__ == "__main__":
       PutResourcePoolRequesterQoSInfo()

API

1. Obtenha o ID do usuário RAM ou o ID da função RAM.

2. Chame a operação PutResourcePoolRequesterQoSInfo com o seguinte corpo de solicitação para limitar a largura de banda de um usuário RAM ou função RAM que acessa um pool de recursos.

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

ossutil

1. Crie um arquivo de configuração de QoS de prioridade chamado 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. Aplique a configuração.

   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. Obtenha e verifique a configuração.

   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() {
	// Specify the region where the bucket is located. For example, set the region to cn-hangzhou for China (Hangzhou).
	var region = "cn-hangzhou"

	// Load the default configurations and set the credential provider and region.
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region)

	// Create an OSS client.
	client := oss.NewClient(cfg)

	// Define the resource pool name.
	resourcePool := "hz-rp-01"

	// Read the content of the priority QoS configuration file.
	qosConf, err := os.ReadFile("priority-qos.xml")
	if err != nil {
		// If an error occurs while reading the QoS configuration file, print the error message and exit the program.
		fmt.Printf("failed to read qos.xml: %v\n", err)
		os.Exit(1)
	}

	// Calculate the MD5 hash of the input data and convert it to a Base64-encoded string.
	calcMd5 := func(input []byte) string {
		if len(input) == 0 {
			return "1B2M2Y8AsgTpgAmY7PhCfg=="
		}
		h := md5.New()
		h.Write(input)
		return base64.StdEncoding.EncodeToString(h.Sum(nil))
	}

	// Create the input parameters for the operation, including the action, method type, and other parameters.
	input := &oss.OperationInput{
		OpName: "PutResourcePoolPriorityQoSConfiguration", // The action.
		Method: "PUT",                                     // The HTTP method.
		Parameters: map[string]string{
			"priorityQos":  "",           // Priority QoS-related parameters.
			"resourcePool": resourcePool, // The resource pool name.
		},
		Headers: map[string]string{
			"Content-MD5": calcMd5(qosConf), // Set the MD5 hash of the request body for data integrity validation.
		},
		Body:   bytes.NewReader(qosConf), // The request body, which contains the QoS configuration content.
		Bucket: nil,                      // This operation does not apply to a specific bucket.
	}

	// Execute the operation and receive the response or an error.
	res, err := client.InvokeOperation(context.TODO(), input)
	if err != nil {
		// If an error occurs, print the error message and exit the program.
		fmt.Printf("invoke operation got error: %v\n", err)
		os.Exit(1)
	}

	// Print the operation result.
	fmt.Println("The result of PutResourcePoolPriorityQoSConfiguration:", res.Status)
}

API

PutResourcePoolPriorityQosConfiguration

ossutil

1. Crie um arquivo de configuração de QoS de prioridade do solicitante chamado 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. Aplique a configuração.

   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. (Opcional) Obtenha e verifique a configuração.

   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() {
	// Specify the region where the bucket is located. For example, set the region to cn-hangzhou for China (Hangzhou).
	var region = "cn-hangzhou"

	// Load the default configurations and set the credential provider and region.
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region)

	// Create an OSS client.
	client := oss.NewClient(cfg)

	// Define the resource pool name.
	resourcePool := "hz-rp-01"

	// Read the content of the requester priority QoS configuration file.
	qosConf, err := os.ReadFile("requester-priority-qos.xml")
	if err != nil {
		// If an error occurs while reading the QoS configuration file, print the error message and exit the program.
		fmt.Printf("failed to read qos.xml: %v\n", err)
		os.Exit(1)
	}

	// Calculate the MD5 hash of the input data and convert it to a Base64-encoded string.
	calcMd5 := func(input []byte) string {
		if len(input) == 0 {
			return "1B2M2Y8AsgTpgAmY7PhCfg=="
		}
		h := md5.New()
		h.Write(input)
		return base64.StdEncoding.EncodeToString(h.Sum(nil))
	}

	// Create the input parameters for the operation, including the action, method type, and other parameters.
	input := &oss.OperationInput{
		OpName: "PutResourcePoolRequesterPriorityQoSConfiguration", // The action.
		Method: "PUT",                                              // The HTTP method.
		Parameters: map[string]string{
			"requesterPriorityQos": "", // Requester priority QoS-related parameters.
			"resourcePool":         resourcePool, // The resource pool name.
		},
		Headers: map[string]string{
			"Content-MD5": calcMd5(qosConf), // Set the MD5 hash of the request body for data integrity validation.
		},
		Body:   bytes.NewReader(qosConf), // The request body, which contains the QoS configuration content.
		Bucket: nil,                      // This operation does not apply to a specific bucket.
	}

	// Execute the operation and receive the response or an error.
	res, err := client.InvokeOperation(context.TODO(), input)
	if err != nil {
		// If an error occurs, print the error message and exit the program.
		fmt.Printf("invoke operation got error: %v\n", err)
		os.Exit(1)
	}

	// Print the operation result.
	fmt.Println("The result of PutResourcePoolRequesterPriorityQoSConfiguration:", res.Status)
}

API

PutResourcePoolRequesterPriorityQosConfiguration