Configura as informações de Quality of Service (QoS) de 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 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 do Security Token Service (STS), é necessário ter a permissão
oss:PutBucketQoSInfo. Para mais detalhes, consulte Grant a custom policy.Configure a limitação de largura de banda apenas em 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 - indica 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 |
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 |
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 |
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 |
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 |
QPS em redes internas, incluindo a rede clássica e VPCs. Nós pai: QoSConfiguration. |
|
ExtranetQps |
Integer |
Sim |
-1 |
Consultas/s |
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 compatíveis, 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 da largura de banda de upload em redes internas e públicas não pode ultrapassar esse limite.
Com IntranetUploadBandwidth igual a -1, não há restrições específicas para a largura de banda de upload em redes internas. No entanto, ela deve permanecer igual ou inferior à largura de banda total de upload de 10 Gbit/s.
O valor -1 em ExtranetUploadBandwidth remove limites diretos para a largura de banda de upload em redes públicas, desde que respeite o teto total de upload de 10 Gbit/s.
Definir TotalDownloadBandwidth como 10 limita a largura de banda total de download a 10 Gbit/s. O tráfego combinado de redes internas e públicas não pode exceder esse valor.
IntranetDownloadBandwidth com valor -1 indica ausência de limites específicos para download em redes internas, condicionado apenas ao limite total de download de 10 Gbit/s.
Ao usar -1 em ExtranetDownloadBandwidth, a largura de banda de download em redes públicas fica livre de restrições individuais, mas ainda sujeita ao limite total de 10 Gbit/s.
TotalQps configurado como 10000 define o limite global de QPS em 10.000 consultas por segundo. O volume total de consultas em redes internas e públicas não pode superar essa marca.
IntranetQps igual a -1 significa que não há imposição de limites para o QPS em redes internas, desde que o total não ultrapasse 10.000 consultas por segundo.
ExtranetQps com valor -1 isenta o QPS de redes externas de limites específicos, mantendo-o subordinado ao teto 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