ListInstanceModel

更新時間:
Copy as MD

AI 節點資源列表。

介面說明

請求說明

  • 該 API 用於取得特定 Holo 執行個體上已部署的模型服務資訊,包括但不限於 CPU、GPU、記憶體等資源佔用情況。

  • instanceId參數為可選項,若不提供,則預設返回所有相關執行個體的資訊。

  • 此介面適用於 Hologres AI 節點,對於非 AI 節點的部分參數可能無效或不適用。

  • 請確保在使用該介面前,已充分了解阿里雲 Hologram 產品的收費方式和價格

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

hologram:ListInstanceModel

none

*All Resource

*

請求文法

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

請求參數

名稱

類型

必填

描述

樣本值

當前API無需請求參數

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

requestId

string

Id of the request

2C2ECDC1-FBAD-14A5-AA4A-96BC787FBDBC

instanceModelList

array<object>

AI 資源列表。

object

cpu

integer

CPU 規格,此參數僅適用於 Hologres AI 節點。

7

gpu

integer

GPU 卡數,此參數僅適用於 Hologres AI 節點。

1

memory

integer

記憶體,單位 GiB,此參數僅適用於 Hologres AI 節點。

16

gpuMemory

integer

顯存大小,單位 GB,此參數僅適用於 Hologres AI 節點。

32

cpuUsed

integer

已使用的節點總 CPU,此參數僅適用於 Hologres AI 節點。

7

memoryUsed

integer

已使用的節點總記憶體,此參數僅適用於 Hologres AI 節點。

32

gpuUsed

integer

已使用的節點總 GPU,此參數僅適用於 Hologres AI 節點。

32

aiInstanceId

string

AI 節點執行個體 ID。

hologram_aicombo_public_cn-77xxx

gpuMemoryUsed

integer

已使用的節點總顯存,此參數僅適用於 Hologres AI 節點。

32

regionId

string

無。

cn-hangzhou

resourceType

string

無。

small

nodeCount

integer

節點數量。

2

commodityCode

string

無。

hologram_aipostpay_public_cn

chargeType

string

無。

PostPaid

status

string

狀態

ResourceReady

expirationTime

string

過期時間(UTC)。

2026-01-28T07:44:27.535Z

autoRenewal

boolean

是否自動續費

holoInstanceId

string

Holo 執行個體 ID

hgpostcn-cn-yi34hlzdx003

holoInstanceName

string

Holo 執行個體名稱

myInstance

aiSpec

string

AI 規格

small-8core-30G-24G

樣本

正常返回樣本

JSON格式

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情