Configura regras de limitação de taxa para um bucket em um pool de recursos.
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 a technical support para solicitar esse recurso.
Por padrão, uma conta Alibaba Cloud pode configurar regras de limitação de taxa para um bucket em um pool de recursos. Para executar essa operação como usuário RAM ou usando o Security Token Service (STS), é necessário ter a permissão
oss:PutBucketQoSInfo. Para mais informações, consulte Exemplos comuns de políticas RAM.
Sintaxe
PUT /?qosInfo HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
<?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>Cabeçalhos da requisição
Esta operação utiliza apenas cabeçalhos de requisição comuns. Para mais informações, consulte Cabeçalhos de requisição comuns.
Elementos da requisição
Na tabela a seguir, o valor padrão -1 indica que a largura de banda do bucket não é limitada. O valor 0 desativa o tipo de largura de banda correspondente. Por exemplo, o valor 0 para ExtranetUploadBandwidth indica que não é possível fazer upload de dados para o bucket pela rede pública.
A soma das configurações de largura de banda do bucket não pode exceder a configuração total de largura de banda do pool de recursos. Cada configuração individual de largura de banda 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 é 100 Gbit/s, a largura de banda de download pela Internet não pode ultrapassar 100 Gbit/s.
|
Elemento |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
QoSConfiguration |
Container |
Sim |
N/A |
O container para as regras de limitação de taxa. Nós pais: nenhum |
|
TotalUploadBandwidth |
Integer |
Sim |
10 |
A largura de banda total de upload do bucket. Unidade: Gbit/s. Nós pais: QoSConfiguration |
|
IntranetUploadBandwidth |
Integer |
Sim |
-1 |
A largura de banda de upload pela rede interna do bucket. Redes internas incluem a rede clássica e VPC. Unidade: Gbit/s. Nós pais: QoSConfiguration |
|
ExtranetUploadBandwidth |
Integer |
Sim |
-1 |
A largura de banda de upload pela rede pública do bucket. Redes públicas incluem a Internet e endpoints de aceleração. Unidade: Gbit/s. Nós pais: QoSConfiguration |
|
TotalDownloadBandwidth |
Integer |
Sim |
10 |
A largura de banda total de download do bucket. Unidade: Gbit/s. Nós pais: QoSConfiguration |
|
IntranetDownloadBandwidth |
Integer |
Sim |
-1 |
A largura de banda de download pela rede interna do bucket. Redes internas incluem a rede clássica e VPC. Unidade: Gbit/s. Nós pais: QoSConfiguration |
|
ExtranetDownloadBandwidth |
Integer |
Sim |
-1 |
A largura de banda de download pela rede pública do bucket. Redes públicas incluem a Internet e endpoints de aceleração. Unidade: Gbit/s. Nós pais: 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 requisiçõ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 requisiçõ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 de resposta comuns.
Exemplos
-
Exemplos de requisições
PUT /?qosInfo HTTP/1.1 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> -
Exemplos de respostas de sucesso
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
Os seguintes SDKs do OSS suportam PutBucketQoSInfo:
ossutil
Para o comando ossutil correspondente a esta operação, consulte Put-bucket-qos-info.