...
| Attributes | Type | Description |
|---|
| action | String | - createSnapshot
- promoteToRelease - one and only one snapshotVersionInputs should be provided
|
| description | String | The description of the snapshot |
| projectssnapshotVersionInputs | List<Project>List<SnapshotVersionInputPojo> | A list of projects project version to be built or associated with the snapshot. |
Projects have the SnapshotVersionInput has following attributes:
| Attributes | Type | Description |
|---|
| projectId | Long | The id of the project |
| projectVersionId | Long | The version id of the project |
| packageName | String | The name of the package (used for partial deployment projects only) |
| buildEnvironmentId | Long | The build environment associated with the project |
| forceBuild | Boolean | Whether or not the project should be force built |
...
| Attributes | Type | Description |
|---|
snapshotId | Long | The id of the snapshot |
| snapshotName | String | The name of the snapshot, which is the time when the snapshot was created |
| snapshotStatus | String | The status of the snapshot |
| description | String | The description of the snapshot |
| snapshotVersions | List<Version>List<SnapshotVersionPojo> | The version information about the projects associated with the snapshot |
Versions have the SnapshotVersion has following attributes:
| Attributes | Type | Description |
|---|
| projectId | Long | The id of the project |
| projectStreamId | Long | Stream included in release for the project. |
| projectVersionId | Long | The version id of the project |
| packageName | String | The name of the package (used for partial deployment projects only) |
| requestAllFiles | Boolean | Whether or not the project was told to request all files |
| snapshotVersionStatus | String | The current status of the snapshot |
Back to Top
...
POST (create snapshot)
This POST service will create a new snapshot with the same attributes as the given JSON object.
...
| Code Block |
|---|
| theme | Eclipse |
|---|
| title | POST JSON |
|---|
|
{
"snapshotId": 10005,
"snapshotName": "07-09-2018 12:12:03",
"description": "example snapshot creation",
"snapshotStatus": "PENDING",
"projects": [
{
"projectId": 10000,
"packageName": "package1",
"projectVersionId": 10001,
"requestAllFiles": false,
"snapshotVersionStatus": "PENDING"
},
{
"projectId": 10000,
"packageName": "package2",
"projectVersionId": null,
"requestAllFiles": false,
"snapshotVersionStatus": "PENDING"
},
{
"projectId": 10002,
"packageName": null,
"projectVersionId": null,
"requestAllFiles": false,
"snapshotVersionStatus": "PENDING"
}
} |
Back to Top
POST (promote to release)
Project versions can be promoted to a release through this POST service. Promoting a project to release will combine the specified version of the specified project with the versions of the other projects used in the last snapshot into a new snapshot.
| Info |
|---|
| title | URL for promoting a project version to a release |
|---|
|
http://host:port/flexdeploy/rest/release/{releaseId}/snapshot |
Promoting a project version to a release has the following parameters
| Attributes | Type | Required | Description |
|---|
| projectId | URL | Yes | The id of the project |
| projectVersionId | URL | Yes | The id of the version of the project |
| releaseId | Integer | Yes | The id of the release |
| description | String | No | The description of the snapshot that will be made |
| packageName | String | Only for partial deployment projects | The name of the package of the partial deployment project |
If the previous snapshot had the following attributes:
| Code Block |
|---|
| theme | Eclipse |
|---|
| title | Current Snapshot Details |
|---|
|
{
"snapshotId": 10005,
"snapshotName": "07-09-2018 12:12:03",
"description": "Existing Snapshot",
"snapshotStatus": "CURRENT",
"projects": [
{
"projectId": 10000,
"packageName": "package1",
"projectVersionId": 10100,
"requestAllFiles": false,
"snapshotVersionStatus": "EXISTING"
},
{
"projectId": 10000,
"packageName": "package2",
"projectVersionId": 10010,
"requestAllFiles": false,
"snapshotVersionStatus": "EXISTING"
},
{
"projectId": 10002,
"packageName": null,
"projectVersionId": 10050,
"requestAllFiles": false,
"snapshotVersionStatus": "EXISTING"
}
} |
And a POST request was sent to http://host:port/flexdeploy/rest/project/promote/10000/11001 with the following JSON object input:
| Code Block |
|---|
| theme | Eclipse |
|---|
| title | POST JSON |
|---|
|
{
"releaseId": 13000,
"packageName": "package1"
} |
The following Snapshot JSON object will begin:
| Code Block |
|---|
| theme | Eclipse |
|---|
| title | Response JSON |
|---|
|
{
"snapshotId": 12010,
"snapshotName": "07-09-2018 12:12:03",
"description": "example snapshot creation",
"snapshotStatus": "PENDING",
"projects": [
{
"projectId": 10000,
"packageName": "package1",
"projectVersionId": 11001,
"requestAllFiles": false,
"snapshotVersionStatus": "EXISTING"
},
{
"projectId": 10000,
"packageName": "package2",
"projectVersionId": 10010,
"requestAllFiles": false,
"snapshotVersionStatus": "EXISTING"
},
{
"projectId": 10002,
"packageName": null,
"projectVersionId": 11001,
"requestAllFiles": false,
"snapshotVersionStatus": "EXISTING"
}
} |
Back to Top