» oci_dns_record

This resource provides the Record resource in Oracle Cloud Infrastructure Dns service.

Replaces records in the specified zone with the records specified in the request body. If a specified record does not exist, it will be created. If the record exists, then it will be updated to represent the record in the body of the request. If a record in the zone does not exist in the request body, the record will be removed from the zone.

» Example Usage

resource "oci_dns_record" "test_record" {
    #Required
    zone_name_or_id = "${oci_dns_zone_name_or.test_zone_name_or.id}"
    domain = "${var.record_items_domain}"
    rtype = "${var.record_items_rtype}"

    #Optional
    compartment_id = "${var.compartment_id}"
    rdata = "${var.record_items_rdata}"
    ttl = "${var.record_items_ttl}"
}

» Argument Reference

The following arguments are supported:

  • compartment_id - (Optional) (Updatable) The OCID of the compartment the resource belongs to. If supplied, it must match the Zone's compartment ocid.
  • domain - (Required) The fully qualified domain name where the record can be located.
  • rdata - (Optional) (Updatable) The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types
  • rtype - (Required) The canonical name for the record's type, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.
  • ttl - (Optional) (Updatable) The Time To Live for the record, in seconds.
  • zone_name_or_id - (Required) The name or OCID of the target zone.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

» Attributes Reference

The following attributes are exported:

  • compartment_id - The OCID of the compartment the resource belongs to.
  • domain - The fully qualified domain name where the record can be located.
  • is_protected - A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.
  • rdata - The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types
  • record_hash - A unique identifier for the record within its zone.
  • rrset_version - The latest version of the record's zone in which its RRSet differs from the preceding version.
  • rtype - The canonical name for the record's type, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.
  • ttl - The Time To Live for the record, in seconds.
  • zone_name_or_id - The name or OCID of the target zone.