oci_dns_rrset

This resource provides the Rrset resource in Oracle Cloud Infrastructure DNS service.

Replaces records in the specified RRSet. When the zone name is provided as a path parameter and the zone has a scope of PRIVATE then the viewId query parameter is required.

Example Usage

resource "oci_dns_rrset" "test_rrset" {
	#Required
	domain = var.rrset_domain
	rtype = var.rrset_rtype
	zone_name_or_id = oci_dns_zone.test_zone.id

	#Optional
	compartment_id = var.compartment_id
	items {
		#Required
		domain = var.rrset_items_domain
		rdata = var.rrset_items_rdata
		rtype = var.rrset_items_rtype
		ttl = var.rrset_items_ttl
	}
	scope = var.rrset_scope
	view_id = oci_dns_view.test_view.id
}

Argument Reference

The following arguments are supported:

• compartment_id - (Optional) (Updatable) The OCID of the compartment the resource belongs to.
• domain - (Required) The target fully-qualified domain name (FQDN) within the target zone.
• items - (Optional) (Updatable) NOTE Omitting items at time of create, will delete any existing records in the RRSet
  • domain - (Required) The fully qualified domain name where the record can be located.
  • rdata - (Required) (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 - (Required) (Updatable) The Time To Live for the record, in seconds.
• rtype - (Required) The type of the target RRSet within the target zone.
• scope - (Optional) Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when creating private Rrsets.
• view_id - (Optional) The OCID of the view the resource is associated with.
• 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:

• items -
  • 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 type of DNS record, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.
  • ttl - The Time To Live for the record, in seconds.

Timeouts

The timeouts block allows you to specify timeouts for certain operations: * create - (Defaults to 20 minutes), when creating the Rrset * update - (Defaults to 20 minutes), when updating the Rrset * delete - (Defaults to 20 minutes), when destroying the Rrset

Import

For legacy Rrsets that were created without using scope, these Rrsets can be imported using the id, e.g.

$ terraform import oci_dns_rrset.test_rrset "zoneNameOrId/{zoneNameOrId}/domain/{domain}/rtype/{rtype}" 

For Rrsets created using scope and view_id, these Rrsets can be imported using the id, e.g.

$ terraform import oci_dns_rrset.test_rrset "zoneNameOrId/{zoneNameOrId}/domain/{domain}/rtype/{rtype}/scope/{scope}/viewId/{viewId}"

skip adding {view_id} at the end if Rrset was created without view_id.