DeployJob - addOneTimeScheduleWithApproval

DeployJob - addOneTimeScheduleWithApproval

Description :

This command adds a one-time schedule to a Deploy Job. If this Deploy Job already had a schedule, this command replaces the old schedule with the schedule you are adding now with approval. The Deploy Job will execute only when the approval request is approved by the approval system. The schedule will expire if the approval does not come before the expiration and will close the change ticket associated with this schedule through the approval system.

The argument jobKey is a handle to the job being modified. To find the jobKey, use the getDBKeyByGroupAndName command.

The dateString argument defines a one-time schedule to be added to the job definition. It must be in the format YYYY-MM-DD HH:MM:SS.

This command does not send a job notification. To add a schedule that includes notifications, see the addOneTimeScheduleWithSNMPNotificationAndWithApproval or addOneTimeScheduleWithEMailNotificationAndWithApproval commands.

Return type : DBKey

Command Input :

Variable Name

Variable Type



Handle to the job.



One-time schedule to be added. The date string must be in the format YYYY-MM-DD HH:MM:SS.



Approval ID to be attached to the job.


The following example shows how to add a single Deploy Job run on the 1st of January 2005 at 11:35 PM.


DATE_STRING="2005-01-01 23:35:00" 

JOB_KEY=`blcli DeployJob  [getDBKeyByGroupAndName|DeployJob - getDBKeyByGroupAndName] /deploys deployconfig` 

JOB_APPROVAL_ID=`blcli Job createApproval 2 2 "My change" 2 3 "" ""` 

JOB_KEY=`blcli DeployJob  [addOneTimeScheduleWithApproval|DeployJob - addOneTimeScheduleWithApproval] $JOB_KEY "$DATE_STRING" $JOB_APPROVAL_ID` 

Was this page helpful? Yes No Submitting... Thank you