Groups

Groups are objects that can be used to organize objects within a domain. Groups contain links which can reference other objects (datasets, groups or committed datatypes). There are four different types of links that can be used:

  • hard: A direct link to a group, dataset, or committed datatype object in the domain.
  • soft: A symbolic link that gives a path to an object within the domain (object may or may not be present).
  • external: A symbolic link to an object that is external to the domain.
  • user-defined: A user-defined link (this implementation only provides title and class for user-defined links).

Groups all have attributes which can be used to store meta-data about the group.

Creating Groups

Use the POST Group operation to create new Groups. Initially the new group will have no links and no attributes.

Getting information about Groups

Use GET Group to get information about a group such as the attribute count, link count and creation and modification times.

To retrieve the UUIDs of all the groups in a domain, use GET Groups.

To retrieve the links of a group use GET Links. Use GET Link to get information about a specific link.

To get a group’s attributes, use GET Attributes.

Deleting Groups

Use DELETE Group to remove a group. All attributes and links of the group will be deleted.

Note: deleting a group will not delete any objects (datasets or other groups) that the the group’s links point to. These objects may become anonymous, i.e. they are not referenced by any link, but can still be accessed via a GET request with the object UUID.