# summary

Check the status of a sandbox creation, and log in to it if it's ready.

# description

Sandbox creation can take a long time. If the original "<%= config.bin %> org create sandbox" command either times out, or you specified the --async flag, the command displays a job ID. Use this job ID to check whether the sandbox creation is complete, and if it is, the command then logs into it.

You can also use the sandbox name to check the status or the --use-most-recent flag to use the job ID of the most recent sandbox creation.

# examples

- Check the status of a sandbox creation using its name and specify a production org with alias "prodOrg":

  <%= config.bin %> <%= command.id %> --name mysandbox --target-org prodOrg

- Check the status using the job ID:

  <%= config.bin %> <%= command.id %> --job-id 0GRxxxxxxxx

- Check the status of the most recent sandbox create request:

  <%= config.bin %> <%= command.id %> --use-most-recent

# flags.id.summary

Job ID of the incomplete sandbox creation that you want to check the status of.

# flags.id.description

The job ID is valid for 24 hours after you start the sandbox creation.

# flags.targetOrg.summary

Username or alias of the production org that contains the sandbox license.

# flags.targetOrg.description

When it creates the sandbox org, Salesforce copies the metadata, and optionally data, from your production org to the new sandbox org.

# flags.name.summary

Name of the sandbox org.

# flags.wait.summary

Number of minutes to wait for the sandbox org to be ready.

# flags.wait.description

If the command continues to run after the wait period, the CLI returns control of the terminal window to you and returns the job ID. To resume checking the sandbox creation, rerun this command.

# flags.use-most-recent.summary

Use the most recent sandbox create request.

# error.NoSandboxNameOrJobId

No sandbox name or job ID were provided.

# error.LatestSandboxRequestNotFound

Retry the command using either the --name or --job-id flags.

# error.NoSandboxRequestFound

Couldn't find a sandbox creation request using the provided sandbox name or job ID.

# error.SandboxNameLength

The sandbox name "%s" should be 10 or fewer characters.