Interroge les configurations de limitation du débit pour un demandeur spécifique accédant à un bucket dans un pool de ressources.
Notes
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, vous pouvez contacter le support technique pour demander l'activation de cette fonctionnalité.
Par défaut, un compte Alibaba Cloud dispose des permissions nécessaires pour interroger les configurations de limitation du débit de tous les demandeurs pour un bucket. L'exécution de requêtes d'interrogation en tant qu'utilisateur RAM ou via Security Token Service (STS) nécessite la permission
oss:GetBucketRequesterQoSInfo. Pour plus d'informations, consultez la section Exemples courants de politiques RAM.
Syntaxe
GET /?requesterQosInfo&qosRequester=uid
Host: BucketName.oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueEn-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 HTTP communs.
Éléments de requête
|
Nom |
Type |
Obligatoire |
Exemple |
Description |
|
qosRequester |
String |
Oui |
300xxxx |
ID utilisateur (UID) du demandeur. |
En-têtes de réponse
Cette opération renvoie uniquement les en-têtes de réponse communs. Pour plus d'informations, consultez la section En-têtes de réponse communs.
Éléments de réponse
|
Nom |
Type |
Exemple |
Description |
|
RequesterQoSInfo |
Container |
N/A |
Conteneur pour le résultat de la requête. Nœuds parents : aucun |
|
Requester |
String |
300xxxx |
ID utilisateur (UID) du demandeur. Nœud parent : RequesterQoSInfo |
|
QoSConfiguration |
Container |
N/A |
Conteneur pour les configurations de limitation du débit du demandeur. Nœud parent : RequesterQoSInfo |
|
TotalUploadBandwidth |
Integer |
10 |
Bande passante totale d'upload spécifiée par le demandeur pour le pool de ressources. Unité : Gbit/s. Nœud parent : QoSConfiguration |
|
IntranetUploadBandwidth |
Integer |
-1 |
Bande passante d'upload sur un réseau interne spécifiée par le demandeur pour le pool de ressources. Les réseaux internes incluent le réseau classique et le VPC. Unité : Gbit/s. Nœud parent : QoSConfiguration |
|
ExtranetUploadBandwidth |
Integer |
-1 |
Bande passante d'upload sur un réseau public spécifiée par le demandeur pour le pool de ressources. Les réseaux publics incluent Internet et les endpoints d'accélération. Unité : Gbit/s. Nœud parent : QoSConfiguration |
|
TotalDownloadBandwidth |
Integer |
10 |
Bande passante totale de download spécifiée par le demandeur pour le pool de ressources. Unité : Gbit/s. Nœud parent : QoSConfiguration |
|
IntranetDownloadBandwidth |
Integer |
-1 |
Bande passante de download sur un réseau interne spécifiée par le demandeur pour le pool de ressources. Les réseaux internes incluent le réseau classique et le VPC. Unité : Gbit/s. Nœud parent : QoSConfiguration |
|
ExtranetDownloadBandwidth |
Integer |
-1 |
Bande passante de download sur un réseau public spécifiée par le demandeur pour le pool de ressources. Les réseaux publics incluent Internet et les endpoints d'accélération. Unité : Gbit/s. Nœud parent : QoSConfiguration |
Exemples
-
Exemple de requête
GET /?requesterQosInfo&qosRequester=300xxxx Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Fri, 27 Dec 2024 03:21:12 GMT Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e -
Exemple de réponse
HTTP/1.1 200 OK Date: Fri, 27 Dec 2024 03:21:12 GMT Content-Length: 515 x-oss-request-id: 534**** <RequesterQoSInfo> <Requester>300xxxx</Requester> <QoSConfiguration> <TotalUploadBandwidth>10</TotalUploadBandwidth> <IntranetUploadBandwidth>-1</IntranetUploadBandwidth> <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth> <TotalDownloadBandwidth>10</TotalDownloadBandwidth> <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth> <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth> </QoSConfiguration> </RequesterQoSInfo>
SDK OSS
Les SDK OSS suivants prennent en charge cette opération :
ossutil
Pour la commande ossutil correspondant à cette opération, consultez la section get-bucket-requester-qos-info.