Configure as informações de Quality of Service (QoS) para um bucket.
Observações de uso
O recurso de QoS do pool de recursos está em visualização por convite. Se o throughput dos buckets do Object Storage Service (OSS) em uma região específica for igual ou superior a 500 Gbit/s, entre em contato com o suporte técnico para solicitar o acesso ao recurso.
Por padrão, uma conta Alibaba Cloud tem permissão para configurar as informações de QoS de um bucket. Para configurar essas informações usando um usuário do Resource Access Management (RAM) ou o Security Token Service (STS), é necessário ter a permissão
oss:PutBucketQoSInfo. Para mais detalhes, consulte Grant a custom policy.A limitação de largura de banda aplica-se apenas a buckets adicionados a um pool de recursos. O limiar de largura de banda de cada item de configuração do bucket não pode exceder o limiar do pool de recursos ao qual ele pertence.
O valor -1 indica que não há limites impostos ao campo. Caso um campo não seja especificado, o valor padrão será -1. O valor 0 proíbe um tipo específico de solicitação de acesso.
A largura de banda de um subitem não pode ultrapassar a largura de banda total do item. Por exemplo, se você definir a largura de banda total de upload como 10 Gbit/s, a largura de banda de upload em redes internas não poderá exceder 10 Gbit/s.
Sintaxe
ossutil api invoke-operation --op-name put-bucket-qos-info --method PUT --bucket <bucket-name> --parameters qosInfo --body=file://<path-to-xml-file>|
Parâmetro |
Tipo |
Descrição |
|
--bucket |
string |
O nome do bucket. |
|
--parameters |
stringArray |
Os parâmetros da solicitação no formato k[=v], como versionId=123 e delete. |
|
--body |
string |
O corpo da solicitação. file:// indica que as configurações são lidas de um arquivo, enquanto - especifica que as configurações são lidas da entrada padrão. |
--body
O parâmetro --body aceita o formato XML. Se o valor do parâmetro começar com file://, as configurações serão carregadas de um arquivo específico.
<QoSConfiguration>
<TotalUploadBandwidth>integer</TotalUploadBandwidth>
<IntranetUploadBandwidth>integer</IntranetUploadBandwidth>
<ExtranetUploadBandwidth>integer</ExtranetUploadBandwidth>
<TotalDownloadBandwidth>integer</TotalDownloadBandwidth>
<IntranetDownloadBandwidth>integer</IntranetDownloadBandwidth>
<ExtranetDownloadBandwidth>integer</ExtranetDownloadBandwidth>
<TotalQps>integer</TotalQps>
<IntranetQps>integer</IntranetQps>
<ExtranetQps>integer</ExtranetQps>
</QoSConfiguration>A tabela a seguir descreve os parâmetros obrigatórios no arquivo de configuração.
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Unidade |
Descrição |
|
TotalUploadBandwidth |
Integer |
Sim |
10 |
Gbit/s |
A largura de banda total de upload. Nós pai: QoSConfiguration. |
|
IntranetUploadBandwidth |
Integer |
Sim |
-1 |
Gbit/s |
A largura de banda de upload em redes internas, incluindo a rede clássica e Virtual Private Clouds (VPCs). Unidade: Gbit/s. Nós pai: QoSConfiguration. |
|
ExtranetUploadBandwidth |
Integer |
Sim |
-1 |
Gbit/s |
A largura de banda de upload em redes externas, abrangendo a Internet e a Alibaba Cloud Content Delivery Network (CDN). Nós pai: QoSConfiguration. |
|
TotalDownloadBandwidth |
Integer |
Sim |
10 |
Gbit/s |
A largura de banda total de download. Nós pai: QoSConfiguration. |
|
IntranetDownloadBandwidth |
Integer |
Sim |
-1 |
Gbit/s |
A largura de banda de download em redes internas, incluindo a rede clássica e VPCs. Unidade: Gbit/s. Nós pai: QoSConfiguration. |
|
ExtranetDownloadBandwidth |
Integer |
Sim |
-1 |
Gbit/s |
A largura de banda de download em redes externas, abrangendo a Internet e a CDN. Nós pai: QoSConfiguration. |
|
TotalQps |
Integer |
Sim |
10000 |
Consultas/s |
O QPS total. Nós pai: QoSConfiguration. |
|
IntranetQps |
Integer |
Sim |
-1 |
Consultas/s |
O QPS em redes internas, incluindo a rede clássica e VPCs. Nós pai: QoSConfiguration. |
|
ExtranetQps |
Integer |
Sim |
-1 |
Consultas/s |
O QPS em redes externas, abrangendo a Internet e a CDN. Nós pai: QoSConfiguration. |
Para obter informações sobre as opções globais de linha de comando suportadas, consulte Global command-line options.
Exemplo
Adicione configurações de QoS a um bucket chamado examplebucket criando um arquivo de configuração XML denominado qos.xml e inserindo o código de exemplo abaixo:
<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>Os itens a seguir detalham os parâmetros utilizados:
O parâmetro TotalUploadBandwidth definido como 10 estabelece a largura de banda total de upload em 10 Gbit/s. A soma do upload em redes internas e públicas não pode ultrapassar esse limite.
IntranetUploadBandwidth configurado como -1 remove limites específicos para upload em redes internas. No entanto, o tráfego interno ainda deve respeitar o teto total de 10 Gbit/s.
ExtranetUploadBandwidth definido como -1 remove restrições dedicadas ao upload em redes públicas, desde que o valor permaneça igual ou inferior à largura de banda total de 10 Gbit/s.
TotalDownloadBandwidth definido como 10 limita a largura de banda total de download a 10 Gbit/s, somando-se os tráfegos de redes internas e públicas.
IntranetDownloadBandwidth definido como -1 remove limites individuais para download interno, mas o consumo não pode exceder a capacidade total de download de 10 Gbit/s.
ExtranetDownloadBandwidth definido como -1 permite que o download via redes públicas utilize toda a capacidade disponível, limitada apenas pelo teto total de 10 Gbit/s.
TotalQps definido como 10000 restringe o volume total de solicitações a 10.000 consultas por segundo, englobando tanto redes internas quanto externas.
IntranetQps definido como -1 remove limites para o QPS interno, garantindo apenas que o valor não supere o total de 10.000 consultas por segundo.
ExtranetQps definido como -1 remove cotas específicas para o QPS externo, mantendo-o subordinado ao limite global de 10.000 consultas por segundo.
Comando de exemplo:
ossutil api invoke-operation --op-name put-bucket-qos-info --method PUT --bucket examplebucket --parameters qosInfo --body=file://qos.xml