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

Observações

• Por padrão, uma conta Alibaba Cloud tem permissões para configurar a limitação de largura de banda do solicitante para um usuário RAM em um pool de recursos. Para configurar a limitação de largura de banda do solicitante para um usuário RAM usando outro usuário RAM ou o Security Token Service (STS), é necessário ter a permissão oss:PutResourcePoolRequesterQoSInfo. Para mais informações, consulte Conceder uma política personalizada.

• A configuração de cada item não pode exceder as configurações de limitação de largura de banda do bucket.

• O valor -1 indica que não há limites impostos ao campo. Se um campo não for especificado, o valor padrão é -1. O valor 0 indica que um tipo específico de solicitação de acesso está proibido.

• A configuração dos subitens não pode exceder a configuração total de um item. Por exemplo, se você definir 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 suporta 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 suporta 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 pool de recursos chamado examplePool, criando um arquivo de configuração XML chamado qos.xml e adicionando o seguinte código de exemplo ao arquivo de configuração:

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

• O parâmetro TotalUploadBandwidth está definido como 10, o que especifica que a largura de banda total de upload é 10 Gbit/s. A largura de banda total de upload pelas redes internas e redes públicas não pode exceder 10 Gbit/s.

• O parâmetro IntranetUploadBandwidth está definido como -1, o que indica que não há limites impostos à largura de banda de upload pelas redes internas. No entanto, a largura de banda de upload pelas redes internas deve ser menor ou igual à largura de banda total de upload, que é 10 Gbit/s.

• O parâmetro ExtranetUploadBandwidth está definido como -1, o que indica que não há limites impostos à largura de banda de upload pelas redes públicas. Porém, a largura de banda de upload pelas redes públicas deve ser menor ou igual à largura de banda total de upload, que é 10 Gbit/s.

• O parâmetro TotalDownloadBandwidth está definido como 10, especificando que a largura de banda total de download é 10 Gbit/s. A largura de banda total de download pelas redes internas e redes públicas não pode exceder 10 Gbit/s.

• O parâmetro IntranetDownloadBandwidth está definido como -1, indicando que não há limites impostos à largura de banda de download pelas redes internas. Contudo, a largura de banda de download pelas redes internas deve ser menor ou igual à largura de banda total de download, que é 10 Gbit/s.

• O parâmetro ExtranetDownloadBandwidth está definido como -1, sem limites impostos à largura de banda de download pelas redes públicas. Entretanto, a largura de banda de download pelas redes públicas deve ser menor ou igual à largura de banda total de download, que é 10 Gbit/s.

• O parâmetro TotalQps está definido como 10000, o que especifica que o limite total de QPS é 10.000 consultas por segundo. O QPS total pelas redes internas e redes públicas não pode exceder esse valor.

• O parâmetro IntranetQps está definido como -1, o que indica que não há limites impostos ao QPS pelas redes internas. No entanto, o QPS pelas redes internas deve ser menor ou igual ao QPS total, que é 10.000 consultas por segundo.

• O parâmetro ExtranetQps está definido como -1, sem limites impostos ao QPS pelas redes externas. Porém, o QPS pelas redes externas deve ser menor ou igual ao QPS total, que é 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