1. Pulumi Registry
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. Dns
  5. Zone
oci logo
Oracle Cloud Infrastructure v0.13.0, Mar 28 23

oci.Dns.Zone

This resource provides the Zone resource in Oracle Cloud Infrastructure DNS service.

Creates a new zone in the specified compartment. Additionally, for Private DNS, the viewId field is required when creating private zones.

Example Usage

using System.Collections.Generic;
using Pulumi;
using Oci = Pulumi.Oci;

return await Deployment.RunAsync(() => 
{
    var testZone = new Oci.Dns.Zone("testZone", new()
    {
        CompartmentId = @var.Compartment_id,
        ZoneType = @var.Zone_zone_type,
        DefinedTags = @var.Zone_defined_tags,
        ExternalMasters = new[]
        {
            new Oci.Dns.Inputs.ZoneExternalMasterArgs
            {
                Address = @var.Zone_external_masters_address,
                Port = @var.Zone_external_masters_port,
                TsigKeyId = oci_dns_tsig_key.Test_tsig_key.Id,
            },
        },
        FreeformTags = @var.Zone_freeform_tags,
        Scope = @var.Zone_scope,
        ViewId = oci_dns_view.Test_view.Id,
    });

});

package main

import (
	"github.com/pulumi/pulumi-oci/sdk/go/oci/Dns"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := Dns.NewZone(ctx, "testZone", &Dns.ZoneArgs{
			CompartmentId: pulumi.Any(_var.Compartment_id),
			ZoneType:      pulumi.Any(_var.Zone_zone_type),
			DefinedTags:   pulumi.Any(_var.Zone_defined_tags),
			ExternalMasters: dns.ZoneExternalMasterArray{
				&dns.ZoneExternalMasterArgs{
					Address:   pulumi.Any(_var.Zone_external_masters_address),
					Port:      pulumi.Any(_var.Zone_external_masters_port),
					TsigKeyId: pulumi.Any(oci_dns_tsig_key.Test_tsig_key.Id),
				},
			},
			FreeformTags: pulumi.Any(_var.Zone_freeform_tags),
			Scope:        pulumi.Any(_var.Zone_scope),
			ViewId:       pulumi.Any(oci_dns_view.Test_view.Id),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Dns.Zone;
import com.pulumi.oci.Dns.ZoneArgs;
import com.pulumi.oci.Dns.inputs.ZoneExternalMasterArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var testZone = new Zone("testZone", ZoneArgs.builder()        
            .compartmentId(var_.compartment_id())
            .zoneType(var_.zone_zone_type())
            .definedTags(var_.zone_defined_tags())
            .externalMasters(ZoneExternalMasterArgs.builder()
                .address(var_.zone_external_masters_address())
                .port(var_.zone_external_masters_port())
                .tsigKeyId(oci_dns_tsig_key.test_tsig_key().id())
                .build())
            .freeformTags(var_.zone_freeform_tags())
            .scope(var_.zone_scope())
            .viewId(oci_dns_view.test_view().id())
            .build());

    }
}

import pulumi
import pulumi_oci as oci

test_zone = oci.dns.Zone("testZone",
    compartment_id=var["compartment_id"],
    zone_type=var["zone_zone_type"],
    defined_tags=var["zone_defined_tags"],
    external_masters=[oci.dns.ZoneExternalMasterArgs(
        address=var["zone_external_masters_address"],
        port=var["zone_external_masters_port"],
        tsig_key_id=oci_dns_tsig_key["test_tsig_key"]["id"],
    )],
    freeform_tags=var["zone_freeform_tags"],
    scope=var["zone_scope"],
    view_id=oci_dns_view["test_view"]["id"])

import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";

const testZone = new oci.dns.Zone("testZone", {
    compartmentId: _var.compartment_id,
    zoneType: _var.zone_zone_type,
    definedTags: _var.zone_defined_tags,
    externalMasters: [{
        address: _var.zone_external_masters_address,
        port: _var.zone_external_masters_port,
        tsigKeyId: oci_dns_tsig_key.test_tsig_key.id,
    }],
    freeformTags: _var.zone_freeform_tags,
    scope: _var.zone_scope,
    viewId: oci_dns_view.test_view.id,
});

resources:
  testZone:
    type: oci:Dns:Zone
    properties:
      #Required
      compartmentId: ${var.compartment_id}
      zoneType: ${var.zone_zone_type}
      #Optional
      definedTags: ${var.zone_defined_tags}
      externalMasters:
        - address: ${var.zone_external_masters_address}
          port: ${var.zone_external_masters_port}
          tsigKeyId: ${oci_dns_tsig_key.test_tsig_key.id}
      freeformTags: ${var.zone_freeform_tags}
      scope: ${var.zone_scope}
      viewId: ${oci_dns_view.test_view.id}

Create Zone Resource

new Zone(name: string, args: ZoneArgs, opts?: CustomResourceOptions);
@overload
def Zone(resource_name: str,
         opts: Optional[ResourceOptions] = None,
         compartment_id: Optional[str] = None,
         defined_tags: Optional[Mapping[str, Any]] = None,
         external_masters: Optional[Sequence[_dns.ZoneExternalMasterArgs]] = None,
         freeform_tags: Optional[Mapping[str, Any]] = None,
         name: Optional[str] = None,
         scope: Optional[str] = None,
         view_id: Optional[str] = None,
         zone_type: Optional[str] = None)
@overload
def Zone(resource_name: str,
         args: ZoneArgs,
         opts: Optional[ResourceOptions] = None)
func NewZone(ctx *Context, name string, args ZoneArgs, opts ...ResourceOption) (*Zone, error)
public Zone(string name, ZoneArgs args, CustomResourceOptions? opts = null)
public Zone(String name, ZoneArgs args)
public Zone(String name, ZoneArgs args, CustomResourceOptions options)

type: oci:Dns:Zone
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
name string
The unique name of the resource.
args ZoneArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name str
The unique name of the resource.
args ZoneArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name string
The unique name of the resource.
args ZoneArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name string
The unique name of the resource.
args ZoneArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name String
The unique name of the resource.
args ZoneArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

Zone Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

The Zone resource accepts the following input properties:

CompartmentId string

(Updatable) The OCID of the compartment the resource belongs to.

ZoneType string

The type of the zone. Must be either PRIMARY or SECONDARY. SECONDARY is only supported for GLOBAL zones.

DefinedTags Dictionary<string, object>

(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

ExternalMasters List<ZoneExternalMasterArgs>

(Updatable) External master servers for the zone. externalMasters becomes a required parameter when the zoneType value is SECONDARY.

FreeformTags Dictionary<string, object>

(Updatable) 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.

Name string

The name of the zone.

Scope string

Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when creating a private zone.

ViewId string

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.

CompartmentId string

(Updatable) The OCID of the compartment the resource belongs to.

ZoneType string

The type of the zone. Must be either PRIMARY or SECONDARY. SECONDARY is only supported for GLOBAL zones.

DefinedTags map[string]interface{}

(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

ExternalMasters []ZoneExternalMasterArgs

(Updatable) External master servers for the zone. externalMasters becomes a required parameter when the zoneType value is SECONDARY.

FreeformTags map[string]interface{}

(Updatable) 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.

Name string

The name of the zone.

Scope string

Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when creating a private zone.

ViewId string

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.

compartmentId String

(Updatable) The OCID of the compartment the resource belongs to.

zoneType String

The type of the zone. Must be either PRIMARY or SECONDARY. SECONDARY is only supported for GLOBAL zones.

definedTags Map<String,Object>

(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

externalMasters List<ZoneExternalMasterArgs>

(Updatable) External master servers for the zone. externalMasters becomes a required parameter when the zoneType value is SECONDARY.

freeformTags Map<String,Object>

(Updatable) 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.

name String

The name of the zone.

scope String

Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when creating a private zone.

viewId String

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.

compartmentId string

(Updatable) The OCID of the compartment the resource belongs to.

zoneType string

The type of the zone. Must be either PRIMARY or SECONDARY. SECONDARY is only supported for GLOBAL zones.

definedTags {[key: string]: any}

(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

externalMasters ZoneExternalMasterArgs[]

(Updatable) External master servers for the zone. externalMasters becomes a required parameter when the zoneType value is SECONDARY.

freeformTags {[key: string]: any}

(Updatable) 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.

name string

The name of the zone.

scope string

Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when creating a private zone.

viewId string

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.

compartment_id str

(Updatable) The OCID of the compartment the resource belongs to.

zone_type str

The type of the zone. Must be either PRIMARY or SECONDARY. SECONDARY is only supported for GLOBAL zones.

defined_tags Mapping[str, Any]

(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

external_masters ZoneExternalMasterArgs]

(Updatable) External master servers for the zone. externalMasters becomes a required parameter when the zoneType value is SECONDARY.

freeform_tags Mapping[str, Any]

(Updatable) 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.

name str

The name of the zone.

scope str

Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when creating a private zone.

view_id str

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.

compartmentId String

(Updatable) The OCID of the compartment the resource belongs to.

zoneType String

The type of the zone. Must be either PRIMARY or SECONDARY. SECONDARY is only supported for GLOBAL zones.

definedTags Map<Any>

(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

externalMasters List<Property Map>

(Updatable) External master servers for the zone. externalMasters becomes a required parameter when the zoneType value is SECONDARY.

freeformTags Map<Any>

(Updatable) 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.

name String

The name of the zone.

scope String

Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when creating a private zone.

viewId String

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.

Outputs

All input properties are implicitly available as output properties. Additionally, the Zone resource produces the following output properties:

Id string

The provider-assigned unique ID for this managed resource.

IsProtected bool

A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.

Nameservers List<ZoneNameserver>

The authoritative nameservers for the zone.

Self string

The canonical absolute URL of the resource.

Serial int

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

State string

The current state of the zone resource.

TimeCreated string

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

Version string

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

Id string

The provider-assigned unique ID for this managed resource.

IsProtected bool

A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.

Nameservers []ZoneNameserver

The authoritative nameservers for the zone.

Self string

The canonical absolute URL of the resource.

Serial int

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

State string

The current state of the zone resource.

TimeCreated string

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

Version string

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

id String

The provider-assigned unique ID for this managed resource.

isProtected Boolean

A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.

nameservers List<ZoneNameserver>

The authoritative nameservers for the zone.

self String

The canonical absolute URL of the resource.

serial Integer

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

state String

The current state of the zone resource.

timeCreated String

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

version String

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

id string

The provider-assigned unique ID for this managed resource.

isProtected boolean

A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.

nameservers ZoneNameserver[]

The authoritative nameservers for the zone.

self string

The canonical absolute URL of the resource.

serial number

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

state string

The current state of the zone resource.

timeCreated string

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

version string

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

id str

The provider-assigned unique ID for this managed resource.

is_protected bool

A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.

nameservers ZoneNameserver]

The authoritative nameservers for the zone.

self str

The canonical absolute URL of the resource.

serial int

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

state str

The current state of the zone resource.

time_created str

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

version str

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

id String

The provider-assigned unique ID for this managed resource.

isProtected Boolean

A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.

nameservers List<Property Map>

The authoritative nameservers for the zone.

self String

The canonical absolute URL of the resource.

serial Number

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

state String

The current state of the zone resource.

timeCreated String

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

version String

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

Look up Existing Zone Resource

Get an existing Zone resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: ZoneState, opts?: CustomResourceOptions): Zone
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        compartment_id: Optional[str] = None,
        defined_tags: Optional[Mapping[str, Any]] = None,
        external_masters: Optional[Sequence[_dns.ZoneExternalMasterArgs]] = None,
        freeform_tags: Optional[Mapping[str, Any]] = None,
        is_protected: Optional[bool] = None,
        name: Optional[str] = None,
        nameservers: Optional[Sequence[_dns.ZoneNameserverArgs]] = None,
        scope: Optional[str] = None,
        self: Optional[str] = None,
        serial: Optional[int] = None,
        state: Optional[str] = None,
        time_created: Optional[str] = None,
        version: Optional[str] = None,
        view_id: Optional[str] = None,
        zone_type: Optional[str] = None) -> Zone
func GetZone(ctx *Context, name string, id IDInput, state *ZoneState, opts ...ResourceOption) (*Zone, error)
public static Zone Get(string name, Input<string> id, ZoneState? state, CustomResourceOptions? opts = null)
public static Zone get(String name, Output<String> id, ZoneState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
resource_name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
The following state arguments are supported:
CompartmentId string

(Updatable) The OCID of the compartment the resource belongs to.

DefinedTags Dictionary<string, object>

(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

ExternalMasters List<ZoneExternalMasterArgs>

(Updatable) External master servers for the zone. externalMasters becomes a required parameter when the zoneType value is SECONDARY.

FreeformTags Dictionary<string, object>

(Updatable) 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.

IsProtected bool

A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.

Name string

The name of the zone.

Nameservers List<ZoneNameserverArgs>

The authoritative nameservers for the zone.

Scope string

Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when creating a private zone.

Self string

The canonical absolute URL of the resource.

Serial int

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

State string

The current state of the zone resource.

TimeCreated string

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

Version string

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

ViewId string

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.

ZoneType string

The type of the zone. Must be either PRIMARY or SECONDARY. SECONDARY is only supported for GLOBAL zones.

CompartmentId string

(Updatable) The OCID of the compartment the resource belongs to.

DefinedTags map[string]interface{}

(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

ExternalMasters []ZoneExternalMasterArgs

(Updatable) External master servers for the zone. externalMasters becomes a required parameter when the zoneType value is SECONDARY.

FreeformTags map[string]interface{}

(Updatable) 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.

IsProtected bool

A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.

Name string

The name of the zone.

Nameservers []ZoneNameserverArgs

The authoritative nameservers for the zone.

Scope string

Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when creating a private zone.

Self string

The canonical absolute URL of the resource.

Serial int

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

State string

The current state of the zone resource.

TimeCreated string

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

Version string

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

ViewId string

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.

ZoneType string

The type of the zone. Must be either PRIMARY or SECONDARY. SECONDARY is only supported for GLOBAL zones.

compartmentId String

(Updatable) The OCID of the compartment the resource belongs to.

definedTags Map<String,Object>

(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

externalMasters List<ZoneExternalMasterArgs>

(Updatable) External master servers for the zone. externalMasters becomes a required parameter when the zoneType value is SECONDARY.

freeformTags Map<String,Object>

(Updatable) 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.

isProtected Boolean

A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.

name String

The name of the zone.

nameservers List<ZoneNameserverArgs>

The authoritative nameservers for the zone.

scope String

Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when creating a private zone.

self String

The canonical absolute URL of the resource.

serial Integer

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

state String

The current state of the zone resource.

timeCreated String

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

version String

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

viewId String

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.

zoneType String

The type of the zone. Must be either PRIMARY or SECONDARY. SECONDARY is only supported for GLOBAL zones.

compartmentId string

(Updatable) The OCID of the compartment the resource belongs to.

definedTags {[key: string]: any}

(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

externalMasters ZoneExternalMasterArgs[]

(Updatable) External master servers for the zone. externalMasters becomes a required parameter when the zoneType value is SECONDARY.

freeformTags {[key: string]: any}

(Updatable) 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.

isProtected boolean

A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.

name string

The name of the zone.

nameservers ZoneNameserverArgs[]

The authoritative nameservers for the zone.

scope string

Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when creating a private zone.

self string

The canonical absolute URL of the resource.

serial number

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

state string

The current state of the zone resource.

timeCreated string

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

version string

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

viewId string

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.

zoneType string

The type of the zone. Must be either PRIMARY or SECONDARY. SECONDARY is only supported for GLOBAL zones.

compartment_id str

(Updatable) The OCID of the compartment the resource belongs to.

defined_tags Mapping[str, Any]

(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

external_masters ZoneExternalMasterArgs]

(Updatable) External master servers for the zone. externalMasters becomes a required parameter when the zoneType value is SECONDARY.

freeform_tags Mapping[str, Any]

(Updatable) 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.

is_protected bool

A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.

name str

The name of the zone.

nameservers ZoneNameserverArgs]

The authoritative nameservers for the zone.

scope str

Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when creating a private zone.

self str

The canonical absolute URL of the resource.

serial int

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

state str

The current state of the zone resource.

time_created str

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

version str

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

view_id str

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.

zone_type str

The type of the zone. Must be either PRIMARY or SECONDARY. SECONDARY is only supported for GLOBAL zones.

compartmentId String

(Updatable) The OCID of the compartment the resource belongs to.

definedTags Map<Any>

(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

externalMasters List<Property Map>

(Updatable) External master servers for the zone. externalMasters becomes a required parameter when the zoneType value is SECONDARY.

freeformTags Map<Any>

(Updatable) 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.

isProtected Boolean

A Boolean flag indicating whether or not parts of the resource are unable to be explicitly managed.

name String

The name of the zone.

nameservers List<Property Map>

The authoritative nameservers for the zone.

scope String

Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when creating a private zone.

self String

The canonical absolute URL of the resource.

serial Number

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

state String

The current state of the zone resource.

timeCreated String

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

version String

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

viewId String

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.

zoneType String

The type of the zone. Must be either PRIMARY or SECONDARY. SECONDARY is only supported for GLOBAL zones.

Supporting Types

ZoneExternalMaster

Address string

(Updatable) The server's IP address (IPv4 or IPv6).

Port int

(Updatable) The server's port. Port value must be a value of 53, otherwise omit the port value.

TsigKeyId string

(Updatable) The OCID of the TSIG key.

Address string

(Updatable) The server's IP address (IPv4 or IPv6).

Port int

(Updatable) The server's port. Port value must be a value of 53, otherwise omit the port value.

TsigKeyId string

(Updatable) The OCID of the TSIG key.

address String

(Updatable) The server's IP address (IPv4 or IPv6).

port Integer

(Updatable) The server's port. Port value must be a value of 53, otherwise omit the port value.

tsigKeyId String

(Updatable) The OCID of the TSIG key.

address string

(Updatable) The server's IP address (IPv4 or IPv6).

port number

(Updatable) The server's port. Port value must be a value of 53, otherwise omit the port value.

tsigKeyId string

(Updatable) The OCID of the TSIG key.

address str

(Updatable) The server's IP address (IPv4 or IPv6).

port int

(Updatable) The server's port. Port value must be a value of 53, otherwise omit the port value.

tsig_key_id str

(Updatable) The OCID of the TSIG key.

address String

(Updatable) The server's IP address (IPv4 or IPv6).

port Number

(Updatable) The server's port. Port value must be a value of 53, otherwise omit the port value.

tsigKeyId String

(Updatable) The OCID of the TSIG key.

ZoneNameserver

Hostname string

The hostname of the nameserver.

Hostname string

The hostname of the nameserver.

hostname String

The hostname of the nameserver.

hostname string

The hostname of the nameserver.

hostname str

The hostname of the nameserver.

hostname String

The hostname of the nameserver.

Import

Zones can be imported using their OCID, e.g.

 $ pulumi import oci:Dns/zone:Zone test_zone "id"

Package Details

Repository
oci pulumi/pulumi-oci
License
Apache-2.0
Notes

This Pulumi package is based on the oci Terraform Provider.