» Data Source: oci_dns_zones

This data source provides the list of Zones in Oracle Cloud Infrastructure Dns service.

Gets a list of all zones in the specified compartment. The collection can be filtered by name, time created, and zone type.

» Example Usage

data "oci_dns_zones" "test_zones" {
    #Required
    compartment_id = "${var.compartment_id}"

    #Optional
    name = "${var.zone_name}"
    name_contains = "${var.zone_name_contains}"
    state = "${var.zone_state}"
    time_created_greater_than_or_equal_to = "${var.zone_time_created_greater_than_or_equal_to}"
    time_created_less_than = "${var.zone_time_created_less_than}"
    zone_type = "${var.zone_zone_type}"
}

» Argument Reference

The following arguments are supported:

  • compartment_id - (Required) The OCID of the compartment the resource belongs to.
  • name - (Optional) A case-sensitive filter for zone names. Will match any zone with a name that equals the provided value.
  • name_contains - (Optional) Search by zone name. Will match any zone whose name (case-insensitive) contains the provided value.
  • sort_by - (Optional) The field by which to sort zones. Allowed values are: name|zoneType|timeCreated
  • sort_order - The order to sort the resources. Allowed values are: ASC|DESC
  • state - (Optional) The state of a resource.
  • time_created_greater_than_or_equal_to - (Optional) An RFC 3339 timestamp that states all returned resources were created on or after the indicated time.
  • time_created_less_than - (Optional) An RFC 3339 timestamp that states all returned resources were created before the indicated time.
  • zone_type - (Optional) Search by zone type, PRIMARY or SECONDARY. Will match any zone whose type equals the provided value.

» Attributes Reference

The following attributes are exported:

  • zones - The list of zones.

» Zone Reference

The following attributes are exported:

  • compartment_id - The OCID of the compartment containing the zone.
  • defined_tags - Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

    Example: {"Operations.CostCenter": "42"}

  • external_masters - External master servers for the zone. externalMasters becomes a required parameter when the zoneType value is SECONDARY.

    • address - The server's IP address (IPv4 or IPv6).
    • port - The server's port. Port value must be a value of 53, otherwise omit the port value.
    • tsig - A TSIG key
      • algorithm - TSIG Algorithms are encoded as domain names, but most consist of only one non-empty label, which is not required to be explicitly absolute. Applicable algorithms include: hmac-sha1, hmac-sha224, hmac-sha256, hmac-sha512. For more information on these algorithms, see RFC 4635.
      • name - A domain name identifying the key for a given pair of hosts.
      • secret - A base64 string encoding the binary shared secret.
  • freeform_tags - Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags.

    Example: {"Department": "Finance"}

  • id - The OCID of the zone.

  • name - The name of the zone.

  • nameservers - The authoritative nameservers for the zone.

    • hostname - The hostname of the nameserver.
  • self - The canonical absolute URL of the resource.

  • serial - The current serial of the zone. As seen in the zone's SOA record.

  • state - The current state of the zone resource.

  • time_created - The date and time the resource was created in "YYYY-MM-ddThh:mmZ" format with a Z offset, as defined by RFC 3339.

    Example: 2016-07-22T17:23:59:60Z

  • version - Version is the never-repeating, totally-orderable, version of the zone, from which the serial field of the zone's SOA record is derived.

  • zone_type - The type of the zone. Must be either PRIMARY or SECONDARY.