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

[font=PingFangSC, "]查看您在容器集群中创建的所有服务实例列表。

请求信息


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

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

返回信息


返回行 ResponseLineHTT P/1.1 200 OK
特有返回头 ResponseHead
无
返回体 ResponseBody[{ "id": "string", "name": "string", "project": "string", "description": "string", "created": "datetime", "updated": "datetime", "desired_state": "string", "current_state": "string", "definition": { "key": "value",...}, "extensions": { "key": "value",...}, "containers": { "key": "value",...}},...]
返回体解释
服务实例的格式 [tr=rgb(51, 205, 229)][td]名称 类型描述idstring服务 IDnamestring服务名称projectstring应用名称createddatetime服务创建时间updateddatetime服务更新时间desired_statestring期望状态 （如果当前状态是中间状态时，期望状态指明变迁终态）current_statestring当前状态definitionmapCompose 中服务定义 key/valueextensionsmap容器服务 Compose 中服务扩展 key/valuecontainersmap服务中所包含容器 key （容器id）/value（属性）

示例


请求示例GET /services/ HTTP/1.1
返回示例
HTTP/1.1 200 Ok
Content-Type:application/json;charset=UTF-8
[
  {
    "id": "wordpress_db",
    "name": "db",
    "project": "wordpress",
    "definition": {
      "environment": [
        "MYSQL_ROOT_PASSWORD=password"
      ],
      "image": "mysql:5.7",
      "restart": "always"
    },
    "extensions": {
      "scale": 1,
      "logs": [
        "/var/log/mysql"
      ]
    },
    "created": "2016-04-21T13:36:32.440646459Z",
    "updated": "2016-04-21T13:36:33.270308958Z",
    "desired_state": "running",
    "current_state": "running",
    "containers": {
      "5616f05d27516b3502a391fd2ca9d312cabffa5ad431bf261ea81f4ceabd476e": {
        "name": "/wordpress_db_1",
        "node": "10.246.2.3",
        "ip": "10.0.0.2",
        "running": true,
        "status": "running",
        "health": "success"
      }
    }
  }
]