查看规格列表¶

列出当前工作区可见的计算规格。

GET https://api.moi.matrixorigin.cn/v5/compute-resource-specs

调用前准备¶

准备有目标工作区访问权限的个人访问令牌和目标工作区 ID。

请求参数¶

请求示例

curl "https://api.moi.matrixorigin.cn/v5/compute-resource-specs" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

参数

此请求不包含路径参数、查询参数或请求体。

成功响应¶

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": [
    {
      "id": "task-standard-small",
      "kind": "task",
      "family": "standard",
      "cpu_milli": 2000,
      "memory_mib": 4096,
      "gpu_count": 0,
      "credit_per_hour": 1,
      "enabled": true
    }
  ]
}

字段说明

通用字段

字段	类型	说明
`code`	string	成功时为 `OK`。
`msg`	string	成功时为 `OK`。
`data`	array of object	计算规格列表。

计算规格

下面表格展开响应示例中 data 数组的每一项；每一行是该数组项的一个字段。

字段	类型	说明
`id`	string	规格 ID，用于创建计算实例。
`kind`	string	资源类型。
`family`	string	规格族标识。
`family_name`	string	规格族名称。
`family_name_en`	string	规格族英文名称。
`cpu_milli`	integer	CPU 容量，单位为毫核。
`memory_mib`	integer	内存容量，单位为 MiB。
`gpu_count`	integer	GPU 数量。
`gpu_memory_mib`	integer	GPU 显存，单位为 MiB。
`gpu_cores`	integer	GPU 核数。
`credit_per_hour`	number	每小时 Credit 用量。
`description`	string	规格说明。
`description_en`	string	英文规格说明。
`node_placement`	object	Kubernetes 节点调度对象；仅接受已定义的 Kubernetes 调度字段。

节点调度

下面表格展开响应示例中 data[].node_placement 对象；每一行是该对象的一个字段。

字段	类型	说明
`node_selector`	object	节点标签选择器；键和值均为 Kubernetes 合法标签。
`affinity`	object	Kubernetes Pod 亲和性与反亲和性规则。
`tolerations`	array of object	容忍节点污点的规则列表。
`topology_spread_constraints`	array of object	拓扑分布约束列表。
`priorityClassName`	string	Kubernetes PriorityClass 名称。
`runtimeClassName`	string	Kubernetes RuntimeClass 名称。
`schedulerName`	string	Kubernetes 调度器名称。

节点选择条件

下面表格展开响应示例中 data[].node_placement.node_selector 对象；每一行是该对象的一个字段。

字段	类型	说明
`<key>`	string	一个节点标签键对应的目标标签值。

亲和性规则

下面表格展开响应示例中 data[].node_placement.affinity 对象；每一行是该对象的一个字段。

字段	类型	说明
`nodeAffinity`	object	节点亲和性规则；有值时返回。
`podAffinity`	object	Pod 亲和性规则；有值时返回。
`podAntiAffinity`	object	Pod 反亲和性规则；有值时返回。

污点容忍规则

下面表格展开响应示例中 data[].node_placement.tolerations 数组的每一项；每一行是该数组项的一个字段。

字段	类型	说明
`key`	string	污点键；`operator` 为 `Exists` 时可省略。
`operator`	string	匹配方式：`Equal` 或 `Exists`；省略时按 `Equal` 处理。
`value`	string	污点值；`operator` 为 `Exists` 时必须为空。
`effect`	string	污点效果；有值时为 `NoSchedule`、`PreferNoSchedule` 或 `NoExecute`。
`tolerationSeconds`	integer	对 `NoExecute` 污点的容忍秒数；有值时返回。

拓扑分布规则

下面表格展开响应示例中 data[].node_placement.topology_spread_constraints 数组的每一项；每一行是该数组项的一个字段。

字段	类型	说明
`maxSkew`	integer	同一拓扑域间允许的最大偏差。
`topologyKey`	string	用于划分拓扑域的节点标签键。
`whenUnsatisfiable`	string	不满足约束时的处理方式：`DoNotSchedule` 或 `ScheduleAnyway`。
`labelSelector`	object	用于匹配 Pod 的标签选择器；有值时返回。
`matchLabelKeys`	array of string	参与匹配的 Pod 标签键；有值时返回。
`nodeAffinityPolicy`	string	节点亲和性策略；有值时返回。
`nodeTaintsPolicy`	string	节点污点策略；有值时返回。
`minDomains`	integer	最小可用拓扑域数量；有值时返回。

标签选择条件

下面表格展开响应示例中 data[].node_placement.topology_spread_constraints[].labelSelector 对象；每一行是该对象的一个字段。

字段	类型	说明
`matchLabels`	object	标签键值选择器；有值时返回。
`matchExpressions`	array of object	标签选择表达式列表；有值时返回。

标签键值

下面表格展开响应示例中 data[].node_placement.topology_spread_constraints[].labelSelector.matchLabels 对象；每一行是该对象的一个字段。

字段	类型	说明
`<key>`	string	一个标签键对应的目标标签值。

标签表达式

下面表格展开响应示例中 data[].node_placement.topology_spread_constraints[].labelSelector.matchExpressions 数组的每一项；每一行是该数组项的一个字段。

字段	类型	说明
`key`	string	标签键。
`operator`	string	标签运算符。
`values`	array of string	标签比较值列表。

管理信息

下面表格展开响应示例中 data 数组的每一项；每一行是该数组项的一个字段。

字段	类型	说明
`enabled`	boolean	规格是否启用。
`is_system`	boolean	是否为系统内置规格。
`created_by`	string	创建者标识。
`updated_by`	string	最后更新者标识。
`created_at`	string	创建时间。
`updated_at`	string	最后更新时间。

错误响应¶

响应示例

{
  "code": "LIST_SPECS_FAILED",
  "msg": "failed to list compute resource specs",
  "data": null
}

字段说明

字段	类型	说明
`code`	string	错误代码。
`msg`	string	错误说明。
`data`	null	错误时为空。

后续操作¶

使用已启用规格的 id 创建计算实例。

最后更新于 2026 年 9 月 11 日