Linode

Pulumi Official
Package maintained by Pulumi
v3.8.0 published on Friday, May 27, 2022 by Pulumi

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 {
		_, err := linode.LookupDomain(ctx, &GetDomainArgs{
			Id: pulumi.StringRef("1234567"),
		}, nil)
		if err != nil {
			return err
		}
		_, err = linode.LookupDomain(ctx, &GetDomainArgs{
			Domain: pulumi.StringRef("bar.example.com"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
package generated_program;

import java.util.*;
import java.io.*;
import java.nio.*;
import com.pulumi.*;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var foo = Output.of(LinodeFunctions.getDomain(GetDomainArgs.builder()
            .id("1234567")
            .build()));

        final var bar = Output.of(LinodeFunctions.getDomain(GetDomainArgs.builder()
            .domain("bar.example.com")
            .build()));

        }
}
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",
}));
variables:
  foo:
    Fn::Invoke:
      Function: linode:getDomain
      Arguments:
        id: 1234567
  bar:
    Fn::Invoke:
      Function: linode:getDomain
      Arguments:
        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)
}
public static CompletableFuture<GetDomainResult> getDomain(GetDomainArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
Fn::Invoke:
  Function: linode:index/getDomain:getDomain
  Arguments:
    # Arguments dictionary

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 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.

domain String

The unique domain name of the Domain record to query.

id String

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 List<String>
description String
expireSec Integer
group String
masterIps List<String>
refreshSec Integer
retrySec Integer
soaEmail String
status String
tags List<String>
ttlSec Integer
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
axfrIps List<String>
description String
expireSec Number
group String
masterIps List<String>
refreshSec Number
retrySec Number
soaEmail String
status String
tags List<String>
ttlSec Number
type String
domain String
id String

Package Details

Repository
https://github.com/pulumi/pulumi-linode
License
Apache-2.0
Notes

This Pulumi package is based on the linode Terraform Provider.