Todos os produtos
Search

Este produto

    Object Storage Service:GetResourcePoolInfo

    Central de documentação

    Object Storage Service:GetResourcePoolInfo

    Última atualização: Oct 13, 2026

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

    Observações de uso

    • O QoS do pool de recursos está em preview por convite. Se a taxa de transferência dos seus buckets 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 permissões para consultar as configurações de limitação de um pool de recursos. Para consultar informações do pool de recursos usando um usuário do Resource Access Management (RAM) ou do Security Token Service (STS), você deve ter a permissão oss:GetResourcePoolInfo. Para mais informações, consulte Anexar uma política personalizada a um usuário RAM.

    Sintaxe da requisição

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

    Cabeçalhos da requisição

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

    Elementos da requisição

    Elemento

    Tipo

    Obrigatório

    Exemplo

    Descrição

    resourcePool

    String

    Sim

    resource-pool-for-ai

    O nome do pool de recursos.

    Cabeçalhos da resposta

    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

    Container

    N/A

    O contêiner para o resultado da requisição.

    Nós pai: nenhum.

    Region

    String

    oss-cn-hangzhou

    A região do pool de recursos.

    Nós pai: GetResourcePoolInfoResponse.

    Name

    String

    resource-pool-for-ai

    O nome do pool de recursos.

    Nós pai: GetResourcePoolInfoResponse.

    Owner

    String

    103xxxx

    O UID da conta proprietária do pool de recursos.

    Nós pai: GetResourcePoolInfoResponse.

    CreateTime

    String

    2024-11-29T08:42:32.000Z

    O horário em que o pool de recursos foi criado, no formato ISO 8601.

    Nós pai: GetResourcePoolInfoResponse.

    QoSConfiguration

    Container

    N/A

    O contêiner para as configurações de limitação do pool de recursos.

    Nós pai: GetResourcePoolInfoResponse.

    TotalUploadBandwidth

    Integer

    10

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

    Nós pai: QoSConfiguration.

    IntranetUploadBandwidth

    Integer

    -1

    A largura de banda de upload do pool de recursos em redes internas. Redes internas incluem a rede clássica e nuvens privadas virtuais (VPCs). Unidade: Gbit/s.

    O valor -1 indica que a largura de banda de upload em redes internas não é limitada.

    Nós pai: QoSConfiguration.

    ExtranetUploadBandwidth

    Integer

    -1

    A largura de banda de upload do pool de recursos em redes públicas. Redes públicas incluem a Internet e endpoints de aceleração. Unidade: Gbit/s.

    Nós pai: QoSConfiguration.

    TotalDownloadBandwidth

    Integer

    10

    A largura de banda total de download do pool de recursos. Unidade: Gbit/s.

    Nós pai: QoSConfiguration.

    IntranetDownloadBandwidth

    Integer

    -1

    A largura de banda de download do pool de recursos em redes internas. Redes internas incluem a rede clássica e VPCs. Unidade: Gbit/s.

    O valor -1 indica que a largura de banda de download em redes internas não é limitada.

    Nós pai: QoSConfiguration.

    ExtranetDownloadBandwidth

    Integer

    -1

    A largura de banda de download do pool de recursos em redes públicas. 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

    • Exemplos de requisiçõ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>
    <TotalQps>10000</TotalQps>
    <IntranetQps>-1</IntranetQps>
    <ExtranetQps>-1</ExtranetQps>
  </QoSConfiguration>
</GetResourcePoolInfoResponse>

    SDKs do OSS

    Você pode chamar GetResourcePoolInfo usando os SDKs do OSS para as seguintes linguagens de programação:

    ossutil

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