Configure ou modifie la qualité de service (QoS) d'un groupe de buckets dans un pool de ressources.
Précautions
La fonctionnalité QoS des pools de ressources est en aperçu sur invitation. Si le débit de vos buckets OSS dans une région a atteint ou dépassé 500 Gbit/s, contactez le support technique pour demander l'accès à cette fonctionnalité.
Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Si vous utilisez un utilisateur RAM ou un rôle RAM, le propriétaire du compte ou un administrateur doit accorder l'autorisation oss:PutResourcePoolBucketGroupQoSInfo via une politique RAM ou une politique de bucket.
Syntaxe de la requête
PUT /?resourcePoolBucketGroupQosInfo&resourcePool=<ResourcePoolName>&resourcePoolBucketGroup=<ResourcePoolBucketGroupName>
Host: oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Content-Type: application/xml
Content-Length: content lengthEn-têtes de requête
Cette opération utilise uniquement des en-têtes de requête communs. Pour plus d'informations, consultez la section En-têtes de requête communs.
Éléments de requête
Pour les éléments de configuration de la bande passante, la valeur -1 correspond à la valeur par défaut et indique qu'il n'y a aucune limite. La valeur 0 désactive le type de bande passante correspondant. Par exemple, si vous définissez ExtranetUploadBandwidth sur 0, vous ne pouvez pas envoyer de données vers le bucket depuis le réseau public.
La bande passante totale du groupe de buckets ne peut pas dépasser la bande passante totale du pool de ressources. La valeur d'un type de bande passante spécifique ne peut pas dépasser la valeur totale de ce type. Par exemple, si
TotalDownloadBandwidthest défini sur 10 Gbps,ExtranetDownloadBandwidthne peut pas être supérieur à 10 Gbps.Si vous définissez une limite de bande passante spécifique, la valeur doit être supérieure ou égale à 5 Gbps.
|
Nom |
Type |
Obligatoire |
Exemple |
Description |
|
resourcePool |
string |
Oui |
resource-pool-for-ai |
Nom du pool de ressources. |
|
resourcePoolBucketGroup |
string |
Oui |
test-group |
Nom du BucketGroup. |
|
QoSConfiguration |
container |
Oui |
Sans objet |
Conteneur pour la configuration de limitation de débit. Nœud parent : Aucun |
|
TotalUploadBandwidth |
Integer |
Oui |
10 |
Bande passante totale d'envoi (upload) pour le BucketGroup. Unité : Gbps. Nœud parent : QoSConfiguration |
|
IntranetUploadBandwidth |
Integer |
Oui |
-1 |
Bande passante d'envoi (upload) sur le réseau interne pour le BucketGroup. Cela inclut la bande passante d'envoi pour les réseaux classiques et les VPC. Unité : Gbps. Nœud parent : QoSConfiguration |
|
ExtranetUploadBandwidth |
Integer |
Oui |
-1 |
Bande passante d'envoi (upload) sur le réseau public pour le BucketGroup. Cela inclut la bande passante d'envoi pour Internet et les endpoints d'accélération. Unité : Gbps. Nœud parent : QoSConfiguration |
|
TotalDownloadBandwidth |
Integer |
Oui |
10 |
Bande passante totale de téléchargement (download) pour le BucketGroup. Unité : Gbps. Nœud parent : QoSConfiguration |
|
IntranetDownloadBandwidth |
Integer |
Oui |
-1 |
Bande passante de téléchargement (download) sur le réseau interne pour le BucketGroup. Cela inclut la bande passante de téléchargement pour les réseaux classiques et les VPC. Unité : Gbps. Nœud parent : QoSConfiguration |
|
ExtranetDownloadBandwidth |
Integer |
Oui |
-1 |
Bande passante de téléchargement (download) sur le réseau public pour le BucketGroup. Cela inclut la bande passante de téléchargement pour Internet et les endpoints d'accélération. Unité : Gbps. Nœud parent : QoSConfiguration |
En-têtes de réponse
Cette opération utilise uniquement des en-têtes de réponse communs. Pour plus d'informations, consultez la section En-têtes de réponse communs.
Exemples
-
Exemple de requête
PUT /?resourcePoolBucketGroupQosInfo&resourcePool=resource-pool-for-ai&resourcePoolBucketGroup=test-group Host: oss-cn-shanghai.aliyuncs.com Date: Sun, 11 Aug 2024 17:45:00 GMT Content-Type: application/xml Content-Length: content length Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e <QoSConfiguration> <TotalUploadBandwidth>10</TotalUploadBandwidth> <IntranetUploadBandwidth>-1</IntranetUploadBandwidth> <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth> <TotalDownloadBandwidth>10</TotalDownloadBandwidth> <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth> <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth> </QoSConfiguration> -
Exemple de réponse
HTTP/1.1 200 OK Date: Sun, 11 Aug 2024 17:45:00 GMT Content-Length: 0
SDK
Les SDK suivants prennent en charge cette opération :