全部产品
Search
文档中心

实时数仓Hologres:ListLeaderInstances - 获取主实例列表

更新时间:May 21, 2026

获取可能的主实例Id列表。

接口说明

请求说明

  • 该 API 用于获取特定 Holo 实例上已部署的模型服务信息,包括但不限于 CPU、GPU、内存等资源占用情况。

  • instanceId参数为可选项,若不提供,则默认返回所有相关实例的信息。

  • 此接口适用于 Hologres AI 节点,对于非 AI 节点的部分参数可能无效或不适用。

  • 请确保在使用该接口前,已充分了解阿里云 Hologram 产品的收费方式和价格

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求语法

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

路径参数

名称

类型

必填

描述

示例值

instanceId

string

实例 id。

hgprecn-cn-zxu3001jn00d

请求参数

名称

类型

必填

描述

示例值

RegionId

string

地域 id。

cn-hangzhou

返回参数

名称

类型

描述

示例值

object

RequestId

string

Id of the request

5600196E-78E2-50F2-B2A1-C44D3B665438

InstanceList

array<object>

实例列表。

array<object>

角色列表。

ChargeType

string

付费类型。

枚举值:

  • PostPaid :

    包年包月

  • PrePaid :

    按量付费

PostPaid

CommodityCode

string

商品 Code

hologram_combo_public_cn

CreationTime

string

创建时间。

2022-07-25T02:15:35Z

ExpirationTime

string

到期时间(按量付费类型没有到期时间)。

2022-07-25T02:15:35Z

InstanceId

string

实例 ID。

hgpostcn-cn-tl32vsdir00h

InstanceName

string

实例名称。

user_defined_name

InstanceStatus

string

实例状态。

枚举值:

  • Creating :

    正在创建

  • Running :

    正常运行

  • Suspended :

    停机

  • Allocating :

    正在处理,一些接口可能不允许操作

Running

InstanceType

string

实例类型。

枚举值:

  • Follower :

    只读从实例

  • Standard :

    普通型

Standard

Tags

array<object>

标签列表。

object

标签列表。

Key

string

标签键。

tagKey

Value

string

标签值。

value

BindingCode

string

主实例和从实例的匹配程度。0 表示完美匹配,其他表示不匹配。

0

Success

string

请求结果,表示此次请求是否发生异常,与业务无关。

枚举值:

  • true :

    成功

  • false :

    失败

true

ErrorCode

string

错误码。

404

ErrorMessage

string

错误信息。

Internal server error.

HttpStatusCode

string

http 状态码。

200

示例

正常返回示例

JSON格式

{
  "RequestId": "5600196E-78E2-50F2-B2A1-C44D3B665438",
  "InstanceList": [
    {
      "ChargeType": "PostPaid",
      "CommodityCode": "hologram_combo_public_cn",
      "CreationTime": "2022-07-25T02:15:35Z",
      "ExpirationTime": "2022-07-25T02:15:35Z",
      "InstanceId": "hgpostcn-cn-tl32vsdir00h",
      "InstanceName": "user_defined_name",
      "InstanceStatus": "Running",
      "InstanceType": "Standard",
      "Tags": [
        {
          "Key": "tagKey",
          "Value": "value"
        }
      ],
      "BindingCode": "0"
    }
  ],
  "Success": "true",
  "ErrorCode": "404",
  "ErrorMessage": "Internal server error.",
  "HttpStatusCode": "200"
}

错误码

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

变更历史

更多信息,参考变更详情