Get started with Pulumi in a free one hour introductory workshop. Register Now

GetDomain

Provides information about a Linode domain.

Attributes

The Linode Domain resource exports the following attributes:

  • id - The unique ID of this Domain.

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

  • 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)

  • group - The group this Domain belongs to.

  • status - Used to control whether this Domain is currently being rendered.

  • description - A description for this Domain.

  • master_ips - The IP addresses representing the master DNS for this Domain.

  • axfr_ips - The list of IPs that may perform a zone transfer for this Domain.

  • ttl_sec - ‘Time to Live’-the amount of time in seconds that this Domain’s records may be cached by resolvers or other domain servers.

  • retry_sec - The interval, in seconds, at which a failed refresh should be retried.

  • expire_sec - The amount of time in seconds that may pass before this Domain is no longer authoritative.

  • refresh_sec - The amount of time in seconds before this Domain should be refreshed.

  • soa_email - Start of Authority email address.

  • tags - An array of tags applied to this object.

Example Usage

using Pulumi;
using Linode = Pulumi.Linode;

class MyStack : Stack
{
    public MyStack()
    {
        var foo = Output.Create(Linode.GetDomain.InvokeAsync(new Linode.GetDomainArgs
        {
            Id = "1234567",
        }));
        var bar = Output.Create(Linode.GetDomain.InvokeAsync(new Linode.GetDomainArgs
        {
            Domain = "bar.example.com",
        }));
    }

}
package main

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

func main() {
    pulumi.Run(func(ctx *pulumi.Context) error {
        opt0 := "1234567"
        _, err := linode.LookupDomain(ctx, &linode.LookupDomainArgs{
            Id: &opt0,
        }, nil)
        if err != nil {
            return err
        }
        opt1 := "bar.example.com"
        _, err = linode.LookupDomain(ctx, &linode.LookupDomainArgs{
            Domain: &opt1,
        }, nil)
        if err != nil {
            return err
        }
        return nil
    })
}
import pulumi
import pulumi_linode as linode

foo = linode.get_domain(id="1234567")
bar = linode.get_domain(domain="bar.example.com")
import * as pulumi from "@pulumi/pulumi";
import * as linode from "@pulumi/linode";

const foo = pulumi.output(linode.getDomain({
    id: "1234567",
}, { async: true }));
const bar = pulumi.output(linode.getDomain({
    domain: "bar.example.com",
}, { async: true }));

Using GetDomain

function getDomain(args: GetDomainArgs, opts?: InvokeOptions): Promise<GetDomainResult>
def get_domain(domain: Optional[str] = None, id: Optional[str] = None, opts: Optional[InvokeOptions] = None) -> GetDomainResult
func LookupDomain(ctx *Context, args *LookupDomainArgs, opts ...InvokeOption) (*LookupDomainResult, error)

Note: This function is named LookupDomain in the Go SDK.

public static class GetDomain {
    public static Task<GetDomainResult> InvokeAsync(GetDomainArgs args, InvokeOptions? opts = null)
}

The following arguments are supported:

Domain string

The unique domain name of the Domain record to query.

Id string

The unique numeric ID of the Domain record to query.

Domain string

The unique domain name of the Domain record to query.

Id string

The unique numeric ID of the Domain record to query.

domain string

The unique domain name of the Domain record to query.

id string

The unique numeric ID of the Domain record to query.

domain str

The unique domain name of the Domain record to query.

id str

The unique numeric ID of the Domain record to query.

GetDomain Result

The following output properties are available:

AxfrIps List<string>
Description string
ExpireSec int
Group string
MasterIps List<string>
RefreshSec int
RetrySec int
SoaEmail string
Status string
Tags List<string>
TtlSec int
Type string
Domain string
Id string
AxfrIps []string
Description string
ExpireSec int
Group string
MasterIps []string
RefreshSec int
RetrySec int
SoaEmail string
Status string
Tags []string
TtlSec int
Type string
Domain string
Id string
axfrIps string[]
description string
expireSec number
group string
masterIps string[]
refreshSec number
retrySec number
soaEmail string
status string
tags string[]
ttlSec number
type string
domain string
id string
axfr_ips Sequence[str]
description str
expire_sec int
group str
master_ips Sequence[str]
refresh_sec int
retry_sec int
soa_email str
status str
tags Sequence[str]
ttl_sec int
type str
domain str
id str

Package Details

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