Object Storage Service:Utiliser la QoS des pools de ressources pour garantir la bande passante aux services critiques

Console

Sur la page Resource Pool QoS, cliquez sur le nom du pool de ressources cible. Ensuite, à droite du bucket cible, cliquez sur Modify Throttling Configurations et définissez la bande passante du bucket selon vos besoins.

ossutil

Avant de commencer, Installez ossutil.

1. Configurez la limite de bande passante pour le bucket avec un fichier XML local nommé qos.xml.

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

2. Appliquez la configuration de bande passante à un bucket spécifique. La commande suivante applique la configuration à un bucket nommé examplebucket.

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

3. Consultez la configuration de bande passante du bucket.

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

SDK

Vous pouvez définir la limite de bande passante pour un bucket uniquement à l'aide du SDK Python V2 et du SDK Go V2.

1. Configurez la limite de bande passante pour le bucket avec un fichier local nommé qos.xml.

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

2. Appliquez la configuration de bande passante à un bucket spécifique.

   Python

   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

Appelez l'opération PutBucketQoSInfo avec le corps de requête suivant pour limiter la bande passante d'un bucket.

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

Console

1. Récupérez l'ID de l'utilisateur RAM.

2. Sur la page Resource Pool QoS, cliquez sur le nom du pool de ressources cible. Ensuite, à droite du bucket cible, cliquez sur Configure Bandwidth Throttling Rules et définissez la bande passante requise pour que l'utilisateur RAM accède au bucket.

ossutil

Avant de commencer, Installez ossutil.

L'exemple suivant montre comment limiter la bande passante d'un utilisateur RAM accédant à un bucket dans un pool de ressources.

1. Configurez la limite de bande passante pour un utilisateur RAM accédant à un bucket dans le pool de ressources à l'aide d'un fichier XML local nommé qos.xml.

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

2. Récupérez l'ID de l'utilisateur RAM.

3. Appliquez la configuration de bande passante à un utilisateur RAM. La commande suivante applique la configuration à l'utilisateur RAM dont l'UID est 266xxxx et qui accède au 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. (Facultatif) Consultez la configuration de bande passante de l'utilisateur RAM.

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

SDK

Vous pouvez limiter la bande passante d'un utilisateur RAM accédant à un bucket uniquement avec les SDK Python V2 et Go V2.

1. Configurez la limite de bande passante pour un utilisateur RAM accédant à un bucket dans le pool de ressources à l'aide d'un fichier local nommé qos.xml.

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

2. Récupérez l'ID de l'utilisateur RAM.

3. Appliquez la configuration de bande passante à l'utilisateur RAM accédant au bucket.

   Python

   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. Récupérez l'ID de l'utilisateur RAM.

2. Appelez l'opération PutBucketRequesterQoSInfo avec le corps de requête suivant pour limiter la bande passante d'un utilisateur RAM accédant à un bucket.

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

Console

1. Récupérez l'ID du rôle RAM.

2. Sur la page Resource Pool QoS, cliquez sur le nom du pool de ressources cible. Ensuite, à droite du bucket cible, cliquez sur Configure Bandwidth Throttling Rules et définissez la bande passante requise pour le demandeur.

ossutil

Avant de commencer, Installez ossutil.

1. Configurez la limite de bande passante pour le rôle RAM accédant à un bucket spécifique à l'aide d'un fichier XML local nommé qos.xml.

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

2. Récupérez l'ID du rôle RAM.

3. Appliquez la configuration de bande passante à un rôle RAM. La commande suivante applique la configuration au rôle RAM dont l'ID est 362xxxx et qui accède au 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. (Facultatif) Répertoriez les configurations de bande passante pour tous les rôles RAM dans le pool de ressources.

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

SDK

Vous pouvez limiter la bande passante d'un rôle RAM accédant à un bucket uniquement avec les SDK Python V2 et Go V2.

1. Configurez la limite de bande passante pour le rôle RAM accédant à un bucket dans le pool de ressources à l'aide d'un fichier local nommé qos.xml.

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

2. Récupérez l'ID du rôle RAM.

3. Appliquez la configuration de bande passante au rôle RAM.

   Python

   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. Récupérez l'ID du rôle RAM.

2. Appelez l'opération PutBucketRequesterQoSInfo avec le corps de requête suivant pour limiter la bande passante d'un rôle RAM accédant à un bucket.

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

Console

1. Sur la page Resource Pool QoS, cliquez sur le nom du pool de ressources cible. Ensuite, cliquez sur Create A Bucket Group, définissez un nom pour le BucketGroup et spécifiez la bande passante requise.

2. Sur la page du pool de ressources cible, cliquez sur Create Bucket Group à droite d'un bucket cible pour ajouter le bucket à faible priorité au BucketGroup.

ossutil

Avant de commencer, Installez ossutil.

1. Les commandes suivantes ajoutent les buckets scheduled-posts et archived-comments à un BucketGroup.

   1. Ajoutez le bucket scheduled-posts au 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. Ajoutez le bucket archived-comments au 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. (Facultatif) Obtenez la liste des buckets dans le BucketGroup.

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

2. Configurez la limite de bande passante pour un BucketGroup spécifique dans le pool de ressources à l'aide d'un fichier XML local nommé qos.xml.

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

3. Appliquez la configuration de bande passante au 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. (Facultatif) Obtenez la configuration de bande passante du 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

Vous pouvez limiter la bande passante d'un BucketGroup uniquement avec les SDK Python V2 et Go V2.

1. Ajoutez des buckets d'un pool de ressources à un BucketGroup.

   Python

   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. Configurez la limite de bande passante pour un BucketGroup spécifique dans le pool de ressources à l'aide d'un fichier XML local nommé qos.xml.

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

3. Appliquez la configuration de bande passante au BucketGroup.

   Python

   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

Appelez l'opération PutResourcePoolBucketGroupQoSInfo avec le corps de requête suivant pour limiter la bande passante d'un BucketGroup.

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

Console

1. Récupérez l'ID d'utilisateur RAM ou l'ID de rôle RAM.

2. Sur la page Resource Pool QoS, cliquez sur le nom du pool de ressources cible. Dans l'onglet Requesters, cliquez sur Modify Throttling Configurations à droite de l'utilisateur RAM ou du rôle RAM cible, puis définissez la bande passante requise pour le demandeur.

ossutil

Avant de commencer, installez ossutil.

1. Configurez la limite de bande passante pour un utilisateur RAM ou un rôle RAM accédant au pool de ressources à l'aide d'un fichier XML local nommé qos.xml.

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

2. Récupérez l'ID d'utilisateur RAM ou l'ID de rôle RAM.

3. Appliquez la configuration de bande passante à un utilisateur RAM. La commande suivante applique la configuration à l'utilisateur RAM dont l'UID est 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. (Facultatif) Répertoriez les configurations de bande passante pour tous les utilisateurs RAM du pool de ressources.

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

SDK

Vous pouvez limiter la bande passante d'un utilisateur RAM ou d'un rôle RAM accédant à un pool de ressources uniquement avec le SDK Python V2 et le SDK Go V2.

1. Configurez la limite de bande passante pour un utilisateur RAM ou un rôle RAM spécifique accédant au pool de ressources à l'aide d'un fichier local nommé qos.xml.

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

2. Récupérez l'ID d'utilisateur RAM ou l'ID de rôle RAM.

3. Appliquez la configuration de bande passante à l'utilisateur RAM ou au rôle RAM.

   Python

   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. Récupérez l'ID d'utilisateur RAM ou l'ID de rôle RAM.

2. Appelez l'opération PutResourcePoolRequesterQoSInfo avec le corps de requête suivant pour limiter la bande passante d'un utilisateur RAM ou d'un rôle RAM accédant à un pool de ressources.

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

ossutil

1. Créez un fichier de configuration QoS de priorité nommé 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. Appliquez la configuration.

   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. Récupérez et vérifiez la configuration.

   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. Créez un fichier de configuration QoS de priorité des demandeurs nommé 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. Appliquez la configuration.

   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. (Facultatif) Récupérez et vérifiez la configuration.

   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