Configure o throttling para um solicitante em um resource pool.
Observações de uso
O QoS de resource pool está em visualização por convite. Se o throughput dos seus buckets do OSS em uma região atingiu ou ultrapassou 500 Gbit/s, entre em contato com o suporte técnico para solicitar esse recurso.
Por padrão, uma conta Alibaba Cloud tem permissões para configurar o throttling de solicitantes em um resource pool. Para executar essa operação com um usuário do Resource Access Management (RAM) ou do Security Token Service (STS), é necessário ter a permissão
oss:PutResourcePoolRequesterQoSInfo. Para mais informações, consulte Exemplos de políticas do RAM.
Sintaxe da solicitação
PUT /?requesterQosInfo&resourcePool=ResourcePoolName&qosRequester=uid
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Type: application/xml
Content-Length: content length
<QoSConfiguration>
<TotalUploadBandwidth>10</TotalUploadBandwidth>
<IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
<ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
<TotalDownloadBandwidth>10</TotalDownloadBandwidth>
<IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
<ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
</QoSConfiguration>Cabeçalhos da solicitação
Esta operação utiliza apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Cabeçalhos de solicitação comuns.
Elementos da solicitação
Nos itens de configuração de largura de banda a seguir, o valor -1 (padrão) indica que não há limite de largura de banda. O valor 0 desativa o tipo de largura de banda correspondente. Por exemplo, ao definir ExtranetUploadBandwidth como 0, o upload de dados para o bucket especificado pela Internet fica bloqueado.
A soma das configurações de largura de banda de um solicitante não pode exceder a configuração total de largura de banda do resource pool. Da mesma forma, a configuração de um único tipo de largura de banda para um solicitante também não pode ultrapassar o total do resource pool. Se a largura de banda total de download do resource pool for de 100 Gbps, por exemplo, a largura de banda de download pela rede pública para um solicitante não poderá ser superior a 100 Gbps.
A configuração de um único tipo de largura de banda para um solicitante deve ser de pelo menos 5 Gbps.
|
Nome |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
resourcePool |
String |
Sim |
resource-pool-for-ai |
Nome do resource pool. |
|
qosRequester |
String |
Sim |
300xxxx |
UID do solicitante. |
|
QoSConfiguration |
Container |
Sim |
N/A |
Contêiner da configuração de QoS. Nó pai: Nenhum |
|
TotalUploadBandwidth |
Integer |
Sim |
10 |
Largura de banda total de upload para o solicitante no nível do resource pool. Unidade: Gbps. Nó pai: QoSConfiguration |
|
IntranetUploadBandwidth |
Integer |
Sim |
-1 |
Largura de banda de upload da rede interna para o solicitante no nível do resource pool. Inclui a largura de banda de upload pela rede clássica e VPCs. Unidade: Gbps. Nó pai: QoSConfiguration |
|
ExtranetUploadBandwidth |
Integer |
Sim |
-1 |
Largura de banda de upload da rede pública para o solicitante no nível do resource pool. Abrange a largura de banda de upload pela rede pública e endpoints de aceleração. Unidade: Gbps. Nó pai: QoSConfiguration |
|
TotalDownloadBandwidth |
Integer |
Sim |
10 |
Largura de banda total de download para o solicitante no nível do resource pool. Unidade: Gbps. Nó pai: QoSConfiguration |
|
IntranetDownloadBandwidth |
Integer |
Sim |
-1 |
Largura de banda de download da rede interna para o solicitante no nível do resource pool. Cobre a largura de banda de download pela rede clássica e VPCs. Unidade: Gbps. Nó pai: QoSConfiguration |
|
ExtranetDownloadBandwidth |
Integer |
Sim |
-1 |
Largura de banda de download da rede pública para o solicitante no nível do resource pool. Engloba a largura de banda de download pela rede pública e endpoints de aceleração. Unidade: Gbps. Nó pai: QoSConfiguration |
Cabeçalhos da resposta
Esta operação utiliza apenas cabeçalhos de resposta comuns. Para mais informações, consulte Cabeçalhos de resposta comuns.
Exemplos
-
Exemplo de solicitação
PUT /?requesterQosInfo&resourcePool=resource-pool-for-ai&qosRequester=300xxxx Host: oss-cn-hangzhou.aliyuncs.com Date: Fri, 27 Dec 2024 03:21:12 GMT Content-Type: application/xml Content-Length: 454 Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e <QoSConfiguration> <TotalUploadBandwidth>10</TotalUploadBandwidth> <IntranetUploadBandwidth>-1</IntranetUploadBandwidth> <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth> <TotalDownloadBandwidth>10</TotalDownloadBandwidth> <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth> <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth> </QoSConfiguration> -
Exemplo de resposta
HTTP/1.1 200 OK x-oss-request-id: 534**** Date: Fri, 27 Dec 2024 03:21:12 GMT Content-Length: 0 Connection: keep-alive Server: AliyunOSS
SDK
Os SDKs abaixo suportam esta operação:
Interface de linha de comando ossutil
Para o comando ossutil correspondente, consulte put-resource-pool-requester-qos-info.