Updated on 2026-04-10 GMT+08:00

Querying a Technology Stack

Function

This API is used to query technology stack information.

Authorization Information

Each account has all of the permissions required to call all APIs, but IAM users must have the required permissions specifically assigned.

  • If you are using role/policy-based authorization, see the required permissions in Permissions and Supported Actions.
  • If you are using identity policy-based authorization, the permission listed below is required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    servicestage:app:listApplication

    list

    -

    -

    servicestage:app:list

    -

URI

GET /v3/{project_id}/cas/runtimestacks

Table 1 Path parameter

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition

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

Constraints

N/A

Range

N/A

Default Value

N/A

Request

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Definition

Message body type (or format).

Constraints

N/A

Range

application/json;charset=utf8

Default Value

N/A

X-Auth-Token

Yes

String

Definition

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.

Constraints

N/A

Range

N/A

Default Value

N/A

Response

Table 3 Response parameters

Parameter

Type

Description

runtime_stacks

Array of objects

Definition

Technology stack. See Table 4.

total

Integer

Definition

Total number of technology stacks.

Range

N/A

Table 4 runtimestack

Parameter

Type

Description

id

String

Definition

Technology stack ID.

Range

N/A

name

String

Definition

Runtime system name.

Range

N/A

project_id

String

Definition

Tenant's project ID.

Range

N/A

deploy_mode

String

Definition

Deployment mode.

Range

  • container
  • virtualmachine

type

String

Definition

Technology stack type.

Range

  • If deploy_mode is set to container, Java and Tomcat are supported.
  • If deploy_mode is set to virtualmachine, Java and Tomcat are supported.

version

String

Definition

Technology stack version.

Range

N/A

spec

Object

Definition

Technology stack parameters. See Table 5.

creator

String

Definition

Creator.

Range

N/A

system

Integer

Definition

Whether the stack is a system technology stack.

Range

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

status

String

Definition

Technology stack status.

Range

  • Supported
  • Deprecated
  • Disable

create_time

Integer

Definition

Creation time.

Range

N/A

update_time

Integer

Definition

Update time.

Range

N/A

component_count

Integer

Definition

Number of components associated with the technology stack.

Range

N/A

Table 5 spec

Parameter

Type

Description

os

String

Definition

OS of the technology stack.

Range

N/A

sdk

String

Definition

Tool package of the technology stack.

Range

N/A

parameters

Map<String,String>

Definition

Address of the image related to the technology stack.

Range

N/A

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://example/bisheng-jdk-8u412-linux-aarch64.tar.gz"
			}
		},
		"system": 0,
		"status": "Disable",
		"creator": "example",
		"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

See ServiceStage Error Codes.