ListInstanceModel - Hologres: Central de Documentação do Alibaba Cloud

Consulta a lista de recursos de nós de IA.

Descrição da operação

Descrição da operação\n- Esta operação de API obtém informações sobre serviços de modelo implantados em uma instância específica do Hologres, incluindo, entre outros, o uso de recursos de CPU, GPU e memória.\n- O parâmetro `instanceId` é opcional. Se você não especificar este parâmetro, as informações sobre todas as instâncias relacionadas serão retornadas por padrão.\n- Esta operação se aplica a nós de IA do Hologres. Alguns parâmetros podem ser inválidos ou inaplicáveis a nós que não sejam de IA.\n- Antes de chamar esta operação, certifique-se de entender os métodos de cobrança e preços do Alibaba Cloud Hologres.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

hologram:ListInstanceModel

none

*Todos os recursos.

*

Nenhuma

Sintaxe da solicitação

GET /api/v1/instances/rpc/listInstanceModel HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

Nenhum parâmetro necessário.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
requestId	string	O ID da solicitação.	2C2ECDC1-FBAD-14A5-AA4A-96BC787FBDBC
instanceModelList	array<object>	A lista de recursos de IA.
	object
cpu	integer	As especificações de CPU. Este parâmetro se aplica apenas a nós de IA do Hologres.	7
gpu	integer	O número de placas de GPU. Este parâmetro se aplica apenas a nós de IA do Hologres.	1
memory	integer	O tamanho da memória. Unidade: GiB. Este parâmetro se aplica apenas a nós de IA do Hologres.	16
gpuMemory	integer	O tamanho da memória da GPU. Unidade: GB. Este parâmetro se aplica apenas a nós de IA do Hologres.	32
cpuUsed	integer	O total de CPU usada pelo nó. Este parâmetro se aplica apenas a nós de IA do Hologres.	7
memoryUsed	integer	O total de memória usada pelo nó. Este parâmetro se aplica apenas a nós de IA do Hologres.	32
gpuUsed	integer	O total de GPU usada pelo nó. Este parâmetro se aplica apenas a nós de IA do Hologres.	32
aiInstanceId	string	O ID da instância do nó de IA.	hologram_aicombo_public_cn-77xxx
gpuMemoryUsed	integer	O total de memória da GPU usada pelo nó. Este parâmetro se aplica apenas a nós de IA do Hologres.	32
regionId	string	O ID da região.	cn-hangzhou
resourceType	string	O tipo de recurso.	small
nodeCount	integer	O número de nós.	2
commodityCode	string	O código da commodity.	hologram_aipostpay_public_cn
chargeType	string	O tipo de cobrança. Valores válidos:\n- PrePaid: assinatura.\n- PostPaid: pós-pago.	PostPaid
status	string	O status.	ResourceReady
expirationTime	string	O horário de expiração em UTC.	2026-01-28T07:44:27.535Z
autoRenewal	boolean	Indica se a renovação automática está ativada.
holoInstanceId	string	O ID da instância do Hologres.	hgpostcn-cn-yi34hlzdx003
holoInstanceName	string	O nome da instância do Hologres.	myInstance
aiSpec	string	As especificações de IA.	small-8core-30G-24G

Exemplos

Resposta de sucesso

JSON formato

{
  "requestId": "2C2ECDC1-FBAD-14A5-AA4A-96BC787FBDBC",
  "instanceModelList": [
    {
      "cpu": 7,
      "gpu": 1,
      "memory": 16,
      "gpuMemory": 32,
      "cpuUsed": 7,
      "memoryUsed": 32,
      "gpuUsed": 32,
      "aiInstanceId": "hologram_aicombo_public_cn-77xxx",
      "gpuMemoryUsed": 32,
      "regionId": "cn-hangzhou",
      "resourceType": "small",
      "nodeCount": 2,
      "commodityCode": "hologram_aipostpay_public_cn",
      "chargeType": "PostPaid",
      "status": "ResourceReady",
      "expirationTime": "2026-01-28T07:44:27.535Z",
      "autoRenewal": false,
      "holoInstanceId": "hgpostcn-cn-yi34hlzdx003",
      "holoInstanceName": "myInstance",
      "aiSpec": "small-8core-30G-24G"
    }
  ]
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.