更新时间:2024-02-06 GMT+08:00
分享

创建环境

功能介绍

环境是用于应用部署和运行的计算、存储、网络等基础资源的集合。ServiceStage把相同VPC下的计算资源(如云服务引擎CCE、弹性云服务器ECS等)、网络资源(如弹性负载均衡ELB、弹性公网EIP等)和中间件(如分布式缓存DCS、云数据库RDS、微服务引擎CSE等)组合为一个环境,如:开发环境,测试环境,预生产环境,生产环境。环境内网络互通,可以按环境维度来管理资源、部署服务,减少具体基础资源运维管理的复杂性。

此API用来创建环境。

调试

您可以在API Explorer中调试该接口。

URI

POST /v2/{project_id}/cas/environments

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

请求消息

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

消息体的类型(格式)。

X-Auth-Token

String

调用接口的认证方式分为Token和AK/SK两种。如果您使用的Token方式,此参数为必填,请填写Token的值。Token获取方式,请参考获取用户Token

表3 请求Body参数

参数

是否必选

参数类型

描述

name

String

环境名称。

由英文字母、数字、中划线(-)、下划线(_)组成,并以英文字母开头,英文字母或者数字结尾,英文字母不区分大小写,长度为2~64个字符。

alias

String

环境别名。

最大长度为64个字符。

deploy_mode

String

指定环境类型。

  • virtualmachine:虚拟机。
  • container:Kubernetes。
  • mixed :虚拟机和Kubernetes。

description

String

环境描述。

最大长度为128个字符。

enterprise_project_id

String

企业项目ID。

charge_mode

String

收费模式,支持provided、on_demanded、monthly。默认provided,表示使用用户提供的已有资源,无需收费。on_demanded表示按需收费,monthly表示包月收费。

vpc_id

String

虚拟私有云ID。

base_resources

Array of objects

基础资源,请参考表4

optional_resources

Array of objects

可选资源,请参考表4

表4 resource参数

参数

是否必选

参数类型

描述

id

String

资源ID。

type

String

资源名称。

name

String

基础资源:cce、ecs、as。

可选资源:rds、dcs、elb、cse等其他类型。

响应消息

表5 响应参数

参数

参数类型

描述

id

String

环境ID。

name

String

环境名称。

alias

String

环境别名。

description

String

环境描述。

project_id

String

项目ID。

enterprise_project_id

String

企业项目ID。

charge_mode

String

收费模式。

deploy_mode

String

环境类型。

  • virtualmachine:虚拟机。
  • container:Kubernetes。
  • mixed :虚拟机和Kubernetes。

vpc_id

String

虚拟私有云ID。

base_resources

Array of objects

基础资源,请参考表6,返回为空。

optional_resources

Array of objects

可选资源,请参考表6,返回为空。

creator

String

创建人。

create_time

Integer

创建时间。

update_time

Integer

修改时间。

表6 resource参数

参数

参数类型

描述

id

String

资源ID。

name

String

资源名称。

type

String

基础资源:cce、ecs、as。

可选资源:rds、dcs、elb、cse等其他类型。

请求示例

创建一个名称为development-env的“虚拟机”类型的环境,环境所在VPC的id为29d55020-ae0e-4a18-871c-93e6976ee7bd。

{
	"name": "development-env",
	"description": "",
	"charge_mode": "provided",
        "deploy_mode": "container",
	"vpc_id": "29d55020-ae0e-4a18-871c-93e6976ee7bd",
        "base_resources": [
                {
                        "id": "b6862a62-d916-11e9-bdf1-0255ac101fd9",
                        "type": "cce"
                }
        ],   
        "optional_resources": [
                {
                        "id": "default",
                        "type": "cse"
                }
        ]
}

响应示例

{
	"id": "00078e9d-a61c-476e-ac63-a10c9cb2638e",
	"name": "development-env",
	"alias": null,
	"description": "",
	"project_id": "e7d2e9c589e5445e808a8ff0d1235aca",
	"enterprise_project_id": "0",
	"charge_mode": "provided",
        "deploy_mode": "container",
	"vpc_id": "29d55020-ae0e-4a18-871c-93e6976ee7bd",	
        "base_resources": [
                {
                        "id": "b6862a62-d916-11e9-bdf1-0255ac101fd9",
                        "type": "cce"
                }
        ],   
        "optional_resources": [
                {
                        "id": "default",
                        "type": "cse"
                }
        ],
	"creator": "ss-test",
	"create_time": 1610418873730,
	"update_time": 1610418873730
}

状态码

表7 状态码说明

HTTP状态码

描述

200

操作成功。

400

错误的请求。

404

请求对象不存在。

500

内部错误。

错误码

错误码格式为:SVCSTG.00100.[Error_ID],例如:SVCSTG.00100400。错误码说明请参考ServiceStage错误码

分享:

    相关文档

    相关产品