文档首页/ 智果（AgentArts）智能体平台/ API参考/ API/ 智能体运行时/ 运行时管理/ 查询当前可用的运行时规格 - ListCoreRuntimeSpecs
更新时间：2026-09-14 GMT+08:00
查看PDF
分享

查询当前可用的运行时规格 - ListCoreRuntimeSpecs

功能介绍

该接口用于查询当前租户可用的智能体运行时CPU和内存规格组合列表。租户默认只能配置2U8G规格，如果需要配置其他规格，请提交工单申请。

适用场景：

创建或更新运行时前，查询可用的资源规格组合。

接口约束：

默认只返回2U8G规格，其他规格需要通过工单申请加入白名单后才会返回。

调用方法

请参见如何调用API。

授权信息

当前API调用无需身份策略权限。

URI

GET /v1/core/runtime-specs

表1 Query参数

参数

是否必选

参数类型

描述

offset

否

Integer

参数解释：

分页查询起始位置，从1开始。

约束限制:

不涉及。

取值范围：

1 - 1000

默认取值:

1

limit

否

Integer

参数解释：

分页查询时每页返回的记录数量。

约束限制:

不涉及。

取值范围：

1 - 100

默认取值:

10

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

specs

Array of CoreRuntimeSpecsResp objects

参数解释:

运行时规格组合列表。

数组类型，元素个数限制1 - 100。

total

Integer

参数解释:

总记录数。

取值范围:

不涉及。
表3 CoreRuntimeSpecsResp

参数

参数类型

描述

cpu_milli_cores

Integer

参数解释:

CPU规格（单位：毫核 millicores，1 核 = 1000 毫核）。

取值范围:

1000 - 64000。

memory_size

Integer

参数解释:

内存规格（单位：MiB，1 GB = 1024 MiB）。

取值范围:

1024 - 524288。

状态码：400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000400表示客户端请求参数错误。

取值范围：

固定值：AgentArts.03000400。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为1-512个字符。

状态码：401

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。枚举值说明：AgentArts.03000401表示未授权（认证令牌缺失、无效或已过期）。

取值范围:

不涉及。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为 1 - 512 个字符。

状态码：403

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000403表示禁止访问（认证后权限不足）。

取值范围：

固定值：AgentArts.03000403。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为 1 - 512 个字符。

coded_authorization_message

String

参数解释：

IAM5 当OpenAPI无权限时报错信息。

取值范围：

长度为 1 - 1024 个字符。

details

Array of CoreRunErrorDetail objects

参数解释：

依赖的下游服务错误信息列表。

取值范围：

最小数量 0，最大数量 10。
表7 CoreRunErrorDetail

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

长度为 18 个字符。

error_msg

String

参数解释：

错误信息。

取值范围：

长度为 1 - 1024 个字符。

状态码：429

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000429表示请求过于频繁（触发限流）。

取值范围：

固定值：AgentArts.03000429。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为 1 - 512 个字符。

状态码：500

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000500表示服务器内部错误。

取值范围：

固定值：AgentArts.03000500。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为 1 - 512 个字符。

请求示例

查询可用运行时规格组合

GET https://{Endpoint}/v1/core/runtime-specs

响应示例

状态码：200

  • {
  "specs" : [ {
    "cpu_milli_cores" : 2000,
    "memory_size" : 8192
  }, {
    "cpu_milli_cores" : 4000,
    "memory_size" : 16384
  }, {
    "cpu_milli_cores" : 8000,
    "memory_size" : 32768
  } ]
}
  • {
  "specs" : [ {
    "cpu_milli_cores" : 2000,
    "memory_size" : 8192
  } ]
}

状态码

状态码

描述

200

查询成功，返回可用的运行时规格组合列表。

400

请求参数错误。

401

未授权（认证令牌缺失、无效或已过期）。

403

禁止访问（认证后权限不足）。

429

请求过于频繁（触发限流）。

500

服务器内部错误。

错误码

请参见错误码。

父主题： 运行时管理

相关文档