1. Packages
  2. Packages
  3. Ionoscloud
  4. API Docs
  5. getDnsReverseRecord
Viewing docs for IonosCloud v0.3.0
published on Wednesday, Apr 15, 2026 by ionos-cloud
Schema (JSON)
ionos-cloud/pulumi-ionoscloud

ionoscloud.getDnsReverseRecord

ionoscloud logo
Viewing docs for IonosCloud v0.3.0
published on Wednesday, Apr 15, 2026 by ionos-cloud
Schema (JSON)
ionos-cloud/pulumi-ionoscloud

    The DNS Reverse Record can be used to search for and return an existing DNS Reverse Record. If a single match is found, it will be returned. If your search results in multiple matches, an error will be returned. When this happens, please refine your search and make sure that your resources have unique names.

    ⚠️ Only tokens are accepted for authorization in the ionoscloud_dns_reverse_record data source. Please ensure you are using tokens as other methods will not be valid.

    Example Usage

    By ID

    import * as pulumi from "@pulumi/pulumi";
import * as ionoscloud from "@ionos-cloud/sdk-pulumi";

const example = ionoscloud.getDnsReverseRecord({
    id: "record_id",
});

    import pulumi
import pulumi_ionoscloud as ionoscloud

example = ionoscloud.get_dns_reverse_record(id="record_id")

    package main

import (
	"github.com/ionos-cloud/pulumi-ionoscloud/sdk/go/ionoscloud"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ionoscloud.GetDnsReverseRecord(ctx, &ionoscloud.LookupDnsReverseRecordArgs{
			Id: pulumi.StringRef("record_id"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var example = Ionoscloud.Index.GetDnsReverseRecord.Invoke(new()
    {
        Id = "record_id",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ionoscloud.IonoscloudFunctions;
import com.pulumi.ionoscloud.inputs.GetDnsReverseRecordArgs;
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) {
        final var example = IonoscloudFunctions.getDnsReverseRecord(GetDnsReverseRecordArgs.builder()
            .id("record_id")
            .build());

    }
}

    variables:
  example:
    fn::invoke:
      function: ionoscloud:getDnsReverseRecord
      arguments:
        id: record_id

    By name

    import * as pulumi from "@pulumi/pulumi";
import * as ionoscloud from "@ionos-cloud/sdk-pulumi";

const example = ionoscloud.getDnsReverseRecord({
    name: "recordexample",
});

    import pulumi
import pulumi_ionoscloud as ionoscloud

example = ionoscloud.get_dns_reverse_record(name="recordexample")

    package main

import (
	"github.com/ionos-cloud/pulumi-ionoscloud/sdk/go/ionoscloud"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ionoscloud.GetDnsReverseRecord(ctx, &ionoscloud.LookupDnsReverseRecordArgs{
			Name: pulumi.StringRef("recordexample"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var example = Ionoscloud.Index.GetDnsReverseRecord.Invoke(new()
    {
        Name = "recordexample",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ionoscloud.IonoscloudFunctions;
import com.pulumi.ionoscloud.inputs.GetDnsReverseRecordArgs;
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) {
        final var example = IonoscloudFunctions.getDnsReverseRecord(GetDnsReverseRecordArgs.builder()
            .name("recordexample")
            .build());

    }
}

    variables:
  example:
    fn::invoke:
      function: ionoscloud:getDnsReverseRecord
      arguments:
        name: recordexample

    By name with partial match

    import * as pulumi from "@pulumi/pulumi";
import * as ionoscloud from "@ionos-cloud/sdk-pulumi";

const example = ionoscloud.getDnsReverseRecord({
    name: "record",
    partialMatch: true,
});

    import pulumi
import pulumi_ionoscloud as ionoscloud

example = ionoscloud.get_dns_reverse_record(name="record",
    partial_match=True)

    package main

import (
	"github.com/ionos-cloud/pulumi-ionoscloud/sdk/go/ionoscloud"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ionoscloud.GetDnsReverseRecord(ctx, &ionoscloud.LookupDnsReverseRecordArgs{
			Name:         pulumi.StringRef("record"),
			PartialMatch: pulumi.BoolRef(true),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var example = Ionoscloud.Index.GetDnsReverseRecord.Invoke(new()
    {
        Name = "record",
        PartialMatch = true,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ionoscloud.IonoscloudFunctions;
import com.pulumi.ionoscloud.inputs.GetDnsReverseRecordArgs;
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) {
        final var example = IonoscloudFunctions.getDnsReverseRecord(GetDnsReverseRecordArgs.builder()
            .name("record")
            .partialMatch(true)
            .build());

    }
}

    variables:
  example:
    fn::invoke:
      function: ionoscloud:getDnsReverseRecord
      arguments:
        name: record
        partialMatch: true

    By IP

    import * as pulumi from "@pulumi/pulumi";
import * as ionoscloud from "@ionos-cloud/sdk-pulumi";

const example = ionoscloud.getDnsReverseRecord({
    ip: "exampleIP",
});

    import pulumi
import pulumi_ionoscloud as ionoscloud

example = ionoscloud.get_dns_reverse_record(ip="exampleIP")

    package main

import (
	"github.com/ionos-cloud/pulumi-ionoscloud/sdk/go/ionoscloud"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ionoscloud.GetDnsReverseRecord(ctx, &ionoscloud.LookupDnsReverseRecordArgs{
			Ip: pulumi.StringRef("exampleIP"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var example = Ionoscloud.Index.GetDnsReverseRecord.Invoke(new()
    {
        Ip = "exampleIP",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ionoscloud.IonoscloudFunctions;
import com.pulumi.ionoscloud.inputs.GetDnsReverseRecordArgs;
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) {
        final var example = IonoscloudFunctions.getDnsReverseRecord(GetDnsReverseRecordArgs.builder()
            .ip("exampleIP")
            .build());

    }
}

    variables:
  example:
    fn::invoke:
      function: ionoscloud:getDnsReverseRecord
      arguments:
        ip: exampleIP

    Using getDnsReverseRecord

    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 getDnsReverseRecord(args: GetDnsReverseRecordArgs, opts?: InvokeOptions): Promise<GetDnsReverseRecordResult>
function getDnsReverseRecordOutput(args: GetDnsReverseRecordOutputArgs, opts?: InvokeOptions): Output<GetDnsReverseRecordResult>
    def get_dns_reverse_record(id: Optional[str] = None,
                           ip: Optional[str] = None,
                           name: Optional[str] = None,
                           partial_match: Optional[bool] = None,
                           opts: Optional[InvokeOptions] = None) -> GetDnsReverseRecordResult
def get_dns_reverse_record_output(id: pulumi.Input[Optional[str]] = None,
                           ip: pulumi.Input[Optional[str]] = None,
                           name: pulumi.Input[Optional[str]] = None,
                           partial_match: pulumi.Input[Optional[bool]] = None,
                           opts: Optional[InvokeOptions] = None) -> Output[GetDnsReverseRecordResult]
    func LookupDnsReverseRecord(ctx *Context, args *LookupDnsReverseRecordArgs, opts ...InvokeOption) (*LookupDnsReverseRecordResult, error)
func LookupDnsReverseRecordOutput(ctx *Context, args *LookupDnsReverseRecordOutputArgs, opts ...InvokeOption) LookupDnsReverseRecordResultOutput

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

    public static class GetDnsReverseRecord 
{
    public static Task<GetDnsReverseRecordResult> InvokeAsync(GetDnsReverseRecordArgs args, InvokeOptions? opts = null)
    public static Output<GetDnsReverseRecordResult> Invoke(GetDnsReverseRecordInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetDnsReverseRecordResult> getDnsReverseRecord(GetDnsReverseRecordArgs args, InvokeOptions options)
public static Output<GetDnsReverseRecordResult> getDnsReverseRecord(GetDnsReverseRecordArgs args, InvokeOptions options)

    fn::invoke:
  function: ionoscloud:index/getDnsReverseRecord:getDnsReverseRecord
  arguments:
    # arguments dictionary

    The following arguments are supported:

    Id string
    [string] The ID of the DNS Reverse Record you want to search for.
    Ip string
    [string] The IP of the DNS Reverse Record you want to search for.
    Name string
    [string] The name of the DNS Reverse Record you want to search for.
    PartialMatch bool

    [bool] Whether partial matching is allowed or not when using name argument. Default value is false.

    Either id, ip or name must be provided. If none, or more are provided, the datasource will return an error.

    Id string
    [string] The ID of the DNS Reverse Record you want to search for.
    Ip string
    [string] The IP of the DNS Reverse Record you want to search for.
    Name string
    [string] The name of the DNS Reverse Record you want to search for.
    PartialMatch bool

    [bool] Whether partial matching is allowed or not when using name argument. Default value is false.

    Either id, ip or name must be provided. If none, or more are provided, the datasource will return an error.

    id String
    [string] The ID of the DNS Reverse Record you want to search for.
    ip String
    [string] The IP of the DNS Reverse Record you want to search for.
    name String
    [string] The name of the DNS Reverse Record you want to search for.
    partialMatch Boolean

    [bool] Whether partial matching is allowed or not when using name argument. Default value is false.

    Either id, ip or name must be provided. If none, or more are provided, the datasource will return an error.

    id string
    [string] The ID of the DNS Reverse Record you want to search for.
    ip string
    [string] The IP of the DNS Reverse Record you want to search for.
    name string
    [string] The name of the DNS Reverse Record you want to search for.
    partialMatch boolean

    [bool] Whether partial matching is allowed or not when using name argument. Default value is false.

    Either id, ip or name must be provided. If none, or more are provided, the datasource will return an error.

    id str
    [string] The ID of the DNS Reverse Record you want to search for.
    ip str
    [string] The IP of the DNS Reverse Record you want to search for.
    name str
    [string] The name of the DNS Reverse Record you want to search for.
    partial_match bool

    [bool] Whether partial matching is allowed or not when using name argument. Default value is false.

    Either id, ip or name must be provided. If none, or more are provided, the datasource will return an error.

    id String
    [string] The ID of the DNS Reverse Record you want to search for.
    ip String
    [string] The IP of the DNS Reverse Record you want to search for.
    name String
    [string] The name of the DNS Reverse Record you want to search for.
    partialMatch Boolean

    [bool] Whether partial matching is allowed or not when using name argument. Default value is false.

    Either id, ip or name must be provided. If none, or more are provided, the datasource will return an error.

    getDnsReverseRecord Result

    The following output properties are available:

    Description string
    Description stored along with the reverse DNS record to describe its usage.
    Id string
    The UUID of the DNS Reverse Record.
    Ip string
    Specifies for which IP address the reverse record should be created. The IP addresses needs to be owned by the contract.
    Name string
    The reverse DNS record name.
    PartialMatch bool
    Description string
    Description stored along with the reverse DNS record to describe its usage.
    Id string
    The UUID of the DNS Reverse Record.
    Ip string
    Specifies for which IP address the reverse record should be created. The IP addresses needs to be owned by the contract.
    Name string
    The reverse DNS record name.
    PartialMatch bool
    description String
    Description stored along with the reverse DNS record to describe its usage.
    id String
    The UUID of the DNS Reverse Record.
    ip String
    Specifies for which IP address the reverse record should be created. The IP addresses needs to be owned by the contract.
    name String
    The reverse DNS record name.
    partialMatch Boolean
    description string
    Description stored along with the reverse DNS record to describe its usage.
    id string
    The UUID of the DNS Reverse Record.
    ip string
    Specifies for which IP address the reverse record should be created. The IP addresses needs to be owned by the contract.
    name string
    The reverse DNS record name.
    partialMatch boolean
    description str
    Description stored along with the reverse DNS record to describe its usage.
    id str
    The UUID of the DNS Reverse Record.
    ip str
    Specifies for which IP address the reverse record should be created. The IP addresses needs to be owned by the contract.
    name str
    The reverse DNS record name.
    partial_match bool
    description String
    Description stored along with the reverse DNS record to describe its usage.
    id String
    The UUID of the DNS Reverse Record.
    ip String
    Specifies for which IP address the reverse record should be created. The IP addresses needs to be owned by the contract.
    name String
    The reverse DNS record name.
    partialMatch Boolean

    Package Details

    Repository
    ionoscloud ionos-cloud/pulumi-ionoscloud
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the ionoscloud Terraform Provider.
    ionoscloud logo
    Viewing docs for IonosCloud v0.3.0
    published on Wednesday, Apr 15, 2026 by ionos-cloud
    Schema (JSON)
    ionos-cloud/pulumi-ionoscloud
      Try Pulumi Cloud free. Your team will thank you.