UpdateZoneDetails¶

class oci.dns.models.UpdateZoneDetails(**kwargs)¶

Bases: object

The body for updating a zone.

Warning: Oracle recommends that you avoid using any confidential information when you supply string values using the API.

Attributes

`DNSSEC_STATE_DISABLED`	A constant which can be used with the dnssec_state property of a UpdateZoneDetails.
`DNSSEC_STATE_ENABLED`	A constant which can be used with the dnssec_state property of a UpdateZoneDetails.
`defined_tags`	Gets the defined_tags of this UpdateZoneDetails.
`dnssec_state`	Gets the dnssec_state of this UpdateZoneDetails.
`external_downstreams`	Gets the external_downstreams of this UpdateZoneDetails.
`external_masters`	Gets the external_masters of this UpdateZoneDetails.
`freeform_tags`	Gets the freeform_tags of this UpdateZoneDetails.

Methods

__init__(**kwargs) Initializes a new UpdateZoneDetails object with values from keyword arguments.

DNSSEC_STATE_DISABLED = 'DISABLED'¶: A constant which can be used with the dnssec_state property of a UpdateZoneDetails. This constant has a value of “DISABLED”

DNSSEC_STATE_ENABLED = 'ENABLED'¶: A constant which can be used with the dnssec_state property of a UpdateZoneDetails. This constant has a value of “ENABLED”

__init__(**kwargs)¶

Initializes a new UpdateZoneDetails object with values from keyword arguments. The following keyword arguments are supported (corresponding to the getters/setters of this class):

Parameters:

freeform_tags (dict(str, str)) – The value to assign to the freeform_tags property of this UpdateZoneDetails.
defined_tags (dict(str, dict(str, object))) – The value to assign to the defined_tags property of this UpdateZoneDetails.
dnssec_state (str) – The value to assign to the dnssec_state property of this UpdateZoneDetails. Allowed values for this property are: “ENABLED”, “DISABLED”
external_masters (list[oci.dns.models.ExternalMaster]) – The value to assign to the external_masters property of this UpdateZoneDetails.
external_downstreams (list[oci.dns.models.ExternalDownstream]) – The value to assign to the external_downstreams property of this UpdateZoneDetails.

defined_tags¶

Gets the defined_tags of this UpdateZoneDetails. Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

Example: {“Operations”: {“CostCenter”: “42”}}

Returns:	The defined_tags of this UpdateZoneDetails.
Return type:	dict(str, dict(str, object))

dnssec_state¶

Gets the dnssec_state of this UpdateZoneDetails. The state of DNSSEC on the zone.

For DNSSEC to function, every parent zone in the DNS tree up to the top-level domain (or an independent trust anchor) must also have DNSSEC correctly set up. After enabling DNSSEC, you must add a DS record to the zone’s parent zone containing the KskDnssecKeyVersion data. You can find the DS data in the dsData attribute of the KskDnssecKeyVersion. Then, use the PromoteZoneDnssecKeyVersion operation to promote the KskDnssecKeyVersion.

New KskDnssecKeyVersion`s are generated annually, a week before the existing `KskDnssecKeyVersion’s expiration. To rollover a KskDnssecKeyVersion, you must replace the parent zone’s DS record containing the old KskDnssecKeyVersion data with the data from the new KskDnssecKeyVersion.

To remove the old DS record without causing service disruption, wait until the old DS record’s TTL has expired, and the new DS record has propagated. After the DS replacement has been completed, then the PromoteZoneDnssecKeyVersion operation must be called.

Metrics are emitted in the oci_dns namespace daily for each KskDnssecKeyVersion indicating how many days are left until expiration. We recommend that you set up alarms and notifications for KskDnssecKeyVersion expiration so that the necessary parent zone updates can be made and the PromoteZoneDnssecKeyVersion operation can be called.

Enabling DNSSEC results in additional records in DNS responses which increases their size and can cause higher response latency.

For more information, see DNSSEC.

Allowed values for this property are: “ENABLED”, “DISABLED”

Returns:	The dnssec_state of this UpdateZoneDetails.
Return type:	str

external_downstreams¶

Gets the external_downstreams of this UpdateZoneDetails. External secondary servers for the zone. This field is currently not supported when zoneType is SECONDARY or scope is PRIVATE.

Returns:	The external_downstreams of this UpdateZoneDetails.
Return type:	list[oci.dns.models.ExternalDownstream]

external_masters¶

Gets the external_masters of this UpdateZoneDetails. External master servers for the zone. externalMasters becomes a required parameter when the zoneType value is SECONDARY.

Returns:	The external_masters of this UpdateZoneDetails.
Return type:	list[oci.dns.models.ExternalMaster]

freeform_tags¶

Gets the freeform_tags of this UpdateZoneDetails. 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”}

Returns:	The freeform_tags of this UpdateZoneDetails.
Return type:	dict(str, str)