Plugins can be accessed through this API using GET. This service retrieves information about plugins.
This GET service will return a list of plugins in the form of JSON objects based on a query parameter for the display name. Plugins are only returned if they contain the specified parameter. If no query parameters are given this request will return the entire list of plugins. Plugins are returned in descending order by Install Date.
http://host:port/flexdeploy/rest/v1/administration/plugins Append the following character sequences to the above URL to specify Query parameters.?pluginDisplayName={pluginDisplayName} Examples:To return all of the plugins:http://host:port/flexdeploy/rest/v1/administration/plugins To search by display name only:http://host:port/flexdeploy/rest/v1/administration/plugins?pluginDisplayName={pluginDisplayName} |
The query parameters are not case sensitive. Searching by name=EXAMPLE is the same as searching by name=example. |
Parameter | Type | Required | Description |
---|---|---|---|
pluginDisplayName | Query - String | No | This is a URL query parameter for the display name which is used to search the plugins. Contains ignore case type 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 |
If we had a plugin in our database with the following attributes
[ { "isActive": true, "pluginId": 10705, "pluginName": "FlexagonJDBCPlugin", "pluginDisplayName": "JDBC", "pluginVersion": "4.5.1.38", "description": "A plugin to import, export, and run scripts.", "vendorName": "Flexagon", "pluginGroup": "Database", "pluginSubGroup": "JDBC", "pluginType": "java", "imageName": null, "isVersionCurrentlyActive": true, "operations": [ { "export", "import", "partialBuild", "partialDeploy", "runPLSQL", "runQuery", "runScript" } ] } ] |
When we run a GET request at the following URL
http://host:port/flexdeploy/rest/v1/administration/plugins?pluginDisplayName=JDBC
The GET request would return the following JSON plugin object
[ { "isActive": true, "pluginId": 10705, "pluginName": "FlexagonJDBCPlugin", "pluginDisplayName": "JDBC", "pluginVersion": "4.5.1.38", "description": "A plugin to import, export, and run scripts.", "vendorName": "Flexagon", "pluginGroup": "Database", "pluginSubGroup": "JDBC", "pluginType": "java", "imageName": null, "isVersionCurrentlyActive": true, "operations": [ { "export", "import", "partialBuild", "partialDeploy", "runPLSQL", "runQuery", "runScript" } ] } ] |