doc/api/schema/Collection.html.textile.liquid

   1 ---
   2 layout: default
   3 navsection: api
   4 navmenu: Schema
   5 title: Collection
   6
   7 ...
   8
   9
  10
  11 This resource concerns metadata, usage accounting, and integrity checks for data stored on the cloud.  Reading and writing the data _per se_ is achieved by the "Keep":{{site.baseurl}}/user/tutorials/tutorial-keep.html storage system.
  12
  13
  14 h2. Methods
  15
  16 See "REST methods for working with Arvados resources":{{site.baseurl}}/api/methods.html
  17
  18 API endpoint base: @https://{{ site.arvados_api_host }}/arvados/v1/links@
  19
  20 h3. Conditions of creating a Collection
  21
  22 The @uuid@ and @manifest_text@ attributes must be provided when creating a Collection. The cryptographic digest of the supplied @manifest_text@ must match the supplied @uuid@.
  23
  24 h3. Side effects of creating a Collection
  25
  26 Referenced data can be protected from garbage collection.
  27
  28 Data can be shared with other users via the Arvados permission model.
  29
  30 Clients can request checks of data integrity and storage redundancy.
  31
  32 h2. Resource
  33
  34 Each collection has, in addition to the usual "attributes of Arvados resources":{{site.baseurl}}/api/resources.html:
  35
  36 table(table table-bordered table-condensed).
  37 |_. Attribute|_. Type|_. Description|_. Example|
  38 |locator|string|||
  39 |portable_data_hash|string|||
  40 |name|string|||
  41 |redundancy|number|||
  42 |redundancy_confirmed_by_client_uuid|string|API client||
  43 |redundancy_confirmed_at|datetime|||
  44 |redundancy_confirmed_as|number|||
  45 |manifest_text|text|||