查看您在容器集群中创建的所有应用实例列表。

请求信息

请求行 RequestLine

GET /projects/ HTTP/1.1

请求行参数 URI Param

名称 类型 是否必须 描述
q string 应用名称
services boolean 是否包含应用的服务信息,缺省值 true
containers boolean 是否包含服务的容器信息,缺省值 true

特有请求头 RequestHead

请求体 RequestBody

返回信息

返回行 ResponseLine

HTTP/1.1 200 OK

特有返回头 ResponseHead

返回体 ResponseBody

[
    {
        "name": "string",
        "description": "string",
        "template": "string",
        "version": "string",
        "created": "datetime",
        "updated": "datetime",
        "desired_state": "string",
        "current_state": "string",
        "environment": {
           "key": "value",
           ...
        }
        "services": [
          ...
        ]
    }
]

返回体解释

Project 的格式

名称 类型 描述
name string 应用名称
description string 应用描述
template string 应用 Compose 模板
version string 应用版本
created datetime 应用创建时间
updated datetime 应用更新时间
desired_state string 期望状态 (如果当前状态是中间状态时,期望状态指明变迁终态)
current_state string 当前状态
environment map 环境变量 key/value
services array 服务列表

示例

请求示例

GET /projects HTTP/1.1

返回示例

HTTP/1.1 200 OK
Content-Type:application/json;charset=UTF-8
[
  {
    "name": "test",
    "description": "This is a test application",
    "template": "...",
    "version": "1.0",
    "environment": {
      "COMPOSE_PROJECT_NAME": "test"
    },
    "created": "2016-02-02T07:45:13.113833319Z",
    "updated": "2016-02-02T07:45:16.03142154Z",
    "desired_state": "running",
    "current_state": "running",
    "services": [
      ...
    ]
  },
  ...
]