Consulta as configurações de limitação de taxa de um solicitante específico que acessa um bucket em um pool de recursos.
Observações
O QoS de pool de recursos está em preview por convite. Se o throughput dos seus buckets do OSS em uma região atingir ou ultrapassar 500 Gbit/s, entre em contato com o suporte técnico para solicitar esse recurso.
Por padrão, uma conta Alibaba Cloud tem permissão para consultar as configurações de limitação de taxa de todos os solicitantes de um bucket. Para consultar como usuário RAM ou com o Security Token Service (STS), é necessária a permissão
oss:GetBucketRequesterQoSInfo. Para mais informações, consulte Exemplos comuns de políticas do RAM.
Sintaxe
GET /?requesterQosInfo&qosRequester=uid
Host: BucketName.oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueCabeçalhos da solicitação
Esta operação utiliza apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Cabeçalhos HTTP comuns.
Elementos da solicitação
|
Nome |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
qosRequester |
String |
Sim |
300xxxx |
ID de usuário (UID) do solicitante. |
Cabeçalhos da resposta
Esta operação retorna apenas cabeçalhos de resposta comuns. Para mais informações, consulte Cabeçalhos de resposta comuns.
Elementos da resposta
|
Nome |
Tipo |
Exemplo |
Descrição |
|
RequesterQoSInfo |
Container |
N/A |
Container do resultado da consulta. Nós pai: nenhum |
|
Requester |
String |
300xxxx |
ID de usuário (UID) do solicitante. Nó pai: RequesterQoSInfo |
|
QoSConfiguration |
Container |
N/A |
Container das configurações de limitação de taxa do solicitante. Nó pai: RequesterQoSInfo |
|
TotalUploadBandwidth |
Integer |
10 |
Largura de banda total de upload especificada pelo solicitante para o pool de recursos. Unidade: Gbit/s. Nó pai: QoSConfiguration |
|
IntranetUploadBandwidth |
Integer |
-1 |
Largura de banda de upload pela rede interna especificada pelo solicitante para o pool de recursos. Redes internas incluem a rede clássica e a VPC. Unidade: Gbit/s. Nó pai: QoSConfiguration |
|
ExtranetUploadBandwidth |
Integer |
-1 |
Largura de banda de upload pela rede pública especificada pelo solicitante para o pool de recursos. Redes públicas incluem a Internet e endpoints de aceleração. Unidade: Gbit/s. Nó pai: QoSConfiguration |
|
TotalDownloadBandwidth |
Integer |
10 |
Largura de banda total de download especificada pelo solicitante para o pool de recursos. Unidade: Gbit/s. Nó pai: QoSConfiguration |
|
IntranetDownloadBandwidth |
Integer |
-1 |
Largura de banda de download pela rede interna especificada pelo solicitante para o pool de recursos. Redes internas incluem a rede clássica e a VPC. Unidade: Gbit/s. Nó pai: QoSConfiguration |
|
ExtranetDownloadBandwidth |
Integer |
-1 |
Largura de banda de download pela rede pública especificada pelo solicitante para o pool de recursos. Redes públicas incluem a Internet e endpoints de aceleração. Unidade: Gbit/s. Nó pai: QoSConfiguration |
Exemplos
-
Exemplo de solicitação
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 -
Exemplo de resposta
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>
SDKs do OSS
Os seguintes SDKs do OSS oferecem suporte a esta operação:
ossutil
Para obter o comando do ossutil correspondente a esta operação, consulte get-bucket-requester-qos-info.