9998: Tidy up, add test.
[arvados.git] / doc / api / methods / containers.html.textile.liquid
1 ---
2 layout: default
3 navsection: api
4 navmenu: API Methods
5 title: "containers"
6
7 ...
8
9 See "REST methods for working with Arvados resources":{{site.baseurl}}/api/methods.html
10
11 API endpoint base: @https://{{ site.arvados_api_host }}/arvados/v1/containers@
12
13 Required arguments are displayed in %{background:#ccffcc}green%.
14
15 h2(#create). create
16
17 Create a new Container.
18
19 Arguments:
20
21 table(table table-bordered table-condensed).
22 |_. Argument |_. Type |_. Description |_. Location |_. Example |
23 {background:#ccffcc}.|container|object|See "Container resource":{{site.baseurl}}/api/schema/Container.html|request body||
24
25 h2. delete
26
27 Delete an existing Container.
28
29 Arguments:
30
31 table(table table-bordered table-condensed).
32 |_. Argument |_. Type |_. Description |_. Location |_. Example |
33 {background:#ccffcc}.|uuid|string|The UUID of the Container in question.|path||
34
35 h2. get
36
37 Get a Container's metadata by UUID.
38
39 Arguments:
40
41 table(table table-bordered table-condensed).
42 |_. Argument |_. Type |_. Description |_. Location |_. Example |
43 {background:#ccffcc}.|uuid|string|The UUID of the Container in question.|path||
44
45 h2. list
46
47 List containers.
48
49 Arguments:
50
51 table(table table-bordered table-condensed).
52 |_. Argument |_. Type |_. Description |_. Location |_. Example |
53 |limit|integer (default 100)|Maximum number of containers to return.|query||
54 |order|string|Order in which to return matching containers.|query||
55 |filters|array|Conditions for filtering containers.|query||
56
57 See the create method documentation for more information about Container-specific filters.
58
59 h2. update
60
61 Update attributes of an existing Container.
62
63 Arguments:
64
65 table(table table-bordered table-condensed).
66 |_. Argument |_. Type |_. Description |_. Location |_. Example |
67 {background:#ccffcc}.|uuid|string|The UUID of the Container in question.|path||
68 |container|object||query||
69
70 h2. auth
71
72 Get the api_client_authorization record indicated by this container's auth_uuid, which belongs to the container's locked_by_uuid.
73
74 table(table table-bordered table-condensed).
75 |_. Argument |_. Type |_. Description |_. Location |_. Example |
76 {background:#ccffcc}.|uuid|string||path||