selectel_domains_rrset_v2
Creates and manages an RRSet in DNS Hosting (actual) using public API v2. For more information about RRSets, see the official Selectel documentation.
Example usage
A RRSet
resource "selectel_domains_rrset_v2" "a_rrset_1" {
zone_id = selectel_domains_zone_v2.zone_1.id
name = "example.com."
type = "A"
ttl = 60
project_id = selectel_vpc_project_v2.project_1.id
records {
content = "127.0.0.1"
# The content value is "<ipv4_address>"
}
}
AAAA RRSet
resource "selectel_domains_rrset_v2" "aaaa_rrset_1" {
zone_id = selectel_domains_zone_v2.zone_1.id
name = "example.com."
type = "AAAA"
ttl = 60
project_id = selectel_vpc_project_v2.project_1.id
records {
content = "2400:cb00:2049:1::a29f:1804"
# The content value is "<ipv6_address>"
}
}
TXT RRSet
resource "selectel_domains_rrset_v2" "txt_rrset_1" {
zone_id = selectel_domains_zone_v2.zone_1.id
name = "example.com."
type = "TXT"
ttl = 60
project_id = selectel_vpc_project_v2.project_1.id
records {
content = "\"hello, world!\""
# The content value is "<text>"
}
}
CNAME RRSet
resource "selectel_domains_rrset_v2" "cname_rrset_1" {
zone_id = selectel_domains_zone_v2.zone_1.id
name = "example.com."
type = "CNAME"
ttl = 60
project_id = selectel_vpc_project_v2.project_1.id
records {
content = "origin.com."
# The content value is "<target>"
}
}
MX RRSet
resource "selectel_domains_rrset_v2" "mx_rrset_1" {
zone_id = selectel_domains_zone_v2.zone_1.id
name = "example.com."
type = "MX"
ttl = 60
project_id = selectel_vpc_project_v2.project_1.id
records {
content = "10 mail.example.org."
# The content value is "<priority> <host>"
}
}
NS RRSet
resource "selectel_domains_rrset_v2" "ns_rrset_1" {
zone_id = selectel_domains_zone_v2.zone_1.id
name = "subdomain.example.com."
type = "NS"
ttl = 60
project_id = selectel_vpc_project_v2.project_1.id
records {
content = "a.ns.selectel.ru."
# The content value is "<name_server>"
}
}
SRV RRSet
resource "selectel_domains_rrset_v2" "srv_rrset_1" {
zone_id = selectel_domains_zone_v2.zone_1.id
name = "_sip._tcp.example.com."
type = "SRV"
ttl = 120
project_id = selectel_vpc_project_v2.project_1.id
records {
content = "10 20 30 example.org."
# The content value is "<priority> <weight> <port> <target>"
}
}
SSHFP RRSet
resource "selectel_domains_rrset_v2" "sshfp_rrset_1" {
zone_id = selectel_domains_zone_v2.zone_1.id
name = "example.com."
type = "SSHFP"
ttl = 60
project_id = selectel_vpc_project_v2.project_1.id
records {
content = "1 1 7491973e5f8b39d5327cd4e08bc81b05f7710b49"
# The content value is "<algorithm> <fingerprint_type> <fingerprint>"
}
}
ALIAS RRSet
resource "selectel_domains_rrset_v2" "alias_rrset_1" {
zone_id = selectel_domains_zone_v2.zone_1.id
name = "example.com."
type = "ALIAS"
ttl = 60
project_id = selectel_vpc_project_v2.project_1.id
records {
content = "origin.com."
# The content value is "<target>"
}
}
CAA RRSet
resource "selectel_domains_rrset_v2" "caa_rrset_1" {
zone_id = selectel_domains_zone_v2.zone_1.id
name = "example.com."
type = "CAA"
ttl = 60
project_id = selectel_vpc_project_v2.project_1.id
records {
content = "128 issue \"letsencrypt.com.\""
# The content value is "<flag> <tag> <value>"
}
}
Argument Reference
-
zone_id— (Required) Unique identifier of the zone. Changing this creates a new RRSet. Retrieved from the selectel_domains_zone_v2 resource. -
name— (Required) RRSet name. Changing this creates a new RRSet. The value must be the same as the zone name. IftypeisNS, you can create an RRSet only for a subdomain, so the value must be a subzone name, the parent zone of which is delegated to DNS hosting (actual). IftypeisSRV, the name must include service and protocol, see the example usage for SRV RRSet. -
type— (Required) RRSet type. Changing this creates a new RRSet. Available types areA,AAAA,TXT,CNAME,MX,SRV,SSHFP,ALIAS,CAA. -
ttl— (Required) RRSet time-to-live in seconds. The available range is from 60 to 604800. -
records— (Required) List of records in the RRSet.-
content— (Required) Record value. The value depends on the RRSet type.<ipv4_address>— IPv4-address. Applicable only to A RRSets.<ipv6_address>— IPv6-address. Applicable only to AAAA RRSets.<text>— Any text wrapped in\". Applicable only to TXT RRSets.<target>— Canonical name of the host providing the service with a dot at the end. Applicable only to CNAME, ALIAS, and SRV RRSets.<name_server>— Canonical name of the NS server. Applicable only to NS RRSets.<priority>— Priority of the records preferences. Applicable only to MX and SRV RRSets. Lower value means more preferred.<host>— Name of the mailserver with a dot at the end. Applicable only to MX RRSets.<weight>— Weight for the records with the same priority. Higher value means more preferred. Applicable only to SRV RRSets.<port>— TCP or UDP port of the host of the service. Applicable only to SRV RRSets.<algorithm>— Algorithm of the public key. Applicable only to SSHFP RRSets. Available values are1for RSA,2for DSA,3for ECDSA,4for Ed25519.<fingerprint_type>— Algorithm used to hash the public key. Applicable only to SSHFP RRSets. Available values are1for SHA-1,2for SHA-256.<fingerprint>— Hexadecimal representation of the hash result, as text. Applicable only to SSHFP RRSets.<flag>— Critical value that has a specific meaning per RFC. Applicable only to CAA RRSets. The available range is from 0 to 128.<tag>— Identifier of the property represented by the record. Applicable only to CAA RRSets. Available values areissue,issuewild,iodef,auth,path,policy.<value>— Value associated with the tag wrapped in\". Applicable only to CAA RRSets.
-
disabled— (Optional) Enables or disables the record. Boolean flag, the default value is false.
-
-
project_id— (Required) Unique identifier of the associated Cloud Platform project. Changing this creates a new RRSet. Retrieved from the selectel_vpc_project_v2 resource. Learn more about Cloud Platform projects. -
comment— (Optional) Comment to add to the RRSet.
Attributes Reference
managed_by— RRSet owner.
Import
You can import an RRSet:
export OS_DOMAIN_NAME=<account_id>
export OS_USERNAME=<username>
export OS_PASSWORD=<password>
export SEL_PROJECT_ID=<selectel_project_id>
terraform import selectel_domains_rrset_v2.rrset_1 <zone_name>/<rrset_name>/<rrset_type>
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 top right corner of the Control panel, go to the account menu ⟶ Profile and Settings ⟶ User management ⟶ the Service users tab ⟶ copy the name of the required user. Learn more about Service users. -
<password>— Password of the service user. -
<selectel_project_id>— Unique identifier of the associated Cloud Platform project. To get the project ID, in the Control panel, go to Cloud Platform ⟶ project name ⟶ copy the ID of the required project. Learn more about Cloud Platform projects. -
<zone_name>— Zone name, for example,example.com.. To get the name, in the Control panel, go to DNS. The zone name is in the Zone column. -
<rrset_name>— RRSet name, for example,example.com.. To get the name, in the Control panel, go to DNS → the zone page. The RRSet name is in the Group name column. -
<rrset_type>— RRSet type. To get the type, in the Control panel, go to DNS → the zone page. The RRSet type is in the Type column.