Out Plane
app

app resume

Start a paused application.

writesrepeatable--dry-run

Starts a paused application again, at the instance count and size it was paused with. There is nothing to rebuild or redeploy: the deployment that was already there is what comes back.

Usage

outplane app resume [APP]

Arguments

ArgumentTypeDescription
APPstringApp name or id. Defaults to the linked app.

Output

FieldTypeDescription
appstring
appIdstring
pausedboolThe state the application is now in.
instancesintThe configured count, which pausing does not change.
changedboolFalse when it was already in that state.

Examples

See what it would do, without doing it

outplane app resume --dry-run

Resume an application

outplane app resume checkout

Resume the linked one and read the result

outplane app resume --json --fields paused,changed
{
  "changed": true,
  "paused": false
}

What to Know

  • Idempotent. Pausing something already paused changes nothing, reports changed false, and exits 0.
  • Applied immediately, without a deployment.
  • The configured replica count is kept, so resuming returns to the scale that was set rather than to a single instance.
  • A paused application still reports its last deployment's state in deploymentStatus. status is what says paused.

Errors

Beyond 0 for success, this command exits with:

ExitKindMeaning
2usageInvalid arguments, unknown flag, or client-side validation failure.
3authNot authenticated, token revoked or expired, or forbidden for this team.
5not_foundThe named resource does not exist, or is not visible to this credential.
8upstreamThe Out Plane API returned a server error.

The code on the error object is one of app.not_found, context.no_app. Branch on that, or on the exit status. The message is prose and changes.

On this page