Todos os produtos
Search

Este produto

    Hologres:GetInstanceModel

    Central de documentação

    Hologres:GetInstanceModel

    Última atualização: Sep 17, 2026

    Consulta a lista de serviços de grandes modelos vinculados a uma instância 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:GetInstanceModel

    get

    *Todos os recursos.

    *

    		 Nenhuma Nenhuma

    Sintaxe da solicitação

    GET /api/v1/instances/{instanceId}/getInstanceModel HTTP/1.1

    Parâmetros de caminho

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    instanceId

    string

    Não

    O ID da instância.

    hgpostcn-cn-7mz2vmuxxxx

    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.

    819A7F0F-2951-540F-BD94-6A41ECF0281F
    cpu

    integer

    A CPU total do nó. Este parâmetro se aplica apenas aos nós de IA do Hologres.

    32
    gpu

    integer

    A GPU total do nó. Este parâmetro se aplica apenas aos nós de IA do Hologres.

    4
    memory

    integer

    A memória total do nó. Este parâmetro se aplica apenas aos nós de IA do Hologres.

    128
    gpuMemory

    integer

    A memória total da GPU do nó. Este parâmetro se aplica apenas aos nós de IA do Hologres.

    128
    modelServiceList

    array<object>

    A lista de serviços de modelo.

    object

    gpuMemory

    integer

    A memória da GPU consumida por este serviço de modelo. Este parâmetro se aplica apenas aos nós de IA do Hologres.

    32
    memory

    integer

    A memória consumida por este serviço de modelo. Este parâmetro se aplica apenas aos nós de IA do Hologres.

    32
    cpu

    integer

    A CPU consumida por este serviço de modelo. Este parâmetro se aplica apenas aos nós de IA do Hologres.

    32
    modelType

    string

    O nome do modelo.

    qwen3.5-plus
    gpu

    integer

    A GPU consumida por este serviço de modelo. Este parâmetro se aplica apenas aos nós de IA do Hologres.

    2
    status

    string

    O status.

    Running
    modelName

    string

    O nome personalizado do serviço de modelo.

    my_model
    serviceCount

    integer

    O número de réplicas do serviço. Este parâmetro se aplica apenas aos nós de IA do Hologres.

    2
    version

    string

    A versão.

    v1.1
    message

    string

    A mensagem de erro.

    Failed
    taskType

    string

    A finalidade do modelo.

    embedding
    modelParams

    string

    Os parâmetros do modelo. Este parâmetro se aplica apenas aos modelos Bailian.

    {"timeout":600,"max_retries":10,"max_retry_delay":8,"initial_retry_delay":0.5}
    apiKey

    string

    A chave de API do Bailian (apenas para exibição e não pode ser usada diretamente).

    sk-42f6c8xxxxxb
    provider

    string

    O provedor do modelo subjacente.

    bailian
    instanceRegion

    string

    A região onde o nó de IA está implantado.

    cn-beijing
    serviceDeployRegion

    string

    A região de implantação.

    cn-beijing
    supportApiKeyAccess

    boolean

    Indica se há suporte para acesso ao serviço de modelo por meio de uma chave de API.

    true
    cpuUsed

    integer

    A CPU total usada pelo nó. Este parâmetro se aplica apenas aos nós de IA do Hologres.

    32
    memoryUsed

    integer

    A memória total usada pelo nó. Este parâmetro se aplica apenas aos nós de IA do Hologres.

    64
    gpuUsed

    integer

    A GPU total usada pelo nó. Este parâmetro se aplica apenas aos nós de IA do Hologres.

    2
    aiInstanceId

    string

    O ID da instância do nó de IA.

    hologram_aicombo_public_cn-77xxx
    gpuMemoryUsed

    integer

    A memória total da GPU usada pelo nó. Este parâmetro se aplica apenas aos nós de IA do Hologres.

    64
    regionId

    string

    O ID da região.

    cn-shanghai
    resourceType

    string

    O tipo de recurso.

    Valores válidos:

    • small :

      Pequeno.

    • middle :

      Médio.

    • large :

      Grande.

    middle
    nodeCount

    integer

    O número de nós.

    2
    commodityCode

    string

    O código da commodity.

    hologram_aipostpay_public_cn
    chargeType

    string

    O método de cobrança. Valores válidos:\n- PrePaid: assinatura.\n- PostPaid: pós-pago.

    PrePaid
    status

    string

    O status do nó.

    Valores válidos:

    • ResourceReady :

      Em execução normal.

    • InstanceWaiting :

      Sendo criado.

    ResourceReady
    expirationTime

    string

    O horário de expiração (UTC).

    2026-01-28T07:44:27.535Z
    autoRenewal

    boolean

    Indica se a renovação automática está ativada para o recurso.\n\n- true: A renovação automática está ativada. O recurso é renovado automaticamente após a expiração.\n- false: A renovação automática não está ativada. O recurso deixa de ficar disponível após a expiração.

    true

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "requestId": "819A7F0F-2951-540F-BD94-6A41ECF0281F.",
  "cpu": 32,
  "gpu": 4,
  "memory": 128,
  "gpuMemory": 128,
  "modelServiceList": [
    {
      "gpuMemory": 32,
      "memory": 32,
      "cpu": 32,
      "modelType": "qwen3.5-plus.",
      "gpu": 2,
      "status": "Running.",
      "modelName": "my_model.",
      "serviceCount": 2,
      "version": "v1.1",
      "message": "Failed.",
      "taskType": "embedding.",
      "modelParams": "{\"timeout\":600,\"max_retries\":10,\"max_retry_delay\":8,\"initial_retry_delay\":0.5}",
      "apiKey": "sk-42f6c8xxxxxb.",
      "provider": "bailian.",
      "instanceRegion": "cn-beijing.",
      "serviceDeployRegion": "cn-beijing.",
      "supportApiKeyAccess": true
    }
  ],
  "cpuUsed": 32,
  "memoryUsed": 64,
  "gpuUsed": 2,
  "aiInstanceId": "hologram_aicombo_public_cn-77xxx.",
  "gpuMemoryUsed": 64,
  "regionId": "cn-shanghai.",
  "resourceType": "middle.",
  "nodeCount": 2,
  "commodityCode": "hologram_aipostpay_public_cn.",
  "chargeType": "PrePaid.",
  "status": "ResourceReady.",
  "expirationTime": "2026-01-28T07:44:27.535Z",
  "autoRenewal": true
}

    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.