Consulta as configurações de limitação de taxa de um bucket.
Observações
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 400 Gbit/s, você pode entrar em contato com technical support para solicitar esse recurso.
Por padrão, uma conta Alibaba Cloud pode consultar as configurações de limitação de taxa de um bucket específico em um pool de recursos. Para fazer solicitações de consulta como um usuário RAM ou usando o Security Token Service (STS), você deve ter a permissão
oss:GetBucketQoSInfo. Para mais informações, consulte RAM policy common examples.
Sintaxe
GET /?qosInfo HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueCabeçalhos da requisição
Uma requisição GetBucketQoSInfo usa apenas cabeçalhos de requisição comuns. Para mais informações, consulte Common HTTP headers.
Cabeçalhos da resposta
A resposta a uma requisição GetBucketQoSInfo usa apenas cabeçalhos de resposta comuns. Para mais informações, consulte Common response headers.
Elementos da resposta
|
Nome |
Tipo |
Exemplo |
Descrição |
|
QoSConfiguration |
Container |
N/A |
O contêiner para o resultado da consulta. Nós pai: nenhum |
|
TotalUploadBandwidth |
Integer |
10 |
Largura de banda total de upload do bucket. Unidade: Gbit/s. Nós pai: QoSConfiguration |
|
IntranetUploadBandwidth |
Integer |
-1 |
Largura de banda de upload pela rede interna do bucket. As redes internas incluem a rede clássica e a VPC. Unidade: Gbit/s. Nós pai: QoSConfiguration |
|
ExtranetUploadBandwidth |
Integer |
-1 |
Largura de banda de upload pela rede pública do bucket. As redes públicas incluem a Internet e endpoints de aceleração. Unidade: Gbit/s. Nós pai: QoSConfiguration |
|
TotalDownloadBandwidth |
Integer |
10 |
Largura de banda total de download do bucket. Unidade: Gbit/s. Nós pai: QoSConfiguration |
|
IntranetDownloadBandwidth |
Integer |
-1 |
Largura de banda de download pela rede interna do bucket. As redes internas incluem a rede clássica e a VPC. Unidade: Gbit/s. Nós pai: QoSConfiguration |
|
ExtranetDownloadBandwidth |
Integer |
-1 |
Largura de banda de download pela rede pública do bucket. As redes públicas incluem a Internet e endpoints de aceleração. Unidade: Gbit/s. Nós pai: QoSConfiguration |
|
TotalQps |
Integer |
10000 |
A configuração total de QPS. Nó pai: QoSConfiguration |
|
IntranetQps |
Integer |
-1 |
A configuração de QPS para requisições de redes internas, incluindo a rede clássica e VPCs. Nó pai: QoSConfiguration |
|
ExtranetQps |
Integer |
-1 |
A configuração de QPS para requisições de redes externas, incluindo a Internet e CDNs. Nó pai: QoSConfiguration |
Exemplos
-
Exemplo de requisição
Get /?qosInfo HTTP/1.1 Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Fri, 27 Dec 2024 03:21:12 GMT Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e -
Exemplo de resposta
HTTP/1.1 200 OK Date: Fri, 27 Dec 2024 03:21:12 GMT Content-Type: application/xml Content-Length: 556 Connection: keep-alive Server: AliyunOSS x-oss-request-id: 534**** <?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> <TotalQps>10000</TotalQps> <IntranetQps>-1</IntranetQps> <ExtranetQps>-1</ExtranetQps> </QoSConfiguration>
SDKs do OSS
Você pode chamar GetBucketQoSInfo usando os SDKs do OSS para as seguintes linguagens de programação:
ossutil
Para o comando ossutil que corresponde à operação GetBucketQoSInfo, consulte get-bucket-qos-info.