oci logo
Oracle Cloud Infrastructure v0.6.0, Jan 23 23

oci.Dns.getRrset

This data source provides details about a specific Rrset resource in Oracle Cloud Infrastructure DNS service.

Gets a list of all records in the specified RRSet. The results are sorted by recordHash by default. For private zones, the scope query parameter is required with a value of PRIVATE. When the zone name is provided as a path parameter and PRIVATE is used for the scope query parameter then the viewId query parameter is required.

Example Usage

using System.Collections.Generic;
using Pulumi;
using Oci = Pulumi.Oci;

return await Deployment.RunAsync(() => 
{
    var testRrset = Oci.Dns.GetRrset.Invoke(new()
    {
        Domain = @var.Rrset_domain,
        Rtype = @var.Rrset_rtype,
        ZoneNameOrId = oci_dns_zone.Test_zone.Id,
        CompartmentId = @var.Compartment_id,
        Scope = @var.Rrset_scope,
        ViewId = oci_dns_view.Test_view.Id,
    });

});
package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := Dns.GetRrset(ctx, &dns.GetRrsetArgs{
			Domain:        _var.Rrset_domain,
			Rtype:         _var.Rrset_rtype,
			ZoneNameOrId:  oci_dns_zone.Test_zone.Id,
			CompartmentId: pulumi.StringRef(_var.Compartment_id),
			Scope:         pulumi.StringRef(_var.Rrset_scope),
			ViewId:        pulumi.StringRef(oci_dns_view.Test_view.Id),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Dns.DnsFunctions;
import com.pulumi.oci.Dns.inputs.GetRrsetArgs;
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 testRrset = DnsFunctions.getRrset(GetRrsetArgs.builder()
            .domain(var_.rrset_domain())
            .rtype(var_.rrset_rtype())
            .zoneNameOrId(oci_dns_zone.test_zone().id())
            .compartmentId(var_.compartment_id())
            .scope(var_.rrset_scope())
            .viewId(oci_dns_view.test_view().id())
            .build());

    }
}
import pulumi
import pulumi_oci as oci

test_rrset = oci.Dns.get_rrset(domain=var["rrset_domain"],
    rtype=var["rrset_rtype"],
    zone_name_or_id=oci_dns_zone["test_zone"]["id"],
    compartment_id=var["compartment_id"],
    scope=var["rrset_scope"],
    view_id=oci_dns_view["test_view"]["id"])
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";

const testRrset = oci.Dns.getRrset({
    domain: _var.rrset_domain,
    rtype: _var.rrset_rtype,
    zoneNameOrId: oci_dns_zone.test_zone.id,
    compartmentId: _var.compartment_id,
    scope: _var.rrset_scope,
    viewId: oci_dns_view.test_view.id,
});
variables:
  testRrset:
    fn::invoke:
      Function: oci:Dns:getRrset
      Arguments:
        domain: ${var.rrset_domain}
        rtype: ${var.rrset_rtype}
        zoneNameOrId: ${oci_dns_zone.test_zone.id}
        compartmentId: ${var.compartment_id}
        scope: ${var.rrset_scope}
        viewId: ${oci_dns_view.test_view.id}

Using getRrset

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 getRrset(args: GetRrsetArgs, opts?: InvokeOptions): Promise<GetRrsetResult>
function getRrsetOutput(args: GetRrsetOutputArgs, opts?: InvokeOptions): Output<GetRrsetResult>
def get_rrset(compartment_id: Optional[str] = None,
              domain: Optional[str] = None,
              rtype: Optional[str] = None,
              scope: Optional[str] = None,
              view_id: Optional[str] = None,
              zone_name_or_id: Optional[str] = None,
              zone_version: Optional[str] = None,
              opts: Optional[InvokeOptions] = None) -> GetRrsetResult
def get_rrset_output(compartment_id: Optional[pulumi.Input[str]] = None,
              domain: Optional[pulumi.Input[str]] = None,
              rtype: Optional[pulumi.Input[str]] = None,
              scope: Optional[pulumi.Input[str]] = None,
              view_id: Optional[pulumi.Input[str]] = None,
              zone_name_or_id: Optional[pulumi.Input[str]] = None,
              zone_version: Optional[pulumi.Input[str]] = None,
              opts: Optional[InvokeOptions] = None) -> Output[GetRrsetResult]
func GetRrset(ctx *Context, args *GetRrsetArgs, opts ...InvokeOption) (*GetRrsetResult, error)
func GetRrsetOutput(ctx *Context, args *GetRrsetOutputArgs, opts ...InvokeOption) GetRrsetResultOutput

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

public static class GetRrset 
{
    public static Task<GetRrsetResult> InvokeAsync(GetRrsetArgs args, InvokeOptions? opts = null)
    public static Output<GetRrsetResult> Invoke(GetRrsetInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetRrsetResult> getRrset(GetRrsetArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
  function: oci:Dns/getRrset:getRrset
  arguments:
    # arguments dictionary

The following arguments are supported:

Domain string

The target fully-qualified domain name (FQDN) within the target zone.

Rtype string

The type of the target RRSet within the target zone.

ZoneNameOrId string

The name or OCID of the target zone.

CompartmentId string

The OCID of the compartment the resource belongs to.

Scope string

Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when listing private Rrsets.

ViewId string

The OCID of the view the resource is associated with.

ZoneVersion string

The version of the zone for which data is requested.

Domain string

The target fully-qualified domain name (FQDN) within the target zone.

Rtype string

The type of the target RRSet within the target zone.

ZoneNameOrId string

The name or OCID of the target zone.

CompartmentId string

The OCID of the compartment the resource belongs to.

Scope string

Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when listing private Rrsets.

ViewId string

The OCID of the view the resource is associated with.

ZoneVersion string

The version of the zone for which data is requested.

domain String

The target fully-qualified domain name (FQDN) within the target zone.

rtype String

The type of the target RRSet within the target zone.

zoneNameOrId String

The name or OCID of the target zone.

compartmentId String

The OCID of the compartment the resource belongs to.

scope String

Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when listing private Rrsets.

viewId String

The OCID of the view the resource is associated with.

zoneVersion String

The version of the zone for which data is requested.

domain string

The target fully-qualified domain name (FQDN) within the target zone.

rtype string

The type of the target RRSet within the target zone.

zoneNameOrId string

The name or OCID of the target zone.

compartmentId string

The OCID of the compartment the resource belongs to.

scope string

Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when listing private Rrsets.

viewId string

The OCID of the view the resource is associated with.

zoneVersion string

The version of the zone for which data is requested.

domain str

The target fully-qualified domain name (FQDN) within the target zone.

rtype str

The type of the target RRSet within the target zone.

zone_name_or_id str

The name or OCID of the target zone.

compartment_id str

The OCID of the compartment the resource belongs to.

scope str

Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when listing private Rrsets.

view_id str

The OCID of the view the resource is associated with.

zone_version str

The version of the zone for which data is requested.

domain String

The target fully-qualified domain name (FQDN) within the target zone.

rtype String

The type of the target RRSet within the target zone.

zoneNameOrId String

The name or OCID of the target zone.

compartmentId String

The OCID of the compartment the resource belongs to.

scope String

Specifies to operate only on resources that have a matching DNS scope. This value will be null for zones in the global DNS and PRIVATE when listing private Rrsets.

viewId String

The OCID of the view the resource is associated with.

zoneVersion String

The version of the zone for which data is requested.

getRrset Result

The following output properties are available:

Domain string

The fully qualified domain name where the record can be located.

Id string
Items List<GetRrsetItem>
Rtype string

The type of DNS record, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.

ZoneNameOrId string
CompartmentId string
Scope string
ViewId string
ZoneVersion string
Domain string

The fully qualified domain name where the record can be located.

Id string
Items []GetRrsetItem
Rtype string

The type of DNS record, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.

ZoneNameOrId string
CompartmentId string
Scope string
ViewId string
ZoneVersion string
domain String

The fully qualified domain name where the record can be located.

id String
items List<GetRrsetItem>
rtype String

The type of DNS record, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.

zoneNameOrId String
compartmentId String
scope String
viewId String
zoneVersion String
domain string

The fully qualified domain name where the record can be located.

id string
items GetRrsetItem[]
rtype string

The type of DNS record, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.

zoneNameOrId string
compartmentId string
scope string
viewId string
zoneVersion string
domain str

The fully qualified domain name where the record can be located.

id str
items GetRrsetItem]
rtype str

The type of DNS record, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.

zone_name_or_id str
compartment_id str
scope str
view_id str
zone_version str
domain String

The fully qualified domain name where the record can be located.

id String
items List<Property Map>
rtype String

The type of DNS record, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.

zoneNameOrId String
compartmentId String
scope String
viewId String
zoneVersion String

Supporting Types

GetRrsetItem

Domain string

The target fully-qualified domain name (FQDN) within the target zone.

IsProtected bool

A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.

Rdata string

The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types

RecordHash string

A unique identifier for the record within its zone.

RrsetVersion string

The latest version of the record's zone in which its RRSet differs from the preceding version.

Rtype string

The type of the target RRSet within the target zone.

Ttl int

The Time To Live for the record, in seconds.

Domain string

The target fully-qualified domain name (FQDN) within the target zone.

IsProtected bool

A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.

Rdata string

The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types

RecordHash string

A unique identifier for the record within its zone.

RrsetVersion string

The latest version of the record's zone in which its RRSet differs from the preceding version.

Rtype string

The type of the target RRSet within the target zone.

Ttl int

The Time To Live for the record, in seconds.

domain String

The target fully-qualified domain name (FQDN) within the target zone.

isProtected Boolean

A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.

rdata String

The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types

recordHash String

A unique identifier for the record within its zone.

rrsetVersion String

The latest version of the record's zone in which its RRSet differs from the preceding version.

rtype String

The type of the target RRSet within the target zone.

ttl Integer

The Time To Live for the record, in seconds.

domain string

The target fully-qualified domain name (FQDN) within the target zone.

isProtected boolean

A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.

rdata string

The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types

recordHash string

A unique identifier for the record within its zone.

rrsetVersion string

The latest version of the record's zone in which its RRSet differs from the preceding version.

rtype string

The type of the target RRSet within the target zone.

ttl number

The Time To Live for the record, in seconds.

domain str

The target fully-qualified domain name (FQDN) within the target zone.

is_protected bool

A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.

rdata str

The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types

record_hash str

A unique identifier for the record within its zone.

rrset_version str

The latest version of the record's zone in which its RRSet differs from the preceding version.

rtype str

The type of the target RRSet within the target zone.

ttl int

The Time To Live for the record, in seconds.

domain String

The target fully-qualified domain name (FQDN) within the target zone.

isProtected Boolean

A Boolean flag indicating whether or not parts of the record are unable to be explicitly managed.

rdata String

The record's data, as whitespace-delimited tokens in type-specific presentation format. All RDATA is normalized and the returned presentation of your RDATA may differ from its initial input. For more information about RDATA, see Supported DNS Resource Record Types

recordHash String

A unique identifier for the record within its zone.

rrsetVersion String

The latest version of the record's zone in which its RRSet differs from the preceding version.

rtype String

The type of the target RRSet within the target zone.

ttl Number

The Time To Live for the record, in seconds.

Package Details

Repository
oci pulumi/pulumi-oci
License
Apache-2.0
Notes

This Pulumi package is based on the oci Terraform Provider.