GetBucketRequesterQoSInfo - Object Storage Service: Central de Documentação do Alibaba Cloud

Observações

O QoS do pool de recursos está em fase de visualização por convite. Caso o throughput dos seus buckets do OSS em uma região tenha atingido ou ultrapassado 500 Gbit/s, entre em contato com o suporte técnico para solicitar a liberação desse recurso.
Por padrão, uma conta Alibaba Cloud possui as permissões necessárias para consultar as configurações de limitação de um solicitante específico em um bucket. Para executar consultas como usuário RAM ou usando o Security Token Service (STS), é necessária a permissão oss:GetBucketRequesterQoSInfo. Para mais informações, consulte RAM policy common examples.

Sintaxe

GET /?requesterQosInfo&qosRequester=uid
Host: BucketName.oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Cabeçalhos da requisição

Esta operação utiliza apenas os cabeçalhos de requisição comuns. Para mais informações, consulte Common HTTP headers.

Elementos da requisição

Nome

Tipo

Obrigatório

Exemplo

Descrição

qosRequester

String

Sim

300xxxx

O ID de usuário (UID) do solicitante.

Cabeçalhos da resposta

Esta operação retorna apenas os cabeçalhos de resposta comuns. Para mais informações, consulte Common response headers.

Elementos da resposta

Nome	Tipo	Exemplo	Descrição
RequesterQoSInfo	Contêiner	N/D	O contêiner para o resultado da consulta. Nós pais: nenhum
Requester	String	300xxxx	ID de usuário (UID) do solicitante. Nó pai: RequesterQoSInfo
QoSConfiguration	Contêiner	N/D	O contêiner para as configurações de limitação do solicitante. Nó pai: RequesterQoSInfo
TotalUploadBandwidth	Inteiro	10	Largura de banda total de upload do solicitante para o bucket. Unidade: Gbit/s. Nó pai: QoSConfiguration
IntranetUploadBandwidth	Inteiro	-1	Largura de banda de upload em rede interna do solicitante para o bucket. As redes internas incluem a rede clássica e a VPC. Unidade: Gbit/s. Nó pai: QoSConfiguration
ExtranetUploadBandwidth	Inteiro	-1	Largura de banda de upload em rede pública do solicitante para o bucket. As redes públicas incluem a Internet e os endpoints de aceleração. Unidade: Gbit/s. Nó pai: QoSConfiguration
TotalDownloadBandwidth	Inteiro	10	Largura de banda total de download do solicitante para o bucket. Unidade: Gbit/s. Nó pai: QoSConfiguration
IntranetDownloadBandwidth	Inteiro	-1	Largura de banda de download em rede interna do solicitante para o bucket. As redes internas incluem a rede clássica e a VPC. Unidade: Gbit/s. Nó pai: QoSConfiguration
ExtranetDownloadBandwidth	Inteiro	-1	Largura de banda de download em rede pública do solicitante para o bucket. As redes públicas incluem a Internet e os endpoints de aceleração. Unidade: Gbit/s. Nó pai: QoSConfiguration
TotalQps	Inteiro	10000	A configuração total de QPS. Nó pai: QoSConfiguration
IntranetQps	Inteiro	-1	A configuração de QPS para requisições de redes internas, incluindo a rede clássica e VPCs. Nó pai: QoSConfiguration
ExtranetQps	Inteiro	-1	A configuração de QPS para requisições de redes externas, incluindo a Internet e CDNs. Nó pai: QoSConfiguration

Exemplos

Exemplo de requisiçã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>
    <TotalQps>10000</TotalQps>
    <IntranetQps>-1</IntranetQps>
    <ExtranetQps>-1</ExtranetQps>
  </QoSConfiguration>
</RequesterQoSInfo>

SDKs do OSS

Os seguintes SDKs do OSS suportam esta operação:

ossutil

Para o comando do ossutil correspondente a esta operação, consulte get-bucket-requester-qos-info.