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

Notas de uso

O QoS do pool de recursos está em preview por convite. Se o throughput dos seus buckets do OSS em uma região atingiu ou ultrapassou 400 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 chamar esta operação. Para chamar esta operação usando um usuário RAM ou o Security Token Service (STS), é necessário ter a permissão oss:ListBucketRequesterQoSInfo. Para mais informações, consulte Exemplos comuns de políticas do RAM.

Sintaxe

GET /?requesterQosInfo&max-keys=10&continuation-token=207xxxx
Host: BucketName.oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Cabeçalhos de solicitação

Esta operação utiliza apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Cabeçalhos de solicitação comuns.

Elementos de solicitação

Elemento	Tipo	Obrigatório	Exemplo	Descrição
max-keys	String	Não	10	O número máximo de solicitantes cujas configurações de limitação de taxa você deseja consultar.
continuation-token	String	Não	207xxxx	O solicitante a partir do qual as configurações de limitação de taxa são retornadas.

Cabeçalhos de resposta

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

Elementos de resposta

Elemento	Tipo	Exemplo	Descrição
ListBucketRequesterQoSInfosResult	Contêiner	N/A	O contêiner raiz da resposta. Nós pais: nenhum
Bucket	String	oss-example	O nome do bucket. Nós pais: ListBucketRequesterQoSInfosResult
ContinuationToken	String	207xxxx	O token de continuação usado nesta solicitação. Nós pais: ListBucketRequesterQoSInfosResult
NextContinuationToken	String	262xxxx	Indica que esta solicitação ListBucketRequesterQoSInfos contém resultados subsequentes. O valor de NextContinuationToken é usado como valor de ContinuationToken para consultar os resultados subsequentes. Nós pais: ListBucketRequesterQoSInfosResult
IsTruncated	Boolean	true	Indica se os resultados consultados foram truncados. true indica que nem todos os resultados foram retornados desta vez. false: todos os resultados foram retornados. Nós pais: ListBucketRequesterQoSInfosResult
RequesterQoSInfo	Contêiner	N/A	O contêiner da configuração de limitação de taxa de um solicitante. Nós pais: ListBucketRequesterQoSInfosResult
Requester	String	266xxxx	O ID de usuário (UID) do solicitante. Nós pais: RequesterQoSInfo
QoSConfiguration	Contêiner	N/A	O contêiner dos detalhes da configuração de limitação de taxa. Nós pais: RequesterQoSInfo
TotalUploadBandwidth	Integer	10	A largura de banda total de upload do solicitante para o bucket. Unidade: Gbit/s. Nós pais: QoSConfiguration
IntranetUploadBandwidth	Integer	-1	A largura de banda de upload pela rede interna do solicitante para o bucket. As redes internas incluem a rede clássica e a virtual private cloud (VPC). Unidade: Gbit/s. Nós pais: QoSConfiguration
ExtranetUploadBandwidth	Integer	-1	A largura de banda de upload pela 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ós pais: QoSConfiguration
TotalDownloadBandwidth	Integer	10	A largura de banda total de download do solicitante para o bucket. Unidade: Gbit/s. Nós pais: QoSConfiguration
IntranetDownloadBandwidth	Integer	-1	A largura de banda de download pela rede interna do solicitante para o bucket. As redes internas incluem a rede clássica e a VPC. Unidade: Gbit/s. Nós pais: QoSConfiguration
ExtranetDownloadBandwidth	Integer	-1	A largura de banda de download pela 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ós pais: QoSConfiguration
TotalQps	Integer	10000	A configuração total de QPS. Nó pai: QoSConfiguration
IntranetQps	Integer	-1	A configuração de QPS para solicitações de redes internas, incluindo a rede clássica e VPCs. Nó pai: QoSConfiguration
ExtranetQps	Integer	-1	A configuração de QPS para solicitações de redes externas, incluindo a Internet e CDNs. Nó pai: QoSConfiguration

Exemplos

Exemplo de solicitação

GET /?requesterQosInfo&max-keys=2&continuation-token=207xxxx
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: 1385
x-oss-request-id: 534****

<ListBucketRequesterQoSInfosResult>
  <Bucket>BucketName</Bucket>
  <ContinuationToken>207xxxx</ContinuationToken>
  <NextContinuationToken>262xxxx</NextContinuationToken>
  <IsTruncated>true</IsTruncated>
  <RequesterQoSInfo>
    <Requester>266xxxx</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>
  <RequesterQoSInfo>
    <Requester>276xxxx</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>
</ListBucketRequesterQoSInfosResult>

SDKs do OSS

Os seguintes SDKs do OSS suportam ListBucketRequesterQoSInfos:

ossutil

Para o comando ossutil correspondente, consulte list-bucket-requester-qos-infos.