oci_dns_rrset

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

Updates records in the specified RRSet.

When the zone name is provided as a path parameter and PRIVATE is used for the scope query parameter 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
	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 zone belongs to.

  This parameter is deprecated and should be omitted.

• 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 type of DNS record, 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. Using a TTL lower than 30 seconds is not recommended.

• 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.

• view_id - (Optional) The OCID of the view the zone is associated with. Required when accessing a private zone by name.

• 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. Using a TTL lower than 30 seconds is not recommended.

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.