Todos os produtos
Search
Central de documentação

Object Storage Service:GetBucketQoSInfo

Última atualização: Jul 03, 2026

Consulta as configurações de limitação de um solicitante específico que acessa um bucket.

Observações

  • O QoS do pool de recursos está em visualização 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 pode consultar as configurações de limitação de todos os solicitantes de um bucket em um pool de recursos. Para consultar como usuário RAM ou com o Security Token Service (STS), você precisa da permissão oss:GetBucketQoSInfo. Para mais informações, consulte Exemplos comuns de políticas do RAM.

Sintaxe

GET /?qosInfo HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Cabeçalhos da solicitação

A solicitação GetBucketQoSInfo usa apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Cabeçalhos HTTP comuns.

Cabeçalhos da resposta

A resposta à solicitação GetBucketQoSInfo usa apenas cabeçalhos de resposta comuns. Para mais informações, consulte Cabeçalhos de resposta comuns.

Elementos da resposta

Nome

Tipo

Exemplo

Descrição

QoSConfiguration

Container

N/A

Container do resultado da consulta.

Nós pai: nenhum

TotalUploadBandwidth

Integer

10

Largura de banda total de upload do bucket. Unidade: Gbit/s.

Nós pai: QoSConfiguration

IntranetUploadBandwidth

Integer

-1

Largura de banda de upload na rede interna do bucket. As redes internas incluem a rede clássica e a VPC. Unidade: Gbit/s.

Nós pai: QoSConfiguration

ExtranetUploadBandwidth

Integer

-1

Largura de banda de upload na rede pública do bucket. As 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 baixe do bucket. Unidade: Gbit/s.

Nós pai: QoSConfiguration

IntranetDownloadBandwidth

Integer

-1

Largura de banda de baixe na rede interna do bucket. As redes internas incluem a rede clássica e a VPC. Unidade: Gbit/s.

Nós pai: QoSConfiguration

ExtranetDownloadBandwidth

Integer

-1

Largura de banda de baixe na rede pública do bucket. As redes públicas incluem a Internet e endpoints de aceleração. Unidade: Gbit/s.

Nós pai: QoSConfiguration

Exemplos

  • Exemplo de solicitação

    Get /?qosInfo HTTP/1.1
    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-Type: application/xml
    Content-Length: 556
    Connection: keep-alive
    Server: AliyunOSS
    x-oss-request-id: 534****
    
    <?xml version="1.0" encoding="UTF-8"?>
    <QoSConfiguration>
      <TotalUploadBandwidth>10</TotalUploadBandwidth>
      <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
      <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
      <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
      <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
      <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
    </QoSConfiguration>

SDKs do OSS

Chame GetBucketQoSInfo com os SDKs do OSS nas seguintes linguagens de programação:

ossutil

Para o comando do ossutil correspondente à operação GetBucketQoSInfo, consulte get-bucket-qos-info.