52 lines
1.3 KiB
Markdown
Executable File
52 lines
1.3 KiB
Markdown
Executable File
---
|
|
layout: "enterprise"
|
|
page_title: "Runs API"
|
|
sidebar_current: "docs-enterprise-api-runs"
|
|
description: |-
|
|
Runs in Terraform Enterprise represents a two step Terraform plan and a subsequent apply.
|
|
---
|
|
|
|
# Runs API
|
|
|
|
Runs in Terraform Enterprise represents a two step Terraform plan and a subsequent apply.
|
|
|
|
Runs are queued under [environments](/docs/enterprise/api/environments.html)
|
|
and require a two-step confirmation workflow. However, environments
|
|
can be configured to auto-apply to avoid this.
|
|
|
|
### Run Attributes
|
|
|
|
<table class="apidocs">
|
|
<tr>
|
|
<th>Attribute</th>
|
|
<th>Description</th>
|
|
<th>Required</th>
|
|
</tr>
|
|
<tr>
|
|
<td><code>destroy</code></td>
|
|
<td>If set to <code>true</code>, this run will be a destroy plan.</td>
|
|
<td>No</td>
|
|
</tr>
|
|
</table>
|
|
|
|
### Actions
|
|
|
|
The following actions can be performed on this resource.
|
|
|
|
<dl>
|
|
<dt>Queue a run</dt>
|
|
<dd>POST /api/v1/environments/:username/:name/plan</dd>
|
|
</dl>
|
|
|
|
### Examples
|
|
|
|
#### Queueing a new run
|
|
|
|
Starts a new run (plan) in the environment. Requires a configuration
|
|
version to be present on the environment to succeed, but will otherwise 404.
|
|
|
|
$ curl %{ATLAS_URL}/api/v1/environments/%{DEFAULT_USERNAME}/test/plan \
|
|
-X POST \
|
|
-d "" \
|
|
-H "X-Atlas-Token: $ATLAS_TOKEN"
|