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) (master, slave)

  • group - The group this Domain belongs to.

  • status - Used to control whether this Domain is currently being rendered. (disabled, active)

  • 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/v3/go/linode"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		opt0 := "1234567"
		_, err := linode.LookupDomain(ctx, &GetDomainArgs{
			Id: &opt0,
		}, nil)
		if err != nil {
			return err
		}
		opt1 := "bar.example.com"
		_, err = linode.LookupDomain(ctx, &GetDomainArgs{
			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",
}));
const bar = pulumi.output(linode.getDomain({
    domain: "bar.example.com",
}));

Using getDomain

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

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

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

public static class GetDomain 
{
    public static Task<GetDomainResult> InvokeAsync(GetDomainArgs args, InvokeOptions? opts = null)
    public static Output<GetDomainResult> Invoke(GetDomainInvokeArgs 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.