创建一个新的应用实例。

请求信息

请求行 RequestLine

POST /projects/ HTTP/1.1

请求行参数 URI Param

特有请求头 RequestHead

Content-Type: application/json

请求体 RequestBody

JSON object

{
    "name": "string",
    "description": "string",
    "template": "string",
    "version": "string",
    "environment": {
       "key": "value",
       ...
    }
}

请求体解释

名称 类型 必须 描述
name string 应用名称。名称为 1~64 个字符,可包含数字,英文字符和连字符(-),且不能以连字符(-)开头。
description string 应用描述。
template string 字符串格式的应用的 Compose yaml 模板,注意需要按照 JSON 格式进行转义。
version string 应用版本,缺省值为 1.0
environment map key/value 用于替换 Compose 模板的变量参数。
latest_image bool 创建应用前,是否需要更新镜像。

返回信息

返回行 ResponseLine

HTTP/1.1 201 Created

特有返回头 ResponseHead

Location /projects/<name>

示例

请求示例

POST /projects HTTP/1.1
Content-Type: application/json
{
  "name": "test",
  "description": "This is a test application",
  "template": "web:\r\n  image: nginx",
  "version": "1.0",
  "environment": {
    "USER": "abc",
    "PWD": "password"
  }
}

返回示例

HTTP/1.1 201 Created 
Location /projects/test