Changing DNS Zone Records
Change the records that contain domain information for a DNS zone. You can change various components of the records within zones, such as time-to-live (TTL) and relevant RDATA.
- 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 there is no error in any zone file you might have used to create the zone.
For general service information, see the DNS Service Overview
- 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.