chef-courier-cli reference
chef-courier-cli
Chef Courier CLI
Options
-h--helphelp for chef-courier-cli
Default value:
false
chef-courier-cli completion
Generate the autocompletion script for the specified shell
Synopsis
Generate the autocompletion script for chef-courier-cli for the specified shell. See each sub-command’s help for details on how to use the generated script.
Options
-h--helphelp for completion
Default value:
false
See also
- chef-courier-cli completion bash
- chef-courier-cli completion fish
- chef-courier-cli completion powershell
- chef-courier-cli completion zsh
chef-courier-cli completion bash
Generate the autocompletion script for bash
Synopsis
Generate the autocompletion script for the bash shell.
This script depends on the ‘bash-completion’ package. If it is not installed already, you can install it via your OS’s package manager.
To load completions in your current shell session:
source <(chef-courier-cli completion bash)
To load completions for every new session, execute once:
Linux:
chef-courier-cli completion bash > /etc/bash_completion.d/chef-courier-cli
macOS:
chef-courier-cli completion bash > $(brew --prefix)/etc/bash_completion.d/chef-courier-cli
You will need to start a new shell for this setup to take effect.
completion-bash package
You must have the bash-completion package installed on your workstation to run the completion bash subcommand.
To install and configure the package, see the Chef 360 Platform CLI documentation.
Usage
chef-courier-cli completion bashOptions
-h--helphelp for bash
Default value:
false--no-descriptionsdisable completion descriptions
Default value:
false
See also
chef-courier-cli completion fish
Generate the autocompletion script for fish
Synopsis
Generate the autocompletion script for the fish shell.
To load completions in your current shell session:
chef-courier-cli completion fish | source
To load completions for every new session, execute once:
chef-courier-cli completion fish > ~/.config/fish/completions/chef-courier-cli.fish
You will need to start a new shell for this setup to take effect.
Usage
chef-courier-cli completion fish [flags]Options
-h--helphelp for fish
Default value:
false--no-descriptionsdisable completion descriptions
Default value:
false
See also
chef-courier-cli completion powershell
Generate the autocompletion script for powershell
Synopsis
Generate the autocompletion script for powershell.
To load completions in your current shell session:
chef-courier-cli completion powershell | Out-String | Invoke-Expression
To load completions for every new session, add the output of the above command to your powershell profile.
Usage
chef-courier-cli completion powershell [flags]Options
-h--helphelp for powershell
Default value:
false--no-descriptionsdisable completion descriptions
Default value:
false
See also
chef-courier-cli completion zsh
Generate the autocompletion script for zsh
Synopsis
Generate the autocompletion script for the zsh shell.
If shell completion is not already enabled in your environment you will need to enable it. You can execute the following once:
echo "autoload -U compinit; compinit" >> ~/.zshrc
To load completions in your current shell session:
source <(chef-courier-cli completion zsh)
To load completions for every new session, execute once:
Linux:
chef-courier-cli completion zsh > "${fpath[1]}/_chef-courier-cli"
macOS:
chef-courier-cli completion zsh > $(brew --prefix)/share/zsh/site-functions/_chef-courier-cli
You will need to start a new shell for this setup to take effect.
Usage
chef-courier-cli completion zsh [flags]Options
-h--helphelp for zsh
Default value:
false--no-descriptionsdisable completion descriptions
Default value:
false
See also
chef-courier-cli delivery
Commands related to delivery service
Options
-h--helphelp for delivery
Default value:
false
See also
chef-courier-cli delivery channel
Commands related to channel
Options
-h--helphelp for channel
Default value:
false
See also
- chef-courier-cli delivery
- chef-courier-cli delivery channel get-url
- chef-courier-cli delivery channel send-run
chef-courier-cli delivery channel get-url
Fetches connection queue string for a node
Synopsis
Fetches the connection string for a give nodeID. Connection string will be used by courier runner to connect the queue.
Usage
chef-courier-cli delivery channel get-url [flags]Options
--formatto print response in format
Default value:
json-h--helphelp for get-url
Default value:
false--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli delivery channel send-run
Deliver a run to a node in order that it be executed
Synopsis
Deliver a run to a node in order that it be executed. Delivery may be queued. Note that delivery does not track or report on delivery status at this time. If no delivery channel exists, one will be created.
Usage
chef-courier-cli delivery channel send-run [flags]Options
--bodyJob to run on the node.
--body-filePath to file in the local system containing valid body parameter value
--body-formatFormat of the --body or --body-file, options: json, yaml, toml
Default value:
json--channelIdchannel to receive delivery. Currently maps to node identifier.
--formatto print response in format
Default value:
json-h--helphelp for send-run
Default value:
false--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli deregister-device
De-register a device
Synopsis
Use this operation to de-register a device
Usage
chef-courier-cli deregister-device [flags]Options
--forceforce remove profile from local list of profiles, even on error from server
Default value:
false-f--formatto print response in format
Default value:
json-h--helphelp for deregister-device
Default value:
false--profilename for the profile of the new api-token
Default value:
default-v--verboseto show debug logs
Default value:
false
See also
chef-courier-cli get-default-profile
Get default profile for request
Usage
chef-courier-cli get-default-profile [flags]Options
-h--helphelp for get-default-profile
Default value:
false
See also
chef-courier-cli list-profile-names
Get the list of profile names available
Usage
chef-courier-cli list-profile-names [flags]Options
-h--helphelp for list-profile-names
Default value:
false
See also
chef-courier-cli orchestrator
Commands related to orchestrator
Options
-h--helphelp for orchestrator
Default value:
false
See also
chef-courier-cli orchestrator add-jobinstance
Submit a job instance for execution
Usage
chef-courier-cli orchestrator add-jobinstance [flags]Options
--bodya job instance to be executed by nodes
--body-filePath to file in the local system containing valid body parameter value
--body-formatFormat of the --body or --body-file, options: json, yaml, toml
Default value:
json--formatto print response in format
Default value:
json-h--helphelp for add-jobinstance
Default value:
false--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli register-device
register a device and get api-token for device login
Usage
chef-courier-cli register-device [flags]Options
--cafilepath to ca file
--device-namename of the device
Default value:
device-f--formatto print response in format
Default value:
json-h--helphelp for register-device
Default value:
false-i--insecureinsecure skip verify
Default value:
false--overwritethis flag is used to overwrite the old profile if the profile for profile name provided already exists
Default value:
false--profile-namename for the profile of the new api-token
--urltenant url
-v--verboseto show debug logs
Default value:
false
See also
chef-courier-cli scheduler
Commands related to scheduler service
Options
-h--helphelp for scheduler
Default value:
false
See also
chef-courier-cli scheduler exceptions
Commands related to exceptions
Options
-h--helphelp for exceptions
Default value:
false
See also
- chef-courier-cli scheduler
- chef-courier-cli scheduler exceptions add-rule
- chef-courier-cli scheduler exceptions delete-rule
- chef-courier-cli scheduler exceptions get-rule
- chef-courier-cli scheduler exceptions list-rules
- chef-courier-cli scheduler exceptions update-rule
chef-courier-cli scheduler exceptions add-rule
Add scheduling exception window.
Synopsis
Add a scheduling exception window. Jobs will not run during exception windows. All future job run schedules are recalculated when an exception is added.
Usage
chef-courier-cli scheduler exceptions add-rule [flags]Options
--bodya new exception rule
--body-filePath to file in the local system containing valid body parameter value
--body-formatFormat of the --body or --body-file, options: json, yaml, toml
Default value:
json--formatto print response in format
Default value:
json-h--helphelp for add-rule
Default value:
false--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli scheduler exceptions delete-rule
Delete scheduling exception rule
Synopsis
Delete scheduling exception rule. Causes recalculation of all future job execution times.
Usage
chef-courier-cli scheduler exceptions delete-rule [flags]Options
--exceptionIdID of a exception
--formatto print response in format
Default value:
json-h--helphelp for delete-rule
Default value:
false--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli scheduler exceptions get-rule
Get scheduling exception rule with exception rule identifier
Usage
chef-courier-cli scheduler exceptions get-rule [flags]Options
--exceptionIdID of a exception
--formatto print response in format
Default value:
json-h--helphelp for get-rule
Default value:
false--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli scheduler exceptions list-rules
Get scheduling exception rules
Synopsis
Get paginated list of all scheduling exception rules
Usage
chef-courier-cli scheduler exceptions list-rules [flags]Options
--formatto print response in format
Default value:
json-h--helphelp for list-rules
Default value:
false--pagination.pagewhat page of the pagination
Default value:
1--pagination.sizeitems per page
Default value:
10--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli scheduler exceptions update-rule
Update a scheduling exception rule.
Synopsis
Update a scheduling exception rule. Causes recalculation of all future job execution times.
Usage
chef-courier-cli scheduler exceptions update-rule [flags]Options
--bodyThe updated exception rule.
--body-filePath to file in the local system containing valid body parameter value
--body-formatFormat of the --body or --body-file, options: json, yaml, toml
Default value:
json--exceptionIdID of a exception
--formatto print response in format
Default value:
json-h--helphelp for update-rule
Default value:
false--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli scheduler jobs
Commands related to jobs
Options
-h--helphelp for jobs
Default value:
false
See also
- chef-courier-cli scheduler
- chef-courier-cli scheduler jobs activated-job
- chef-courier-cli scheduler jobs add-job
- chef-courier-cli scheduler jobs cancel-job
- chef-courier-cli scheduler jobs delete-job
- chef-courier-cli scheduler jobs estimate-run-times
- chef-courier-cli scheduler jobs get-head
- chef-courier-cli scheduler jobs get-job
- chef-courier-cli scheduler jobs get-pastDueJobs
- chef-courier-cli scheduler jobs list-jobs
- chef-courier-cli scheduler jobs update-job
chef-courier-cli scheduler jobs activated-job
marks the specified job as having been activated.
Synopsis
Internal use only. Invoked when a job has been activated. Updates run count and pre-calculates next execution time.
Usage
chef-courier-cli scheduler jobs activated-job [flags]Options
--formatto print response in format
Default value:
json-h--helphelp for activated-job
Default value:
false--jobIdID of a Job
--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli scheduler jobs add-job
Create a new job.
Synopsis
Create a new new job.
Usage
chef-courier-cli scheduler jobs add-job [flags]Options
--bodyThe job to be created
--body-filePath to file in the local system containing valid body parameter value
--body-formatFormat of the --body or --body-file, options: json, yaml, toml
Default value:
json--formatto print response in format
Default value:
json-h--helphelp for add-job
Default value:
false--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli scheduler jobs cancel-job
cancel all future occurrences of a job
Synopsis
prevents future instances of this job from running by updating the job status to ‘canceled’. Note that this will not affect any job instance running at the time of this request.
Usage
chef-courier-cli scheduler jobs cancel-job [flags]Options
--formatto print response in format
Default value:
json-h--helphelp for cancel-job
Default value:
false--jobIdID of a Job
--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli scheduler jobs delete-job
Deletes the specified job
Synopsis
Deletes the job identified by jobId
Usage
chef-courier-cli scheduler jobs delete-job [flags]Options
--formatto print response in format
Default value:
json-h--helphelp for delete-job
Default value:
false--jobIdID of a Job
--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli scheduler jobs estimate-run-times
get future execution times for a job
Synopsis
get one or more estimated run times for the specified job
Usage
chef-courier-cli scheduler jobs estimate-run-times [flags]Options
--countnumber of future runs to retrieve
Default value:
0--formatto print response in format
Default value:
json-h--helphelp for estimate-run-times
Default value:
false--jobIdID of a Job
--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli scheduler jobs get-head
Retrieve request headers for a job by its identifier.
Synopsis
this can be used to verify that a job does (or does not) exist, without retrieving the job itself.
Usage
chef-courier-cli scheduler jobs get-head [flags]Options
--formatto print response in format
Default value:
json-h--helphelp for get-head
Default value:
false--jobIdID of a Job
--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli scheduler jobs get-job
Retrieve the job by identifier
Synopsis
Returns the specific job
Usage
chef-courier-cli scheduler jobs get-job [flags]Options
--formatto print response in format
Default value:
json-h--helphelp for get-job
Default value:
false--jobIdID of a Job
--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli scheduler jobs get-pastDueJobs
Retrieve the jobs that are due to run as of the given ‘deadline’
Synopsis
Fetches jobs that are expected to run at or before ‘deadline’ passes.
Usage
chef-courier-cli scheduler jobs get-pastDueJobs [flags]Options
--deadlinefilter by job instances initiated before the given time.
--formatto print response in format
Default value:
json-h--helphelp for get-pastDueJobs
Default value:
false--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli scheduler jobs list-jobs
List all jobs.
Synopsis
Lists all jobs. If a filter is provided and no results match, an empty list will be returned.
Usage
chef-courier-cli scheduler jobs list-jobs [flags]Options
--activeFilter by active jobs. An active job is defined as one with an 'active' status that is also scheduled for at least one future execution.
Default value:
false--formatto print response in format
Default value:
json-h--helphelp for list-jobs
Default value:
false--pagination.pagewhat page of the pagination
Default value:
1--pagination.sizeitems per page
Default value:
10--profilename of the profile to be used for cmd
Default value:
default--statusThe Status to filter the jobs list by
--verboseto show debug logs
Default value:
false
See also
chef-courier-cli scheduler jobs update-job
replace the job with the new job provided.
Synopsis
Updates the job and recalculates its next scheduled run. This update will have no effect previous or in-flight executions of this job. == NOTE == This operation is not currently supported
Usage
chef-courier-cli scheduler jobs update-job [flags]Options
--bodyThe job to be updated
--body-filePath to file in the local system containing valid body parameter value
--body-formatFormat of the --body or --body-file, options: json, yaml, toml
Default value:
json--formatto print response in format
Default value:
json-h--helphelp for update-job
Default value:
false--jobIdID of a Job
--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli set-default-profile
Set default profile for request
Usage
chef-courier-cli set-default-profile [flags]Options
-h--helphelp for set-default-profile
Default value:
false
See also
chef-courier-cli state
Commands related to state service
Options
-h--helphelp for state
Default value:
false
See also
chef-courier-cli state instance
Commands related to instance
Options
-h--helphelp for instance
Default value:
false
See also
- chef-courier-cli state
- chef-courier-cli state instance complete-instance
- chef-courier-cli state instance create-instance
- chef-courier-cli state instance get-instance
- chef-courier-cli state instance list-all
- chef-courier-cli state instance list-instance-runs
chef-courier-cli state instance complete-instance
Update a Job Instance’s state to complete.
Synopsis
Update the job instance state to complete, with the provided status. A Job Instance is expected to marked as ‘failure’ or ‘success’ as soon as the determination is made, which can occur while some nodes are still performing actions. These updates will be captured but will not affect the final status of the Job Instance. An Instance is considered successful only if all of its Success Criteria have been met.
Usage
chef-courier-cli state instance complete-instance [flags]Options
--body--body-filePath to file in the local system containing valid body parameter value
--body-formatFormat of the --body or --body-file, options: json, yaml, toml
Default value:
json--formatto print response in format
Default value:
json-h--helphelp for complete-instance
Default value:
false--instanceIdThe unique identifier of a Job Instance
--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli state instance create-instance
Capture the state of a job that is about to be started.
Synopsis
Captures the Job Instance and its expanded job-run list to state. This request will fail with a 500 response if both operations are not completed successfully. This allows the system to track the nodes it is expecting to hear in from, without relying on those nodes checking in to be visible. Typically invoked by Orchestrator when it is preparing to run a job instance.
Usage
chef-courier-cli state instance create-instance [flags]Options
--bodyThe Job Instance to capture
--body-filePath to file in the local system containing valid body parameter value
--body-formatFormat of the --body or --body-file, options: json, yaml, toml
Default value:
json--formatto print response in format
Default value:
json-h--helphelp for create-instance
Default value:
false--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli state instance get-instance
get the requested Job Instance
Synopsis
This retrieves a Job Instance record for the given instance-id. The run records associated with the Job Instance are not included in the results.
Note that instances that have been moved to history will not be available with this API.
Usage
chef-courier-cli state instance get-instance [flags]Options
--formatto print response in format
Default value:
json-h--helphelp for get-instance
Default value:
false--instanceIdThe unique identifier of a Job Instance
--profilename of the profile to be used for cmd
Default value:
default--verboseto show debug logs
Default value:
false
See also
chef-courier-cli state instance list-all
retrieve job instances
Synopsis
Fetch a list of job instances, filtered by the provided query parameters. Results will contain only those records matching all provided filters.
Usage
chef-courier-cli state instance list-all [flags]Options
--formatto print response in format
Default value:
json-h--helphelp for list-all
Default value:
false--job-idfilter by job instances originating from the given job
--pagination.pagewhat page of the pagination
Default value:
1--pagination.sizeitems per page
Default value:
10--profilename of the profile to be used for cmd
Default value:
default--run-afterfilter by job instances initiated after the given time.
--run-beforefilter by job instances initiated before the given time.
--statusfilter by the provided instance status
--verboseto show debug logs
Default value:
false
See also
chef-courier-cli state instance list-instance-runs
list all job runs for the given job instance
Synopsis
Retrieves all runs in the given job instance, filtered by the provided query parameters. Results returned will meet all filter criteria provided.
Usage
chef-courier-cli state instance list-instance-runs [flags]Options
--formatto print response in format
Default value:
json--groupNumfilter results to include only those in the specified group
Default value:
0-h--helphelp for list-instance-runs
Default value:
false--instanceIdThe unique identifier of a Job Instance
--pagination.pagewhat page of the pagination
Default value:
1--pagination.sizeitems per page
Default value:
10--profilename of the profile to be used for cmd
Default value:
default--run-afterfilter results to include only job runs last updated after this date
--run-beforefilter results to include only job runs last updated prior to this date
--statusfilters results to include only job runs with this status
--verboseto show debug logs
Default value:
false
See also
chef-courier-cli state run
Commands related to run
Options
-h--helphelp for run
Default value:
false
See also
- chef-courier-cli state
- chef-courier-cli state run attach-step-attempt-evidence
- chef-courier-cli state run complete-run
- chef-courier-cli state run get-run
- chef-courier-cli state run get-step-attempt-evidence
- chef-courier-cli state run list-steps
- chef-courier-cli state run received-run
- chef-courier-cli state run timeout-run
- chef-courier-cli state run update-step
chef-courier-cli state run attach-step-attempt-evidence
Synopsis
Upload evidence (artifacts) related to completion of the step, such as command output. Content is expected to be uploaded as multipart/form-data in gzipped format. Evidence upload does not affect the status of an action within the job run. Client must PUT to state/run/{runId}/step/{stepId} prior to uploading evidence. Future: The capture of evidence will be processed asynchronously
Usage
chef-courier-cli state run attach-step-attempt-evidence [flags]Options
--attemptNothe attempt number for a given step/action within a job run.
Default value:
0--fileTakes path of file.
--formatto print response in format
Default value:
json-h--helphelp for attach-step-attempt-evidence
Default value:
false--profilename of the profile to be used for cmd
Default value:
default--runIdThe unique identifier of a job run in GUID format.
--stepNoa single step/action within a job run.
Default value:
0--verboseto show debug logs
Default value:
false
See also
chef-courier-cli state run complete-run
Update a run to indicate it is complete.
Synopsis
Updates the run’s state reflect that the job run has been completed. Generally used by the client to indicate it has completed processing all steps of a run.
Usage
chef-courier-cli state run complete-run [flags]Options
--body--body-filePath to file in the local system containing valid body parameter value
--body-formatFormat of the --body or --body-file, options: json, yaml, toml
Default value:
json--formatto print response in format
Default value:
json-h--helphelp for complete-run
Default value:
false--profilename of the profile to be used for cmd
Default value:
default--runIdThe unique identifier of a job run in GUID format.
--verboseto show debug logs
Default value:
false
See also
chef-courier-cli state run get-run
provides job run details for any job run id
Synopsis
this is intended as an endpoint to provide job run details for provided job run id. Results will not include any steps. For those, use the endpoint run/{runId}/steps. Note that job runs that have been moved to history will not be available via this API.
Usage
chef-courier-cli state run get-run [flags]Options
--formatto print response in format
Default value:
json-h--helphelp for get-run
Default value:
false--profilename of the profile to be used for cmd
Default value:
default--runIdThe unique identifier of a job run in GUID format.
--verboseto show debug logs
Default value:
false
See also
chef-courier-cli state run get-step-attempt-evidence
Synopsis
This provides a signed expiring download URL to the artifact associated with this job run step attempt. == COMPATIBILITY NOTE == This will be changing for GA to provide direct download of the artifact.
Usage
chef-courier-cli state run get-step-attempt-evidence [flags]Options
--attemptNothe attempt number for a given step/action within a job run.
Default value:
0--formatto print response in format
Default value:
json-h--helphelp for get-step-attempt-evidence
Default value:
false--profilename of the profile to be used for cmd
Default value:
default--runIdThe unique identifier of a job run in GUID format.
--stepNoa single step/action within a job run.
Default value:
0--verboseto show debug logs
Default value:
false
See also
chef-courier-cli state run list-steps
retrieve all step results for the given run
Synopsis
Fetch paginated step results for a given run. Does not include artifacts, which must be queried separately.
Usage
chef-courier-cli state run list-steps [flags]Options
--formatto print response in format
Default value:
json-h--helphelp for list-steps
Default value:
false--pagination.pagewhat page of the pagination
Default value:
1--pagination.sizeitems per page
Default value:
10--profilename of the profile to be used for cmd
Default value:
default--runIdThe unique identifier of a job run in GUID format.
--verboseto show debug logs
Default value:
false
See also
chef-courier-cli state run received-run
Notify the State system that a job run has been received.
Synopsis
Updates the job run state to reflect that the job run has been received by the client. This will also update the last-update time, delaying timeout in orchestrator.
Usage
chef-courier-cli state run received-run [flags]Options
--formatto print response in format
Default value:
json-h--helphelp for received-run
Default value:
false--profilename of the profile to be used for cmd
Default value:
default--runIdThe unique identifier of a job run in GUID format.
--verboseto show debug logs
Default value:
false
See also
chef-courier-cli state run timeout-run
Update a run to indicate that it has timed out
Synopsis
Updates the run’s state to reflect that the job run has been timed out by Orchestrator. Intended for internal use by chef-orchestrator-watchdog. A timeout will not update the last-updated time, so that there remains record of the last time Courier Server heard from the node. IMPORTANT> Even though orchestrator considers the run-timed out and will no longer be tracking it, the can still check in and complete the run. In this case, the timeout status will be replaced with the final status as long as the instance has not been migrated to history.
Usage
chef-courier-cli state run timeout-run [flags]Options
--formatto print response in format
Default value:
json-h--helphelp for timeout-run
Default value:
false--profilename of the profile to be used for cmd
Default value:
default--runIdThe unique identifier of a job run in GUID format.
--verboseto show debug logs
Default value:
false
See also
chef-courier-cli state run update-step
Synopsis
Status endpoint used by a node to update the status and state of the given step. These messages will be are processed asynchronously by the State Service. Receipt timestamp will be captured at server-side as the last-update/alive time received. Client is expected to invoke this API endpoint at the start and completion of the step (with appropriate status/state values); and if a reboot is required it should also perform an interim update with ‘active’ status.
Usage
chef-courier-cli state run update-step [flags]Options
--body--body-filePath to file in the local system containing valid body parameter value
--body-formatFormat of the --body or --body-file, options: json, yaml, toml
Default value:
json--formatto print response in format
Default value:
json-h--helphelp for update-step
Default value:
false--profilename of the profile to be used for cmd
Default value:
default--runIdThe unique identifier of a job run in GUID format.
--stepNoa single step/action within a job run.
Default value:
0--verboseto show debug logs
Default value:
false
See also
chef-courier-cli version
Chef Courier cli
Usage
chef-courier-cli version [flags]Options
-h--helphelp for version
Default value:
false