wait

wait

Specifies how many seconds to wait for a long-running operation to return the expected values. Use in conjunction with the expected-values and check-every options.

Syntax

{--wait | -w} seconds

Arguments

Argument	Description
seconds	Specifies the number of seconds the command waits for the expected output specified by the {--expected-values \| -e} option before completing. The default is the value of the CC_WAIT environment variable. If the CC_WAIT environment variable is not set, the command uses 120 seconds.

Usage Notes

The {--wait | -w} option is only needed when you specify the {--expected-values | -e} option.

If the time specified by the {--wait | -w} option elapses before the expected results are returned, the command fails.

The use of the {--expected-values | -e}, {--wait | -w}, and {--check-every | -c} options is helpful with commands that perform actions that might take several seconds or minutes to complete. Depending on your use case, these options might be helpful with any command. However, they are most helpful with the lifecycle and monitoring commands because they allow you to reliably execute the commands.

Example

To have a command wait 180 seconds for the expected results:

--wait 180

Note:
To see an example that uses all of the {--expected-values | e}, {--wait | -w}, and {--check-every | -c} options, see expected-values.