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.