Configura a limitação de largura de banda no nível do solicitante para um bucket em um pool de recursos.
Observações
O QoS de pool de recursos 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.
Contas Alibaba Cloud têm essa permissão por padrão. Usuários RAM ou acesso via STS exigem a permissão
oss:PutBucketRequesterQoSInfo. Consulte os Exemplos de políticas do RAM.
Sintaxe
PUT /?requesterQosInfo&qosRequester=uid
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
<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 usa apenas Cabeçalhos comuns de solicitação.
Parâmetros da solicitação
O valor -1 indica ausência de limite de largura de banda. O valor 0 significa que o tipo de largura de banda não é compatível. Por exemplo, defina ExtranetUploadBandwidth como 0 bloqueia uploads via rede pública para o bucket.
O limiar total de largura de banda de um solicitante não pode exceder a largura de banda total do pool de recursos. Por exemplo, se a largura de banda total de download do pool for 100 Gbit/s, a largura de banda de download pela Internet de um único solicitante não poderá ultrapassar 100 Gbit/s.
Cada limiar de largura de banda deve ser de, no mínimo, 5 Gbit/s.
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
qosRequester |
String |
Sim |
300xxxx |
ID de usuário (UID) do solicitante. Nós pai: nenhum |
|
QoSConfiguration |
Container |
Sim |
N/A |
Container que armazena os resultados. Nós pai: nenhum |
|
TotalUploadBandwidth |
Integer |
Sim |
10 |
Largura de banda total de upload do solicitante para o bucket. Unidade: Gbit/s. Nó pai: QoSConfiguration |
|
IntranetUploadBandwidth |
Integer |
Sim |
-1 |
Largura de banda de upload em rede interna para o solicitante neste bucket. Redes internas incluem rede clássica e VPC. Unidade: Gbit/s. Nó pai: QoSConfiguration |
|
ExtranetUploadBandwidth |
Integer |
Sim |
-1 |
Largura de banda de upload em rede pública para o solicitante neste bucket. Redes públicas incluem Internet e endpoints de aceleração. Unidade: Gbit/s. Nó pai: QoSConfiguration |
|
TotalDownloadBandwidth |
Integer |
Sim |
10 |
Largura de banda total de download do solicitante para o bucket. Unidade: Gbit/s. Nó pai: QoSConfiguration |
|
IntranetDownloadBandwidth |
Integer |
Sim |
-1 |
Largura de banda de download em rede interna para o solicitante neste bucket. Redes internas incluem rede clássica e VPC. Unidade: Gbit/s. Nó pai: QoSConfiguration |
|
ExtranetDownloadBandwidth |
Integer |
Sim |
-1 |
Largura de banda de download em rede pública para o solicitante neste bucket. Redes públicas incluem Internet e endpoints de aceleração. Unidade: Gbit/s. Nó pai: QoSConfiguration |
Cabeçalhos da resposta
Esta operação retorna apenas cabeçalhos comuns de resposta. Para mais informações, consulte Cabeçalhos comuns de resposta.
Exemplo
-
Exemplo de solicitação
PUT /?requesterQosInfo&qosRequester=300xxxx Host: oss-example.oss-cn-hangzhou.aliyuncs.com Content-Length: 209 Date: Fri, 27 Dec 2024 03:21:12 GMT Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e <?xml version="1.0" encoding="UTF-8"?> <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
SDKs do OSS
SDKs do OSS compatíveis com esta operação:
ossutil
Para o comando correspondente do ossutil, consulte put-bucket-requester-qos-info.