文档首页/ AI开发平台ModelArts/ API参考/ 服务管理/ 查询支持的服务部署规格
更新时间:2024-05-30 GMT+08:00

查询支持的服务部署规格

功能介绍

查询支持的服务部署规格列表。

调试

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

URI

GET /v1/{project_id}/services/specifications

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

表2 Query参数

参数

是否必选

参数类型

描述

is_personal_cluster

Boolean

是否查询专属资源池支持的服务部署规格列表,默认为false。

infer_type

String

推理方式,枚举值如下:

  • real-time:在线服务,默认值

  • batch:批量服务

  • edge: 边缘服务

limit

String

指定每一页返回的最大条目数,默认为1000。

offset

String

返回数据的起始偏移量,默认为0。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

total_count

Integer

部署服务规格总数。

count

Integer

当前列表的规格数量。

specifications

Array of Specification objects

支持的服务部署规格列表。

表5 Specification

参数

参数类型

描述

is_open

Boolean

是否开放此规格,默认是true;取值为false时,用户需要提工单申请才可使用此规格。

spec_status

String

规格状态,取值为:

  • normal:正常。

  • sellout:售罄,售罄时无法使用此规格部署服务。

specification

String

规格的唯一标识。

billing_spec

String

计费对应规格的唯一标识。

category

String

规格类型。

cpu_info

CpuInfo object

规格的CPU信息。

memory_info

MemoryInfo object

规格的内存信息。

gpu_info

GpuInfo object

规格的GPU信息。

npu_info

NpuInfo object

规格的NPU信息。

source_type

String

此规格应用于模型的类型,取值为空或auto,默认为空,代表是用户自己产生的模型;取值为auto时,代表是自动学习训练的模型,计费方式有差别。

is_free

Boolean

当前规格是否是免费规格,“true”表示是免费规格。

over_quota

Boolean

当前规格是否超过可用配额,“true”表示超过可用配额。

extend_params

Integer

计费因子。

display_en

String

规格的英文描述。

display_cn

String

规格的中文描述。

表6 CpuInfo

参数

参数类型

描述

arch

String

架构类型。

cpu

Number

CPU核心数。

表7 MemoryInfo

参数

参数类型

描述

unit

String

单位。

memory

Integer

内存大小。

表8 GpuInfo

参数

参数类型

描述

brand

String

品牌。

version

String

卡类型。

unit

String

单位。

memory

Integer

卡内存大小。

gpu

Number

GPU数。

表9 NpuInfo

参数

参数类型

描述

brand

String

品牌。

version

String

卡类型。

unit

String

单位。

memory

Integer

卡内存大小。

npu

Integer

NPU数。

请求示例

GET https://{endpoint}/v1/{project_id}/services/specifications

响应示例

状态码: 200

服务部署规格列表。

{
  "total_count" : 3,
  "count" : 3,
  "specifications" : [ {
    "specification" : "modelarts.vm.cpu.2u",
    "billing_spec" : "modelarts.vm.cpu.2u",
    "category" : "CPU",
    "cpu_info" : {
      "arch" : "x86",
      "cpu" : 2.0
    },
    "memory_info" : {
      "unit" : "GB",
      "memory" : 8
    },
    "gpu_info" : {
      "unit" : "MB",
      "gpu" : 0.0,
      "memory" : 0
    },
    "npu_info" : {
      "unit" : "MB",
      "npu" : 0,
      "memory" : 0
    },
    "display_en" : "CPU: 2 vCPUs | 8 GiB",
    "display_cn" : "CPU: 2 Core 8 GiB",
    "is_open" : true,
    "spec_status" : "normal",
    "is_free" : false,
    "over_quota" : false,
    "extend_params" : 1
  }, {
    "specification" : "modelarts.vm.gpu.pnt004",
    "billing_spec" : "modelarts.vm.gpu.pnt004",
    "category" : "GPU",
    "cpu_info" : {
      "arch" : "x86",
      "cpu" : 8.0
    },
    "memory_info" : {
      "unit" : "GB",
      "memory" : 32
    },
    "gpu_info" : {
      "unit" : "GB",
      "brand" : "NVIDIA",
      "version" : "Pnt004",
      "gpu" : 1.0,
      "memory" : 16
    },
    "npu_info" : {
      "unit" : "MB",
      "npu" : 0,
      "memory" : 0
    },
    "display_en" : "CPU: 8 vCPUs | 32 GiB GPU:Pnt004",
    "display_cn" : "CPU:8 Core 32 GiB GPU:1 * Pnt004",
    "is_open" : true,
    "spec_status" : "normal",
    "is_free" : false,
    "over_quota" : false,
    "extend_params" : 1
  }, {
    "specification" : "modelarts.vm.ai1.snt3",
    "billing_spec" : "modelarts.vm.ai1.snt3",
    "category" : "NPU",
    "cpu_info" : {
      "arch" : "x86",
      "cpu" : 2.0
    },
    "memory_info" : {
      "unit" : "GB",
      "memory" : 8
    },
    "gpu_info" : {
      "unit" : "MB",
      "gpu" : 0.0,
      "memory" : 0
    },
    "npu_info" : {
      "unit" : "GB",
      "brand" : "Ascend",
      "version" : "Snt3",
      "npu" : 1,
      "memory" : 8
    },
    "display_en" : "CPU: 2 vCPUs | 8 GiB Ascend: 1 x Ascend snt3",
    "display_cn" : "CPU:2 Core 8 GiB Ascend: 1 * Ascend snt3",
    "is_open" : false,
    "spec_status" : "normal",
    "is_free" : false,
    "over_quota" : false,
    "extend_params" : 1
  } ]
}

状态码

状态码

描述

200

服务部署规格列表。

错误码

请参见错误码