Configure regras de limitação de largura de banda para um bucket em um pool de recursos.
Observações de uso
O QoS do 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.
Por padrão, uma conta Alibaba Cloud pode configure regras de limitação de largura de banda para um bucket em um pool de recursos. Para executar essa operação como usuário RAM ou usando o Security Token Service (STS), você precisa da permissão
oss:PutBucketQoSInfo. Para mais informações, consulte Exemplos comuns de políticas do RAM.
Sintaxe
PUT /?qosInfo HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
<?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>Cabeçalhos da requisição
Esta operação utiliza apenas cabeçalhos de requisição comuns. Para mais informações, consulte Cabeçalhos de requisição comuns.
Elementos da requisição
Na tabela a seguir, o valor padrão -1 indica que não há limite de largura de banda para o bucket. O valor 0 significa que o tipo de largura de banda não é suportado. Por exemplo, o valor 0 para ExtranetUploadBandwidth impede o upload de dados para o bucket via rede pública.
A largura de banda total de um bucket não pode exceder a largura de banda total do pool de recursos nem a soma das larguras de banda de todos os buckets. Por exemplo, se a largura de banda total de download de todos os buckets for 100 Gbit/s, a largura de banda de download pela Internet de um único bucket não poderá ultrapassar 100 Gbit/s.
|
Elemento |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
QoSConfiguration |
Container |
Sim |
N/A |
Container das regras de limitação de largura de banda. Nós pai: nenhum |
|
TotalUploadBandwidth |
Integer |
Sim |
10 |
Largura de banda total de upload do bucket. Unidade: Gbit/s. Nós pai: QoSConfiguration |
|
IntranetUploadBandwidth |
Integer |
Sim |
-1 |
Largura de banda de upload pela rede interna do bucket. Redes internas incluem a rede clássica e VPC. Unidade: Gbit/s. Nós pai: QoSConfiguration |
|
ExtranetUploadBandwidth |
Integer |
Sim |
-1 |
Largura de banda de upload pela rede pública do bucket. Redes públicas incluem a Internet e endpoints de aceleração. Unidade: Gbit/s. Nós pai: QoSConfiguration |
|
TotalDownloadBandwidth |
Integer |
Sim |
10 |
Largura de banda total de download do bucket. Unidade: Gbit/s. Nós pai: QoSConfiguration |
|
IntranetDownloadBandwidth |
Integer |
Sim |
-1 |
Largura de banda de download pela rede interna do bucket. Redes internas incluem a rede clássica e VPC. Unidade: Gbit/s. Nós pai: QoSConfiguration |
|
ExtranetDownloadBandwidth |
Integer |
Sim |
-1 |
Largura de banda de download pela rede pública do bucket. Redes públicas incluem a Internet e endpoints de aceleração. Unidade: Gbit/s. Nós pai: QoSConfiguration |
Cabeçalhos da resposta
Esta operação retorna apenas cabeçalhos de resposta comuns. Para mais informações, consulte Cabeçalhos de resposta comuns.
Exemplos
-
Exemplos de requisições
PUT /?qosInfo HTTP/1.1 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> -
Exemplos de respostas de sucesso
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
Os seguintes SDKs do OSS suportam PutBucketQoSInfo:
ossutil
Para o comando do ossutil correspondente a esta operação, consulte put-bucket-qos-info.