Class Domain

Provides a Linode Domain resource. This can be used to create, modify, and delete Linode Domains through Linode's managed DNS service. For more information, see DNS Manager and the Linode APIv4 docs.

Example Usage

using Pulumi;
using Linode = Pulumi.Linode;

class MyStack : Stack
{
public MyStack()
{
    var foobarDomain = new Linode.Domain("foobarDomain", new Linode.DomainArgs
    {
        Domain = "foobar.example",
        SoaEmail = "example@foobar.example",
        Tags = 
        {
            "foo",
            "bar",
        },
        Type = "master",
    });
    var foobarDomainRecord = new Linode.DomainRecord("foobarDomainRecord", new Linode.DomainRecordArgs
    {
        DomainId = foobarDomain.Id,
        Name = "www",
        RecordType = "CNAME",
        Target = "foobar.example",
    });
}

}

Attributes

This resource exports no additional attributes, however status may reflect degraded states.

Inheritance

System.Object

Resource

CustomResource

Domain

Inherited Members

CustomResource.Id

Resource.GetResourceType()

Resource.GetResourceName()

Resource.Urn

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.ToString()

Namespace: Pulumi.Linode

Assembly: Pulumi.Linode.dll

Syntax

public class Domain : CustomResource

Constructors

Domain(String, DomainArgs, CustomResourceOptions)

Create a Domain resource with the given unique name, arguments, and options.

Declaration

public Domain(string name, DomainArgs args, CustomResourceOptions options = null)

Parameters

Type	Name	Description
System.String	name	The unique name of the resource
DomainArgs	args	The arguments used to populate this resource's properties
CustomResourceOptions	options	A bag of options that control this resource's behavior

Properties

AxfrIps

The list of IPs that may perform a zone transfer for this Domain. This is potentially dangerous, and should be set to an empty list unless you intend to use it.

Declaration

public Output<ImmutableArray<string>> AxfrIps { get; }

Property Value

Type	Description
Output<System.Collections.Immutable.ImmutableArray<System.String>>

Description

A description for this Domain. This is for display purposes only.

Declaration

public Output<string> Description { get; }

Property Value

Type	Description
Output<System.String>

DomainName

The domain this Domain represents. These must be unique in our system; you cannot have two Domains representing the same domain.

Declaration

public Output<string> DomainName { get; }

Property Value

Type	Description
Output<System.String>

ExpireSec

The amount of time in seconds that may pass before this Domain is no longer authoritative. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.

Declaration

public Output<int?> ExpireSec { get; }

Property Value

Type	Description
Output<System.Nullable<System.Int32>>

Group

The group this Domain belongs to. This is for display purposes only.

Declaration

public Output<string> Group { get; }

Property Value

Type	Description
Output<System.String>

MasterIps

The IP addresses representing the master DNS for this Domain.

Declaration

public Output<ImmutableArray<string>> MasterIps { get; }

Property Value

Type	Description
Output<System.Collections.Immutable.ImmutableArray<System.String>>

RefreshSec

The amount of time in seconds before this Domain should be refreshed. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.

Declaration

public Output<int?> RefreshSec { get; }

Property Value

Type	Description
Output<System.Nullable<System.Int32>>

RetrySec

The interval, in seconds, at which a failed refresh should be retried. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.

Declaration

public Output<int?> RetrySec { get; }

Property Value

Type	Description
Output<System.Nullable<System.Int32>>

SoaEmail

Start of Authority email address. This is required for master Domains.

Declaration

public Output<string> SoaEmail { get; }

Property Value

Type	Description
Output<System.String>

Status

Used to control whether this Domain is currently being rendered (defaults to "active").

Declaration

public Output<string> Status { get; }

Property Value

Type	Description
Output<System.String>

Tags

A list of tags applied to this object. Tags are for organizational purposes only.

Declaration

public Output<ImmutableArray<string>> Tags { get; }

Property Value

Type	Description
Output<System.Collections.Immutable.ImmutableArray<System.String>>

TtlSec

'Time to Live' - the amount of time in seconds that this Domain's records may be cached by resolvers or other domain servers. Valid values are 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200 - any other value will be rounded to the nearest valid value.

Declaration

public Output<int?> TtlSec { get; }

Property Value

Type	Description
Output<System.Nullable<System.Int32>>

Type

If this Domain represents the authoritative source of information for the domain it describes, or if it is a read-only copy of a master (also called a slave).

Declaration

public Output<string> Type { get; }

Property Value

Type	Description
Output<System.String>

Methods

Get(String, Input<String>, DomainState, CustomResourceOptions)

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

Declaration

public static Domain Get(string name, Input<string> id, DomainState state = null, CustomResourceOptions options = null)

Parameters

Type	Name	Description
System.String	name	The unique name of the resulting resource.
Input<System.String>	id	The unique provider ID of the resource to lookup.
DomainState	state	Any extra arguments used during the lookup.
CustomResourceOptions	options	A bag of options that control this resource's behavior

Returns

Type	Description
Domain