terraform/website/source/docs/providers/http/data_source.html.md

1.5 KiB

layout page_title sidebar_current description
http HTTP Data Source docs-http-data-source Retrieves the content at an HTTP or HTTPS URL.

http Data Source

The http data source makes an HTTP GET request to the given URL and exports information about the response.

The given URL may be either an http or https URL. At present this resource can only retrieve data from URLs that respond with text/* or application/json content types, and expects the result to be UTF-8 encoded regardless of the returned content type header.

~> Important Although https URLs can be used, there is currently no mechanism to authenticate the remote server except for general verification of the server certificate's chain of trust. Data retrieved from servers not under your control should be treated as untrustworthy.

Example Usage

data "http" "example" {
  url = "https://checkpoint-api.hashicorp.com/v1/check/terraform"

  # Optional request headers
  request_headers {
    "Accept" = "application/json"
  }
}

Argument Reference

The following arguments are supported:

  • url - (Required) The URL to request data from. This URL must respond with a 200 OK response and a text/* or application/json Content-Type.

  • request_headers - (Optional) A map of strings representing additional HTTP headers to include in the request.

Attributes Reference

The following attributes are exported:

  • body - The raw body of the HTTP response.