Object Storage Service:put-resource-pool-requester-qos-info

Observações

• Por padrão, uma conta Alibaba Cloud tem permissão para configurar a limitação de largura de banda do solicitante para um usuário RAM em um resource pool. Para defina essa configuração usando outro usuário RAM ou o Security Token Service (STS), é necessária a permissão oss:PutResourcePoolRequesterQoSInfo. Para mais informações, consulte Grant a custom policy.

• O valor configurado para cada item não pode exceder as definições de limitação de largura de banda do bucket.

• 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.

• As configurações dos subitens não podem ultrapassar a configuração total do item. Por exemplo, se você defina a largura de banda total de upload como 10 Gbit/s, a largura de banda de upload pela rede 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 maior ou igual a 5 Gbit/s.

• Um único bucket aceita limitação de largura de banda para até 300 usuários RAM.

Sintaxe

ossutil api invoke-operation --op-name put-resource-pool-requester-qos-info --method PUT --parameters resourcePool=<resource-pool> --parameters qosRequester=<uid> --parameters requesterQosInfo --body=file://<path-to-xml>

--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>

Exemplos

Adicione configurações de QoS a um solicitante cujo ID é 202835923910178019 em um resource pool chamado examplePool. Para isso, crie um arquivo de configuração XML denominado qos.xml e adicione o seguinte código de exemplo:

<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 abaixo descrevem os parâmetros:

• 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 nas 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 10 Gbit/s.

• Definir TotalDownloadBandwidth como 10 fixa a largura de banda total de baixe em 10 Gbit/s. O tráfego combinado de baixe nas redes internas e públicas não pode exceder esse valor.

• IntranetDownloadBandwidth com valor -1 indica ausência de limites específicos para baixe em redes internas, limitado apenas pelo teto total de baixe de 10 Gbit/s.

• Quando ExtranetDownloadBandwidth é -1, a largura de banda de baixe 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 total de QPS em 10.000 consultas por segundo. O volume agregado de consultas nas redes internas e públicas não pode superar essa marca.

• O parâmetro IntranetQps igual a -1 não impõe restrições ao QPS em redes internas, contanto que o volume se mantenha dentro do limite total de 10.000 consultas por segundo.

• ExtranetQps definido como -1 libera o QPS em redes externas de limites específicos, respeitando apenas o teto global de 10.000 consultas por segundo.

Comando de exemplo:

ossutil api invoke-operation --op-name put-resource-pool-requester-qos-info --method PUT --parameters resourcePool=examplePool --parameters qosRequester=202835923910178019 --parameters requesterQosInfo --body=file://qos.xml