Skip to main content

Nameshield Provider

This Nameshield provider supports DNS resources and data sources, interacting with the Nameshield DNS API.

Features​

  • Manage DNS zone properties (TTL, SOA)
  • Manage and search DNS records

Requirements​

Use provider​


terraform {
    required_providers {
        nameshield = {
            source = "tools.nameshield.net/terraform/nms"
            version = "1.0.0"
        }
    }
}

Authentication​

The Nameshield provider requires the DNS API authentification to interact with. You can provide your credentials in the provider configuration, or with the NAMESHIELD_TOKEN and NAMESHIELD_TOKEN environnement variables. See how to generate tokens.


provider "nameshield" {
  url   = "{api_url}"
  token = "{api_token}"
}
  • url (String) URL of the Nameshield DNS API. May also be provided via NAMESHIELD_URL environment variable.
  • token (String, Sensitive) Authentification token of the Nameshield DNS API. May also be provided via NAMESHIELD_TOKEN environment variable.

Example​

terraform {
    required_providers {
        nameshield = {
            source = "tools.nameshield.net/terraform/nms"
            version = "1.0.0"
        }
    }
}

provider "nameshield" {
  url   = "{api_url}"
  token = "{api_token}"
}

resource "nameshield_record" "example" {
  zone                   = "nameshield.net"
  name                   = "terraform"
  type                   = "TXT"
  data                   = "\"test\""
  ttl                    = 3600
  append_if_rrset_exists = true
}