Property Sets can be accessed through this API using service: GET. This service allow for the retrieval of Property Sets.
Authentication - Use Basic Authentication for this API.
There are two implementations of GET. One will find a Property Set with the given Id and return the JSON representation of the Property Set. The other will find a list of Property Sets matching the parameters supplied to it.
This GET service will find a Property Set with the given Id and return the JSON representation of the object.
http://host:port/flexdeploy/rest/v2/administration/propertyset/{Id} |
Parameter | Required | Type | Description |
---|---|---|---|
Id | Yes | URL | URL parameter for the Id which is used to find and return a Property Set |
HTTP Code | Description |
---|---|
200 | Property Set was found and returned |
400 | Bad request |
401 | Authentication failure |
403 | Authorization failure (no access to resource) |
404 | Property Set not found |
500 | Unexpected internal server error |
If we have a Property Set in our database with an Id of 11941 and the following attributes
When we run a GET request at the following URL
http://host:port/flexdeploy/rest/v2/administration/propertyset/11941
The GET request would return the following JSON Property Set object
{ "ownerType": "PLUGIN", "versionNumber": 1, "isActive": true, "propertySetName": "installJDevExtension", "createdOn": "2021-01-28T04:02:08.530+0000", "createdBy": "autoupload", "updatedOn": "2021-01-28T04:02:08.546+0000", "propertySetId": 11941, "updatedBy": "autoupload", "ownerId": 122930, "propertySetKeyDefs": [ { "versionNumber": 1, "createdOn": "2021-01-28T04:02:08.530+0000", "createdBy": "autoupload", "updatedOn": "2021-01-28T04:02:08.546+0000", "propertySetId": 11941, "updatedBy": "autoupload", "propertyDefinitionId": 11937 }, { "versionNumber": 1, "createdOn": "2021-01-28T04:02:08.546+0000", "createdBy": "autoupload", "updatedOn": "2021-01-28T04:02:08.546+0000", "propertySetId": 11941, "updatedBy": "autoupload", "propertyDefinitionId": 11938 } ] } |
This GET service will return a list of Property Sets in the form of JSON objects based on the query parameters propertySetId, propertySetName, ownerType, ownerId and isActive. PropertySets are only returned if they match ALL of the specified query parameters. If no query parameters are given this request will return the entire list of Property Sets. The propertySetName parameter returns Property Sets that contain the specified parameter. The other parameters must be equal to the Property Sets.
http://host:port/flexdeploy/rest/v2/ Append the following character sequences to the above URL to specify Query parameters.Use '&' between successive query parameters:propertySetId={propertySetId} propertySetName={propertySetName} isActive={isActive} ownerType={ownerType} ownerId={ownerId} Examples:To Specify the code parameter only:http://host:port/flexdeploy/rest/v2/administration/propertyset?propertySetId={propertySetId} To Specify the code and group code parameters:http://host:port/flexdeploy/rest/v2/administration To Specify the name, group code, and sub group code parameters:http://host:port/flexdeploy/rest/v2/administration/propertyset?propertySetId={propertySetId}&propertySetName={propertySetName}&ownerType={ownerType} |
The query parameters are not case sensitive. Searching by propertySetName=NAME is the same as searching by propertySetName=name. |
Parameter | Required | Type | Description |
---|---|---|---|
propertySetId | No | Query - Long | This is a URL query parameter for the Property Set Id which is used to search the Property Sets. Equals search |
propertySetName | No | Query - String | This is a URL query parameter for the Property Set Name which is used to search the Property Sets. Like ignore case search |
ownerType | No | Query - String | This is a URL query parameter for the Owner Type which is used to search the Property Sets. Equals ignore case search |
ownerId | No | Query - Long | This is a URL query parameter for the Owner Id which is used to search the Property Sets. Equals search |
isActive | No | Query - Boolean | This is a URL query parameter for the Is Active which is used to search the Property Sets. Equals search |
HTTP Code | Description |
---|---|
200 | Search successful and results returned |
400 | Bad request |
401 | Authentication failure |
403 | Authorization failure (no access to resource) |
500 | Unexpected internal server error |
Output when querying by ownerType through http://host:port/flexdeploy/rest/v2/administration/propertyset?ownerType=TESTING_TOOL
[ { "ownerType": "TESTING_TOOL", "versionNumber": 1, "isActive": true, "propertySetName": "OATS_TESTING_PS", "createdOn": "2021-01-22T04:54:46.023+0000", "createdBy": "autoupload", "updatedOn": "2021-01-22T04:54:46.033+0000", "propertySetId": 10032, "updatedBy": "autoupload", "ownerId": 10004, "propertySetKeyDefs": [ { "versionNumber": 1, "createdOn": "2021-01-22T04:54:46.027+0000", "createdBy": "autoupload", "updatedOn": "2021-01-22T04:54:46.035+0000", "propertySetId": 10032, "updatedBy": "autoupload", "propertyDefinitionId": 10031 } ] }, { "ownerType": "TESTING_TOOL", "versionNumber": 1, "isActive": true, "propertySetName": "SOAPUI_TESTING_PS", "createdOn": "2021-01-22T04:54:46.185+0000", "createdBy": "autoupload", "updatedOn": "2021-01-22T04:54:46.197+0000", "propertySetId": 10041, "updatedBy": "autoupload", "ownerId": 10005, "propertySetKeyDefs": [ { "versionNumber": 1, "createdOn": "2021-01-22T04:54:46.190+0000", "createdBy": "autoupload", "updatedOn": "2021-01-22T04:54:46.198+0000", "propertySetId": 10041, "updatedBy": "autoupload", "propertyDefinitionId": 10040 } ] } ] |