PutResourcePoolBucketGroupQoSInfo - Object Storage Service: Central de Documentação do Alibaba Cloud

Precauções

A QoS de resource pool está em preview por convite. Se o throughput dos seus buckets do OSS em uma região atingir ou ultrapassar 500 Gbit/s, entre em contato com o suporte técnico para solicitar acesso a 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 do RAM, o proprietário da conta ou um administrador deverá conceder a permissão oss:PutResourcePoolBucketGroupQoSInfo por meio de uma política do RAM ou de 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 length

Cabeç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

Nota

Nos itens de configuração de largura de banda, o valor -1 é o padrão e indica ausência de limite. O valor 0 desativa o tipo de largura de banda correspondente. Por exemplo, se você defina ExtranetUploadBandwidth como 0, não será possível fazer upload de dados para o bucket pela rede pública.
A largura de banda total do grupo de buckets não pode exceder a largura de banda total do resource pool. Além disso, o valor de um tipo específico de largura de banda não pode superar o valor total desse mesmo tipo. Por exemplo, se TotalDownloadBandwidth estiver definido como 10 Gbps, ExtranetDownloadBandwidth não poderá ser maior que 10 Gbps.
Se você defina um limite específico de largura de banda, o valor deverá ser igual ou superior a 5 Gbps.

Nome	Tipo	Obrigatório	Exemplo	Descrição
resourcePool	string	Sim	resource-pool-for-ai	Nome do resource pool.
resourcePoolBucketGroup	string	Sim	test-group	Nome do BucketGroup.
QoSConfiguration	container	Sim	Não aplicável	Container da configuração de limitação de taxa. Nó pai: Nenhum
TotalUploadBandwidth	Integer	Sim	10	Largura de banda total de upload do BucketGroup. Unidade: Gbps. Nó pai: QoSConfiguration
IntranetUploadBandwidth	Integer	Sim	-1	Largura de banda de upload da rede interna do BucketGroup. Inclui redes clássicas e VPCs. Unidade: Gbps. Nó pai: QoSConfiguration
ExtranetUploadBandwidth	Integer	Sim	-1	Largura de banda de upload da rede pública do BucketGroup. Inclui internet e endpoints de aceleração. Unidade: Gbps. Nó pai: QoSConfiguration
TotalDownloadBandwidth	Integer	Sim	10	Largura de banda total de download do BucketGroup. Unidade: Gbps. Nó pai: QoSConfiguration
IntranetDownloadBandwidth	Integer	Sim	-1	Largura de banda de download da rede interna do BucketGroup. Inclui redes clássicas e VPCs. Unidade: Gbps. Nó pai: QoSConfiguration
ExtranetDownloadBandwidth	Integer	Sim	-1	Largura de banda de download da rede pública do BucketGroup. Inclui internet e endpoints de aceleração. Unidade: Gbps. 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>
</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 oferecem suporte a esta operação: