GetInstanceModel - 实例部署模型详情

更新时间:
复制 MD 格式

Holo实例已经绑定的大模型服务列表

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

hologram:GetInstanceModel

get

*全部资源

*

请求语法

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

路径参数

名称

类型

必填

描述

示例值

instanceId

string

实例 id。

hgpostcn-cn-7mz2vmuxxxx

请求参数

名称

类型

必填

描述

示例值

当前API无需请求参数

返回参数

名称

类型

描述

示例值

object

Schema of Response

requestId

string

Id of the request

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

cpu

integer

节点总 CPU,此参数仅适用于 Hologres AI 节点

32

gpu

integer

节点总 GPU,此参数仅适用于 Hologres AI 节点

4

memory

integer

节点总内存,此参数仅适用于 Hologres AI 节点

128

gpuMemory

integer

节点总显存,此参数仅适用于 Hologres AI 节点

128

modelServiceList

array<object>

模型服务列表

object

gpuMemory

integer

此模型服务占用的显存,此参数仅适用于 Hologres AI 节点

32

memory

integer

此模型服务占用的内存,此参数仅适用于 Hologres AI 节点

32

cpu

integer

此模型服务占用的 CPU, 此参数仅适用于 Hologres AI 节点

32

modelType

string

模型名称

qwen3.5-plus

gpu

integer

此模型服务占用的 GPU,此参数仅适用于 Hologres AI 节点

2

status

string

状态

Running

modelName

string

模型服务自定义名称

my_model

serviceCount

integer

服务副本数,此参数仅适用于 Hologres AI 节点

2

version

string

版本。

v1.1

message

string

错误信息

Failed

taskType

string

模型用途

embedding

modelParams

string

模型参数,此参数仅适用于百炼模型

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

apiKey

string

百炼 API Key(仅展示,无法直接使用)

sk-42f6c8xxxxxb

provider

string

底层模型提供方。

bailian

instanceRegion

string

AI 节点部署地域

cn-beijing

serviceDeployRegion

string

部署地域

cn-beijing

supportApiKeyAccess

boolean

cpuUsed

integer

已使用的节点总 CPU,此参数仅适用于 Hologres AI 节点

32

memoryUsed

integer

已使用的节点总内存,此参数仅适用于 Hologres AI 节点

64

gpuUsed

integer

已使用的节点总 GPU,此参数仅适用于 Hologres AI 节点

2

aiInstanceId

string

AI 节点实例 id

hologram_aicombo_public_cn-77xxx

gpuMemoryUsed

integer

已使用的节点总显存,此参数仅适用于 Hologres AI 节点

64

regionId

string

地域 ID。

cn-shanghai

resourceType

string

资源类型。

枚举值:

  • small :

    small

  • middle :

    middle

  • large :

    large

middle

nodeCount

integer

节点数量

2

commodityCode

string

商品 code

hologram_aipostpay_public_cn

chargeType

string

付费类型。取值:

  • PrePaid:包年包月。

  • PostPaid: 按量付费。

PrePaid

status

string

节点状态

枚举值:

  • ResourceReady :

    运行正常

  • InstanceWaiting :

    创建中

ResourceReady

expirationTime

string

过期时间(UTC)

2026-01-28T07:44:27.535Z

autoRenewal

boolean

资源是否开启了自动续费功能。

  • true:开启自动续费,资源到期后会自动续订。

  • false:未开启自动续费,资源到期后将停止使用。

true

示例

正常返回示例

JSON格式

{
  "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
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情