Want to learn about running containers in Lambda? Join our free hands-on workshop. Register Now

DnsZone

The akamai.edgedns.DnsZone provides the resource for configuring a dns zone to integrate easily with your existing DNS infrastructure to provide a secure, high performance, highly available and scalable solution for DNS hosting.

Example Usage

Basic usage:

using Pulumi;
using Akamai = Pulumi.Akamai;

class MyStack : Stack
{
    public MyStack()
    {
        var demozone = new Akamai.Edgedns.DnsZone("demozone", new Akamai.Edgedns.DnsZoneArgs
        {
            Comment = "some comment",
            Contract = "ctr_XXX",
            Group = "100",
            Masters = 
            {
                "1.2.3.4",
                "1.2.3.5",
            },
            SignAndServe = false,
            Type = "secondary",
            Zone = "example.com",
        });
    }

}
package main

import (
    "github.com/pulumi/pulumi-akamai/sdk/go/akamai/edgedns"
    "github.com/pulumi/pulumi/sdk/v2/go/pulumi"
)

func main() {
    pulumi.Run(func(ctx *pulumi.Context) error {
        _, err := edgedns.NewDnsZone(ctx, "demozone", &edgedns.DnsZoneArgs{
            Comment:  pulumi.String("some comment"),
            Contract: pulumi.String("ctr_XXX"),
            Group:    pulumi.String("100"),
            Masters: pulumi.StringArray{
                pulumi.String("1.2.3.4"),
                pulumi.String("1.2.3.5"),
            },
            SignAndServe: pulumi.Bool(false),
            Type:         pulumi.String("secondary"),
            Zone:         pulumi.String("example.com"),
        })
        if err != nil {
            return err
        }
        return nil
    })
}
import pulumi
import pulumi_akamai as akamai

demozone = akamai.edgedns.DnsZone("demozone",
    comment="some comment",
    contract="ctr_XXX",
    group=100,
    masters=[
        "1.2.3.4",
        "1.2.3.5",
    ],
    sign_and_serve=False,
    type="secondary",
    zone="example.com")
import * as pulumi from "@pulumi/pulumi";
import * as akamai from "@pulumi/akamai";

const demozone = new akamai.edgedns.DnsZone("demozone", {
    comment: "some comment",
    contract: "ctr_XXX",
    group: "100",
    masters: [
        "1.2.3.4",
        "1.2.3.5",
    ],
    signAndServe: false,
    type: "secondary",
    zone: "example.com",
});

Create a DnsZone Resource

new DnsZone(name: string, args: DnsZoneArgs, opts?: CustomResourceOptions);
def DnsZone(resource_name, opts=None, comment=None, contract=None, end_customer_id=None, group=None, masters=None, sign_and_serve=None, sign_and_serve_algorithm=None, target=None, tsig_key=None, type=None, zone=None, __props__=None)
func NewDnsZone(ctx *Context, name string, args DnsZoneArgs, opts ...ResourceOption) (*DnsZone, error)
public DnsZone(string name, DnsZoneArgs args, CustomResourceOptions? opts = null)
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.
opts ResourceOptions
A bag of options that control this 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.

DnsZone Resource Properties

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

Inputs

The DnsZone resource accepts the following input properties:

Contract string

— (Required) The contract ID.

Group string

— (Required) The currently selected group ID.

Type string

— (Required) Whether the zone is primary or secondary.

Zone string

— (Required) Domain zone, encapsulating any nested subdomains.

Comment string

— (Required) A descriptive comment.

EndCustomerId string

— (Optional)

Masters List<string>

— (Required for Secondary) The names or addresses of the customer’s nameservers from which the zone data should be retrieved.

SignAndServe bool

— (Optional) Whether DNSSEC Sign&Serve is enabled.

SignAndServeAlgorithm string

— (Optional) Algorithm used by Sign&Serve.

Target string

— (Required for Alias)

TsigKey DnsZoneTsigKeyArgs

— (Optional) TSIG Key used in secure zone transfers

Contract string

— (Required) The contract ID.

Group string

— (Required) The currently selected group ID.

Type string

— (Required) Whether the zone is primary or secondary.

Zone string

— (Required) Domain zone, encapsulating any nested subdomains.

Comment string

— (Required) A descriptive comment.

EndCustomerId string

— (Optional)

Masters []string

— (Required for Secondary) The names or addresses of the customer’s nameservers from which the zone data should be retrieved.

SignAndServe bool

— (Optional) Whether DNSSEC Sign&Serve is enabled.

SignAndServeAlgorithm string

— (Optional) Algorithm used by Sign&Serve.

Target string

— (Required for Alias)

TsigKey DnsZoneTsigKey

— (Optional) TSIG Key used in secure zone transfers

contract string

— (Required) The contract ID.

group string

— (Required) The currently selected group ID.

type string

— (Required) Whether the zone is primary or secondary.

zone string

— (Required) Domain zone, encapsulating any nested subdomains.

comment string

— (Required) A descriptive comment.

endCustomerId string

— (Optional)

masters string[]

— (Required for Secondary) The names or addresses of the customer’s nameservers from which the zone data should be retrieved.

signAndServe boolean

— (Optional) Whether DNSSEC Sign&Serve is enabled.

signAndServeAlgorithm string

— (Optional) Algorithm used by Sign&Serve.

target string

— (Required for Alias)

tsigKey DnsZoneTsigKey

— (Optional) TSIG Key used in secure zone transfers

contract str

— (Required) The contract ID.

group str

— (Required) The currently selected group ID.

type str

— (Required) Whether the zone is primary or secondary.

zone str

— (Required) Domain zone, encapsulating any nested subdomains.

comment str

— (Required) A descriptive comment.

end_customer_id str

— (Optional)

masters List[str]

— (Required for Secondary) The names or addresses of the customer’s nameservers from which the zone data should be retrieved.

sign_and_serve bool

— (Optional) Whether DNSSEC Sign&Serve is enabled.

sign_and_serve_algorithm str

— (Optional) Algorithm used by Sign&Serve.

target str

— (Required for Alias)

tsig_key Dict[DnsZoneTsigKey]

— (Optional) TSIG Key used in secure zone transfers

Outputs

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

ActivationState string
AliasCount int
Id string
The provider-assigned unique ID for this managed resource.
VersionId string
ActivationState string
AliasCount int
Id string
The provider-assigned unique ID for this managed resource.
VersionId string
activationState string
aliasCount number
id string
The provider-assigned unique ID for this managed resource.
versionId string
activation_state str
alias_count float
id str
The provider-assigned unique ID for this managed resource.
version_id str

Look up an 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
static get(resource_name, id, opts=None, activation_state=None, alias_count=None, comment=None, contract=None, end_customer_id=None, group=None, masters=None, sign_and_serve=None, sign_and_serve_algorithm=None, target=None, tsig_key=None, type=None, version_id=None, zone=None, __props__=None)
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)
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.

The following state arguments are supported:

ActivationState string
AliasCount int
Comment string

— (Required) A descriptive comment.

Contract string

— (Required) The contract ID.

EndCustomerId string

— (Optional)

Group string

— (Required) The currently selected group ID.

Masters List<string>

— (Required for Secondary) The names or addresses of the customer’s nameservers from which the zone data should be retrieved.

SignAndServe bool

— (Optional) Whether DNSSEC Sign&Serve is enabled.

SignAndServeAlgorithm string

— (Optional) Algorithm used by Sign&Serve.

Target string

— (Required for Alias)

TsigKey DnsZoneTsigKeyArgs

— (Optional) TSIG Key used in secure zone transfers

Type string

— (Required) Whether the zone is primary or secondary.

VersionId string
Zone string

— (Required) Domain zone, encapsulating any nested subdomains.

ActivationState string
AliasCount int
Comment string

— (Required) A descriptive comment.

Contract string

— (Required) The contract ID.

EndCustomerId string

— (Optional)

Group string

— (Required) The currently selected group ID.

Masters []string

— (Required for Secondary) The names or addresses of the customer’s nameservers from which the zone data should be retrieved.

SignAndServe bool

— (Optional) Whether DNSSEC Sign&Serve is enabled.

SignAndServeAlgorithm string

— (Optional) Algorithm used by Sign&Serve.

Target string

— (Required for Alias)

TsigKey DnsZoneTsigKey

— (Optional) TSIG Key used in secure zone transfers

Type string

— (Required) Whether the zone is primary or secondary.

VersionId string
Zone string

— (Required) Domain zone, encapsulating any nested subdomains.

activationState string
aliasCount number
comment string

— (Required) A descriptive comment.

contract string

— (Required) The contract ID.

endCustomerId string

— (Optional)

group string

— (Required) The currently selected group ID.

masters string[]

— (Required for Secondary) The names or addresses of the customer’s nameservers from which the zone data should be retrieved.

signAndServe boolean

— (Optional) Whether DNSSEC Sign&Serve is enabled.

signAndServeAlgorithm string

— (Optional) Algorithm used by Sign&Serve.

target string

— (Required for Alias)

tsigKey DnsZoneTsigKey

— (Optional) TSIG Key used in secure zone transfers

type string

— (Required) Whether the zone is primary or secondary.

versionId string
zone string

— (Required) Domain zone, encapsulating any nested subdomains.

activation_state str
alias_count float
comment str

— (Required) A descriptive comment.

contract str

— (Required) The contract ID.

end_customer_id str

— (Optional)

group str

— (Required) The currently selected group ID.

masters List[str]

— (Required for Secondary) The names or addresses of the customer’s nameservers from which the zone data should be retrieved.

sign_and_serve bool

— (Optional) Whether DNSSEC Sign&Serve is enabled.

sign_and_serve_algorithm str

— (Optional) Algorithm used by Sign&Serve.

target str

— (Required for Alias)

tsig_key Dict[DnsZoneTsigKey]

— (Optional) TSIG Key used in secure zone transfers

type str

— (Required) Whether the zone is primary or secondary.

version_id str
zone str

— (Required) Domain zone, encapsulating any nested subdomains.

Supporting Types

DnsZoneTsigKey

See the input and output API doc for this type.

See the input and output API doc for this type.

See the input and output API doc for this type.

Algorithm string
Name string

key name * algorithm * secret

Secret string
Algorithm string
Name string

key name * algorithm * secret

Secret string
algorithm string
name string

key name * algorithm * secret

secret string
algorithm str
name str

key name * algorithm * secret

secret str

Package Details

Repository
https://github.com/pulumi/pulumi-akamai
License
Apache-2.0
Notes
This Pulumi package is based on the akamai Terraform Provider.