文档首页/魔坊（ModelArts）模型训推平台/API参考/Lite Server管理/获取软件信息 - ShowSoftware
更新时间：2026-01-15 GMT+08:00
在线调试
CLI示例
查看PDF
分享

获取软件信息 - ShowSoftware

功能介绍

获取软件信息接口用于查询支持的软件信息，支持通过flavor_type和name查询参数进行过滤。该接口适用于以下场景：当用户需要了解系统支持的软件及其详细信息，例如在选择合适的软件版本或配置环境时，可以通过此接口获取相关信息。使用该接口的前提条件是用户具有查看软件信息的权限。查询操作完成后，接口将返回符合条件的软件列表，包括软件名称、版本、类型等详细信息。若用户无权限操作、提供的查询参数不正确或系统中无符合条件的软件，接口将返回相应的错误信息。

调试

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

授权信息

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

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

GET /v1/{project_id}/dev-servers/software

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

约束限制：1 - 64字符，字母、数字和中划线。

取值范围：不涉及。

默认取值：不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

flavor_type

否

String

参数解释：Lite Server的规格类型。

约束限制：字母、数字和中划线。

取值范围：不涉及。

默认取值：不涉及。

type

否

String

参数解释：Lite Server的软件类型。

约束限制：字母、数字和中划线。

取值范围：不涉及。

默认取值：不涉及。

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

data

Array of SoftwareData objects

参数解释：查询出的所有规格类型及其支持的软件。

表4 SoftwareData

参数

参数类型

描述

flavor_type

String

参数解释：规格类型。

取值范围：-ascend_snt9b -ascend_snt9b23 -ascend_generic。

support

Array of SoftwareSupport objects

参数解释：flavor_type支持的所有软件信息。

表5 SoftwareSupport

参数

参数类型

描述

type

String

参数解释：软件名称。

取值范围：- ASCEND_HDK -CES_AGENT -ASCEND_CANN -K8S_TOOLKITS

info

Array of VersionInfo objects

参数解释：软件版本信息，包含软件版本号及软件描述信息。

表6 VersionInfo

参数

参数类型

描述

id

String

参数解释：id。

取值范围：不涉及。

version

String

参数解释：版本号。

取值范围：不涉及。

description

String

参数解释：版本描述信息，供前端下拉框展示。

取值范围：不涉及。

url

String

参数解释：下载链接。

取值范围：不涉及。

status

String

参数解释：可用状态。

取值范围：-ACTIVE -INACTIVE

file

Array of File objects

参数解释：软件包列表。

表7 File

参数

参数类型

描述

name

String

参数解释：软件包名称。

取值范围：不涉及。

file

String

参数解释：软件包安装包。

取值范围：不涉及。

请求示例

GET https://{endpoint}/v1/{project_id}/dev-servers/software

{ }

响应示例

状态码：200

OK

{
  "data" : [ {
    "flavor_type" : "ASCEND_SNT9B",
    "support" : [ {
      "info" : [ {
        "description" : "Driver: 23.0.6 | Firmware: 7.1.0.9.220",
        "id" : "5a0f7b07-b4d7-4f7c-8290-617f3e4be8d0",
        "status" : "ACTIVE",
        "url" : "https://abc.com/hdk",
        "version" : "23.0.6"
      }, {
        "description" : "Driver: 24.1.0.3 | Firmware: 7.5.0.3.220",
        "id" : "af890aa4-4579-418a-83ca-d6e41398ca65",
        "status" : "ACTIVE",
        "url" : "https://abc.com/hdk",
        "version" : "24.1.0.3"
      } ],
      "type" : "ASCEND_HDK"
    } ]
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题：Lite Server管理