This POST 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 specified with the project Id. The service will return the workflowRequestId which return workflow request. Workflow request id from return data can be used by the getWorkflowRequestStatus call with Workflow Request API to determine when the workflow execution is complete.
| Info | ||
|---|---|---|
| ||
http://host:port/flexdeploy/rest/v1/project/{Id}/deploy |
...
| Parameter | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| environmentId | Y | Long | This is the environment id, not the environment name that is seen on most screens. | ||||
| instanceIds | N | Array of Long | The list of instances where the deployment will occur. Make sure to enter the instance id, not the instance name that is seen on most screens. If not provided, all deploy instances configured for Project will be used for deployment. | ||||
| projectId | Y | Long | The Id of the project to deploy. | packageDetails | N* | Array of PackageInfoThis is required for partial deployments, but not for full deployments. Included to indicate what should be deployed in a partial deployment. See more info on PackageInfo below. | |
| forceDeploy | N | Boolean | Values are true or false. Indicates that the deployment should occur even when the projectVersionId is already deployed to that instance. Defaults to false. | ||||
| exceptionToWindow | N | Boolean | Values are true or false. Indicates that the deployment is an exception to the deployment window. Defaults to false. | ||||
| projectVersionId | NY | Long | The id of the project version to be deployed. If not specified, the most recently built projectVersionId will be deployed. | ||||
| startTime | N | String | The time when the deployment will be started. Format should yyyy-MM-dd'T'HH:mm:ssXXX. For example, 2019-03-16T21:17:52-06:00 | ||||
| workflowVersionOverride | N | String | Optionally, the version of the workflow can be overridden. | ||||
| inputs | N | Array | See Common Parameters below. | ||||
| flexFields | N | Array | See Common Parameters below. | ||||
| changeTickets | N | Array of String | Ticket number for the given deployment, using the configured Change Management System. |
...
| Attribute | Required | Type | Description |
|---|---|---|---|
| code | Y | String | The code of the FlexField |
| value | N | String | The value of the FlexField |
PackageInfo
| Attribute | Required | Type | Description |
|---|---|---|---|
| packageName | N | String | The name of the package to deploy. If blank, all files will be assumed. |
| priority | N | Integer | The priority of the package. If it is not indicated, then FlexDeploy will deploy the packages in the order they are provided in the JSON request. |
| projectVersionId | Y* | Long | The id of the project version to deploy. This parameter is not required if useLatestPackageVersion is true. |
| useLatestPackageVersion | N | Boolean | Uses the most recent package version. Defaults to false. |
Response
| Attribute | Type | Description |
|---|---|---|
| warningMessage | String | Indicates any warning message in the event where the request was successful but no new deployment was initiated. For example: Project Version is already deployed and force deploy wasn't specified |
| warningCode | String | Matching warning code for the warning message. |
| workflowRequests | Array | Array of workflow request objects |
Response Codes
| HTTP Code | Description |
|---|---|
| 200 | Project version already deployed |
| 201 | Deploy request initiated successfully |
| 400 | Bad request |
| 401 |
| Authentication failure | |
| 403 | Authorization failure (no access to resource) |
| 404 | Project not found |
| 500 | Unexpected internal server error |
Example Deploy Request
We can deploy a project with
...
Id 6298858 with the following request:
Example 1:
| Info | ||
|---|---|---|
| ||
http://host:port/flexdeploy/rest/v1/project/100046298858/deploy |
We send request by this payload:
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"instanceIds" : [1000013535],
"environmentId" :12345 418564,
"forceDeploy":"false",
"inputs":
[
{
"code":"RESTART_SEVER",
"value":"true"
},
{
"code":"COMMENT",
"value":"Deploying from REST API"
}
] "forceDeploy" : "true",
"projectVersionId" : 11053771
} |
In response, we will receive an array of workflowRequests:
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"warningMessageisException": nullfalse,
"warningCoderequestedStartTime": null,
"workflowRequestspredeployRequestedStartTime": [null,
"stopOnPkgError": false,
{ "groupRequestId": null,
"requestStatus": "READY",
"packageNamedeploymentStrategy": null,
"oldWeight": null,
"folderNamenewWeight": "Human Resources"null,
"routeRule": null,
"releaseSnapshotIdfinishDeployment": null,
"instances": [
"workflowRequestStatus": "READY", {
"folderIdinstanceCode": 10001"EBS2",
"exceptionToWindowcreatedOn": falsenull,
"releaseDefinitionIdcreatedBy": null,
"cmsissuesinstanceId": ""3535,
"workflowRequestId": 12001,208087
}
],
"projectNameprojectWorkflowId": 6298861,
"ProcessHRRequestpredeployWorkflowExecId": null,
"flexField1": null,
"projectStreamIdflexField3": 10502null,
"flexField4": null,
"projectVersionNameflexField2": "1.0.8"null,
"flexField5": null,
"requestAllFilesflexField6": falsenull,
"flexField7": null,
"projectVersionIdflexField8": 29201null,
"flexField9": null,
"environmentIdflexField10": 11210null,
"allFilesRequested": false,
"folderRequestIdworkflowVersionOverride": null,
"force": true,
"flexFieldscreatedOn": []"2023-01-24T15:40:10.296+0000",
"createdBy": "fdadmin",
"folderPathupdatedOn": "FlexDeploy/Human Resources2023-01-24T15:40:10.517+0000",
"updatedBy": "fdadmin",
"projectIdversionNumber": 105012,
"pipelineStageStepExecId": null,
"requestedBypipelineStageExecId": "fdadmin"null,
"relDefinitionId": null,
"requestedStartTimerelSnapshotId": null,
"triggerType": "MANUAL",
"folderId": 943036,
"forceworkflowRequestId": true208087,
"projectId": 6298858,
"stopOnPackageErrorenvironmentId": null418564,
"inputs": [],
"workflowOverrideVersionprojectStreamId": null6298859,
"projectVersionId": 11053771,
"folderVersionIdworkflowId": null481140,
"workflowType": "DEPLOY",
} ]"priority": 1
} |