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.