Configure les règles de limitation de bande passante pour un bucket dans un pool de ressources.
Notes d'utilisation
La fonctionnalité QoS du pool 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'activation de cette fonctionnalité.
Par défaut, un compte Alibaba Cloud peut configurer des règles de limitation de bande passante pour un bucket dans un pool de ressources. Pour effectuer cette opération en tant qu'utilisateur RAM ou via Security Token Service (STS), vous devez disposer de l'autorisation
oss:PutBucketQoSInfo. Pour plus d'informations, consultez la section Exemples courants de politiques RAM.
Syntaxe
PUT /?qosInfo HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<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 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
Dans le tableau suivant, une valeur par défaut de -1 indique que la bande passante du bucket n'est pas limitée. Une valeur de 0 signifie que le type de bande passante n'est pas pris en charge. Par exemple, une valeur de 0 pour ExtranetUploadBandwidth indique que l'envoi de données vers le bucket via un réseau public est impossible.
La bande passante totale d'un bucket ne peut pas dépasser la bande passante totale du pool de ressources ni la bande passante combinée de tous les buckets. Par exemple, si la bande passante totale de téléchargement de tous les buckets est de 100 Gbit/s, la bande passante de téléchargement via Internet pour un seul bucket ne peut pas dépasser 100 Gbit/s.
|
Élément |
Type |
Obligatoire |
Exemple |
Description |
|
QoSConfiguration |
Conteneur |
Oui |
S/O |
Conteneur pour les règles de limitation de bande passante. Nœuds parents : aucun |
|
TotalUploadBandwidth |
Entier |
Oui |
10 |
Bande passante totale d'envoi (upload) du bucket. Unité : Gbit/s. Nœuds parents : QoSConfiguration |
|
IntranetUploadBandwidth |
Entier |
Oui |
-1 |
Bande passante d'envoi (upload) via un réseau interne du bucket. Les réseaux internes incluent le réseau classique et le VPC. Unité : Gbit/s. Nœuds parents : QoSConfiguration |
|
ExtranetUploadBandwidth |
Entier |
Oui |
-1 |
Bande passante d'envoi (upload) via un réseau public du bucket. Les réseaux publics incluent Internet et les endpoints d'accélération. Unité : Gbit/s. Nœuds parents : QoSConfiguration |
|
TotalDownloadBandwidth |
Entier |
Oui |
10 |
Bande passante totale de téléchargement (download) du bucket. Unité : Gbit/s. Nœuds parents : QoSConfiguration |
|
IntranetDownloadBandwidth |
Entier |
Oui |
-1 |
Bande passante de téléchargement (download) via un réseau interne du bucket. Les réseaux internes incluent le réseau classique et le VPC. Unité : Gbit/s. Nœuds parents : QoSConfiguration |
|
ExtranetDownloadBandwidth |
Entier |
Oui |
-1 |
Bande passante de téléchargement (download) via un réseau public du bucket. Les réseaux publics incluent Internet et les endpoints d'accélération. Unité : Gbit/s. Nœuds parents : QoSConfiguration |
En-têtes de réponse
Cette opération renvoie 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 /?qosInfo HTTP/1.1 Host: oss-example.oss-cn-hangzhou.aliyuncs.com Content-Length: 209 Date: Fri, 27 Dec 2024 03:21:12 GMT Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e <?xml version="1.0" encoding="UTF-8"?> <QoSConfiguration> <TotalUploadBandwidth>10</TotalUploadBandwidth> <IntranetUploadBandwidth>-1</IntranetUploadBandwidth> <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth> <TotalDownloadBandwidth>10</TotalDownloadBandwidth> <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth> <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth> </QoSConfiguration> -
Exemple de réponse réussie
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 OSS
Les SDK OSS suivants prennent en charge PutBucketQoSInfo :
ossutil
Pour la commande ossutil correspondant à cette opération, consultez la section Put-bucket-qos-info.