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

Observações de uso

O QoS do pool de recursos está em visualização por convite. Se o throughput dos seus buckets do OSS em uma região atingiu ou ultrapassou 500 Gbit/s, entre em contato com o suporte técnico para solicitar esse recurso.
Por padrão, a conta Alibaba Cloud tem permissão para chamar esta operação. Para chamá-la com um usuário RAM ou Security Token Service (STS), é necessária 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 da 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 da solicitação

Elemento	Tipo	Obrigatório	Exemplo	Descrição
max-keys	String	Não	10	Número máximo de solicitantes cujas configurações de limitação serão consultadas.
continuation-token	String	Não	207xxxx	Solicitante a partir do qual as configurações de limitação são retornadas.

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

Elemento	Tipo	Exemplo	Descrição
ListBucketRequesterQoSInfosResult	Container	N/A	Contêiner raiz da resposta. Nós pai: nenhum
Bucket	String	oss-example	Nome do bucket. Nós pai: ListBucketRequesterQoSInfosResult
ContinuationToken	String	207xxxx	Token de continuação usado nesta solicitação. Nós pai: ListBucketRequesterQoSInfosResult
NextContinuationToken	String	262xxxx	Indica que a solicitação ListBucketRequesterQoSInfos contém resultados subsequentes. Use o valor de NextContinuationToken como ContinuationToken para consultar os próximos resultados. Nós pai: ListBucketRequesterQoSInfosResult
IsTruncated	Boolean	true	Indica se os resultados consultados foram truncados. true: nem todos os resultados foram retornados nesta chamada. false: todos os resultados foram retornados. Nós pai: ListBucketRequesterQoSInfosResult
RequesterQoSInfo	Container	N/A	Contêiner da configuração de limitação de um solicitante. Nós pai: RequesterQoSInfo
Requester	String	266xxxx	ID de usuário (UID) do solicitante. Nós pai: RequesterQoSInfo
QoSConfiguration	Container	N/A	Contêiner com os detalhes da configuração de limitação. Nós pai: RequesterQoSInfo
TotalUploadBandwidth	Integer	10	Largura de banda total de upload do solicitante para o bucket. Unidade: Gbit/s. Nós pai: QoSConfiguration
IntranetUploadBandwidth	Integer	-1	Largura de banda de upload pela rede interna do solicitante para o bucket. Redes internas incluem a rede clássica e a Virtual Private Cloud (VPC). Unidade: Gbit/s. Nós pai: QoSConfiguration
ExtranetUploadBandwidth	Integer	-1	Largura de banda de upload pela rede pública do solicitante para o bucket. Redes públicas incluem a Internet e endpoints de aceleração. Unidade: Gbit/s. Nós pai: QoSConfiguration
TotalDownloadBandwidth	Integer	10	Largura de banda total de download do solicitante para o bucket. Unidade: Gbit/s. Nós pai: QoSConfiguration
IntranetDownloadBandwidth	Integer	-1	Largura de banda de download pela rede interna do solicitante para o bucket. Redes internas incluem a rede clássica e a VPC. Unidade: Gbit/s. Nós pai: QoSConfiguration
ExtranetDownloadBandwidth	Integer	-1	Largura de banda de download pela rede pública do solicitante para o bucket. Redes públicas incluem a Internet e endpoints de aceleração. Unidade: Gbit/s. Nós 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>
    </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>
    </QoSConfiguration>
  </RequesterQoSInfo>
</ListBucketRequesterQoSInfosResult>

SDKs do OSS

Os seguintes SDKs do OSS oferecem suporte ao ListBucketRequesterQoSInfos:

ossutil

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