- style
deployProject
This service will perform the same action found on the "Deployment Request Form" off the project screen. It will initiate a request to deploy the project selected in the qualifiedProjectName
. The service will return the workflowRequestId
which can be used by the getWorkflowRequestStatus
call to determine when the workflow is complete.
API URL
http://host:port/flexdeploy/rest/workflow/deployProject
{ "authentication": { "password":"fdadmin", "userId": "password1" }, "environmentCode":"DEV", "exceptionToWindow":"true", "forceDeploy": "true", "instanceCodes":["soa1","soa2"], "projectVersion": "1.2", "qualifiedProjectName":"/FlexDeploy/folder1/myApp/SimpleProj", "startTime":"2015-03-16T21:17:52-06:00", "workflowVersionOverride":"1.8", "inputs": [ { "name":"input1","value": "xyz" }, { "name":"inp2","value": "123" }], "flexFields": [ { "name": "Change","value":"101012" }, { "name": "field2","value":"123" }] }
Parameters
Parameter | Required | Type | Description |
---|---|---|---|
Authentication | Y |
| See Common Parameters. |
environmentCode | Y | String | This is the environment code, not the environment name that you see on most screens. |
exceptionToWindow |
| Boolean | Values are true or false. Indicates that the deployment is an exception to the deployment window. |
forceDeploy |
| Boolean | Values are true or false. Indicates that the deployment should occur even when the projectVersion is already deployed to that instance. |
instanceCodes | Y |
| See Common Parameters. |
projectVersion |
| String | The projectVersion to be deployed. If not specified, the most recently built projectVersion will be deployed. |
qualifiedProjectName | Y | String | The qualified project name starts with /FlexDeploy and includes any sub folder, then the application and finally the project. |
StartTime |
| DateTime | The time when the deployment will be started. |
WorkflowVersionOverride |
| String | Optionally, the version of the workflow can be overridden. |
inputs |
|
| See Common Parameters. |
flexFields |
|
| See Common Parameters. |
Authentication
The authentication parameter is comprised of 2 fields.
- userId – a valid user id for FlexDeploy
- password – the associated password
Inputs
This is a list of name/value pairs for the inputs. Not all inputs need to be supplied. If an input has a default value that is acceptable for the workflow to run, it does not need to be changed.
Flex Fields
Applicable only for deployProject and deployApplication. This is a list of name (Display Name of FlexField)/value pairs for the FlexFields. Not all FlexFields need to be supplied. If a flex field has a default value or options that are acceptable for the workflow to run, it does not need to be changed.
InstanceCodes
The list of instances where the deployment will occur.
- style