Configura ou modifica a Qualidade de Serviço (QoS) para um grupo de buckets em um pool de recursos.
Precauções
A QoS do pool de recursos está em pré-visualização por convite. Se a taxa de transferência dos seus buckets do OSS em uma região atingiu ou excedeu 500 Gbit/s, você pode entrar em contato com o suporte técnico para solicitar esse recurso.
Por padrão, uma conta Alibaba Cloud tem todas as permissões. Se você usar um usuário do Resource Access Management (RAM) ou uma função RAM, o proprietário da conta ou um administrador deve conceder a permissão oss:PutResourcePoolBucketGroupQoSInfo usando uma política do RAM ou uma política de bucket.
Sintaxe da solicitação
PUT /?resourcePoolBucketGroupQosInfo&resourcePool=<ResourcePoolName>&resourcePoolBucketGroup=<ResourcePoolBucketGroupName>
Host: oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Content-Type: application/xml
Content-Length: content lengthCabeçalhos da solicitação
Esta operação usa apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Cabeçalhos de solicitação comuns.
Elementos da solicitação
Para os itens de configuração de largura de banda, um valor de -1 é o padrão e indica que não há limite. Um valor de 0 desativa o tipo de largura de banda correspondente. Por exemplo, se você definir ExtranetUploadBandwidth como 0, não poderá fazer upload de dados para o bucket a partir da rede pública.
A largura de banda total do grupo de buckets não pode exceder a largura de banda total do pool de recursos. O valor para um tipo específico de largura de banda não pode exceder o valor total para esse tipo de largura de banda. Por exemplo, se
TotalDownloadBandwidthestiver definido como 10 Gbps,ExtranetDownloadBandwidthnão poderá ser maior que 10 Gbps.Se você definir um limite específico de largura de banda, o valor deverá ser de 5 Gbps ou superior.
|
Nome |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
resourcePool |
string |
Sim |
resource-pool-for-ai |
O nome do pool de recursos. |
|
resourcePoolBucketGroup |
string |
Sim |
test-group |
O nome do BucketGroup. |
|
QoSConfiguration |
container |
Sim |
Não aplicável |
O contêiner para a configuração de limitação. Nó pai: Nenhum |
|
TotalUploadBandwidth |
Integer |
Sim |
10 |
A largura de banda total de upload para o BucketGroup. Unidade: Gbps. Nó pai: QoSConfiguration |
|
IntranetUploadBandwidth |
Integer |
Sim |
-1 |
A largura de banda de upload da rede interna para o BucketGroup. Isso inclui a largura de banda de upload para redes clássicas e VPCs. Unidade: Gbps. Nó pai: QoSConfiguration |
|
ExtranetUploadBandwidth |
Integer |
Sim |
-1 |
A largura de banda de upload da rede pública para o BucketGroup. Isso inclui a largura de banda de upload para a Internet e endpoints de aceleração. Unidade: Gbps. Nó pai: QoSConfiguration |
|
TotalDownloadBandwidth |
Integer |
Sim |
10 |
A largura de banda total de download para o BucketGroup. Unidade: Gbps. Nó pai: QoSConfiguration |
|
IntranetDownloadBandwidth |
Integer |
Sim |
-1 |
A largura de banda de download da rede interna para o BucketGroup. Isso inclui a largura de banda de download para redes clássicas e VPCs. Unidade: Gbps. Nó pai: QoSConfiguration |
|
ExtranetDownloadBandwidth |
Integer |
Sim |
-1 |
A largura de banda de download da rede pública para o BucketGroup. Isso inclui a largura de banda de download para a Internet e endpoints de aceleração. Unidade: Gbps. Nó pai: QoSConfiguration |
|
TotalQps |
Integer |
Não |
10000 |
A configuração total de QPS. Nó pai: QoSConfiguration |
|
IntranetQps |
Integer |
Não |
-1 |
A 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 |
A configuração de QPS para solicitações de redes externas, incluindo a Internet e CDNs. Nó pai: QoSConfiguration |
Cabeçalhos da resposta
Esta operação usa apenas cabeçalhos de resposta comuns. Para mais informações, consulte Cabeçalhos de resposta comuns.
Exemplos
-
Exemplo de solicitação
PUT /?resourcePoolBucketGroupQosInfo&resourcePool=resource-pool-for-ai&resourcePoolBucketGroup=test-group Host: oss-cn-shanghai.aliyuncs.com Date: Sun, 11 Aug 2024 17:45:00 GMT Content-Type: application/xml Content-Length: content length 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 Date: Sun, 11 Aug 2024 17:45:00 GMT Content-Length: 0
SDK
Os seguintes SDKs suportam esta operação: