Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This section explains the following REST operations regarding the associations / association of the resource which have been secured with OAuth 2.0.

...

Note

The following terms explain the meaning of the query parameters passed with the following REST URIs.

ParameterExplanation
pathPath of the resource.
OAuth access tokenAuthorized access token per user for an hour by default.
typeType of association. By default, Governance Registry has three types of association. These are usedBy, ownedBy, and other.

Array of values

Array of values for the property e.g.: ["val1","val2","val3",......].
startStart page number.
sizeNumber of associations to be fetched.
targetTarget resource path

...

AttributesValues

HTTP Method                 

GET
Request URI/associations?path={ resource path }&type={ association type }
HTTP Request HeaderAuthorization: Bearer {OAuth access token}

Description

It retrieves all the associations for the specific type on of the given resource
ResponseHTTP 200 OK
Response TypeJSONapplication/json

Add Associations to a Resource

AttributesValues

HTTP Method                 

POST
Request URI/association?path={resource path}
HTTP Request Header

Authorization: Bearer {OAuth access token}

Content-Type: application/json

Payload[{ "type":"<type of the association>","target":"<valid resource path>"}] 

Description

It adds the array of associations passed as the payload for the source resource
ResponseHTTP 204 No Content.
Response TypeJSONapplication/json

Delete

...

Associations on a Given Resource

AttributesValues

HTTP Method                 

DELETE
Request URI/association?path={resource path}
Payload[{ "type":"<type of the association>","target":"<valid resource path>"}] 
HTTP Request HeaderAuthorization: Bearer {OAuth access token}

Description

It deletes the association between the source and target resources for the given association type.
ResponseHTTP 204 No Content.
Response TypeJSONapplication/json