查询支持的服务部署规格
功能介绍
查询支持的服务部署规格列表。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v1/{project_id}/services/specifications
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
用户项目ID。获取方法请参见获取项目ID和名称。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
is_personal_cluster |
否 |
Boolean |
是否查询专属资源池支持的服务部署规格列表,默认为false。 |
|
infer_type |
否 |
String |
推理方式,枚举值如下:
|
|
limit |
否 |
String |
指定每一页返回的最大条目数,默认为1000。 |
|
offset |
否 |
String |
返回数据的起始偏移量,默认为0。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total_count |
Integer |
部署服务规格总数。 |
|
count |
Integer |
当前列表的规格数量。 |
|
specifications |
Array of Specification objects |
支持的服务部署规格列表。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
is_open |
Boolean |
是否开放此规格,默认是true;取值为false时,用户需要提工单申请才可使用此规格。 |
|
spec_status |
String |
规格状态,取值为:
|
|
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 |
规格的中文描述。 |
请求示例
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 |
服务部署规格列表。 |
错误码
请参见错误码。