Modifica as configurações de limitação de largura de banda de um bucket.
Observações de uso
O QoS do pool de recursos está em visualização por convite. Se o throughput do OSS em uma região atingir 500 Gbit/s ou mais, entre em contato com o suporte técnico para solicitar a ativação.
Contas Alibaba Cloud têm essa permissão por padrão. Usuários RAM e STS exigem a permissão
oss:PutBucketRequesterQoSInfo. Para mais informações, consulte Conceder uma política personalizada.Nenhum item pode exceder os limites de largura de banda no nível do bucket.
O valor -1 indica ausência de limite (padrão se não especificado). O valor 0 proíbe esse tipo de acesso.
Os valores dos subitens não podem ultrapassar 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 poderá 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 aceita 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 exclua. |
|
--body |
string |
Corpo da solicitação. file:// lê de um arquivo. - lê da entrada padrão (stdin). |
--body
O parâmetro --body aceita XML. Valores iniciados com file:// carregam o conteúdo do arquivo especificado.
<QoSConfiguration>
<TotalUploadBandwidth>integer</TotalUploadBandwidth>
<IntranetUploadBandwidth>integer</IntranetUploadBandwidth>
<ExtranetUploadBandwidth>integer</ExtranetUploadBandwidth>
<TotalDownloadBandwidth>integer</TotalDownloadBandwidth>
<IntranetDownloadBandwidth>integer</IntranetDownloadBandwidth>
<ExtranetDownloadBandwidth>integer</ExtranetDownloadBandwidth>
</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 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 Internet e CDN. Nó pai: QoSConfiguration |
Para obter mais informações sobre as opções globais de linha de comando compatíveis, 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>
</QoSConfiguration>Descrição 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 este valor.
IntranetUploadBandwidth definido como -1 (sem limite), mas respeitando o teto de 10 Gbit/s da largura de banda total de upload.
ExtranetUploadBandwidth definido como -1 (sem limite), limitado apenas pela largura de banda total de upload de 10 Gbit/s.
TotalDownloadBandwidth definido como 10 (10 Gbit/s). A combinação das larguras de banda de download interna e pública não pode ultrapassar este valor.
IntranetDownloadBandwidth definido como -1 (sem limite), sem exceder a largura de banda total de download de 10 Gbit/s.
ExtranetDownloadBandwidth definido como -1 (sem limite), restrito à largura de banda total de download de 10 Gbit/s.
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