selectel_domains_record_v1

Last update: December 17 2024

selectel_domains_record_v1

For your information

This instruction is a copy of the Selectel Terraform provider's documentation in the Terraform Registry.

carefully

This resource is applicable to DNS Hosting (legacy). We do not support and develop DNS Hosting (legacy), but domains and records created in DNS Hosting (legacy) continue to work until further notice. We recommend to transfer your data to DNS Hosting (actual). For more infomation about DNS Hosting (actual), see the official Selectel documentation.
To create records in DNS Hosting (actual), use the selectel_domains_rrset_v2 resource.

Creates and manages a record in DNS Hosting (legacy) using public API v1. For more information about records, see the official Selectel documentation.

Example usage⁠

A Record⁠

resource "selectel_domains_record_v1" "a_record_1" {
  domain_id = selectel_domains_domain_v1.domain_1.id
  name      = "example.com"
  type      = "A"
  content   = "127.0.0.1"
  ttl       = 60
}

AAAA Record⁠

resource "selectel_domains_record_v1" "aaaa_record_1" {
  domain_id = selectel_domains_domain_v1.domain_1.id
  name      = "example.com"
  type      = "AAAA"
  content   = "2400:cb00:2049:1::a29f:1804"
  ttl       = 60
}

TXT Record⁠

resource "selectel_domains_record_v1" "txt_record_1" {
  domain_id = selectel_domains_domain_v1.domain_1.id
  name      = "example.com"
  type      = "TXT"
  content   = "hello, world!"
  ttl       = 60
}

CNAME Record⁠

resource "selectel_domains_record_v1" "cname_record_1" {
  domain_id = selectel_domains_domain_v1.domain_1.id
  name      = "example.com"
  type      = "CNAME"
  content   = "origin.com"
  ttl       = 60
}

NS Record⁠

resource "selectel_domains_record_v1" "ns_record_1" {
  domain_id = selectel_domains_domain_v1.domain_1.id
  name      = "example.com"
  type      = "NS"
  content   = "ns5.selectel.org"
  ttl       = 86400
}

MX Record⁠

resource "selectel_domains_record_v1" "mx_record_1" {
  domain_id = selectel_domains_domain_v1.domain_1.id
  name      = "example.com"
  type      = "MX"
  content   = "mail.example.org"
  ttl       = 60
  priority  = 10
}

SRV Record⁠

resource "selectel_domains_record_v1" "srv_record_1" {
  domain_id = selectel_domains_domain_v1.domain_1.id
  name      = "example.com"
  type      = "SRV"
  ttl       = 120
  priority  = 10
  weight    = 20
  target    = "example.com"
  port      = 100
}

SSHFP Record⁠

resource "selectel_domains_record_v1" "sshfp_record_1" {
  domain_id        = selectel_domains_domain_v1.main_domain.id
  name             = format("%s", selectel_domains_domain_v1.main_domain.name)
  type             = "SSHFP"
  ttl              = 60
  algorithm        = 1
  fingerprint_type = 1
  fingerprint      = "01AA"
}

ALIAS Record⁠

resource "selectel_domains_record_v1" "alias_record_1" {
  domain_id = selectel_domains_domain_v1.main_domain.id
  name      = format("subc.%s", selectel_domains_domain_v1.main_domain.name)
  type      = "ALIAS"
  content   = format("%s", selectel_domains_domain_v1.main_domain.name)
  ttl       = 60
}

CAA Record⁠

resource "selectel_domains_record_v1" "caa_record_1" {
  domain_id = selectel_domains_domain_v1.main_domain.id
  name      = format("caa.%s", selectel_domains_domain_v1.main_domain.name)
  type      = "CAA"
  ttl       = 60
  tag       = "issue"
  flag      = 128
  value     = "letsencrypt.com"
}

Argument Reference⁠

• domain_id — (Required) Unique identifier of the associated domain. Changing this creates a new domain record. Retrieved from the selectel_domains_domain_v1 resource.

• name — (Required) Name of the domain record. The name format depends on the record type, see the examples above.

• type — (Required) Type of the record. Available values are A, AAAA, TXT, CNAME, NS, MX, SRV, SSHFP, ALIAS, CAA.

• content — (Optional) Content of the record. Not applicable to SRV, SSHFP, CAA records.

• ttl — (Required) Time-to-live for the record in seconds. The available range is from 60 to 604800.

• priority — (Optional) Priority of the records preferences. Applicable only to MX and SRV records. Lower value means more preferred.

• weight — (Optional) Weight for the records with the same priority. Higher value means more preferred. Applicable only to SRV records.

• target — (Optional) Canonical name of the host providing the service. Applicable only to SRV records.

• port — (Optional) TCP or UDP port of the host of the service. Applicable only to SRV records.

• algorithm — (Optional) Algorithm of the public key. Applicable only to SSHFP records. Available values are RSA, DSA, ECDSA, Ed25519.

• fingerprint_type — (Optional) Algorithm used to hash the public key. Applicable only to SSHFP records. Available values are SHA-1, SHA-256.

• fingerprint — (Optional) Hexadecimal representation of the hash result, as text. Applicable only to SSHFP records.

• tag — (Optional) Identifier of the property represented by the record. Applicable only to CAA records. Available values are issue, issuewild, iodef, auth, path, policy.

• flag — (Optional) Critical value that has a specific meaning per RFC. Applicable only to CAA records. The available range is from 0 to 128.

• value — (Optional) Value associated with the tag. Applicable only to CAA records.

• email — (Optional) Email of the domain administrator. Applicable only to SOA records.

Attributes Reference⁠

• content — Content of the record. Applicable only to A, AAAA, TXT, CNAME, NS, MX, ALIAS records.

• priority — Priority of the records preferences. Applicable only to MX, SRV records.

• weight — Weight for the records with the same priority. Applicable only to SRV records.

• target — Canonical name of the host providing the service. Applicable only to SRV records.

• port — TCP or UDP port of the host of the service. Applicable only to SRV records.

• algorithm — Algorithm of the public key. Applicable only to SSHFP records.

• fingerprint_type — Algorithm used to hash the public key. Applicable only to SSHFP records.

• fingerprint — Hexadecimal representation of the hash result, as text. Applicable only to SSHFP records.

• tag — Identifier of the property represented by the record. Applicable only to CAA records.

• flag — Critical value that has a specific meaning per RFC. Applicable only to CAA records.

• value — Value associated with the tag. Applicable only to CAA records.

• email — Email of the domain administrator. Applicable only to SOA records.

Import⁠

You can import a domain record:

export OS_DOMAIN_NAME=<account_id>
export OS_USERNAME=<username>
export OS_PASSWORD=<password>
terraform import selectel_domains_record_v1.record_1 <domain_id>/<record_id>

where:

• <account_id> — Selectel account ID. The account ID is in the top right corner of the Control panel. Learn more about Registration.

• <username> — Name of the service user. To get the name, in the Control panel, go to Identity & Access Management ⟶ User management ⟶ the Service users tab ⟶ copy the name of the required user. Learn more about Service users.

• <password> — Password of the service user.

• <domain_id> — Unique identifier of the domain, for example, 45623. To get the domain ID, in the Control panel, go to Networks Services ⟶ DNS Hosting ⟶ the domain page ⟶ copy the domain ID from the address bar.

• <record_id> — Unique identifier of the record, for example, 123. To get the record ID, use DNS Hosting API.