查询支持的服务部署规格
功能介绍
查询支持的服务部署规格列表。
调试
您可以在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.p4",
"billing_spec" : "modelarts.vm.gpu.p4",
"category" : "GPU",
"cpu_info" : {
"arch" : "x86",
"cpu" : 8.0
},
"memory_info" : {
"unit" : "GB",
"memory" : 32
},
"gpu_info" : {
"unit" : "GB",
"brand" : "NVIDIA",
"version" : "P4",
"gpu" : 1.0,
"memory" : 16
},
"npu_info" : {
"unit" : "MB",
"npu" : 0,
"memory" : 0
},
"display_en" : "CPU: 8 vCPUs | 32 GiB GPU：P4",
"display_cn" : "CPU：8 Core 32 GiB GPU：1 * P4",
"is_open" : true,
"spec_status" : "normal",
"is_free" : false,
"over_quota" : false,
"extend_params" : 1
}, {
"specification" : "modelarts.vm.ai1.a310",
"billing_spec" : "modelarts.vm.ai1.a310",
"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 |
服务部署规格列表 |
错误码
请参见错误码。
