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 400 Gbit/s, entre em contato com o suporte técnico para solicitar esse service.
Por padrão, uma conta Alibaba Cloud tem permissões para configure o throttling de solicitantes em um resource pool. Para executar esta 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 RAM policy examples.
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>
<TotalQps>10000</TotalQps>
<IntranetQps>-1</IntranetQps>
<ExtranetQps>-1</ExtranetQps>
</QoSConfiguration>Cabeçalhos da solicitação
Esta operação utiliza apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Common request headers.
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 especificado. Por exemplo, ao defina 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. Além disso, cada configuração individual de largura de banda do solicitante não pode superar sua própria configuração total. Se a largura de banda total de baixe for 100 Gbps, por exemplo, a largura de banda de baixe pela Internet não poderá ultrapassar 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 do solicitante no nível do resource pool. Unidade: Gbps. Nó pai: QoSConfiguration |
|
IntranetUploadBandwidth |
Integer |
Sim |
-1 |
Largura de banda de upload da rede interna do 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 do 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 baixe do solicitante no nível do resource pool. Unidade: Gbps. Nó pai: QoSConfiguration |
|
IntranetDownloadBandwidth |
Integer |
Sim |
-1 |
Largura de banda de baixe da rede interna do solicitante no nível do resource pool. Inclui a largura de banda de baixe pela rede clássica e VPCs. Unidade: Gbps. Nó pai: QoSConfiguration |
|
ExtranetDownloadBandwidth |
Integer |
Sim |
-1 |
Largura de banda de baixe da rede pública do solicitante no nível do resource pool. Abrange a largura de banda de baixe pela rede pública e endpoints de aceleração. Unidade: Gbps. Nó pai: QoSConfiguration |
|
TotalQps |
Integer |
Não |
10000 |
Configuração total de QPS. Nó pai: QoSConfiguration |
|
IntranetQps |
Integer |
Não |
-1 |
Configuração de QPS para solicitações de redes internas, incluindo a rede clássica e VPCs. Nó pai: QoSConfiguration |
|
ExtranetQps |
Integer |
Não |
-1 |
Configuração de QPS para solicitações de redes externas, incluindo Internet e CDNs. Nó pai: QoSConfiguration |
Cabeçalhos da resposta
Esta operação utiliza apenas cabeçalhos de resposta comuns. Para mais informações, consulte Common response headers.
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> <TotalQps>10000</TotalQps> <IntranetQps>-1</IntranetQps> <ExtranetQps>-1</ExtranetQps> </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.