Modifica as configurações de limitação de largura de banda de um bucket.
Notas de uso
O QoS do pool de recursos está em visualização por convite. Se o throughput do OSS em uma região atingir 400 Gbit/s ou mais, entre em contato com o suporte técnico para solicitar.
-
Contas Alibaba Cloud têm essa permissão por padrão. Usuários RAM e STS precisam da permissão
oss:PutBucketRequesterQoSInfo. Para mais informações, consulte Conceder uma política personalizada. -
Cada item não pode exceder os limites de largura de banda no nível do bucket.
-
O valor -1 significa que nenhum limite é imposto (padrão se não especificado). O valor 0 proíbe esse tipo de acesso.
-
Os valores dos subitens não podem exceder o total do item pai. Por exemplo, se a largura de banda total de upload for 10 Gbit/s, a largura de banda de upload interna não pode exceder 10 Gbit/s.
-
A limitação de largura de banda do solicitante não pode ser inferior a 5 Gbit/s. Por exemplo, a largura de banda de upload deve ser de pelo menos 5 Gbit/s.
-
Cada bucket suporta limitação de largura de banda para até 300 usuários RAM.
Sintaxe
ossutil api invoke-operation --op-name put-bucket-requester-qos-info --method PUT --bucket=<bucket-name> --parameters requesterQosInfo --parameters qosRequester=<uid> --body file://<path-to-xml>|
Parâmetro |
Tipo |
Descrição |
|
--bucket |
string |
Nome do bucket. |
|
--parameters |
stringArray |
Parâmetros da solicitação no formato k[=v], como versionId=123 e delete. |
|
--body |
string |
O corpo da solicitação. file:// lê de um arquivo. - lê da entrada padrão (stdin). |
--body
O parâmetro --body aceita XML. Valores que começam com file:// carregam do arquivo especificado.
<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>|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Unidade |
Descrição |
|
TotalUploadBandwidth |
Integer |
Sim |
10 |
Gbps |
Largura de banda total de upload. Nó pai: QoSConfiguration |
|
IntranetUploadBandwidth |
Integer |
Sim |
-1 |
Gbps |
Largura de banda de upload em redes internas, incluindo a rede clássica e VPCs. Nó pai: QoSConfiguration |
|
ExtranetUploadBandwidth |
Integer |
Sim |
-1 |
Gbps |
Largura de banda de upload em redes externas, incluindo a Internet e CDN. Nó pai: QoSConfiguration |
|
TotalDownloadBandwidth |
Integer |
Sim |
10 |
Gbps |
Largura de banda total de download. Nó pai: QoSConfiguration |
|
IntranetDownloadBandwidth |
Integer |
Sim |
-1 |
Gbps |
Largura de banda de download em redes internas, incluindo a rede clássica e VPCs. Nó pai: QoSConfiguration |
|
ExtranetDownloadBandwidth |
Integer |
Sim |
-1 |
Gbps |
Largura de banda de download em redes externas, incluindo a Internet e CDN. Nó pai: QoSConfiguration |
|
TotalQps |
Integer |
Sim |
10000 |
solicitações/s |
A configuração total de QPS. Nó pai: QoSConfiguration |
|
IntranetQps |
Integer |
Sim |
-1 |
solicitações/s |
A configuração de QPS para solicitações de redes internas, incluindo a rede clássica e VPCs. Nó pai: QoSConfiguration |
|
ExtranetQps |
Integer |
Sim |
-1 |
solicitações/s |
A configuração de QPS para solicitações de redes externas, incluindo a Internet e CDNs. Nó pai: QoSConfiguration |
Para mais informações sobre as opções globais de linha de comando suportadas, consulte Opções globais de linha de comando.
Exemplos
Configure o QoS para o solicitante 202835923910178018 no bucket examplebucket. Crie um arquivo chamado qos.xml com o seguinte conteúdo:
<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>Descrições dos parâmetros:
-
TotalUploadBandwidth definido como 10 (10 Gbit/s). A soma das larguras de banda de upload interna e pública não pode exceder esse valor.
-
IntranetUploadBandwidth definido como -1 (sem limite), mas não pode exceder a largura de banda total de upload de 10 Gbit/s.
-
ExtranetUploadBandwidth definido como -1 (sem limite), mas não pode exceder a largura de banda total de upload de 10 Gbit/s.
-
TotalDownloadBandwidth definido como 10 (10 Gbit/s). A soma das larguras de banda de download interna e pública não pode exceder esse valor.
-
IntranetDownloadBandwidth definido como -1 (sem limite), mas não pode exceder a largura de banda total de download de 10 Gbit/s.
-
ExtranetDownloadBandwidth definido como -1 (sem limite), mas não pode exceder a largura de banda total de download de 10 Gbit/s.
-
TotalQps definido como 10000, o que limita o QPS combinado de todas as solicitações em redes internas e externas a 10.000 solicitações por segundo.
-
IntranetQps definido como -1, o que não impõe um limite separado de QPS para solicitações internas. O QPS interno ainda está sujeito ao limite geral de TotalQps.
-
ExtranetQps definido como -1, o que não impõe um limite separado de QPS para solicitações externas. O QPS externo ainda está sujeito ao limite geral de TotalQps.
Comando de exemplo:
ossutil api invoke-operation --op-name put-bucket-requester-qos-info --method PUT --bucket=examplebucket --parameters requesterQosInfo --parameters qosRequester=202835923910178018 --body file://qos.xml