Modifique as configurações de prioridade e Quality of Service (QoS) de largura de banda para buckets e grupos de buckets em um resource pool do OSS. Isso garante que o compromisso mínimo de largura de banda e as regras de prioridade estejam em conformidade com os limites do resource pool. - Object Storage Service: Central de Documentação do Alibaba Cloud

Precauções

A quantidade de níveis de prioridade deve estar entre 3 e 10.
Os níveis de prioridade começam em 1. Um número maior indica uma prioridade mais alta.
Caso você não configure um compromisso mínimo de largura de banda padrão (DefaultGuaranteedQosConfiguration), será necessário defina um para cada nível de prioridade. Se houver um valor padrão configurado, qualquer nível de prioridade sem um compromisso específico utilizará esse valor.
A soma de um item de compromisso mínimo de largura de banda (como TotalUploadBandwidth) em todos os níveis de prioridade não pode exceder o valor do item correspondente no resource pool.
Só é possível definir o compromisso mínimo de largura de banda de um nível de prioridade como -1 se o valor do item correspondente no resource pool também for -1.
Quando um bucket e seu grupo de buckets possuem configurações de prioridade diferentes, a prioridade do grupo de buckets prevalece.

Sintaxe da solicitação

PUT /?priorityQos&resourcePool=ResourcePoolName
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Type: application/xml
Content-Length: content length

Elementos da solicitação

Nome	Tipo	Posição do parâmetro	Descrição
resourcePool	string	Query	Nome do resource pool de destino.
PriorityQosConfiguration	container	Body	Container para a configuração de limitação por prioridade do resource pool.Nó pai: None
PriorityCount	Integer	-	Quantidade de níveis de prioridade.Valores válidos: 3 a 10.Nó pai: PriorityQosConfiguration
DefaultPriorityLevel	Integer	-	Nível de prioridade padrão.Valores válidos: 1 a PriorityCount.Nó pai: PriorityQosConfiguration
DefaultGuaranteedQosConfiguration	container	-	Compromisso mínimo de largura de banda padrão. Se não estiver configurado, você deve especifique um compromisso mínimo de largura de banda para cada nível de prioridade. Quando configurado, os níveis de prioridade sem um compromisso específico usam este valor padrão.Nó pai: PriorityQosConfiguration
QosPriorityLevelConfiguration	container	-	Container para a configuração de limitação de um nível de prioridade específico.Nó pai: PriorityQosConfiguration
PriorityLevel	Integer	-	Nível de prioridade.Valores válidos: 1 a PriorityCount.Nó pai: QosPriorityLevelConfiguration
GuaranteedQosConfiguration	container	-	Container para o compromisso mínimo de largura de banda de um nível de prioridade específico.Nó pai: QosPriorityLevelConfiguration
TotalUploadBandwidth	Integer	-	Compromisso mínimo total de largura de banda de upload. Unidade: Gbps.Nó pai: DefaultGuaranteedQosConfiguration ou GuaranteedQosConfiguration
IntranetUploadBandwidth	Integer	-	Compromisso mínimo de largura de banda de upload para a rede interna. Unidade: Gbps. Inclui solicitações de redes internas, como classic network e VPC.Nó pai: DefaultGuaranteedQosConfiguration ou GuaranteedQosConfiguration
ExtranetUploadBandwidth	Integer	-	Compromisso mínimo de largura de banda de upload para a rede pública. Unidade: Gbps. Abrange solicitações de redes públicas, como Internet e CDN.Nó pai: DefaultGuaranteedQosConfiguration ou GuaranteedQosConfiguration
TotalDownloadBandwidth	Integer	-	Compromisso mínimo total de largura de banda de baixe. Unidade: Gbps.Nó pai: DefaultGuaranteedQosConfiguration ou GuaranteedQosConfiguration
IntranetDownloadBandwidth	Integer	-	Compromisso mínimo de largura de banda de baixe para a rede interna. Unidade: Gbps. Cobre solicitações de redes internas, como classic network e VPC.Nó pai: DefaultGuaranteedQosConfiguration ou GuaranteedQosConfiguration
ExtranetDownloadBandwidth	Integer	-	Compromisso mínimo de largura de banda de baixe para a rede pública. Unidade: Gbps. Engloba solicitações de redes públicas, como Internet e CDN.Nó pai: DefaultGuaranteedQosConfiguration ou GuaranteedQosConfiguration
Subjects	container	-	Container para os objetos de limitação, incluindo buckets e grupos de buckets.Nó pai: QosPriorityLevelConfiguration
Bucket	string	-	Nome do bucket.Nó pai: Subjects
BucketGroup	string	-	Nome do grupo de buckets.Nó pai: Subjects

Exemplos

Exemplo de solicitação

PUT /?priorityQos&resourcePool=ResoucePoolName
Host: oss-cn-shanghai.aliyuncs.com
Date: Fri, 10 Oct 2025 07:38:42 GMT
Content-Type: application/xml
Content-Length: content length

<PriorityQosConfiguration>
  <PriorityCount>4</PriorityCount>
  <DefaultPriorityLevel>3</DefaultPriorityLevel>
  <DefaultGuaranteedQosConfiguration>
    <TotalUploadBandwidth>10</TotalUploadBandwidth>
    <IntranetUploadBandwidth>20</IntranetUploadBandwidth>
    <ExtranetUploadBandwidth>30</ExtranetUploadBandwidth>
    <TotalDownloadBandwidth>40</TotalDownloadBandwidth>
    <IntranetDownloadBandwidth>50</IntranetDownloadBandwidth>
    <ExtranetDownloadBandwidth>60</ExtranetDownloadBandwidth>
  </DefaultGuaranteedQosConfiguration>
  <QosPriorityLevelConfiguration>
    <PriorityLevel>1</PriorityLevel>
    <GuaranteedQosConfiguration>
      <TotalUploadBandwidth>20</TotalUploadBandwidth>
      <ToTalDownloadBandwidth>20</ToTalDownloadBandwidth>
      <ExtranetUploadBandwidth>10</ExtranetUploadBandwidth>
      <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
      <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth>
      <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth>
    </GuaranteedQosConfiguration>
  </QosPriorityLevelConfiguration>
  <QosPriorityLevelConfiguration>
    <PriorityLevel>2</PriorityLevel>
    <GuaranteedQosConfiguration>
      <TotalUploadBandwidth>20</TotalUploadBandwidth>
      <ToTalDownloadBandwidth>20</ToTalDownloadBandwidth>
      <ExtranetUploadBandwidth>10</ExtranetUploadBandwidth>
      <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
      <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth>
      <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth>
    </GuaranteedQosConfiguration>
    <Subjects>
      <BucketGroup>bucketGroup-02</BucketGroup>
      <Bucket>bucket-02</Bucket>
    </Subjects>
  </QosPriorityLevelConfiguration>
</PriorityQosConfiguration>

Exemplo de resposta

HTTP/1.1 200 OK
Date: Fri, 10 Oct 2025 07:38:42 GMT
Content-Length: 0

SDK

Os SDKs a seguir oferecem suporte a esta operação:

Go V2

Ferramenta de linha de comando ossutil

Para obter o comando ossutil correspondente, consulte put-resource-pool-priority-qos-configuration.