terraform/website/source/docs/providers/powerdns/index.html.markdown

37 lines
1.3 KiB
Markdown

---
layout: "powerdns"
page_title: "Provider: PowerDNS"
sidebar_current: "docs-powerdns-index"
description: |-
The PowerDNS provider is used manipulate DNS records supported by PowerDNS server. The provider needs to be configured with the proper credentials before it can be used.
---
# PowerDNS Provider
The PowerDNS provider is used manipulate DNS records supported by PowerDNS server. The provider needs to be configured
with the proper credentials before it can be used. It supports both the [legacy API](https://doc.powerdns.com/3/httpapi/api_spec/) and the new [version 1 API](https://doc.powerdns.com/md/httpapi/api_spec/), however resources may need to be configured differently.
Use the navigation to the left to read about the available resources.
## Example Usage
```hcl
# Configure the PowerDNS provider
provider "powerdns" {
api_key = "${var.pdns_api_key}"
server_url = "${var.pdns_server_url}"
}
# Create a record
resource "powerdns_record" "www" {
# ...
}
```
## Argument Reference
The following arguments are supported:
* `api_key` - (Required) The PowerDNS API key. This can also be specified with `PDNS_API_KEY` environment variable.
* `server_url` - (Required) The address of PowerDNS server. This can also be specified with `PDNS_SERVER_URL` environment variable.