Todos os produtos
Search
Central de documentação

Object Storage Service:GetResourcePoolInfo

Última atualização: Jul 09, 2026

Consulta informações sobre um pool de recursos especificado.

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 tem permissão para consultar as configurações de limitação de um pool de recursos. Para consultar informações do pool de recursos com um usuário do Resource Access Management (RAM) ou do Security Token Service (STS), você precisa da permissão oss:GetResourcePoolInfo. Para mais informações, consulte Anexar uma política personalizada a um usuário RAM.

Sintaxe da solicitação

GET /?resourcePoolInfo&resourcePool=ResourcePoolName
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Cabeçalhos da solicitação

O GetResourcePoolInfo utiliza apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Cabeçalhos de solicitação comuns.

Elementos da solicitação

Elemento

Tipo

Obrigatório

Exemplo

Descrição

resourcePool

String

Sim

resource-pool-for-ai

Nome do pool de recursos.

Cabeçalhos da resposta

O GetResourcePoolInfo retorna apenas cabeçalhos de resposta comuns. Para mais informações, consulte Cabeçalhos de resposta comuns.

Elementos da resposta

Elemento

Tipo

Exemplo

Descrição

GetResourcePoolInfoResponse

Contêiner

N/A

Contêiner do resultado da solicitação.

Nós pai: nenhum.

Region

String

oss-cn-hangzhou

Região do pool de recursos.

Nós pai: GetResourcePoolInfoResponse.

Name

String

resource-pool-for-ai

Nome do pool de recursos.

Nós pai: GetResourcePoolInfoResponse.

Owner

String

103xxxx

UID da conta proprietária do pool de recursos.

Nós pai: GetResourcePoolInfoResponse.

CreateTime

String

2024-11-29T08:42:32.000Z

Horário de criação do pool de recursos, no formato ISO 8601.

Nós pai: GetResourcePoolInfoResponse.

QoSConfiguration

Contêiner

N/A

Contêiner das configurações de limitação do pool de recursos.

Nós pai: GetResourcePoolInfoResponse.

TotalUploadBandwidth

Integer

10

Largura de banda total de upload do pool de recursos. Unidade: Gbit/s.

Nós pai: QoSConfiguration.

IntranetUploadBandwidth

Integer

-1

Largura de banda de upload do pool de recursos em redes internas, que incluem a rede clássica e Virtual Private Clouds (VPCs). Unidade: Gbit/s.

O valor -1 indica que não há limite para a largura de banda de upload em redes internas.

Nós pai: QoSConfiguration.

ExtranetUploadBandwidth

Integer

-1

Largura de banda de upload do pool de recursos em redes públicas, que 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 pool de recursos. Unidade: Gbit/s.

Nós pai: QoSConfiguration.

IntranetDownloadBandwidth

Integer

-1

Largura de banda de download do pool de recursos em redes internas, que incluem a rede clássica e VPCs. Unidade: Gbit/s.

O valor -1 indica que não há limite para a largura de banda de download em redes internas.

Nós pai: QoSConfiguration.

ExtranetDownloadBandwidth

Integer

-1

Largura de banda de download do pool de recursos em redes públicas, que incluem a Internet e endpoints de aceleração. Unidade: Gbit/s.

Nós pai: QoSConfiguration.

Exemplos

  • Exemplos de solicitações

    GET /?resourcePoolInfo&resourcePool=resource-pool-for-ai
    Host: 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
  • Exemplos de respostas de sucesso

    HTTP/1.1 200 OK
    Date: Fri, 27 Dec 2024 03:21:12 GMT
    Content-Length: 624
    Content-Type: application/xml
    
    <?xml version="1.0" encoding="UTF-8"?>
    <GetResourcePoolInfoResponse>
      <Region>oss-cn-hangzhou</Region>
      <Name>resource-pool-for-ai</Name>
      <Owner>103xxxx</Owner>
      <CreateTime>2024-11-29T08:42:32.000Z</CreateTime>
      <QoSConfiguration>
        <TotalUploadBandwidth>10</TotalUploadBandwidth>
        <IntranetUploadBandwidth>-1</IntranetUploadBandwidth>
        <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth>
        <TotalDownloadBandwidth>10</TotalDownloadBandwidth>
        <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth>
        <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth>
      </QoSConfiguration>
    </GetResourcePoolInfoResponse>

SDKs do OSS

Chame o GetResourcePoolInfo usando os SDKs do OSS nas seguintes linguagens de programação:

ossutil

Para o comando do ossutil correspondente ao GetResourcePoolInfo, consulte get-resource-pool-info.