Todos os produtos
Search

Este produto

    Object Storage Service:PutBucketRequesterQoSInfo

    Central de documentação

    Object Storage Service:PutBucketRequesterQoSInfo

    Última atualização: Oct 29, 2026

    Configura a limitação de taxa para um solicitante no nível do bucket.

    Observações

    • O QoS do pool de recursos está em preview por convite. Se o throughput dos seus buckets OSS em uma região atingiu ou ultrapassou 400 Gbit/s, entre em contato com o suporte técnico para solicitar acesso a esse recurso.

    • Uma conta Alibaba Cloud tem essa permissão por padrão. Usuários RAM ou acesso via STS precisam da permissão oss:PutBucketRequesterQoSInfo. Exemplos de políticas RAM.

    Sintaxe

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

<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>

    Cabeçalhos da solicitação

    Esta operação usa apenas Cabeçalhos comuns de solicitação.

    Parâmetros da solicitação

    Nota

    • O valor -1 (valor padrão) significa que não há limite de largura de banda. O valor 0 desativa o tipo de largura de banda. Por exemplo, ExtranetUploadBandwidth definido como 0 bloqueia uploads pela rede pública para o bucket.

    • A configuração de largura de banda de um solicitante no nível do bucket não pode exceder a configuração total de largura de banda do bucket. Por exemplo, se a largura de banda total de download do bucket é de 100 Gbit/s, a largura de banda de download pela Internet de um solicitante para o bucket não pode exceder 100 Gbit/s.

    • Cada limite de largura de banda deve ser de pelo menos 5 Gbit/s.

    Parâmetro

    Tipo

    Obrigatório

    Exemplo

    Descrição

    qosRequester

    String

    Sim

    300xxxx

    ID de usuário (UID) do solicitante.

    Nós pai: nenhum

    QoSConfiguration

    Contêiner

    Sim

    N/A

    Contêiner que armazena os resultados.

    Nó pai: nenhum

    TotalUploadBandwidth

    Integer

    Sim

    10

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

    Nó pai: QoSConfiguration

    IntranetUploadBandwidth

    Integer

    Sim

    -1

    Largura de banda de upload pela rede interna para o solicitante neste bucket. Redes internas incluem a rede clássica e VPC. Unidade: Gbit/s.

    Nó pai: QoSConfiguration

    ExtranetUploadBandwidth

    Integer

    Sim

    -1

    Largura de banda de upload pela rede pública para o solicitante neste bucket. Redes públicas incluem a Internet e endpoints de aceleração. Unidade: Gbit/s.

    Nó pai: QoSConfiguration

    TotalDownloadBandwidth

    Integer

    Sim

    10

    Largura de banda total de download do solicitante para o bucket. Unidade: Gbit/s.

    Nó pai: QoSConfiguration

    IntranetDownloadBandwidth

    Integer

    Sim

    -1

    Largura de banda de download pela rede interna para o solicitante neste bucket. Redes internas incluem a rede clássica e VPC. Unidade: Gbit/s.

    Nó pai: QoSConfiguration

    ExtranetDownloadBandwidth

    Integer

    Sim

    -1

    Largura de banda de download pela rede pública para o solicitante neste bucket. Redes públicas incluem a Internet e endpoints de aceleração. Unidade: Gbit/s.

    Nó pai: QoSConfiguration

    TotalQps

    Integer

    Não

    10000

    A configuração total de QPS.

    Nó pai: QoSConfiguration

    IntranetQps

    Integer

    Não

    -1

    A configuração de QPS para solicitações de redes internas, incluindo a rede clássica e VPCs.

    Nó pai: QoSConfiguration

    ExtranetQps

    Integer

    Não

    -1

    A configuração de QPS para solicitações de redes externas, incluindo a Internet e CDNs.

    Nó pai: QoSConfiguration

    Cabeçalhos da resposta

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

    Exemplo

    • Exemplo de solicitação

      PUT /?requesterQosInfo&qosRequester=300xxxx
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Content-Length: 209
Date: Fri, 27 Dec 2024 03:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

<?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>
  <TotalQps>10000</TotalQps>
  <IntranetQps>-1</IntranetQps>
  <ExtranetQps>-1</ExtranetQps>
</QoSConfiguration>

    • Exemplo de resposta

      HTTP/1.1 200 OK
x-oss-request-id: 534****
Date: Fri, 27 Dec 2024 03:21:12 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

    SDKs do OSS

    SDKs do OSS que suportam esta operação:

    ossutil

    Para o comando ossutil correspondente, consulte Put-bucket-requester-qos-info.