Skip to main content
Version: Deploy 23.1

Types used in the Deploy CLI

This topic provides an overview of the types that are available in the Deploy command-line interface (CLI).

Artifact

A configuration item (CI) with an associated file; extends ConfigurationItem.

NameTypeDescription
fileOverthereFileAn abstract representation of a file that can be access through an OverthereConnection

ArtifactAndData

NameTypeDescription
artifactArtifactThe artifact
databyte[]The file contents
filenameStringThe name of the file

ConfigurationItem

A new CI or a CI from the repository.

NameTypeDescription
idStringThe ID of the CI
typeStringThe UDM type of the CI
ci_attributesCiAttributesCreation and modification date and user of this CI
valuesMapThe properties of the CI
validationsListThe validation errors on the CI

ConfigurationItemId

A CI reference with type information.

NameTypeDescription
idStringThe ID of the CI
typeStringThe UDM type of the CI

Deployment

Settings for doing a deployment.

NameTypeDescription
deployedApplicationConfigurationItemThe application being deployed
deployedsListThe configured deployeds
deployablesListThe available deployables in the package
containersListThe containers being deployed to
deploymentTypeStringThe type of deployment. Possible values: INITIAL, UPDATE, UNDEPLOYMENT

StepState

Information about a task step.

NameTypeDescription
descriptionStringThe human-readable description of the step
stateStringThe current state of the step. Possible values: PENDING, SKIP, EXECUTING, PAUSED, FAILED, DONE, SKIPPED
startDateCalendarThe date the step was started
completionDateCalendarThe date the step was completed
logStringThe log output of the step
failureCountStringThe times the step has failed
metadatamapStep metadata, containing the order and deployed

TaskState

Deploy task.

NameTypeDescription
idStringThe ID of the task
stateStringThe state the task was in when queried. Possible values: PENDING, QUEUED, EXECUTING, STOPPED, EXECUTED, DONE, CANCELLED
startDateCalendarThe date the task was started
completionDateCalendarThe date the task was completed
nrStepsintThe number of steps in the task
currentStepNrintThe number of the step the task is currently at
metadatamapTask metadata, including the application, environment, version
failureCountintThe number of times the task has stopped because of a failed step
ownerStringThe current owner of the task

TaskWithSteps

Deploy task including its steps.

NameTypeDescription
idStringThe ID of the task
stateStringThe state the task was in when queried. Possible values: PENDING, QUEUED, EXECUTING, STOPPED, EXECUTED, DONE, CANCELLED
startDateCalendarThe date the task was started
completionDateCalendarThe date the task was completed
nrStepsintThe number of steps in the task
currentStepNrintThe number of the step the task is currently at
metadatamapTask metadata, containing the application, environment, version
failureCountintThe number of times the task has stopped because of a failed step
ownerStringThe current owner of the task
stepsListAll steps in the task represented as StepState objects

FullTaskInfo

Task that includes step information. Extends TaskInfo.

NameTypeDescription
stepsListThe steps in the task

FullTaskInfos

List of tasks with step information.

NameTypeDescription
tasksListAll retrieved tasks as a list

ValidationMessage

Indicates a validation error and provides a message.

NameTypeDescription
ciIdStringThe ID of the CI this validation message refers to
propertyNameStringThe name of the property in the CI this validation message refers to
messageStringThe message itself

StepInfo

Information about a task step. Deprecated; use StepState instead.

NameTypeDescription
descriptionStringThe human-readable description of the step
stateStringThe current state of the step. Possible values: PENDING, SKIP, EXECUTING, PAUSED, FAILED, DONE, SKIPPED
startDateCalendarThe date the step was started
completionDateCalendarThe date the step was completed
logStringThe log output of the step
failureCountStringThe times the step has failed
nrintThe position of the step in the task

TaskInfo

Deploy task. Deprecated; use TaskState instead.

NameTypeDescription
idStringThe ID of the task
labelStringThe label describing the task
stateStringThe state the task was in when queried. Possible values: PENDING, QUEUED, EXECUTING, STOPPED, EXECUTED, DONE, CANCELLED
startDateCalendarThe date the task was started
completionDateCalendarThe date the task was completed
nrOfStepsintThe number of steps in the task
currentStepNrintThe number of the step the task is currently at
applicationStringFor deployment tasks, the udm.Application the task is for
versionStringFor deployment tasks, the version of the udm.Application the task is for. This refers to the actual package being deployed, viz. the deployment package or composite package
environmentStringFor deployment tasks, the environment the package is being deployed to
failureCountintThe number of times the task has stopped because of a failed step