Updated on 2024-12-16 GMT+08:00

Querying a Runtime System Stack

Function

This API is used to query runtime system stack information.

URI

GET /v3/{project_id}/cas/runtimestacks

Table 1 Path parameter

Parameter

Mandatory

Type

Description

project_id

Yes

String

Tenant's project ID. See Obtaining a Project ID.

Request

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Message body type (format). Default value: application/json;charset=utf8.

X-Auth-Token

Yes

String

API calling can be authenticated using a token or AK/SK. If you use a token, this parameter is mandatory and must be set to the token. For details about how to obtain the token, see Authentication.

Response

Table 3 Response parameters

Parameter

Type

Description

runtime_stacks

Array of objects

Technology stack. See Table 4.

total

Integer

Total number of technology stacks.

Table 4 runtimestack

Parameter

Type

Description

id

String

Technology stack ID.

name

String

Runtime system name.

project_id

String

Tenant's project ID.

deploy_mode

String

Deployment mode.

  • container
  • virtualmachine

type

String

Technology stack type. Value: Nodejs, Java, Tomcat, Python, Docker, or Php.

version

String

Technology stack version.

spec

Object

Technology stack parameters. See Table 5.

system

Integer

Whether the stack is a system technology stack.

  • 1: system technology stack.
  • 0: custom technology stack.

status

String

Technology stack status.

  • Supported
  • Deprecated
  • Disable

create_time

Integer

Creation time.

update_time

Integer

Update time.

component_count

Integer

Number of components associated with the technology stack.

Table 5 spec

Parameter

Type

Description

os

String

OS of the technology stack.

sdk

String

Tool package of the technology stack.

parameters

Map<String,String>

Address of the image related to the technology stack.

Example Request

None

Example Response

{
	"runtime_stacks": [{
		"id": "1c5e7000-f2f2-4fc2-988f-0a22ca67940f",
		"name": "OpenJDK11",
		"project_id": "578ac30b81034b89a7255b3af26db9c9",
		"deploy_mode": "virtualmachine",
		"type": "Java",
		"version": "1.3.7",
		"spec": {
			"os": "Linux",
			"sdk": "OpenJDK-11.0.23",
			"parameters": null
		},
		"system": 1,
		"status": "Supported",
		"create_time": 1722416061588,
		"update_time": 1722416098865,
		"component_count": 3
	},
	{
		"id": "b153f6b8-9335-46a1-913e-c2d8f966d4b2",
		"name": "CustomJdk",
		"project_id": "578ac30b81034b89a7255b3af26db9c9",
		"deploy_mode": "virtualmachine",
		"type": "Java",
		"version": "1.0.0",
		"spec": {
			"os": null,
			"sdk": null,
			"parameters": {
				"jdk_url": "obs://cyf/bisheng-jdk-8u412-linux-aarch64.tar.gz"
			}
		},
		"system": 0,
		"status": "Disable",
		"creator": "cyf",
		"create_time": 1722932102641,
		"update_time": 1722932102641,
		"component_count": 0
	}],
	"total": 2
}

Status Code

Status Code

Description

200

OK

400

Bad Request

404

Not Found

409

Conflict

500

Internal Server Error

Error Code

The error code format is SVCSTG.00100.[Error_ID], for example, SVCSTG.00100400. For details, see ServiceStage Error Codes.