Configurez la limitation de débit pour un demandeur au sein d'un pool de ressources.
Notes d'utilisation
La fonctionnalité QoS pour les pools de ressources est en aperçu exclusif sur invitation. Si le débit de vos buckets OSS dans une région a atteint ou dépassé 500 Gbit/s, vous pouvez contacter le support technique afin de demander l'activation de cette fonctionnalité.
Par défaut, un compte Alibaba Cloud dispose des permissions nécessaires pour configurer la limitation de débit des demandeurs dans un pool de ressources. Si vous souhaitez effectuer cette opération à l'aide d'un utilisateur Resource Access Management (RAM) ou via Security Token Service (STS), vous devez disposer de l'autorisation
oss:PutResourcePoolRequesterQoSInfo. Pour plus d'informations, consultez la section Exemples de politiques RAM.
Syntaxe de la requête
PUT /?requesterQosInfo&resourcePool=ResourcePoolName&qosRequester=uid
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Type: application/xml
Content-Length: content length
<QoSConfiguration>
<TotalUploadBandwidth>10</TotalUploadBandwidth>
<IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
<ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
<TotalDownloadBandwidth>10</TotalDownloadBandwidth>
<IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
<ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
</QoSConfiguration>En-têtes de requête
Cette opération utilise uniquement les 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 paramètres de configuration de bande passante suivants, la valeur -1 (valeur par défaut) indique qu'aucune limite n'est appliquée. La valeur 0 signifie que le type de bande passante correspondant est désactivé. Par exemple, si vous définissez ExtranetUploadBandwidth sur 0, il vous sera impossible de télécharger des données vers le bucket spécifié via Internet.
La somme des configurations de bande passante pour un demandeur ne doit pas excéder la configuration totale de bande passante du pool de ressources. De même, la configuration d'un type de bande passante unique pour un demandeur ne peut pas dépasser la configuration totale du pool. Par exemple, si la bande passante totale de téléchargement du pool de ressources est configurée à 100 Gbps, la bande passante de téléchargement via le réseau public pour un demandeur ne peut pas dépasser 100 Gbps.
La configuration d'un type de bande passante unique pour un demandeur ne peut pas être inférieure à 5 Gbps.
|
Nom |
Type |
Obligatoire |
Exemple |
Description |
|
resourcePool |
String |
Oui |
resource-pool-for-ai |
Nom du pool de ressources. |
|
qosRequester |
String |
Oui |
300xxxx |
UID du demandeur. |
|
QoSConfiguration |
Container |
Oui |
S/O |
Conteneur pour la configuration QoS. Nœud parent : Aucun |
|
TotalUploadBandwidth |
Integer |
Oui |
10 |
Bande passante totale d'envoi pour le demandeur au niveau du pool de ressources. Unité : Gbps. Nœud parent : QoSConfiguration |
|
IntranetUploadBandwidth |
Integer |
Oui |
-1 |
Bande passante d'envoi sur le réseau interne pour le demandeur au niveau du pool de ressources. Cela inclut la bande passante d'envoi via le réseau classique et les VPC. Unité : Gbps. Nœud parent : QoSConfiguration |
|
ExtranetUploadBandwidth |
Integer |
Oui |
-1 |
Bande passante d'envoi sur le réseau public pour le demandeur au niveau du pool de ressources. Cela inclut la bande passante d'envoi via le réseau public et les endpoints d'accélération. Unité : Gbps. Nœud parent : QoSConfiguration |
|
TotalDownloadBandwidth |
Integer |
Oui |
10 |
Bande passante totale de téléchargement pour le demandeur au niveau du pool de ressources. Unité : Gbps. Nœud parent : QoSConfiguration |
|
IntranetDownloadBandwidth |
Integer |
Oui |
-1 |
Bande passante de téléchargement sur le réseau interne pour le demandeur au niveau du pool de ressources. Cela inclut la bande passante de téléchargement via le réseau classique et les VPC. Unité : Gbps. Nœud parent : QoSConfiguration |
|
ExtranetDownloadBandwidth |
Integer |
Oui |
-1 |
Bande passante de téléchargement sur le réseau public pour le demandeur au niveau du pool de ressources. Cela inclut la bande passante de téléchargement via le réseau public et les endpoints d'accélération. Unité : Gbps. Nœud parent : QoSConfiguration |
En-têtes de réponse
Cette opération utilise uniquement les 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 /?requesterQosInfo&resourcePool=resource-pool-for-ai&qosRequester=300xxxx Host: oss-cn-hangzhou.aliyuncs.com Date: Fri, 27 Dec 2024 03:21:12 GMT Content-Type: application/xml Content-Length: 454 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 x-oss-request-id: 534**** Date: Fri, 27 Dec 2024 03:21:12 GMT Content-Length: 0 Connection: keep-alive Server: AliyunOSS
SDK
Les SDK suivants prennent en charge cette opération :
Interface de ligne de commande ossutil
Pour la commande ossutil correspondante, consultez la section put-resource-pool-requester-qos-info.