Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
maxLevel1

POST

...

  • createSnapshot
  • promoteToRelease - one and only one snapshotVersionInputs should be provided

...

SnapshotVersionInput has following attributes:

...

(

...

POST (create snapshot)

This POST service will create a new snapshot with the same attributes as the given JSON object.

Info
titleAPI URL

http://host:port/flexdeploy/rest/releases/{releaseId}/snapshot

Parameters

POST will receive a snapshot input JSON object and return a snapshot JSON object. Snapshot input JSON objects can have the following attributes:

AttributesTypeRequiredDescription
actionStringYes

should be set to createSnapshot for this API.

descriptionStringNoThe description of the snapshot
snapshotVersionInputsList<SnapshotVersionInputPojo>No
  • A list of
snapshot
  • project versions to be built or existing versions to be associated with new snapshot.
  • If you do not provide projectVersionId, build will be initiated.
  • If you do not supply specific project that is configured in release, it will be added for build. projectId and packageName is used to identify if project is configured in Release or not.
  • If you supply projectId and packageName combination that is not part of release, exception will be thrown.
Parameters for each element of snapshotVersionInputs. If not supplied all projects configured in Release will be included.

Elements of snapshotVersionInputs has following attributes:

AttributesTypeRequiredDescription
projectIdLongYesProject associated with release.
projectVersionIdLongNoThe version id of the project. If project version is not supplied new build will be performed.
packageNameString

Yes

*

for partial deploy,

otherwise No

The name of the package (used for partial deployment projects only) associated with release. If Partial deployment project and packageName is not supplied it will be considered all files type version.
projectVersionId
buildEnvironmentIdLongNo
The version id of the project. If project version is not supplied new build will be performed.buildEnvironmentId
LongYes**
The build environment associated with the project. If not supplied and only one environment found for build instance then it will be defaulted.
forceBuildBooleanNoWhether or not the project should be force built. This will be overridden to true for partial deployment project.

* only if it's a partial deployment project

**only if the project has multiple build environments

Response

Snapshot JSON objects can having the following attributes:

...

Info
titleURL for promoting a project version to a release

http://host:port/flexdeploy/rest/releases/{releaseId}/snapshot

Parameters

POST will receive a snapshot input JSON object and return a snapshot JSON object. Snapshot input JSON objects can have the following attributes:

Parameters for each element of snapshotVersionInputs.
AttributesTypeRequiredDescription
actionStringYesshould be set to promoteToRelease for this API.
descriptionStringNoThe description of the snapshot
snapshotVersionInputsList<SnapshotVersionInputPojo>
NoA list containing only one project version to be associated with latest snapshot.
YesOne and only one element is required for promote to release action.

Elements of snapshotVersionInputs has following attributes:

AttributesTypeRequiredDescription
projectIdLongYesProject associated with release.
projectVersionIdLongYesThe version id of the project. If using packageName, version for package must be provided.
packageNameString
Yes*
NoThe name of the package (used for partial deployment projects only) associated with release. If Partial deployment project and packageName is not supplied it will be considered all files type
version.projectVersionIdLongYesThe version id of the project. If using packageName,
version
for package must be provided
.

Response

Snapshot JSON objects can having the following attributes:

...