Project Properties can be accessed and modified through this API using three services: GET,PUT, and PATCH. These three services allow for the retrieval, complete update, and partial update of Project Properties.
There is one implementation which will find a list of Project Properties associated with the URL specified Project and return the JSON representation of the list of Project Properties.
This GET service will find list of Project Properties associated with the given Project and return the JSON representation of the list.
http://host:port/flexdeploy/rest/v1/project/{projectid}/property |
Parameter | Type | Required | Description |
---|---|---|---|
projectid | URL | Yes | This is a URL parameter for the Project Id which is searched to find and return the Properties associated with it. |
HTTP Code | Description |
---|---|
200 | Project was found and its properties returned |
400 | Bad request |
401 | Authentication failure |
403 | Authorization failure (no access to resource) |
404 | Project was not found with the specified project id |
500 | Unexpected internal server error |
If we had a Project in our database with an Id of 11101 and we run a GET request at the following URL: http://host:port/flexdeploy/rest/v1/project/11101
The GET request would return the following JSON Project Property list
[ { "propertyName": "FD_PARTIAL_FILE_EXCLUDES", "propertyValue": "java", "credentialId": null, "isExpression": false }, { "propertyName": "FD_PARTIAL_FILE_INCLUDES", "propertyValue": "sql", "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_PROPERTY_REPLACEMENT_DEFAULT", "propertyValue": "true", "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_RETRY_COUNT_DEFAULT", "propertyValue": 5, "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_SQL_EXTENSIONS", "propertyValue": "seq,tbl,idx,typ,tps,tpb,sql,pkh,plb,pks,pkb,pls,pck,fnc,trg,spc,bdy,prc", "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_SQL_ROOT_TARGET_FOLDER", "propertyValue": "/sql", "credentialId": null, "isExpression": false }, { "propertyName": "JDBC_ALTERNATE_SCHEMA_PASS", "propertyValue": "*****", "credentialId": 49384, "isExpression": false } ] |
This PUT service will update the propertyValue of each property in the project associated with the Project id specified in the URL.
http://host:port/flexdeploy/rest/v1/project/{projectid}/property |
Attributes | Type | Required | Description |
---|---|---|---|
projectid | URL | Yes | This is the Id of the Project which will have it's Properties updated. |
properties | List<PropertyValuePojo> | Yes | This is the list of properties being set for the project. Attributes for a property object are described below |
Attributes | Type | Required | Description |
---|---|---|---|
propertyName | String | Yes | This is the key name of the property |
propertyValue | String | No | This is the value that the property with the associated propertyName will be updated to |
credentialId | Long | No | The id of the credential associated to this property. Applicable only for encrypted properties |
isExpression | Boolean | No | Is the propertyValue a groovy expression? @Since 5.3.0.1 |
All unlisted properties for the project will default to null for PUT requests. |
HTTP Code | Description |
---|---|
200 | Project was found and its Properties were updated |
400 | Bad request |
401 | Authentication failure |
403 | Authorization failure (no access to resource) |
404 | Project not found |
500 | Unexpected internal server error |
If we had an Project in our database with a Project Id of 25262 and the following Properties
[ { "propertyName": "FD_PARTIAL_FILE_EXCLUDES", "propertyValue": "java", "credentialId": null, "isExpression": false }, { "propertyName": "FD_PARTIAL_FILE_INCLUDES", "propertyValue": "", "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_PROPERTY_REPLACEMENT_DEFAULT", "propertyValue": "true", "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_RETRY_COUNT_DEFAULT", "propertyValue": 5, "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_SQL_EXTENSIONS", "propertyValue": "seq,tbl,idx,typ,tps,tpb,sql,pkh,plb,pks,pkb,pls,pck,fnc,trg,spc,bdy,prc", "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_SQL_ROOT_TARGET_FOLDER", "propertyValue": "/sql", "credentialId": null, "isExpression": false }, { "propertyName": "JDBC_ALTERNATE_SCHEMA_PASS", "propertyValue": "*****", "credentialId": 49384, "isExpression": false } ] |
When we run a PUT request at the following URL: http://host:port/flexdeploy/rest/v1/project/25262
And the PUT request receives the following JSON Project Properties list
[ { "propertyName": "FD_PARTIAL_FILE_EXCLUDES", "propertyValue": "java", "credentialId": null, "isExpression": false }, { "propertyName": "FD_PARTIAL_FILE_INCLUDES", "propertyValue": "sql", "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_PROPERTY_REPLACEMENT_DEFAULT", "propertyValue": "true", "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_RETRY_COUNT_DEFAULT", "propertyValue": 5, "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_SQL_EXTENSIONS", "propertyValue": "seq,tbl,idx,typ,tps,tpb,sql,pkh,plb,pks,pkb,pls,pck,fnc,trg,spc,bdy,prc", "credentialId": null, "isExpression": false }, { "propertyName": "JDBC_ALTERNATE_SCHEMA_PASS", "propertyValue": "", "credentialId": 71422, "isExpression": false } ] |
The PUT request would then update the Project Properties of the Project with Id 25262 and return the following JSON Project Properties list.
[ { "propertyName": "FD_PARTIAL_FILE_EXCLUDES", "propertyValue": "java", "credentialId": null, "isExpression": false }, { "propertyName": "FD_PARTIAL_FILE_INCLUDES", "propertyValue": "sql", "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_PROPERTY_REPLACEMENT_DEFAULT", "propertyValue": "true", "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_RETRY_COUNT_DEFAULT", "propertyValue": 5, "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_SQL_EXTENSIONS", "propertyValue": "seq,tbl,idx,typ,tps,tpb,sql,pkh,plb,pks,pkb,pls,pck,fnc,trg,spc,bdy,prc", "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_SQL_ROOT_TARGET_FOLDER", "propertyValue": null, "credentialId": null, "isExpression": false }, { "propertyName": "JDBC_ALTERNATE_SCHEMA_PASS", "propertyValue": "*****", "credentialId": 71422, "isExpression": false } ] |
This PATCH service will update an existing Project's Properties with the information passed through a JSON object. If a property is not listed it will not be updated in the Project.
http://host:port/flexdeploy/rest/v1/project/{projectid}/property |
Attributes | Type | Required | Description |
---|---|---|---|
projectId | URL | Yes | This is the Id of the Project which will have it's Properties updated. |
properties | List<PropertyValuePojo> | Yes | This is the list of properties being set for the project. Attributes for a property object are described below |
Attributes | Type | Required | Description |
---|---|---|---|
propertyName | String | Yes | This is the key name of the property |
propertyValue | String | No | This is the value that the property with the associated propertyName will be updated to |
credentialId | Long | No | The id of the credential associated to this property. Applicable only for encrypted properties |
isExpression | Boolean | No | Is the propertyValue a groovy expression? @Since 5.3.0.1 |
HTTP Code | Description |
---|---|
200 | Project was found and its Properties were updated |
400 | Bad request |
401 | Authentication failure |
403 | Authorization failure (no access to resource) |
404 | Project not found |
500 | Unexpected internal server error |
If we had a Project in our database with an Id of 12723 and had the following attributes
[ { "propertyName": "FD_PARTIAL_FILE_EXCLUDES", "propertyValue": "java", "credentialId": null, "isExpression": false }, { "propertyName": "FD_PARTIAL_FILE_INCLUDES", "propertyValue": "sql", "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_PROPERTY_REPLACEMENT_DEFAULT", "propertyValue": "true", "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_RETRY_COUNT_DEFAULT", "propertyValue": 5, "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_SQL_EXTENSIONS", "propertyValue": "seq,tbl,idx,typ,tps,tpb,sql,pkh,plb,pks,pkb,pls,pck,fnc,trg,spc,bdy,prc", "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_SQL_ROOT_TARGET_FOLDER", "propertyValue": null, "credentialId": null, "isExpression": false }, { "propertyName": "JDBC_ALTERNATE_SCHEMA_PASS", "propertyValue": "*****", "credentialId": 71422, "isExpression": false } ] |
When we run a PATCH request at the following URL: http://host:port/flexdeploy/rest/v1/project/12723
And the PATCH request receives the following JSON Project Properties object,
[ { "propertyName": "FD_PARTIAL_FILE_EXCLUDES", "propertyValue": "java", "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_SQL_ROOT_TARGET_FOLDER", "propertyValue": "/targetfolder", "credentialId": null, "isExpression": false }, { "propertyName": "JDBC_ALTERNATE_SCHEMA_PASS", "propertyValue": "", "credentialId": 80855, "isExpression": false } ] |
The PATCH request would then update the specified Project's Properties and return the following JSON object
[ { "propertyName": "FD_PARTIAL_FILE_EXCLUDES", "propertyValue": "java", "credentialId": null, "isExpression": false }, { "propertyName": "FD_PARTIAL_FILE_INCLUDES", "propertyValue": "sql", "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_PROPERTY_REPLACEMENT_DEFAULT", "propertyValue": "true", "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_RETRY_COUNT_DEFAULT", "propertyValue": 5, "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_SQL_EXTENSIONS", "propertyValue": "seq,tbl,idx,typ,tps,tpb,sql,pkh,plb,pks,pkb,pls,pck,fnc,trg,spc,bdy,prc", "credentialId": null, "isExpression": false }, { "propertyName": "FDJDBC_SQL_ROOT_TARGET_FOLDER", "propertyValue": "/targetfolder", "credentialId": null, "isExpression": false }, { "propertyName": "JDBC_ALTERNATE_SCHEMA_PASS", "propertyValue": "*****", "credentialId": 80855, "isExpression": false } ] |