Constructor and Description |
---|
Builder() |
Modifier and Type | Method and Description |
---|---|
Zone |
build() |
Zone.Builder |
compartmentId(String compartmentId)
The OCID of the compartment containing the zone.
|
Zone.Builder |
copy(Zone model) |
Zone.Builder |
definedTags(Map<String,Map<String,Object>> definedTags)
Defined tags for this resource.
|
Zone.Builder |
dnssecConfig(DnssecConfig dnssecConfig) |
Zone.Builder |
dnssecState(ZoneDnssecState dnssecState)
The state of DNSSEC on the zone.
|
Zone.Builder |
externalDownstreams(List<ExternalDownstream> externalDownstreams)
External secondary servers for the zone.
|
Zone.Builder |
externalMasters(List<ExternalMaster> externalMasters)
External master servers for the zone.
|
Zone.Builder |
freeformTags(Map<String,String> freeformTags)
Free-form tags for this resource.
|
Zone.Builder |
id(String id)
The OCID of the zone.
|
Zone.Builder |
isProtected(Boolean isProtected)
A Boolean flag indicating whether or not parts of the resource are unable to be
explicitly managed.
|
Zone.Builder |
lifecycleState(Zone.LifecycleState lifecycleState)
The current state of the zone resource.
|
Zone.Builder |
name(String name)
The name of the zone.
|
Zone.Builder |
nameservers(List<Nameserver> nameservers)
The authoritative nameservers for the zone.
|
Zone.Builder |
scope(Scope scope)
The scope of the zone.
|
Zone.Builder |
self(String self)
The canonical absolute URL of the resource.
|
Zone.Builder |
serial(Long serial)
The current serial of the zone.
|
Zone.Builder |
timeCreated(Date timeCreated)
The date and time the resource was created in “YYYY-MM-ddThh:mm:ssZ” format with a Z
offset, as defined by RFC 3339.
|
Zone.Builder |
version(String 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.Builder |
viewId(String viewId)
The OCID of the private view containing the zone.
|
Zone.Builder |
zoneTransferServers(List<ZoneTransferServer> zoneTransferServers)
The OCI nameservers that transfer the zone data with external nameservers.
|
Zone.Builder |
zoneType(Zone.ZoneType zoneType)
The type of the zone.
|
public Zone.Builder name(String name)
The name of the zone.
name
- the value to setpublic Zone.Builder zoneType(Zone.ZoneType zoneType)
The type of the zone. Must be either PRIMARY
or SECONDARY
. SECONDARY
is only supported for GLOBAL zones.
zoneType
- the value to setpublic Zone.Builder compartmentId(String compartmentId)
The OCID of the compartment containing the zone.
compartmentId
- the value to setpublic Zone.Builder viewId(String viewId)
The OCID of the private view containing the zone. This value will be null for zones in the global DNS, which are publicly resolvable and not part of a private view.
viewId
- the value to setpublic Zone.Builder scope(Scope scope)
The scope of the zone.
scope
- the value to setpublic Zone.Builder freeformTags(Map<String,String> freeformTags)
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"}
freeformTags
- the value to setpublic Zone.Builder definedTags(Map<String,Map<String,Object>> definedTags)
Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
**Example:** {"Operations": {"CostCenter": "42"}}
definedTags
- the value to setpublic Zone.Builder dnssecState(ZoneDnssecState dnssecState)
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](https://docs.cloud.oracle.com/iaas/Content/DNS/Concepts/dnssec.htm).
dnssecState
- the value to setpublic Zone.Builder externalMasters(List<ExternalMaster> externalMasters)
External master servers for the zone. externalMasters
becomes a required
parameter when the zoneType
value is SECONDARY
.
externalMasters
- the value to setpublic Zone.Builder externalDownstreams(List<ExternalDownstream> externalDownstreams)
External secondary servers for the zone. This field is currently not supported when
zoneType
is SECONDARY
or scope
is PRIVATE
.
externalDownstreams
- the value to setpublic Zone.Builder self(String self)
The canonical absolute URL of the resource.
self
- the value to setpublic Zone.Builder id(String id)
The OCID of the zone.
id
- the value to setpublic Zone.Builder timeCreated(Date timeCreated)
The date and time the resource was created in “YYYY-MM-ddThh:mm:ssZ” format with a Z offset, as defined by RFC 3339.
*Example:** 2016-07-22T17:23:59:60Z
timeCreated
- the value to setpublic Zone.Builder version(String 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.
version
- the value to setpublic Zone.Builder serial(Long serial)
The current serial of the zone. As seen in the zone’s SOA record.
serial
- the value to setpublic Zone.Builder lifecycleState(Zone.LifecycleState lifecycleState)
The current state of the zone resource.
lifecycleState
- the value to setpublic Zone.Builder isProtected(Boolean isProtected)
A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.
isProtected
- the value to setpublic Zone.Builder dnssecConfig(DnssecConfig dnssecConfig)
public Zone.Builder nameservers(List<Nameserver> nameservers)
The authoritative nameservers for the zone.
nameservers
- the value to setpublic Zone.Builder zoneTransferServers(List<ZoneTransferServer> zoneTransferServers)
The OCI nameservers that transfer the zone data with external nameservers.
zoneTransferServers
- the value to setpublic Zone build()
public Zone.Builder copy(Zone model)
Copyright © 2016–2024. All rights reserved.