Obtaining Software Information

Function

This API is used to obtain the supported software information. The flavor_type and name parameters are supported.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

URI

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

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition: Project ID. For details, see Obtaining a Project ID and Name. Constraints: The value can contain 1 to 64 characters. Letters, digits, and hyphens (-) are allowed. Range: N/A Default Value: N/A

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
flavor_type	No	String	Definition: DevServer flavor type. Constraints: The value can contain letters, digits, and hyphens (-). Range: N/A Default Value: N/A
type	No	String	Definition: DevServer software type. Constraints: The value can contain letters, digits, and hyphens (-). Range: N/A Default Value: N/A

Request Parameters

None

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
data	Array of SoftwareData objects	All flavor types and supported software.

**Table 4** SoftwareData
Parameter	Type	Description
flavor_type	String	Flavor type.
support	Array of SoftwareSupport objects	Information about all software supported by flavor_type.

**Table 5** SoftwareSupport
Parameter	Type	Description
type	String	Software name.
info	Array of VersionInfo objects	Software version information, including the software version number and software description.

**Table 6** VersionInfo
Parameter	Type	Description
id	String	Definition: ID. Range: N/A
version	String	Version.
description	String	Version description, which is displayed in the drop-down list on the frontend.
url	String	Download link.
status	String	Availability status.
file	Array of File objects	Software package list.

**Table 7** File
Parameter	Type	Description
name	String	Software package name.
file	String	Software package and installation package.

Example Requests

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

{ }

Example Responses

Status code: 200

{
  "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"
    } ]
  } ]
}