doc/api/methods.html.textile.liquid

   1 ---
   2 layout: default
   3 navsection: api
   4 navmenu: Concepts
   5 title: REST methods
   6
   7 ...
   8
   9
  10
  11 (using Group as an example)
  12
  13 h2(#index). Index, list, search
  14
  15 <pre>
  16 GET https://{{ site.arvados_api_host }}/arvados/v1/groups?filters=[["owner_uuid","=","xyzzy-tpzed-a4lcehql0dv2u25"]]
  17
  18 POST https://{{ site.arvados_api_host }}/arvados/v1/groups
  19 _method=GET
  20 filters=[["owner_uuid","=","xyzzy-tpzed-a4lcehql0dv2u25"]]
  21 </pre>
  22
  23 &rarr; Group resource list
  24
  25 table(table table-bordered table-condensed).
  26 |*Parameter name*|*Value*|*Description*|
  27 |limit|integer|Maximum number of resources to return|
  28 |filters|array|Conditions for selecting resources to return|
  29
  30 h2. Create
  31
  32 <pre>
  33 POST https://{{ site.arvados_api_host }}/arvados/v1/groups
  34 group={"name":"fresh new group"}
  35 </pre>
  36
  37 &rarr; Group resource
  38
  39 h2. Delete
  40
  41 <pre>
  42 DELETE https://{{ site.arvados_api_host }}/arvados/v1/groups/xyzzy-ldvyl-vyydjeplwaa6emg
  43 </pre>
  44
  45 &rarr; Group resource
  46
  47 h2. Update
  48
  49 <pre>
  50 PUT https://{{ site.arvados_api_host }}/arvados/v1/groups/xyzzy-ldvyl-vyydjeplwaa6emg
  51 group={"uuid":"xyzzy-ldvyl-vyydjeplwaa6emg", "name":"Important group"}
  52 </pre>
  53
  54 &rarr; Group resource
  55
  56 <pre>
  57 PUT https://{{ site.arvados_api_host }}/arvados/v1/groups/xyzzy-ldvyl-vyydjeplwaa6emg
  58 group[uuid]=xyzzy-ldvyl-vyydjeplwaa6emg
  59 group[name]=Important group
  60 </pre>
  61
  62 &rarr; Group resource
  63
  64 More appropriate (but not yet implemented):
  65
  66 <pre>
  67 PATCH https://{{ site.arvados_api_host }}/arvados/v1/groups/xyzzy-ldvyl-vyydjeplwaa6emg
  68 group={"uuid":"xyzzy-ldvyl-vyydjeplwaa6emg", "name":"Important group"}
  69 </pre>
  70
  71 &rarr; Group resource