mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
Merge pull request #18171 from MHBauer/gh7205
update 'top' api endpoint documentation
This commit is contained in:
commit
919a068fb6
9 changed files with 363 additions and 192 deletions
|
@ -269,7 +269,9 @@ Status Codes:
|
|||
|
||||
`GET /containers/(id)/top`
|
||||
|
||||
List processes running inside the container `id`
|
||||
List processes running inside the container `id`. On Unix systems this
|
||||
is done by running the `ps` command. This endpoint is not
|
||||
supported on Windows.
|
||||
|
||||
**Example request**:
|
||||
|
||||
|
@ -282,27 +284,44 @@ List processes running inside the container `id`
|
|||
|
||||
{
|
||||
"Titles" : [
|
||||
"USER",
|
||||
"PID",
|
||||
"%CPU",
|
||||
"%MEM",
|
||||
"VSZ",
|
||||
"RSS",
|
||||
"TTY",
|
||||
"STAT",
|
||||
"START",
|
||||
"TIME",
|
||||
"COMMAND"
|
||||
"UID", "PID", "PPID", "C", "STIME", "TTY", "TIME", "CMD"
|
||||
],
|
||||
"Processes" : [
|
||||
["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"],
|
||||
["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"]
|
||||
[
|
||||
"root", "13642", "882", "0", "17:03", "pts/0", "00:00:00", "/bin/bash"
|
||||
],
|
||||
[
|
||||
"root", "13735", "13642", "0", "17:06", "pts/0", "00:00:00", "sleep 10"
|
||||
]
|
||||
]
|
||||
}
|
||||
|
||||
**Example request**:
|
||||
|
||||
GET /containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
|
||||
|
||||
**Example response**:
|
||||
|
||||
HTTP/1.1 200 OK
|
||||
Content-Type: application/json
|
||||
|
||||
{
|
||||
"Titles" : [
|
||||
"USER","PID","%CPU","%MEM","VSZ","RSS","TTY","STAT","START","TIME","COMMAND"
|
||||
]
|
||||
"Processes" : [
|
||||
[
|
||||
"root","13642","0.0","0.1","18172","3184","pts/0","Ss","17:03","0:00","/bin/bash"
|
||||
],
|
||||
[
|
||||
"root","13895","0.0","0.0","4348","692","pts/0","S+","17:15","0:00","sleep 10"
|
||||
]
|
||||
],
|
||||
}
|
||||
|
||||
Query Parameters:
|
||||
|
||||
- **ps_args** – ps arguments to use (e.g., aux)
|
||||
- **ps_args** – `ps` arguments to use (e.g., `aux`), defaults to `-ef`
|
||||
|
||||
Status Codes:
|
||||
|
||||
|
|
|
@ -357,7 +357,9 @@ Status Codes:
|
|||
|
||||
`GET /containers/(id)/top`
|
||||
|
||||
List processes running inside the container `id`
|
||||
List processes running inside the container `id`. On Unix systems this
|
||||
is done by running the `ps` command. This endpoint is not
|
||||
supported on Windows.
|
||||
|
||||
**Example request**:
|
||||
|
||||
|
@ -370,27 +372,44 @@ List processes running inside the container `id`
|
|||
|
||||
{
|
||||
"Titles" : [
|
||||
"USER",
|
||||
"PID",
|
||||
"%CPU",
|
||||
"%MEM",
|
||||
"VSZ",
|
||||
"RSS",
|
||||
"TTY",
|
||||
"STAT",
|
||||
"START",
|
||||
"TIME",
|
||||
"COMMAND"
|
||||
"UID", "PID", "PPID", "C", "STIME", "TTY", "TIME", "CMD"
|
||||
],
|
||||
"Processes" : [
|
||||
["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"],
|
||||
["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"]
|
||||
[
|
||||
"root", "13642", "882", "0", "17:03", "pts/0", "00:00:00", "/bin/bash"
|
||||
],
|
||||
[
|
||||
"root", "13735", "13642", "0", "17:06", "pts/0", "00:00:00", "sleep 10"
|
||||
]
|
||||
]
|
||||
}
|
||||
|
||||
**Example request**:
|
||||
|
||||
GET /containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
|
||||
|
||||
**Example response**:
|
||||
|
||||
HTTP/1.1 200 OK
|
||||
Content-Type: application/json
|
||||
|
||||
{
|
||||
"Titles" : [
|
||||
"USER","PID","%CPU","%MEM","VSZ","RSS","TTY","STAT","START","TIME","COMMAND"
|
||||
]
|
||||
"Processes" : [
|
||||
[
|
||||
"root","13642","0.0","0.1","18172","3184","pts/0","Ss","17:03","0:00","/bin/bash"
|
||||
],
|
||||
[
|
||||
"root","13895","0.0","0.0","4348","692","pts/0","S+","17:15","0:00","sleep 10"
|
||||
]
|
||||
],
|
||||
}
|
||||
|
||||
Query Parameters:
|
||||
|
||||
- **ps_args** – ps arguments to use (e.g., aux)
|
||||
- **ps_args** – `ps` arguments to use (e.g., `aux`), defaults to `-ef`
|
||||
|
||||
Status Codes:
|
||||
|
||||
|
|
|
@ -357,7 +357,9 @@ Status Codes:
|
|||
|
||||
`GET /containers/(id)/top`
|
||||
|
||||
List processes running inside the container `id`
|
||||
List processes running inside the container `id`. On Unix systems this
|
||||
is done by running the `ps` command. This endpoint is not
|
||||
supported on Windows.
|
||||
|
||||
**Example request**:
|
||||
|
||||
|
@ -370,27 +372,44 @@ List processes running inside the container `id`
|
|||
|
||||
{
|
||||
"Titles" : [
|
||||
"USER",
|
||||
"PID",
|
||||
"%CPU",
|
||||
"%MEM",
|
||||
"VSZ",
|
||||
"RSS",
|
||||
"TTY",
|
||||
"STAT",
|
||||
"START",
|
||||
"TIME",
|
||||
"COMMAND"
|
||||
"UID", "PID", "PPID", "C", "STIME", "TTY", "TIME", "CMD"
|
||||
],
|
||||
"Processes" : [
|
||||
["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"],
|
||||
["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"]
|
||||
[
|
||||
"root", "13642", "882", "0", "17:03", "pts/0", "00:00:00", "/bin/bash"
|
||||
],
|
||||
[
|
||||
"root", "13735", "13642", "0", "17:06", "pts/0", "00:00:00", "sleep 10"
|
||||
]
|
||||
]
|
||||
}
|
||||
|
||||
**Example request**:
|
||||
|
||||
GET /containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
|
||||
|
||||
**Example response**:
|
||||
|
||||
HTTP/1.1 200 OK
|
||||
Content-Type: application/json
|
||||
|
||||
{
|
||||
"Titles" : [
|
||||
"USER","PID","%CPU","%MEM","VSZ","RSS","TTY","STAT","START","TIME","COMMAND"
|
||||
]
|
||||
"Processes" : [
|
||||
[
|
||||
"root","13642","0.0","0.1","18172","3184","pts/0","Ss","17:03","0:00","/bin/bash"
|
||||
],
|
||||
[
|
||||
"root","13895","0.0","0.0","4348","692","pts/0","S+","17:15","0:00","sleep 10"
|
||||
]
|
||||
],
|
||||
}
|
||||
|
||||
Query Parameters:
|
||||
|
||||
- **ps_args** – ps arguments to use (e.g., aux)
|
||||
- **ps_args** – `ps` arguments to use (e.g., `aux`), defaults to `-ef`
|
||||
|
||||
Status Codes:
|
||||
|
||||
|
|
|
@ -396,7 +396,9 @@ Status Codes:
|
|||
|
||||
`GET /containers/(id)/top`
|
||||
|
||||
List processes running inside the container `id`
|
||||
List processes running inside the container `id`. On Unix systems this
|
||||
is done by running the `ps` command. This endpoint is not
|
||||
supported on Windows.
|
||||
|
||||
**Example request**:
|
||||
|
||||
|
@ -409,27 +411,44 @@ List processes running inside the container `id`
|
|||
|
||||
{
|
||||
"Titles" : [
|
||||
"USER",
|
||||
"PID",
|
||||
"%CPU",
|
||||
"%MEM",
|
||||
"VSZ",
|
||||
"RSS",
|
||||
"TTY",
|
||||
"STAT",
|
||||
"START",
|
||||
"TIME",
|
||||
"COMMAND"
|
||||
"UID", "PID", "PPID", "C", "STIME", "TTY", "TIME", "CMD"
|
||||
],
|
||||
"Processes" : [
|
||||
["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"],
|
||||
["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"]
|
||||
[
|
||||
"root", "13642", "882", "0", "17:03", "pts/0", "00:00:00", "/bin/bash"
|
||||
],
|
||||
[
|
||||
"root", "13735", "13642", "0", "17:06", "pts/0", "00:00:00", "sleep 10"
|
||||
]
|
||||
]
|
||||
}
|
||||
|
||||
**Example request**:
|
||||
|
||||
GET /containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
|
||||
|
||||
**Example response**:
|
||||
|
||||
HTTP/1.1 200 OK
|
||||
Content-Type: application/json
|
||||
|
||||
{
|
||||
"Titles" : [
|
||||
"USER","PID","%CPU","%MEM","VSZ","RSS","TTY","STAT","START","TIME","COMMAND"
|
||||
]
|
||||
"Processes" : [
|
||||
[
|
||||
"root","13642","0.0","0.1","18172","3184","pts/0","Ss","17:03","0:00","/bin/bash"
|
||||
],
|
||||
[
|
||||
"root","13895","0.0","0.0","4348","692","pts/0","S+","17:15","0:00","sleep 10"
|
||||
]
|
||||
],
|
||||
}
|
||||
|
||||
Query Parameters:
|
||||
|
||||
- **ps_args** – ps arguments to use (e.g., aux)
|
||||
- **ps_args** – `ps` arguments to use (e.g., `aux`), defaults to `-ef`
|
||||
|
||||
Status Codes:
|
||||
|
||||
|
|
|
@ -434,7 +434,9 @@ Status Codes:
|
|||
|
||||
`GET /containers/(id)/top`
|
||||
|
||||
List processes running inside the container `id`
|
||||
List processes running inside the container `id`. On Unix systems this
|
||||
is done by running the `ps` command. This endpoint is not
|
||||
supported on Windows.
|
||||
|
||||
**Example request**:
|
||||
|
||||
|
@ -447,27 +449,44 @@ List processes running inside the container `id`
|
|||
|
||||
{
|
||||
"Titles" : [
|
||||
"USER",
|
||||
"PID",
|
||||
"%CPU",
|
||||
"%MEM",
|
||||
"VSZ",
|
||||
"RSS",
|
||||
"TTY",
|
||||
"STAT",
|
||||
"START",
|
||||
"TIME",
|
||||
"COMMAND"
|
||||
"UID", "PID", "PPID", "C", "STIME", "TTY", "TIME", "CMD"
|
||||
],
|
||||
"Processes" : [
|
||||
["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"],
|
||||
["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"]
|
||||
[
|
||||
"root", "13642", "882", "0", "17:03", "pts/0", "00:00:00", "/bin/bash"
|
||||
],
|
||||
[
|
||||
"root", "13735", "13642", "0", "17:06", "pts/0", "00:00:00", "sleep 10"
|
||||
]
|
||||
]
|
||||
}
|
||||
|
||||
**Example request**:
|
||||
|
||||
GET /containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
|
||||
|
||||
**Example response**:
|
||||
|
||||
HTTP/1.1 200 OK
|
||||
Content-Type: application/json
|
||||
|
||||
{
|
||||
"Titles" : [
|
||||
"USER","PID","%CPU","%MEM","VSZ","RSS","TTY","STAT","START","TIME","COMMAND"
|
||||
]
|
||||
"Processes" : [
|
||||
[
|
||||
"root","13642","0.0","0.1","18172","3184","pts/0","Ss","17:03","0:00","/bin/bash"
|
||||
],
|
||||
[
|
||||
"root","13895","0.0","0.0","4348","692","pts/0","S+","17:15","0:00","sleep 10"
|
||||
]
|
||||
],
|
||||
}
|
||||
|
||||
Query Parameters:
|
||||
|
||||
- **ps_args** – ps arguments to use (e.g., aux)
|
||||
- **ps_args** – `ps` arguments to use (e.g., `aux`), defaults to `-ef`
|
||||
|
||||
Status Codes:
|
||||
|
||||
|
|
|
@ -449,7 +449,9 @@ Status Codes:
|
|||
|
||||
`GET /containers/(id)/top`
|
||||
|
||||
List processes running inside the container `id`
|
||||
List processes running inside the container `id`. On Unix systems this
|
||||
is done by running the `ps` command. This endpoint is not
|
||||
supported on Windows.
|
||||
|
||||
**Example request**:
|
||||
|
||||
|
@ -462,27 +464,44 @@ List processes running inside the container `id`
|
|||
|
||||
{
|
||||
"Titles" : [
|
||||
"USER",
|
||||
"PID",
|
||||
"%CPU",
|
||||
"%MEM",
|
||||
"VSZ",
|
||||
"RSS",
|
||||
"TTY",
|
||||
"STAT",
|
||||
"START",
|
||||
"TIME",
|
||||
"COMMAND"
|
||||
"UID", "PID", "PPID", "C", "STIME", "TTY", "TIME", "CMD"
|
||||
],
|
||||
"Processes" : [
|
||||
["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"],
|
||||
["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"]
|
||||
[
|
||||
"root", "13642", "882", "0", "17:03", "pts/0", "00:00:00", "/bin/bash"
|
||||
],
|
||||
[
|
||||
"root", "13735", "13642", "0", "17:06", "pts/0", "00:00:00", "sleep 10"
|
||||
]
|
||||
]
|
||||
}
|
||||
|
||||
**Example request**:
|
||||
|
||||
GET /containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
|
||||
|
||||
**Example response**:
|
||||
|
||||
HTTP/1.1 200 OK
|
||||
Content-Type: application/json
|
||||
|
||||
{
|
||||
"Titles" : [
|
||||
"USER","PID","%CPU","%MEM","VSZ","RSS","TTY","STAT","START","TIME","COMMAND"
|
||||
]
|
||||
"Processes" : [
|
||||
[
|
||||
"root","13642","0.0","0.1","18172","3184","pts/0","Ss","17:03","0:00","/bin/bash"
|
||||
],
|
||||
[
|
||||
"root","13895","0.0","0.0","4348","692","pts/0","S+","17:15","0:00","sleep 10"
|
||||
]
|
||||
],
|
||||
}
|
||||
|
||||
Query Parameters:
|
||||
|
||||
- **ps_args** – ps arguments to use (e.g., aux)
|
||||
- **ps_args** – `ps` arguments to use (e.g., `aux`), defaults to `-ef`
|
||||
|
||||
Status Codes:
|
||||
|
||||
|
|
|
@ -460,7 +460,9 @@ Status Codes:
|
|||
|
||||
`GET /containers/(id)/top`
|
||||
|
||||
List processes running inside the container `id`
|
||||
List processes running inside the container `id`. On Unix systems this
|
||||
is done by running the `ps` command. This endpoint is not
|
||||
supported on Windows.
|
||||
|
||||
**Example request**:
|
||||
|
||||
|
@ -473,27 +475,44 @@ List processes running inside the container `id`
|
|||
|
||||
{
|
||||
"Titles" : [
|
||||
"USER",
|
||||
"PID",
|
||||
"%CPU",
|
||||
"%MEM",
|
||||
"VSZ",
|
||||
"RSS",
|
||||
"TTY",
|
||||
"STAT",
|
||||
"START",
|
||||
"TIME",
|
||||
"COMMAND"
|
||||
"UID", "PID", "PPID", "C", "STIME", "TTY", "TIME", "CMD"
|
||||
],
|
||||
"Processes" : [
|
||||
["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"],
|
||||
["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"]
|
||||
[
|
||||
"root", "13642", "882", "0", "17:03", "pts/0", "00:00:00", "/bin/bash"
|
||||
],
|
||||
[
|
||||
"root", "13735", "13642", "0", "17:06", "pts/0", "00:00:00", "sleep 10"
|
||||
]
|
||||
]
|
||||
}
|
||||
|
||||
**Example request**:
|
||||
|
||||
GET /containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
|
||||
|
||||
**Example response**:
|
||||
|
||||
HTTP/1.1 200 OK
|
||||
Content-Type: application/json
|
||||
|
||||
{
|
||||
"Titles" : [
|
||||
"USER","PID","%CPU","%MEM","VSZ","RSS","TTY","STAT","START","TIME","COMMAND"
|
||||
]
|
||||
"Processes" : [
|
||||
[
|
||||
"root","13642","0.0","0.1","18172","3184","pts/0","Ss","17:03","0:00","/bin/bash"
|
||||
],
|
||||
[
|
||||
"root","13895","0.0","0.0","4348","692","pts/0","S+","17:15","0:00","sleep 10"
|
||||
]
|
||||
],
|
||||
}
|
||||
|
||||
Query Parameters:
|
||||
|
||||
- **ps_args** – ps arguments to use (e.g., aux)
|
||||
- **ps_args** – `ps` arguments to use (e.g., `aux`), defaults to `-ef`
|
||||
|
||||
Status Codes:
|
||||
|
||||
|
|
|
@ -525,7 +525,9 @@ Status Codes:
|
|||
|
||||
`GET /containers/(id)/top`
|
||||
|
||||
List processes running inside the container `id`
|
||||
List processes running inside the container `id`. On Unix systems this
|
||||
is done by running the `ps` command. This endpoint is not
|
||||
supported on Windows.
|
||||
|
||||
**Example request**:
|
||||
|
||||
|
@ -538,27 +540,44 @@ List processes running inside the container `id`
|
|||
|
||||
{
|
||||
"Titles" : [
|
||||
"USER",
|
||||
"PID",
|
||||
"%CPU",
|
||||
"%MEM",
|
||||
"VSZ",
|
||||
"RSS",
|
||||
"TTY",
|
||||
"STAT",
|
||||
"START",
|
||||
"TIME",
|
||||
"COMMAND"
|
||||
"UID", "PID", "PPID", "C", "STIME", "TTY", "TIME", "CMD"
|
||||
],
|
||||
"Processes" : [
|
||||
["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"],
|
||||
["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"]
|
||||
[
|
||||
"root", "13642", "882", "0", "17:03", "pts/0", "00:00:00", "/bin/bash"
|
||||
],
|
||||
[
|
||||
"root", "13735", "13642", "0", "17:06", "pts/0", "00:00:00", "sleep 10"
|
||||
]
|
||||
]
|
||||
}
|
||||
|
||||
**Example request**:
|
||||
|
||||
GET /containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
|
||||
|
||||
**Example response**:
|
||||
|
||||
HTTP/1.1 200 OK
|
||||
Content-Type: application/json
|
||||
|
||||
{
|
||||
"Titles" : [
|
||||
"USER","PID","%CPU","%MEM","VSZ","RSS","TTY","STAT","START","TIME","COMMAND"
|
||||
]
|
||||
"Processes" : [
|
||||
[
|
||||
"root","13642","0.0","0.1","18172","3184","pts/0","Ss","17:03","0:00","/bin/bash"
|
||||
],
|
||||
[
|
||||
"root","13895","0.0","0.0","4348","692","pts/0","S+","17:15","0:00","sleep 10"
|
||||
]
|
||||
],
|
||||
}
|
||||
|
||||
Query Parameters:
|
||||
|
||||
- **ps_args** – ps arguments to use (e.g., aux)
|
||||
- **ps_args** – `ps` arguments to use (e.g., `aux`), defaults to `-ef`
|
||||
|
||||
Status Codes:
|
||||
|
||||
|
|
|
@ -530,7 +530,9 @@ Status Codes:
|
|||
|
||||
`GET /containers/(id)/top`
|
||||
|
||||
List processes running inside the container `id`
|
||||
List processes running inside the container `id`. On Unix systems this
|
||||
is done by running the `ps` command. This endpoint is not
|
||||
supported on Windows.
|
||||
|
||||
**Example request**:
|
||||
|
||||
|
@ -543,27 +545,44 @@ List processes running inside the container `id`
|
|||
|
||||
{
|
||||
"Titles" : [
|
||||
"USER",
|
||||
"PID",
|
||||
"%CPU",
|
||||
"%MEM",
|
||||
"VSZ",
|
||||
"RSS",
|
||||
"TTY",
|
||||
"STAT",
|
||||
"START",
|
||||
"TIME",
|
||||
"COMMAND"
|
||||
"UID", "PID", "PPID", "C", "STIME", "TTY", "TIME", "CMD"
|
||||
],
|
||||
"Processes" : [
|
||||
["root","20147","0.0","0.1","18060","1864","pts/4","S","10:06","0:00","bash"],
|
||||
["root","20271","0.0","0.0","4312","352","pts/4","S+","10:07","0:00","sleep","10"]
|
||||
[
|
||||
"root", "13642", "882", "0", "17:03", "pts/0", "00:00:00", "/bin/bash"
|
||||
],
|
||||
[
|
||||
"root", "13735", "13642", "0", "17:06", "pts/0", "00:00:00", "sleep 10"
|
||||
]
|
||||
]
|
||||
}
|
||||
|
||||
**Example request**:
|
||||
|
||||
GET /containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
|
||||
|
||||
**Example response**:
|
||||
|
||||
HTTP/1.1 200 OK
|
||||
Content-Type: application/json
|
||||
|
||||
{
|
||||
"Titles" : [
|
||||
"USER","PID","%CPU","%MEM","VSZ","RSS","TTY","STAT","START","TIME","COMMAND"
|
||||
]
|
||||
"Processes" : [
|
||||
[
|
||||
"root","13642","0.0","0.1","18172","3184","pts/0","Ss","17:03","0:00","/bin/bash"
|
||||
],
|
||||
[
|
||||
"root","13895","0.0","0.0","4348","692","pts/0","S+","17:15","0:00","sleep 10"
|
||||
]
|
||||
],
|
||||
}
|
||||
|
||||
Query Parameters:
|
||||
|
||||
- **ps_args** – ps arguments to use (e.g., aux)
|
||||
- **ps_args** – `ps` arguments to use (e.g., `aux`), defaults to `-ef`
|
||||
|
||||
Status Codes:
|
||||
|
||||
|
|
Loading…
Reference in a new issue