1. Packages
  2. Gcore Provider
  3. API Docs
  4. DnsZone
Viewing docs for gcore 2.0.0-alpha.2
published on Tuesday, Mar 24, 2026 by g-core
gcore logo
Viewing docs for gcore 2.0.0-alpha.2
published on Tuesday, Mar 24, 2026 by g-core

    DNS zones are authoritative containers for domain name records, with support for DNSSEC and SOA configuration.

    Example Usage

    Basic DNS zone

    Creates a DNS zone with default settings.

    import * as pulumi from "@pulumi/pulumi";
    import * as gcore from "@pulumi/gcore";
    
    // Basic DNS Zone
    const example = new gcore.DnsZone("example", {name: "example.com"});
    
    import pulumi
    import pulumi_gcore as gcore
    
    # Basic DNS Zone
    example = gcore.DnsZone("example", name="example.com")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/v2/gcore"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		// Basic DNS Zone
    		_, err := gcore.NewDnsZone(ctx, "example", &gcore.DnsZoneArgs{
    			Name: pulumi.String("example.com"),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Gcore = Pulumi.Gcore;
    
    return await Deployment.RunAsync(() => 
    {
        // Basic DNS Zone
        var example = new Gcore.DnsZone("example", new()
        {
            Name = "example.com",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.gcore.DnsZone;
    import com.pulumi.gcore.DnsZoneArgs;
    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) {
            // Basic DNS Zone
            var example = new DnsZone("example", DnsZoneArgs.builder()
                .name("example.com")
                .build());
    
        }
    }
    
    resources:
      # Basic DNS Zone
      example:
        type: gcore:DnsZone
        properties:
          name: example.com
    

    DNS zone with SOA configuration

    Creates a DNS zone with custom SOA record fields.

    import * as pulumi from "@pulumi/pulumi";
    import * as gcore from "@pulumi/gcore";
    
    // DNS Zone with SOA configuration
    const advanced = new gcore.DnsZone("advanced", {
        name: "advanced-example.com",
        enabled: true,
        contact: "admin@advanced-example.com",
        expiry: 604800,
        nxTtl: 3600,
        primaryServer: "ns1.advanced-example.com.",
        refresh: 3600,
        retry: 1800,
    });
    
    import pulumi
    import pulumi_gcore as gcore
    
    # DNS Zone with SOA configuration
    advanced = gcore.DnsZone("advanced",
        name="advanced-example.com",
        enabled=True,
        contact="admin@advanced-example.com",
        expiry=604800,
        nx_ttl=3600,
        primary_server="ns1.advanced-example.com.",
        refresh=3600,
        retry=1800)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/v2/gcore"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		// DNS Zone with SOA configuration
    		_, err := gcore.NewDnsZone(ctx, "advanced", &gcore.DnsZoneArgs{
    			Name:          pulumi.String("advanced-example.com"),
    			Enabled:       pulumi.Bool(true),
    			Contact:       pulumi.String("admin@advanced-example.com"),
    			Expiry:        pulumi.Float64(604800),
    			NxTtl:         pulumi.Float64(3600),
    			PrimaryServer: pulumi.String("ns1.advanced-example.com."),
    			Refresh:       pulumi.Float64(3600),
    			Retry:         pulumi.Float64(1800),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Gcore = Pulumi.Gcore;
    
    return await Deployment.RunAsync(() => 
    {
        // DNS Zone with SOA configuration
        var advanced = new Gcore.DnsZone("advanced", new()
        {
            Name = "advanced-example.com",
            Enabled = true,
            Contact = "admin@advanced-example.com",
            Expiry = 604800,
            NxTtl = 3600,
            PrimaryServer = "ns1.advanced-example.com.",
            Refresh = 3600,
            Retry = 1800,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.gcore.DnsZone;
    import com.pulumi.gcore.DnsZoneArgs;
    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) {
            // DNS Zone with SOA configuration
            var advanced = new DnsZone("advanced", DnsZoneArgs.builder()
                .name("advanced-example.com")
                .enabled(true)
                .contact("admin@advanced-example.com")
                .expiry(604800.0)
                .nxTtl(3600.0)
                .primaryServer("ns1.advanced-example.com.")
                .refresh(3600.0)
                .retry(1800.0)
                .build());
    
        }
    }
    
    resources:
      # DNS Zone with SOA configuration
      advanced:
        type: gcore:DnsZone
        properties:
          name: advanced-example.com
          enabled: true # SOA record fields
          contact: admin@advanced-example.com
          expiry: 604800
          nxTtl: 3600
          primaryServer: ns1.advanced-example.com.
          refresh: 3600
          retry: 1800
    

    Create DnsZone Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new DnsZone(name: string, args?: DnsZoneArgs, opts?: CustomResourceOptions);
    @overload
    def DnsZone(resource_name: str,
                args: Optional[DnsZoneArgs] = None,
                opts: Optional[ResourceOptions] = None)
    
    @overload
    def DnsZone(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                contact: Optional[str] = None,
                dnssec_enabled: Optional[bool] = None,
                enabled: Optional[bool] = None,
                expiry: Optional[float] = None,
                meta: Optional[Mapping[str, str]] = None,
                name: Optional[str] = None,
                nx_ttl: Optional[float] = None,
                primary_server: Optional[str] = None,
                refresh: Optional[float] = None,
                retry: Optional[float] = None)
    func NewDnsZone(ctx *Context, name string, args *DnsZoneArgs, opts ...ResourceOption) (*DnsZone, error)
    public DnsZone(string name, DnsZoneArgs? args = null, CustomResourceOptions? opts = null)
    public DnsZone(String name, DnsZoneArgs args)
    public DnsZone(String name, DnsZoneArgs args, CustomResourceOptions options)
    
    type: gcore:DnsZone
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args DnsZoneArgs
    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 DnsZoneArgs
    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 DnsZoneArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args DnsZoneArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args DnsZoneArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var dnsZoneResource = new Gcore.DnsZone("dnsZoneResource", new()
    {
        Contact = "string",
        DnssecEnabled = false,
        Enabled = false,
        Expiry = 0,
        Meta = 
        {
            { "string", "string" },
        },
        Name = "string",
        NxTtl = 0,
        PrimaryServer = "string",
        Refresh = 0,
        Retry = 0,
    });
    
    example, err := gcore.NewDnsZone(ctx, "dnsZoneResource", &gcore.DnsZoneArgs{
    	Contact:       pulumi.String("string"),
    	DnssecEnabled: pulumi.Bool(false),
    	Enabled:       pulumi.Bool(false),
    	Expiry:        pulumi.Float64(0),
    	Meta: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	Name:          pulumi.String("string"),
    	NxTtl:         pulumi.Float64(0),
    	PrimaryServer: pulumi.String("string"),
    	Refresh:       pulumi.Float64(0),
    	Retry:         pulumi.Float64(0),
    })
    
    var dnsZoneResource = new DnsZone("dnsZoneResource", DnsZoneArgs.builder()
        .contact("string")
        .dnssecEnabled(false)
        .enabled(false)
        .expiry(0.0)
        .meta(Map.of("string", "string"))
        .name("string")
        .nxTtl(0.0)
        .primaryServer("string")
        .refresh(0.0)
        .retry(0.0)
        .build());
    
    dns_zone_resource = gcore.DnsZone("dnsZoneResource",
        contact="string",
        dnssec_enabled=False,
        enabled=False,
        expiry=0,
        meta={
            "string": "string",
        },
        name="string",
        nx_ttl=0,
        primary_server="string",
        refresh=0,
        retry=0)
    
    const dnsZoneResource = new gcore.DnsZone("dnsZoneResource", {
        contact: "string",
        dnssecEnabled: false,
        enabled: false,
        expiry: 0,
        meta: {
            string: "string",
        },
        name: "string",
        nxTtl: 0,
        primaryServer: "string",
        refresh: 0,
        retry: 0,
    });
    
    type: gcore:DnsZone
    properties:
        contact: string
        dnssecEnabled: false
        enabled: false
        expiry: 0
        meta:
            string: string
        name: string
        nxTtl: 0
        primaryServer: string
        refresh: 0
        retry: 0
    

    DnsZone Resource Properties

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

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The DnsZone resource accepts the following input properties:

    Contact string
    email address of the administrator responsible for this zone
    DnssecEnabled bool
    Whether DNSSEC is enabled for the zone. Set to true to enable DNSSEC, false to disable. Managed via a separate API endpoint.
    Enabled bool
    If a zone is disabled, then its records will not be resolved on dns servers
    Expiry double
    number of seconds after which secondary name servers should stop answering request for this zone
    Meta Dictionary<string, string>
    arbitrarily data of zone in json format you can specify webhook url and webhook_method here webhook will get a map with three arrays: for created, updated and deleted rrsets webhook_method can be omitted, POST will be used by default
    Name string
    name of DNS zone
    NxTtl double
    Time To Live of cache
    PrimaryServer string
    primary master name server for zone
    Refresh double
    number of seconds after which secondary name servers should query the master for the SOA record, to detect zone changes.
    Retry double
    number of seconds after which secondary name servers should retry to request the serial number
    Contact string
    email address of the administrator responsible for this zone
    DnssecEnabled bool
    Whether DNSSEC is enabled for the zone. Set to true to enable DNSSEC, false to disable. Managed via a separate API endpoint.
    Enabled bool
    If a zone is disabled, then its records will not be resolved on dns servers
    Expiry float64
    number of seconds after which secondary name servers should stop answering request for this zone
    Meta map[string]string
    arbitrarily data of zone in json format you can specify webhook url and webhook_method here webhook will get a map with three arrays: for created, updated and deleted rrsets webhook_method can be omitted, POST will be used by default
    Name string
    name of DNS zone
    NxTtl float64
    Time To Live of cache
    PrimaryServer string
    primary master name server for zone
    Refresh float64
    number of seconds after which secondary name servers should query the master for the SOA record, to detect zone changes.
    Retry float64
    number of seconds after which secondary name servers should retry to request the serial number
    contact String
    email address of the administrator responsible for this zone
    dnssecEnabled Boolean
    Whether DNSSEC is enabled for the zone. Set to true to enable DNSSEC, false to disable. Managed via a separate API endpoint.
    enabled Boolean
    If a zone is disabled, then its records will not be resolved on dns servers
    expiry Double
    number of seconds after which secondary name servers should stop answering request for this zone
    meta Map<String,String>
    arbitrarily data of zone in json format you can specify webhook url and webhook_method here webhook will get a map with three arrays: for created, updated and deleted rrsets webhook_method can be omitted, POST will be used by default
    name String
    name of DNS zone
    nxTtl Double
    Time To Live of cache
    primaryServer String
    primary master name server for zone
    refresh Double
    number of seconds after which secondary name servers should query the master for the SOA record, to detect zone changes.
    retry Double
    number of seconds after which secondary name servers should retry to request the serial number
    contact string
    email address of the administrator responsible for this zone
    dnssecEnabled boolean
    Whether DNSSEC is enabled for the zone. Set to true to enable DNSSEC, false to disable. Managed via a separate API endpoint.
    enabled boolean
    If a zone is disabled, then its records will not be resolved on dns servers
    expiry number
    number of seconds after which secondary name servers should stop answering request for this zone
    meta {[key: string]: string}
    arbitrarily data of zone in json format you can specify webhook url and webhook_method here webhook will get a map with three arrays: for created, updated and deleted rrsets webhook_method can be omitted, POST will be used by default
    name string
    name of DNS zone
    nxTtl number
    Time To Live of cache
    primaryServer string
    primary master name server for zone
    refresh number
    number of seconds after which secondary name servers should query the master for the SOA record, to detect zone changes.
    retry number
    number of seconds after which secondary name servers should retry to request the serial number
    contact str
    email address of the administrator responsible for this zone
    dnssec_enabled bool
    Whether DNSSEC is enabled for the zone. Set to true to enable DNSSEC, false to disable. Managed via a separate API endpoint.
    enabled bool
    If a zone is disabled, then its records will not be resolved on dns servers
    expiry float
    number of seconds after which secondary name servers should stop answering request for this zone
    meta Mapping[str, str]
    arbitrarily data of zone in json format you can specify webhook url and webhook_method here webhook will get a map with three arrays: for created, updated and deleted rrsets webhook_method can be omitted, POST will be used by default
    name str
    name of DNS zone
    nx_ttl float
    Time To Live of cache
    primary_server str
    primary master name server for zone
    refresh float
    number of seconds after which secondary name servers should query the master for the SOA record, to detect zone changes.
    retry float
    number of seconds after which secondary name servers should retry to request the serial number
    contact String
    email address of the administrator responsible for this zone
    dnssecEnabled Boolean
    Whether DNSSEC is enabled for the zone. Set to true to enable DNSSEC, false to disable. Managed via a separate API endpoint.
    enabled Boolean
    If a zone is disabled, then its records will not be resolved on dns servers
    expiry Number
    number of seconds after which secondary name servers should stop answering request for this zone
    meta Map<String>
    arbitrarily data of zone in json format you can specify webhook url and webhook_method here webhook will get a map with three arrays: for created, updated and deleted rrsets webhook_method can be omitted, POST will be used by default
    name String
    name of DNS zone
    nxTtl Number
    Time To Live of cache
    primaryServer String
    primary master name server for zone
    refresh Number
    number of seconds after which secondary name servers should query the master for the SOA record, to detect zone changes.
    retry Number
    number of seconds after which secondary name servers should retry to request the serial number

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Records List<DnsZoneRecord>
    RrsetsAmount DnsZoneRrsetsAmount
    Serial double
    Serial number for this zone. Server-managed: always derived from the zone's last modification timestamp.
    Status string
    Warnings List<string>
    Id string
    The provider-assigned unique ID for this managed resource.
    Records []DnsZoneRecord
    RrsetsAmount DnsZoneRrsetsAmount
    Serial float64
    Serial number for this zone. Server-managed: always derived from the zone's last modification timestamp.
    Status string
    Warnings []string
    id String
    The provider-assigned unique ID for this managed resource.
    records List<DnsZoneRecord>
    rrsetsAmount DnsZoneRrsetsAmount
    serial Double
    Serial number for this zone. Server-managed: always derived from the zone's last modification timestamp.
    status String
    warnings List<String>
    id string
    The provider-assigned unique ID for this managed resource.
    records DnsZoneRecord[]
    rrsetsAmount DnsZoneRrsetsAmount
    serial number
    Serial number for this zone. Server-managed: always derived from the zone's last modification timestamp.
    status string
    warnings string[]
    id str
    The provider-assigned unique ID for this managed resource.
    records Sequence[DnsZoneRecord]
    rrsets_amount DnsZoneRrsetsAmount
    serial float
    Serial number for this zone. Server-managed: always derived from the zone's last modification timestamp.
    status str
    warnings Sequence[str]
    id String
    The provider-assigned unique ID for this managed resource.
    records List<Property Map>
    rrsetsAmount Property Map
    serial Number
    Serial number for this zone. Server-managed: always derived from the zone's last modification timestamp.
    status String
    warnings List<String>

    Look up Existing DnsZone Resource

    Get an existing DnsZone 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?: DnsZoneState, opts?: CustomResourceOptions): DnsZone
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            contact: Optional[str] = None,
            dnssec_enabled: Optional[bool] = None,
            enabled: Optional[bool] = None,
            expiry: Optional[float] = None,
            meta: Optional[Mapping[str, str]] = None,
            name: Optional[str] = None,
            nx_ttl: Optional[float] = None,
            primary_server: Optional[str] = None,
            records: Optional[Sequence[DnsZoneRecordArgs]] = None,
            refresh: Optional[float] = None,
            retry: Optional[float] = None,
            rrsets_amount: Optional[DnsZoneRrsetsAmountArgs] = None,
            serial: Optional[float] = None,
            status: Optional[str] = None,
            warnings: Optional[Sequence[str]] = None) -> DnsZone
    func GetDnsZone(ctx *Context, name string, id IDInput, state *DnsZoneState, opts ...ResourceOption) (*DnsZone, error)
    public static DnsZone Get(string name, Input<string> id, DnsZoneState? state, CustomResourceOptions? opts = null)
    public static DnsZone get(String name, Output<String> id, DnsZoneState state, CustomResourceOptions options)
    resources:  _:    type: gcore:DnsZone    get:      id: ${id}
    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:
    Contact string
    email address of the administrator responsible for this zone
    DnssecEnabled bool
    Whether DNSSEC is enabled for the zone. Set to true to enable DNSSEC, false to disable. Managed via a separate API endpoint.
    Enabled bool
    If a zone is disabled, then its records will not be resolved on dns servers
    Expiry double
    number of seconds after which secondary name servers should stop answering request for this zone
    Meta Dictionary<string, string>
    arbitrarily data of zone in json format you can specify webhook url and webhook_method here webhook will get a map with three arrays: for created, updated and deleted rrsets webhook_method can be omitted, POST will be used by default
    Name string
    name of DNS zone
    NxTtl double
    Time To Live of cache
    PrimaryServer string
    primary master name server for zone
    Records List<DnsZoneRecord>
    Refresh double
    number of seconds after which secondary name servers should query the master for the SOA record, to detect zone changes.
    Retry double
    number of seconds after which secondary name servers should retry to request the serial number
    RrsetsAmount DnsZoneRrsetsAmount
    Serial double
    Serial number for this zone. Server-managed: always derived from the zone's last modification timestamp.
    Status string
    Warnings List<string>
    Contact string
    email address of the administrator responsible for this zone
    DnssecEnabled bool
    Whether DNSSEC is enabled for the zone. Set to true to enable DNSSEC, false to disable. Managed via a separate API endpoint.
    Enabled bool
    If a zone is disabled, then its records will not be resolved on dns servers
    Expiry float64
    number of seconds after which secondary name servers should stop answering request for this zone
    Meta map[string]string
    arbitrarily data of zone in json format you can specify webhook url and webhook_method here webhook will get a map with three arrays: for created, updated and deleted rrsets webhook_method can be omitted, POST will be used by default
    Name string
    name of DNS zone
    NxTtl float64
    Time To Live of cache
    PrimaryServer string
    primary master name server for zone
    Records []DnsZoneRecordArgs
    Refresh float64
    number of seconds after which secondary name servers should query the master for the SOA record, to detect zone changes.
    Retry float64
    number of seconds after which secondary name servers should retry to request the serial number
    RrsetsAmount DnsZoneRrsetsAmountArgs
    Serial float64
    Serial number for this zone. Server-managed: always derived from the zone's last modification timestamp.
    Status string
    Warnings []string
    contact String
    email address of the administrator responsible for this zone
    dnssecEnabled Boolean
    Whether DNSSEC is enabled for the zone. Set to true to enable DNSSEC, false to disable. Managed via a separate API endpoint.
    enabled Boolean
    If a zone is disabled, then its records will not be resolved on dns servers
    expiry Double
    number of seconds after which secondary name servers should stop answering request for this zone
    meta Map<String,String>
    arbitrarily data of zone in json format you can specify webhook url and webhook_method here webhook will get a map with three arrays: for created, updated and deleted rrsets webhook_method can be omitted, POST will be used by default
    name String
    name of DNS zone
    nxTtl Double
    Time To Live of cache
    primaryServer String
    primary master name server for zone
    records List<DnsZoneRecord>
    refresh Double
    number of seconds after which secondary name servers should query the master for the SOA record, to detect zone changes.
    retry Double
    number of seconds after which secondary name servers should retry to request the serial number
    rrsetsAmount DnsZoneRrsetsAmount
    serial Double
    Serial number for this zone. Server-managed: always derived from the zone's last modification timestamp.
    status String
    warnings List<String>
    contact string
    email address of the administrator responsible for this zone
    dnssecEnabled boolean
    Whether DNSSEC is enabled for the zone. Set to true to enable DNSSEC, false to disable. Managed via a separate API endpoint.
    enabled boolean
    If a zone is disabled, then its records will not be resolved on dns servers
    expiry number
    number of seconds after which secondary name servers should stop answering request for this zone
    meta {[key: string]: string}
    arbitrarily data of zone in json format you can specify webhook url and webhook_method here webhook will get a map with three arrays: for created, updated and deleted rrsets webhook_method can be omitted, POST will be used by default
    name string
    name of DNS zone
    nxTtl number
    Time To Live of cache
    primaryServer string
    primary master name server for zone
    records DnsZoneRecord[]
    refresh number
    number of seconds after which secondary name servers should query the master for the SOA record, to detect zone changes.
    retry number
    number of seconds after which secondary name servers should retry to request the serial number
    rrsetsAmount DnsZoneRrsetsAmount
    serial number
    Serial number for this zone. Server-managed: always derived from the zone's last modification timestamp.
    status string
    warnings string[]
    contact str
    email address of the administrator responsible for this zone
    dnssec_enabled bool
    Whether DNSSEC is enabled for the zone. Set to true to enable DNSSEC, false to disable. Managed via a separate API endpoint.
    enabled bool
    If a zone is disabled, then its records will not be resolved on dns servers
    expiry float
    number of seconds after which secondary name servers should stop answering request for this zone
    meta Mapping[str, str]
    arbitrarily data of zone in json format you can specify webhook url and webhook_method here webhook will get a map with three arrays: for created, updated and deleted rrsets webhook_method can be omitted, POST will be used by default
    name str
    name of DNS zone
    nx_ttl float
    Time To Live of cache
    primary_server str
    primary master name server for zone
    records Sequence[DnsZoneRecordArgs]
    refresh float
    number of seconds after which secondary name servers should query the master for the SOA record, to detect zone changes.
    retry float
    number of seconds after which secondary name servers should retry to request the serial number
    rrsets_amount DnsZoneRrsetsAmountArgs
    serial float
    Serial number for this zone. Server-managed: always derived from the zone's last modification timestamp.
    status str
    warnings Sequence[str]
    contact String
    email address of the administrator responsible for this zone
    dnssecEnabled Boolean
    Whether DNSSEC is enabled for the zone. Set to true to enable DNSSEC, false to disable. Managed via a separate API endpoint.
    enabled Boolean
    If a zone is disabled, then its records will not be resolved on dns servers
    expiry Number
    number of seconds after which secondary name servers should stop answering request for this zone
    meta Map<String>
    arbitrarily data of zone in json format you can specify webhook url and webhook_method here webhook will get a map with three arrays: for created, updated and deleted rrsets webhook_method can be omitted, POST will be used by default
    name String
    name of DNS zone
    nxTtl Number
    Time To Live of cache
    primaryServer String
    primary master name server for zone
    records List<Property Map>
    refresh Number
    number of seconds after which secondary name servers should query the master for the SOA record, to detect zone changes.
    retry Number
    number of seconds after which secondary name servers should retry to request the serial number
    rrsetsAmount Property Map
    serial Number
    Serial number for this zone. Server-managed: always derived from the zone's last modification timestamp.
    status String
    warnings List<String>

    Supporting Types

    DnsZoneRecord, DnsZoneRecordArgs

    Name string
    ShortAnswers List<string>
    Ttl double
    Type string
    Name string
    ShortAnswers []string
    Ttl float64
    Type string
    name String
    shortAnswers List<String>
    ttl Double
    type String
    name string
    shortAnswers string[]
    ttl number
    type string
    name str
    short_answers Sequence[str]
    ttl float
    type str
    name String
    shortAnswers List<String>
    ttl Number
    type String

    DnsZoneRrsetsAmount, DnsZoneRrsetsAmountArgs

    Dynamic DnsZoneRrsetsAmountDynamic
    Amount of dynamic RRsets in zone
    Static double
    Amount of static RRsets in zone
    Total double
    Total amount of RRsets in zone
    Dynamic DnsZoneRrsetsAmountDynamic
    Amount of dynamic RRsets in zone
    Static float64
    Amount of static RRsets in zone
    Total float64
    Total amount of RRsets in zone
    dynamic DnsZoneRrsetsAmountDynamic
    Amount of dynamic RRsets in zone
    static_ Double
    Amount of static RRsets in zone
    total Double
    Total amount of RRsets in zone
    dynamic DnsZoneRrsetsAmountDynamic
    Amount of dynamic RRsets in zone
    static number
    Amount of static RRsets in zone
    total number
    Total amount of RRsets in zone
    dynamic DnsZoneRrsetsAmountDynamic
    Amount of dynamic RRsets in zone
    static float
    Amount of static RRsets in zone
    total float
    Total amount of RRsets in zone
    dynamic Property Map
    Amount of dynamic RRsets in zone
    static Number
    Amount of static RRsets in zone
    total Number
    Total amount of RRsets in zone

    DnsZoneRrsetsAmountDynamic, DnsZoneRrsetsAmountDynamicArgs

    Healthcheck double
    Amount of RRsets with enabled healthchecks
    Total double
    Total amount of dynamic RRsets in zone
    Healthcheck float64
    Amount of RRsets with enabled healthchecks
    Total float64
    Total amount of dynamic RRsets in zone
    healthcheck Double
    Amount of RRsets with enabled healthchecks
    total Double
    Total amount of dynamic RRsets in zone
    healthcheck number
    Amount of RRsets with enabled healthchecks
    total number
    Total amount of dynamic RRsets in zone
    healthcheck float
    Amount of RRsets with enabled healthchecks
    total float
    Total amount of dynamic RRsets in zone
    healthcheck Number
    Amount of RRsets with enabled healthchecks
    total Number
    Total amount of dynamic RRsets in zone

    Import

    $ pulumi import gcore:index/dnsZone:DnsZone example '<name>'
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    gcore g-core/terraform-provider-gcore
    License
    Notes
    This Pulumi package is based on the gcore Terraform Provider.
    gcore logo
    Viewing docs for gcore 2.0.0-alpha.2
    published on Tuesday, Mar 24, 2026 by g-core
      Try Pulumi Cloud free. Your team will thank you.