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. Show
  48
  49 <pre>
  50 GET https://{{ site.arvados_api_host }}/arvados/v1/groups/xyzzy-ldvyl-vyydjeplwaa6emg
  51 </pre>
  52
  53 &rarr; Group resource
  54
  55 h2. Update
  56
  57 <pre>
  58 PUT https://{{ site.arvados_api_host }}/arvados/v1/groups/xyzzy-ldvyl-vyydjeplwaa6emg
  59 group={"uuid":"xyzzy-ldvyl-vyydjeplwaa6emg", "name":"Important group"}
  60 </pre>
  61
  62 &rarr; Group resource
  63
  64 <pre>
  65 PUT https://{{ site.arvados_api_host }}/arvados/v1/groups/xyzzy-ldvyl-vyydjeplwaa6emg
  66 group[uuid]=xyzzy-ldvyl-vyydjeplwaa6emg
  67 group[name]=Important group
  68 </pre>
  69
  70 &rarr; Group resource
  71
  72 More appropriate (but not yet implemented):
  73
  74 <pre>
  75 PATCH https://{{ site.arvados_api_host }}/arvados/v1/groups/xyzzy-ldvyl-vyydjeplwaa6emg
  76 group={"uuid":"xyzzy-ldvyl-vyydjeplwaa6emg", "name":"Important group"}
  77 </pre>
  78
  79 &rarr; Group resource