published on Tuesday, Mar 24, 2026 by g-core
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
- 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 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
webhookurl andwebhook_methodhere webhook will get a map with three arrays: for created, updated and deleted rrsetswebhook_methodcan be omitted, POST will be used by default - Name string
- name of DNS zone
- Nx
Ttl double - Time To Live of cache
- Primary
Server 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
- 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 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
webhookurl andwebhook_methodhere webhook will get a map with three arrays: for created, updated and deleted rrsetswebhook_methodcan be omitted, POST will be used by default - Name string
- name of DNS zone
- Nx
Ttl float64 - Time To Live of cache
- Primary
Server 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
- dnssec
Enabled 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
webhookurl andwebhook_methodhere webhook will get a map with three arrays: for created, updated and deleted rrsetswebhook_methodcan be omitted, POST will be used by default - name String
- name of DNS zone
- nx
Ttl Double - Time To Live of cache
- primary
Server 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
- dnssec
Enabled 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
webhookurl andwebhook_methodhere webhook will get a map with three arrays: for created, updated and deleted rrsetswebhook_methodcan be omitted, POST will be used by default - name string
- name of DNS zone
- nx
Ttl number - Time To Live of cache
- primary
Server 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
webhookurl andwebhook_methodhere webhook will get a map with three arrays: for created, updated and deleted rrsetswebhook_methodcan 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
- dnssec
Enabled 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
webhookurl andwebhook_methodhere webhook will get a map with three arrays: for created, updated and deleted rrsetswebhook_methodcan be omitted, POST will be used by default - name String
- name of DNS zone
- nx
Ttl Number - Time To Live of cache
- primary
Server 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<Dns
Zone Record> - Rrsets
Amount DnsZone Rrsets Amount - 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
[]Dns
Zone Record - Rrsets
Amount DnsZone Rrsets Amount - 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<Dns
Zone Record> - rrsets
Amount DnsZone Rrsets Amount - 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
Dns
Zone Record[] - rrsets
Amount DnsZone Rrsets Amount - 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[Dns
Zone Record] - rrsets_
amount DnsZone Rrsets Amount - 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>
- rrsets
Amount 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) -> DnsZonefunc 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.
- Contact string
- 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 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
webhookurl andwebhook_methodhere webhook will get a map with three arrays: for created, updated and deleted rrsetswebhook_methodcan be omitted, POST will be used by default - Name string
- name of DNS zone
- Nx
Ttl double - Time To Live of cache
- Primary
Server string - primary master name server for zone
- Records
List<Dns
Zone Record> - 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
- Rrsets
Amount DnsZone Rrsets Amount - 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
- 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 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
webhookurl andwebhook_methodhere webhook will get a map with three arrays: for created, updated and deleted rrsetswebhook_methodcan be omitted, POST will be used by default - Name string
- name of DNS zone
- Nx
Ttl float64 - Time To Live of cache
- Primary
Server string - primary master name server for zone
- Records
[]Dns
Zone Record Args - 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
- Rrsets
Amount DnsZone Rrsets Amount Args - 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
- dnssec
Enabled 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
webhookurl andwebhook_methodhere webhook will get a map with three arrays: for created, updated and deleted rrsetswebhook_methodcan be omitted, POST will be used by default - name String
- name of DNS zone
- nx
Ttl Double - Time To Live of cache
- primary
Server String - primary master name server for zone
- records
List<Dns
Zone Record> - 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
- rrsets
Amount DnsZone Rrsets Amount - 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
- dnssec
Enabled 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
webhookurl andwebhook_methodhere webhook will get a map with three arrays: for created, updated and deleted rrsetswebhook_methodcan be omitted, POST will be used by default - name string
- name of DNS zone
- nx
Ttl number - Time To Live of cache
- primary
Server string - primary master name server for zone
- records
Dns
Zone Record[] - 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
- rrsets
Amount DnsZone Rrsets Amount - 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
webhookurl andwebhook_methodhere webhook will get a map with three arrays: for created, updated and deleted rrsetswebhook_methodcan 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[Dns
Zone Record Args] - 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 DnsZone Rrsets Amount Args - 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
- dnssec
Enabled 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
webhookurl andwebhook_methodhere webhook will get a map with three arrays: for created, updated and deleted rrsetswebhook_methodcan be omitted, POST will be used by default - name String
- name of DNS zone
- nx
Ttl Number - Time To Live of cache
- primary
Server 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
- rrsets
Amount 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
- Short
Answers List<string> - Ttl double
- Type string
- Name string
- Short
Answers []string - Ttl float64
- Type string
- name String
- short
Answers List<String> - ttl Double
- type String
- name string
- short
Answers string[] - ttl number
- type string
- name str
- short_
answers Sequence[str] - ttl float
- type str
- name String
- short
Answers List<String> - ttl Number
- type String
DnsZoneRrsetsAmount, DnsZoneRrsetsAmountArgs
- Dynamic
Dns
Zone Rrsets Amount Dynamic - Amount of dynamic RRsets in zone
- Static double
- Amount of static RRsets in zone
- Total double
- Total amount of RRsets in zone
- Dynamic
Dns
Zone Rrsets Amount Dynamic - Amount of dynamic RRsets in zone
- Static float64
- Amount of static RRsets in zone
- Total float64
- Total amount of RRsets in zone
- dynamic
Dns
Zone Rrsets Amount Dynamic - Amount of dynamic RRsets in zone
- static_ Double
- Amount of static RRsets in zone
- total Double
- Total amount of RRsets in zone
- dynamic
Dns
Zone Rrsets Amount Dynamic - Amount of dynamic RRsets in zone
- static number
- Amount of static RRsets in zone
- total number
- Total amount of RRsets in zone
- dynamic
Dns
Zone Rrsets Amount Dynamic - 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
gcoreTerraform Provider.
published on Tuesday, Mar 24, 2026 by g-core
