Oracle Cloud Infrastructure Documentation

Changing DNS Zone Records

Change the records that contain domain information for a domain name service (DNS) zone. You can change various components of the records within zones, such as time-to-live (TTL) and relevant RDATA.

For example, the RDATA of an A or AAAA record contains an IP address for a domain name, while MX records contain information about the mail server for a domain. Oracle Cloud Infrastructure normalizes all RDATA into the most machine-readable format. The returned presentation of RDATA might differ from its initial input. For more information, see Managing Resource Records.
Note

  • Some records are protected and contain information that you can't change.
  • You can't manage records when a zone isn't active.
    • If the zone is updating, wait a few moments and try again.
    • If the zone is in a failed state, delete the zone and re-create it. Be sure the zone name is unique, and that no error exists in any zone file you might have used to create the zone.

For general service information, see the DNS Service Overview

    1. On the Public zones or Private zones list page, select the zone you want to work with. If you need help finding the list page, see Listing DNS Zones.
    2. Select the Records tab.

      A list of records appears. Records that have the same name, type, and TTL are displayed as a single RRset in the Zone Records list.

    3. Select Manage Records.
    4. Use the Filters options to filter by record state or type.
    5. Select the Actions menu (three dots) for the record that you want to update, and select Edit.
    6. In the Edit Record panel, make the changes, and then select Save changes.
      When records are added, they're staged to combine records in an RRSet. Record changes don't take effect until they're published in the next steps.
    7. Select Publish Changes.
    8. On the Confirm page, review the changes and compare them with the previous published version, and then select Confirm publish changes.
  • Important

    • If a record in the zone or RRset doesn't exist in the request body, the record is removed from the zone or RRset.
    • If a specified record doesn't exist, it's created. If the record exists, then it's updated to represent the record in the body of the request.
    • 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.

    • Use the record rrset update command and required parameters to edit a single record in an RRset. 

      oci dns record rrset update --domain FQDN_1 --rtype "record_type_1" --zone-name-or-id zone_name or zone_OCID
--items  '[{"domain":"FQDN_1","rdata":"updated_record_data" ,"rtype":"record_type_1","ttl":"time_to_live_seconds"}]' ... [OPTIONS]

    • Use the record zone update command and required parameters to bulk edit many records in a zone. 

      oci dns record zone update --zone-name-or-id zone_name or zone_OCID --items  
'[{"domain":"FQDN_1","rdata":"updated_record_data","rtype":"record_type_1","ttl":"time_to_live_seconds"};
{"domain":"FQDN_2","rdata":"updated_record_data","rtype":"record_type_1","ttl":"time_to_live_seconds"}]' ... [OPTIONS]

    For a complete list of flags and variable options for CLI commands, see the CLI Command Reference.

  • Important

    • If a specified record doesn't exist, it's created. If the record exists, then it's updated to represent the record in the body of the request.
    • 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.

    • Run the UpdateRrset operation to edit a single record in an RRset in a zone. An RRset is defined as a group of records that have the same name, type, and TTL values.

    • Run the UpdateZoneRecords operation to bulk edit many records in a zone.