Swarm API参考  应用API列表  创建应用实例

[font=PingFangSC, "]创建一个新的应用实例。

请求信息


请求行 RequestLinePOST /projects/ HTTP/1.1
请求行参数 URI Param
无
特有请求头 RequestHeadContent-Type: application/json
请求体 RequestBody
JSON object
{
    "name": "string",
    "description": "string",
    "template": "string",
    "version": "string",
    "environment": {
       "key": "value",
       ...
    }
}
请求体解释 environment

[tr=rgb(51, 205, 229)][td]名称 类型必须描述namestring是应用名称。名称为 1~64 个字符，可包含数字，英文字符和连字符（-）,且不能以连字符（-）开头。descriptionstring否应用描述。templatestring是字符串格式的应用的 Compose yaml 模板，注意需要按照 JSON 格式进行转义。versionstring否应用版本，缺省值为 1.0。[tr=rgb(239, 251, 255)][td] map否key/value 用于替换 Compose 模板的变量参数。 latest_imagebool否创建应用前，是否需要更新镜像。

返回信息



返回行 ResponseLineHT TP/1.1 201 Created
特有返回头 ResponseHeadLocation /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 CreatedLocation /projects/test
https://help.aliyun.com/document_detail/26066.html