Projects can be accessed through this API using the GET service.
Source Control Management System | JSON String Representation |
---|---|
ClearCase Unified Control Management | "CCUCM" |
Concurrent Version System | "CVS" |
Git | "GIT" |
File System | "FILE" |
Perforce | "PERF" |
Polytron Version Control System | "PVCS" |
Subversion | "SVN" |
Team Foundation Version Control | "TFVC" |
Project Type | JSON String Representation |
---|---|
General | "GENERAL" |
Managed File Transfer | "MFT" |
Partial File | "PARTIAL_FILE" |
Oracle Forms | "OracleForms" |
Oracle Database | "ORACLE_DB" |
Oracle Business Intelligence | "ORACLE_BI" |
Sales Force | "SALESFORCE" |
Utility | "UTILITY" |
Generic | "GENERIC" |
Priority Scope Types | JSON String Representation |
---|---|
Application | "Application" |
Folder | "Folder" |
Global | "Global" |
There are two implementations of GET. One will find a Project with the given Id and return the JSON representation of the Project. The other will find a list of Projects matching the parameters supplied to it.
This GET service will find a Project by Id and return a JSON representation of it.
http://host:port/flexdeploy/rest/v1/project/{id} |
Parameter | Required | Type | Description |
---|---|---|---|
id | Yes | URL | This is a URL path parameter for the id which is used to find a project. |
HTTP Code | Description |
---|---|
200 | Projects were found and returned |
400 | Bad request |
401 | Unauthorized |
500 | Unexpected internal server error |
If we had a Project in our database with the name 'Project1' with the following attributes:
{ "priority": 1, "projectName": "Project1", "description": "Our thoughts become our words. Our words become our actions.", "applicationId": 10001, "priorityScope": "Application", "partialDeployment": false, "isActive": true, "scmType": "NONE", "streams": [ 10802, 10803, 10804, 10805 ], "deployWorkflowId": 10873, "deployInstanceIds": [ 11153, 11168, 11183, 11198, 11213, 11228, 11243 ], "buildWorkflowId": 10869, "buildInstanceId": 11153, "projectType": null } |
When we run a GET request at the following URL:
http://host:port/flexdeploy/rest/v1/project/10002
The GET request would return the following JSON project object
{ "priority": 1, "projectName": "Project1", "description": "Our thoughts become our words. Our words become our actions.", "applicationId": 10001, "priorityScope": "Application", "partialDeployment": false, "isActive": true, "scmType": "NONE", "streams": [ 10802, 10803, 10804, 10805 ], "utilityWorkflowId": 11434, "utilityInstanceIds": [11275], "deployWorkflowId": 10873, "deployInstanceIds": [ 11153, 11168, 11183, 11198, 11213, 11228, 11243 ], "buildWorkflowId": 10869, "buildInstanceId": 11153, "projectType": null } |
This GET service will find a project by querying based on a name and application id and return the JSON representations of the objects. If no query parameters are given this request will return the entire list of projects.
http://host:port/flexdeploy/rest/v1/project? projectName={name} applicationId={applicationid} folderPath={folderPath} folderPath Format
Examples:
|
The query parameters are not case sensitive. Searching by projectName=NAME is the same as searching by projectName=name. |
Parameter | Required | Type | Description |
---|---|---|---|
projectName | No | URL(query) | This is a URL query parameter for the name which is used to query the projects with. |
applicationId | No | URL(query) | This is a URL query parameter for application id which is used to query the projects within an application. |
folderPath | No | URL(query) | This is a URL query parameter which specified the path of the desired folders (and optionally the application, but not the project name) |
HTTP Code | Description |
---|---|
200 | Projects were found and returned |
400 | Bad request |
401 | Unauthorized |
500 | Unexpected internal server error |
If we had Projects in our database with the names 'Project1' and 'Project2' and the following attributes:
{ "priority": 1, "projectName": "Project1", "description": "Our thoughts become our words. Our words become our actions.", "applicationId": 10001, "priorityScope": "Application", "partialDeployment": false, "isActive": true, "scmType": "NONE", "streams": [ 10802, 10803, 10804, 10805 ], "utilityWorkflowId": 11434, "utilityInstanceIds": [11275], "deployWorkflowId": 10873, "deployInstanceIds": [ 11153, 11168, 11183, 11198, 11213, 11228, 11243 ], "buildWorkflowId": 10869, "buildInstanceId": 11153, "projectType": null } |
{ "priority": 1, "description": "No Permissions", "applicationId": 10001, "isActive": true, "scmType": "SVN", "projectType": null, "projectName": "Project2", "streams": [], "priorityScope": "Application", "partialDeployment": false, "utilityWorkflowId": null, "utilityInstanceIds": null, "deployWorkflowId": null, "buildWorkflowId": null, "deployInstanceIds": null, "buildInstanceId": null } |
When we run a GET request at the following URL
http://host:port/flexdeploy/rest/v1/project?applicationId=10001
The GET request would return the following JSON workflow object
[ { "priority": 1, "projectName": "Project1", "description": "Our thoughts become our words. Our words become our actions.", "applicationId": 10001, "priorityScope": "Application", "partialDeployment": false, "isActive": true, "scmType": "NONE", "streams": [ 10802, 10803, 10804, 10805 ], "utilityWorkflowId": 11434, "utilityInstanceIds": [11275], "deployWorkflowId": 10873, "deployInstanceIds": [ 11153, 11168, 11183, 11198, 11213, 11228, 11243 ], "buildWorkflowId": 10869, "buildInstanceId": 11153, "projectType": null }, { "priority": 1, "description": "No Permissions", "applicationId": 10001, "isActive": true, "scmType": "SVN", "projectType": null, "projectName": "Project2", "streams": [], "priorityScope": "Application", "partialDeployment": false, "utilityWorkflowId": null, "utilityInstanceIds": null, "deployWorkflowId": null, "buildWorkflowId": null, "deployInstanceIds": null, "buildInstanceId": null } ] |
This POST service will perform the same action found on the Execute Utility Project Request Form off the project screen. It will initiate a request to execute the project with the Project ID specified in the URL. The service will return the workflowRequestId
which can be used by the getWorkflowRequestStatus
call to determine when the workflow is complete.
http://host:port/flexdeploy/rest/v1/project/{id}/execute |
Parameter | Required | Type | Description |
---|---|---|---|
id | Yes | URL | This is a URL path parameter for the id which is used to execute a project. |
Attributes | Required | Type | Description |
---|---|---|---|
environmentId | Y | Long | The Id of the Environment the project should be executed in. |
instanceIds | N | List<Long> | A list of Instance Ids that the project should be executed on. If not supplied, the project will execute on the instances that are associated to the utility project. |
exceptionToWindow | N | Boolean | Values are true or false. Indicates that the deployment is an exception to the deployment window. Defaults to false. |
startTime | N | DateTime | The time when the deployment will be started. The expected time format is: |
workflowVersionOverride | N | String | Optionally, specify a workflow version to override the active workflow version. |
inputs | N | Array | This is a list of |
flexFields | N | Array | This is a list of the |
HTTP Code | Description |
---|---|
201 | Project was found and executed |
400 | Bad request |
401 | Unauthorized |
500 | Unexpected internal server error |
We can execute a Utility Project with Id 10004 with this request:
URL: http://host:port/flexdeploy/rest/v1/project/10004/execute
{ "environmentId":10045, "instanceIds":[10044], "exceptionToWindow":false, "startTime":"2018-07-20T11:31:06Z", "workflowVersionOverride":"1.0", "inputs":[ {"code":"INPUT1","value":"Test"}, {"code":"INPUT2","value":"1234"} ], "flexFields":[ {"code":"FLEXFIELD1","value":"123"}, {"code":"FLEXFIELD2","value":"abc"} ] } |
In response, we will receive the workflowRequestId:
10001 |