This POST service will perform the same action found on the Release Screen. This service can be is used to create a new releaseFlexDeploy Release, or update an existing one.
@since 5.0.0.4 this API returns the release id, which is a required input for some of the other APIs.
| Info | ||
|---|---|---|
| ||
http://host:port/flexdeploy/rest/release/createOrUpdateRelease |
| Note |
|---|
The authenticated user must be a member of a group which has FlexDeploy Administrator privileges. |
Create New Release Sample JSON Request
| |||||||
|---|---|---|---|---|---|---|---|
| Opening bracket Authentication section, used on all types of requests. | ||||||
Required parameters for creating or editing a release. | |||||||
| Create a release named Demo Release The release is to be in | ||||||
Optionally, include any of this information. Verify that your JSON is valid; check for trailing commas if you don't include this section. | |||||||
| An optional Description of the release Use the An optional list of Projects and Add the Project located at Set the Priority of this project to Build this project in the Put this project in " Add the Project located at Set the Priority of this project to Build this project in the Put this project in Optionally Request All Files when performing a Configure a Change Management System to be used on the release Use the Optionally Override the Default Properties from the Use the Specify whether or not to Require a Change Ticket for Deployment of the release projects. Optionally Override Environment Configurations from the Override settings for the Do not Require a Change Ticket for Deployment to this environment. Override settings for the Require a Change Ticket for Deployment to this environment. | ||||||
} | Closing bracket | ||||||
Parameters
Parameter | Required | Type | Description |
|---|---|---|---|
| Y | Object | The login information for the user connecting to FlexDeploy. |
| Y | String | The name of the release being created or updated. |
| Y | String | An updated status for the release. Can be |
| N | String | A description to give to the release. |
| N | String | The username of the FlexDeploy user to assign as the Primary Manager for this release. |
| N | String | The username of the FlexDeploy user to assign as the Secondary Manager for this release. |
| N | String | The name of a pipeline to associate to this release. |
releaseProjectDetails | N | Array | An array of projects to be associated to the release. |
qualifiedProjectName | Y* | String | The full path within FlexDeploy to a project. |
priority | N | Integer | The deploy priority for this project. |
streamName | N | String | The SCM stream to use when building this project. Defaults to the main stream. |
groupName | N | String | A group on the release to put the project in. |
requestAllFiles | N | Boolean | Should the project use all files? If true, don't specify packageName. If false, specify packageName. |
packageName | N | String | The name of the package to be built and deployed. Required if not using all files. |
releaseCMSDetails | N | Array | An array of CMS properties to be configured on the release. |
instanceCode | Y* | String | The instance code of a valid CMS instance |
overrideDefaultSettings | N | Boolean | Override the CMS instance's configuration. |
overriddenDefaultConfigurations | Y* | Object | An object containing the "Default" properties for CMS on the release. |
requireChangeTicketForDeployment | Y* | Boolean | Set this to true to require a change ticket for all deployments. |
overriddenEnvironmentConfigurations | N | List | A list of environments and properties to override on this release. |
environmentCode | Y* | String | The environment code of a valid instance being used in this release. |
requireChangeTicketForDeployment | Y* | Boolean | Set this to true to require a change ticket for deployments to this environment. |
...