Swarm API参考  应用API列表  查看应用实例列表

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

请求信息


请求行 RequestLineGET /projects/ HTTP/1.1
请求行参数 URI Param

[tr=rgb(51, 205, 229)][td]名称 类型是否必须描述qstring否应用名称servicesboolean否是否包含应用的服务信息，缺省值 truecontainersboolean否是否包含服务的容器信息，缺省值 true
特有请求头 RequestHead
无
请求体 RequestBody
无

返回信息


返回行 ResponseLineHT TP/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 的格式 [tr=rgb(51, 205, 229)][td]名称 类型描述namestring应用名称descriptionstring应用描述templatestring应用 Compose 模板versionstring应用版本createddatetime应用创建时间updateddatetime应用更新时间desired_statestring期望状态 （如果当前状态是中间状态时，期望状态指明变迁终态）current_statestring当前状态environmentmap环境变量 key/valueservicesarray服务列表


示例


请求示例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": [
      ...
    ]
  },
  ...
]