文档首页/ 应用管理与运维平台 ServiceStage/ API参考/ 应用管理API（v3版本）/ 系统配置/ 技术栈管理/ 创建技术栈
更新时间：2025-09-19 GMT+08:00
查看PDF
分享

创建技术栈

功能介绍

此API用于创建自定义技术栈。

URI

POST /v3/{project_id}/cas/runtimestacks

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户项目ID。获取方法，请参考获取项目ID。

请求消息

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

消息体的类型（格式），默认取值为“application/json;charset=utf8”。

X-Auth-Token

是

String

调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考认证鉴权。
表3 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

技术栈名称。

deploy_mode

是

String

部署类型。

  • container，容器部署。
  • virtualmachine，虚拟机部署。

type

是

String

技术栈类型。

  • “deploy_mode”为“container”时，支持Java、Tomcat。
  • “deploy_mode”为“virtualmachine”时，支持Java、Tomcat。

version

是

String

版本号。

spec

否

Object

技术栈相关参数，请参考表4。

description

否

String

技术栈描述。
表4 spec

参数

是否必选

参数类型

描述

sdk

否

String

技术栈工具包。

os

否

String

技术栈操作系统。

parameters

否

Map<String, String>

技术栈相关镜像参数。

键（Key）和值（Value）取值说明：

  • os_url，操作系统镜像地址，用于作为容器部署类型技术栈的基础镜像。值示例：swr.cn-north-4.myhuaweicloud.com/example/euleros_x86_64:2.9.5。
  • os_type，容器部署类型技术栈的操作系统镜像类型。值可以为系统预置（system）或者自定义（custom）。
  • jdk_url，JDK版本软件包的存储路径。值示例：obs://example/bisheng-jdk-8u412-linux-aarch64.tar.gz。
  • tomcat_url，Tomcat版本软件包的存储路径。值示例：obs://example/apache-tomcat-8.5.100.tar.gz。

响应消息

表5 响应参数

参数

参数类型

描述

id

String

技术栈的ID。

name

String

运行时名称。

project_id

String

租户项目ID。

deploy_mode

String

部署类型。

  • container，容器部署。
  • virtualmachine，虚拟机部署。

version

String

版本号。

type

String

技术栈类型。

  • “deploy_mode”为“container”时，支持Java、Tomcat。
  • “deploy_mode”为“virtualmachine”时，支持Java、Tomcat。

version

String

技术栈版本。

spec

Object

技术栈相关参数，请参考表6。

description

String

技术栈描述。

system

Integer

是否系统技术栈。

  • 1：系统技术栈。
  • 0：自定义技术栈。

status

String

技术栈状态。

  • Supported，启用。
  • Deprecated，已弃用。
  • Disable，未启用。

creator

String

创建人。

create_time

Integer

创建时间。

update_time

Integer

修改时间。

component_count

Integer

技术栈关联的组件个数。
表6 spec

参数

参数类型

描述

os

String

技术栈操作系统。

sdk

String

技术栈工具包。

parameters

Map<String,String>

技术栈相关镜像地址。

请求示例

创建虚拟机部署类型的自定义Java技术栈版本。

{
	"name": "test",
	"deploy_mode": "virtualmachine",
	"type": "Java",
	"version": "1.0.0",
	"description": "1234",
	"spec": {
		"parameters": {
			"jdk_url": "obs://example/bisheng-jdk-8u412-linux-aarch64.tar.gz"
		}
	}
}

响应示例

{
    "id": "cf4727f0-0d6f-43d5-b1b8-f2c1f09d1611",
    "name": "test",
    "project_id": "578ac30b81034b89a7255b3af26db9c9",
    "deploy_mode": "virtualmachine",
    "type": "Java",
    "version": "1.0.0",
    "description": null,
    "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": 1722934506431,
    "update_time": 1722934506431
}

状态码

状态码

描述

200

操作成功

400

错误的请求

404

请求对象不存在

409

请求与当前对象状态冲突

500

内部错误

错误码

请参考ServiceStage错误码。

父主题： 技术栈管理

相关文档