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 Omittingitems
at time of create, will delete any existing records in the RRSetdomain
- (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 andPRIVATE
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 Typesrecord_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
.