terraform/website/source/docs/backends/types/http.html.md

47 lines
1.0 KiB
Markdown
Raw Normal View History

2017-02-15 19:47:30 +01:00
---
2017-02-15 21:19:38 +01:00
layout: "backend-types"
page_title: "Backend Type: http"
sidebar_current: "docs-backends-types-standard-http"
2017-02-15 19:47:30 +01:00
description: |-
2017-02-15 21:19:38 +01:00
Terraform can store state remotely at any valid HTTP endpoint.
2017-02-15 19:47:30 +01:00
---
# http
2017-02-15 21:19:38 +01:00
**Kind: Standard (with no locking)**
2017-02-15 19:47:30 +01:00
Stores the state using a simple [REST](https://en.wikipedia.org/wiki/Representational_state_transfer) client.
State will be fetched via GET, updated via POST, and purged with DELETE.
## Example Usage
```
2017-02-15 21:19:38 +01:00
terraform {
backend "http" {
address = "http://myrest.api.com"
}
}
2017-02-15 19:47:30 +01:00
```
## Example Referencing
```
data "terraform_remote_state" "foo" {
backend = "http"
config {
address = "http://my.rest.api.com"
}
}
```
## Configuration variables
The following configuration options are supported:
* `address` - (Required) The address of the REST endpoint
* `username` - (Optional) The username for HTTP basic authentication
* `password` - (Optional) The password for HTTP basic authentication
* `skip_cert_verification` - (Optional) Whether to skip TLS verification.
Defaults to `false`.