NS1 v3.6.2, Apr 9 25

NS1 v3.6.2 published on Wednesday, Apr 9, 2025 by Pulumi

ns1.getRecord

Explore with Pulumi AI

NS1 v3.6.2 published on Wednesday, Apr 9, 2025 by Pulumi

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as ns1 from "@pulumi/ns1";

// Get details about a NS1 Record.
const example = ns1.getRecord({
    zone: "example.io",
    domain: "terraform.example.io",
    type: "A",
});

import pulumi
import pulumi_ns1 as ns1

# Get details about a NS1 Record.
example = ns1.get_record(zone="example.io",
    domain="terraform.example.io",
    type="A")

package main

import (
	"github.com/pulumi/pulumi-ns1/sdk/v3/go/ns1"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		// Get details about a NS1 Record.
		_, err := ns1.LookupRecord(ctx, &ns1.LookupRecordArgs{
			Zone:   "example.io",
			Domain: "terraform.example.io",
			Type:   "A",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ns1 = Pulumi.Ns1;

return await Deployment.RunAsync(() => 
{
    // Get details about a NS1 Record.
    var example = Ns1.GetRecord.Invoke(new()
    {
        Zone = "example.io",
        Domain = "terraform.example.io",
        Type = "A",
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ns1.Ns1Functions;
import com.pulumi.ns1.inputs.GetRecordArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

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

    public static void stack(Context ctx) {
        // Get details about a NS1 Record.
        final var example = Ns1Functions.getRecord(GetRecordArgs.builder()
            .zone("example.io")
            .domain("terraform.example.io")
            .type("A")
            .build());

    }
}

variables:
  # Get details about a NS1 Record.
  example:
    fn::invoke:
      function: ns1:getRecord
      arguments:
        zone: example.io
        domain: terraform.example.io
        type: A

Using getRecord

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 getRecord(args: GetRecordArgs, opts?: InvokeOptions): Promise<GetRecordResult>
function getRecordOutput(args: GetRecordOutputArgs, opts?: InvokeOptions): Output<GetRecordResult>

def get_record(domain: Optional[str] = None,
               type: Optional[str] = None,
               zone: Optional[str] = None,
               opts: Optional[InvokeOptions] = None) -> GetRecordResult
def get_record_output(domain: Optional[pulumi.Input[str]] = None,
               type: Optional[pulumi.Input[str]] = None,
               zone: Optional[pulumi.Input[str]] = None,
               opts: Optional[InvokeOptions] = None) -> Output[GetRecordResult]

func LookupRecord(ctx *Context, args *LookupRecordArgs, opts ...InvokeOption) (*LookupRecordResult, error)
func LookupRecordOutput(ctx *Context, args *LookupRecordOutputArgs, opts ...InvokeOption) LookupRecordResultOutput

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

public static class GetRecord 
{
    public static Task<GetRecordResult> InvokeAsync(GetRecordArgs args, InvokeOptions? opts = null)
    public static Output<GetRecordResult> Invoke(GetRecordInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetRecordResult> getRecord(GetRecordArgs args, InvokeOptions options)
public static Output<GetRecordResult> getRecord(GetRecordArgs args, InvokeOptions options)

fn::invoke:
  function: ns1:index/getRecord:getRecord
  arguments:
    # arguments dictionary

The following arguments are supported:

Domain string: The records' domain.
Type string: The records' RR type.
Zone string: The zone the record belongs to.

Domain string: The records' domain.
Type string: The records' RR type.
Zone string: The zone the record belongs to.

domain String: The records' domain.
type String: The records' RR type.
zone String: The zone the record belongs to.

domain string: The records' domain.
type string: The records' RR type.
zone string: The zone the record belongs to.

domain str: The records' domain.
type str: The records' RR type.
zone str: The zone the record belongs to.

domain String: The records' domain.
type String: The records' RR type.
zone String: The zone the record belongs to.

getRecord Result

The following output properties are available:

Answers List<GetRecordAnswer>: List of NS1 answers.
Domain string
Filters List<GetRecordFilter>: List of NS1 filters.
Id string: The provider-assigned unique ID for this managed resource.
Link string: The target record this links to.
Meta Dictionary<string, string>: Map of metadata
OverrideAddressRecords bool
OverrideTtl bool
Regions List<GetRecordRegion>: List of regions.
ShortAnswers List<string>
Tags Dictionary<string, string>
Ttl int: The records' time to live (in seconds).
Type string
UseClientSubnet bool: Whether to use EDNS client subnet data when available (in filter chain).
Zone string

Answers []GetRecordAnswer: List of NS1 answers.
Domain string
Filters []GetRecordFilter: List of NS1 filters.
Id string: The provider-assigned unique ID for this managed resource.
Link string: The target record this links to.
Meta map[string]string: Map of metadata
OverrideAddressRecords bool
OverrideTtl bool
Regions []GetRecordRegion: List of regions.
ShortAnswers []string
Tags map[string]string
Ttl int: The records' time to live (in seconds).
Type string
UseClientSubnet bool: Whether to use EDNS client subnet data when available (in filter chain).
Zone string

answers List<GetRecordAnswer>: List of NS1 answers.
domain String
filters List<GetRecordFilter>: List of NS1 filters.
id String: The provider-assigned unique ID for this managed resource.
link String: The target record this links to.
meta Map<String,String>: Map of metadata
overrideAddressRecords Boolean
overrideTtl Boolean
regions List<GetRecordRegion>: List of regions.
shortAnswers List<String>
tags Map<String,String>
ttl Integer: The records' time to live (in seconds).
type String
useClientSubnet Boolean: Whether to use EDNS client subnet data when available (in filter chain).
zone String

answers GetRecordAnswer[]: List of NS1 answers.
domain string
filters GetRecordFilter[]: List of NS1 filters.
id string: The provider-assigned unique ID for this managed resource.
link string: The target record this links to.
meta {[key: string]: string}: Map of metadata
overrideAddressRecords boolean
overrideTtl boolean
regions GetRecordRegion[]: List of regions.
shortAnswers string[]
tags {[key: string]: string}
ttl number: The records' time to live (in seconds).
type string
useClientSubnet boolean: Whether to use EDNS client subnet data when available (in filter chain).
zone string

answers Sequence[GetRecordAnswer]: List of NS1 answers.
domain str
filters Sequence[GetRecordFilter]: List of NS1 filters.
id str: The provider-assigned unique ID for this managed resource.
link str: The target record this links to.
meta Mapping[str, str]: Map of metadata
override_address_records bool
override_ttl bool
regions Sequence[GetRecordRegion]: List of regions.
short_answers Sequence[str]
tags Mapping[str, str]
ttl int: The records' time to live (in seconds).
type str
use_client_subnet bool: Whether to use EDNS client subnet data when available (in filter chain).
zone str

answers List<Property Map>: List of NS1 answers.
domain String
filters List<Property Map>: List of NS1 filters.
id String: The provider-assigned unique ID for this managed resource.
link String: The target record this links to.
meta Map<String>: Map of metadata
overrideAddressRecords Boolean
overrideTtl Boolean
regions List<Property Map>: List of regions.
shortAnswers List<String>
tags Map<String>
ttl Number: The records' time to live (in seconds).
type String
useClientSubnet Boolean: Whether to use EDNS client subnet data when available (in filter chain).
zone String

Supporting Types

GetRecordAnswer

Answer string
Meta Dictionary<string, string>: Map of metadata
Region string

Answer string
Meta map[string]string: Map of metadata
Region string

answer String
meta Map<String,String>: Map of metadata
region String

answer string
meta {[key: string]: string}: Map of metadata
region string

answer str
meta Mapping[str, str]: Map of metadata
region str

answer String
meta Map<String>: Map of metadata
region String

GetRecordFilter

Config Dictionary<string, string>
Disabled bool
Filter string

Config map[string]string
Disabled bool
Filter string

config Map<String,String>
disabled Boolean
filter String

config {[key: string]: string}
disabled boolean
filter string

config Mapping[str, str]
disabled bool
filter str

config Map<String>
disabled Boolean
filter String

GetRecordRegion

Meta Dictionary<string, string>: Map of metadata
Name string

Meta map[string]string: Map of metadata
Name string

meta Map<String,String>: Map of metadata
name String

meta {[key: string]: string}: Map of metadata
name string

meta Mapping[str, str]: Map of metadata
name str

meta Map<String>: Map of metadata
name String

Package Details

Repository: NS1 pulumi/pulumi-ns1
License: Apache-2.0
Notes: This Pulumi package is based on the ns1 Terraform Provider.

NS1 v3.6.2 published on Wednesday, Apr 9, 2025 by Pulumi

pulumi/pulumi-ns1

ns1.getRecord

On this page

On this page

Example Usage

Using getRecord

getRecord Result

Supporting Types

GetRecordAnswer

GetRecordFilter

GetRecordRegion

Package Details

On this page

On this page