This section explains the following REST operations regarding the associations of resource which have been secured with OAuth 2.0.
- Get all the associations on a resource.
- Get an association of specific type on a given resource.
- Add the associations to a resource
- Delete an association on a given resource
Since the current Registry REST API did not implement the pagination right now, If the user specifies any value other than 0 for the pagestart or pageend in the REST requests will throw HTTP 404 error code. Even though the user omits the pagestart and pageend parameters to be passed with URL , the request will work with the current REST API. Pagination support to REST API will be adapted soon.
Get all the associations on a resource
HTTP Method : GET
Request URI : http://<ip address>:<port>/restapi/associations?path=/_system/A&pagestart=0&pageend=0
HTTP Request Header : Authorization: Bearer <OAuth access token>
Response : it retrieves all the associations posted on the specific resource.
Response Type : JSON
Get an association of specific type on a given resource
HTTP Method : GET
Request URI : http://<ip address>:<port>/restapi/property?path=<resource path>&name=<property name>
HTTP Request Header : Authorization: Bearer <OAuth access token>
Response : it retrieves the specific property associated with the given property name.
Response Type : JSON
Add properties to a resource
HTTP Method : POST
Request URI : http://<ip address>:<port>/restapi/property?path=<resource path>
HTTP Request Headers : Authorization: Bearer <OAuth access token>
: Content-Type: application/json
Payload : [ {"name":"<property name>","value":[<array of values>] }]
Response : it retrieves all the properties with the added one for the given resource.
Response Type : JSON
Update properties on a given resource
HTTP Method : PUT
Request URI : http://<ip address>:<port>/restapi/property?path=<resource path>
HTTP Request Headers : Authorization: Bearer <OAuth access token>
: Content-Type: application/json
Payload : [ {"name":"<property name>","value":[<array of updated values>] }]
Response : it retrieves all the properties including the updated one for the given resource. The property is updated with the array of updated values
Response Type : JSON
Delete a property on a given resource
HTTP Method : DELETE
Request URI :http://<ip address>:<port>/restapi/property?path=<resource path>&name=<property name>
HTTP Request Headers : Authorization: Bearer <OAuth access token>
Response : it retrieves rest of the properties for the given resource after deletion.
Response Type : JSON
Please note the following points for the above requests.
- ip address - IP address at which Governance Registry is running
- port - HTTP port number at the Governance Registry is up
- resource path - Path of the resource
- OAuth access token - Authorized access token per user for an hour by default.
- property name - name of the property on the given resource
- array of values - eg: ["val1","val2","val3",......]
- restapi - name of the War file for the REST API resides at {Greg_home}/repository/deployment/server/jaxwebapps/.
If the user renamed this war file, the new name value will be used instead of restapi.