doapi-action

NAME

doapi-action — manage DigitalOcean API actions

SYNOPSIS

doapi-action show [<action> ...]
doapi-action show {--in-progress | --last}
doapi-action wait [--wait-time <seconds>] [--wait-interval <seconds>] [<action> ...]
doapi-action resource <action> ...
doapi-action resource {--in-progress | --last}

doapi-action also takes the universal options common to all doapi commands.

Actions are specified by ID number.

show

doapi-action show [<action> ...]
doapi-action show {--in-progress | --last}

Show the given actions. If no actions or flags are specified, all actions ever performed on the account are shown. The actions are output as a list of Action objects converted to JSON.

Options

--in-progress

Show only the currently in-progress actions

--last

Show only the most recent action performed on the account instead of a list of all actions. If multiple actions were triggered simultaneously, the choice of which to display is undefined.

wait

doapi-action wait [--wait-time <seconds>] [--wait-interval <seconds>] [<action> ...]

Wait for the given actions to either complete or error out. The finished actions are output as a list of Action objects converted to JSON, with each action output (roughly) as soon as it finishes. If no actions are specified, wait will wait for all currently in-progress actions to complete.

Options

--wait-interval <seconds>

How often to poll the server for the actions’ current statuses; default value: 5 seconds

--wait-time <seconds>

The maximum number of seconds to wait for all actions to complete. After this much time has passed since program invocation, any remaining in-progress actions will be output immediately without waiting for them to finish.

If this option is not specified, wait will wait indefinitely.

resource

doapi-action resource <action> ...
doapi-action resource {--in-progress | --last}

Show the resources that the specified actions operated on. The resources are output as a list of Droplet, Image, and/or FloatingIP objects converted to JSON. Resources that no longer exist are output as null.

Options

--in-progress

Show only the resources currently being acted upon

--last

Show only the resource operated on by the account’s most recent action. If multiple actions were triggered simultaneously, the choice of which to display is undefined.