文档首页/ 魔坊（ModelArts）模型训推平台/ API参考/ 模型推理（新版）/ 资源池信息/ 查询支持可切换规格列表 - ListV2ClusterFlavors
更新时间：2026-07-02 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询支持可切换规格列表 - ListV2ClusterFlavors

功能介绍

该接口允许用户查询当前资源实例支持的可切换规格列表，适用于需要调整实例资源配置的场景。使用该接口前，用户需确保已登录并拥有查询权限。执行成功后，用户将获得一个包含各种可切换规格的详细列表，包括规格ID、名称、资源配额等信息，可用于后续的实例规格变更操作。如果用户没有相应的查询权限或资源实例ID无效，接口将返回错误信息，如401 Unauthorized或404 Not Found。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    modelarts::listClusterFlavors

    List

    -

    -

    modelarts:clusterFlavor:list

    -

URI

GET /v2/{project_id}/services/flavors

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

用户项目ID。获取方法请参见获取项目ID和名称。

约束限制：

不涉及。

取值范围：

账号的项目ID。

默认取值：

不涉及。
表2 Query参数

参数

是否必选

参数类型

描述

flavor_type

否

String

参数解释：

规格类型。

约束限制：

不涉及。

取值范围：

  • CPU

  • GPU

  • ASCEND

默认取值：

不涉及。

limit

否

Integer

参数解释：

指定返回的最大条目数。

约束限制：

不涉及。

取值范围：

[1,500]

默认取值：

10。

offset

否

Integer

参数解释：

分页列表查询的偏移量。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

0。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。通过调用IAM服务获取用户Token接口获取响应消息头中X-Subject-Token的值。获取方法请参见获取IAM用户Token（使用密码）。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

Content-Type

否

String

参数解释：

消息体的类型（格式）。

约束限制：

不涉及。

取值范围：

  • application/json JSON格式。

  • application/json;charset=utf-8 JSON格式，UTF-8编码。

默认取值：

不涉及。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

current

Integer

参数解释：

当前页码。

取值范围：

不涉及。

data

Array of NotebookFlavor objects

参数解释：

规格列表。

取值范围：

不涉及。

pages

Integer

参数解释：

总页数。

取值范围：

不涉及。

size

Integer

参数解释：

每页数量。

取值范围：

不涉及。

total

Integer

参数解释：

总记录数。

取值范围：

不涉及。
表5 NotebookFlavor

参数

参数类型

描述

arch

String

参数解释：

架构类型。

取值范围：

  • X86_64

  • arm64

ascend

AscendInfo object

参数解释：

NPU信息。

billing

BillingInfo object

参数解释：

话单信息。

category

String

参数解释：

规格处理器类型。

取值范围：

  • CPU

  • GPU

  • ASCEND

description

String

参数解释：

规格描述信息。

取值范围：

不涉及。

feature

String

参数解释：

规格类别。

取值范围：

  • DEFAULT：CodeLab规格。

  • NOTEBOOK：Notebook规格。

free

Boolean

参数解释：

是否为免费规格。

取值范围：

  • true: 免费规格。

  • false: 付费规格。

gpu

GPUInfo object

参数解释：

GPU信息。

取值范围：

不涉及。

id

String

参数解释：

规格ID。

取值范围：

不涉及。

memory

Long

参数解释：

内存大小。

取值范围：

不涉及。

name

String

参数解释：

规格名称。

取值范围：

不涉及。

sold_out

Boolean

参数解释：

资源是否充足。

取值范围：

  • true 资源不足。

  • false 资源充足。

storages

Array of strings

参数解释：

规格支持的存储类型。

vcpus

Integer

参数解释：

CPU核数。

取值范围：

不涉及。

evs_max_size

String

参数解释：

EVS磁盘最大容量。

取值范围：

不涉及。
表6 AscendInfo

参数

参数类型

描述

npu

Integer

参数解释：

NPU数量。

取值范围：

不涉及。

npu_memory

String

参数解释：

NPU内存。

取值范围：

不涉及。

type

String

参数解释：

NPU类型。

取值范围：

不涉及。

ai_core

String

参数解释：

切分规格中的ai_core。

取值范围：

不涉及。

ai_cpu

String

参数解释：

切分规格中的ai_cpu。

取值范围：

不涉及。
表7 BillingInfo

参数

参数类型

描述

code

String

参数解释：

计费码。

取值范围：

不涉及。

unit_num

Integer

参数解释：

计费单元。

取值范围：

不涉及。
表8 GPUInfo

参数

参数类型

描述

gpu

Integer

参数解释：

GPU卡数。

取值范围：

不涉及。

gpu_memory

String

参数解释：

GPU内存。

取值范围：

不涉及。

type

String

参数解释：

GPU类型。

取值范围：

不涉及。

状态码：401

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

ModelArts错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

具体错误信息。

取值范围：

不涉及。

状态码：403

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

ModelArts错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

具体错误信息。

取值范围：

不涉及。

状态码：404

表11 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

ModelArts错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

具体错误信息。

取值范围：

不涉及。

请求示例

查询支持可切换规格列表

GET https://{endpoint}/v2/04f258c84780d5a52f3bc00dc15aa5e7/services/flavors

响应示例

状态码：200

规格列表。

{
  "current" : 1,
  "data" : [ {
    "arch" : "x86_64",
    "billing" : {
      "unit_num" : 1
    },
    "category" : "CPU",
    "description" : "CPU算力增强型，适用于密集计算场景下运算",
    "evs_max_size" : "4096",
    "feature" : "NOTEBOOK",
    "free" : false,
    "id" : "modelarts.vm.cpu.8u.32g",
    "memory" : 33554432,
    "name" : "CPU: 8核 32GB",
    "sold_out" : true,
    "storages" : [ "EFS", "OBS", "EVS", "OBSFS" ],
    "vcpus" : 8
  }, {
    "arch" : "x86_64",
    "billing" : {
      "unit_num" : 1
    },
    "category" : "CPU",
    "description" : "CPU通用规格，用于快速数据探索和实验",
    "evs_max_size" : "4096",
    "feature" : "NOTEBOOK",
    "free" : false,
    "id" : "modelarts.vm.cpu.2u.8g",
    "memory" : 8388608,
    "name" : "CPU: 2核 8GB",
    "sold_out" : true,
    "storages" : [ "EFS", "OBS", "EVS", "OBSFS" ],
    "vcpus" : 2
  } ],
  "pages" : 1,
  "size" : 8,
  "total" : 8
}

状态码

状态码

描述

200

规格列表。

401

鉴权失败。

403

权限不足

404

资源未找到。

错误码

请参见错误码。

父主题： 资源池信息

相关文档