oci.Dns.getRrsets
Explore with Pulumi AI
This data source provides the list of RRsets in Oracle Cloud Infrastructure DNS service.
Gets a list of all rrsets in the specified zone. You can optionally filter the results using the listed parameters.
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
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";
const testRrsets = oci.Dns.getRrsets({
zoneNameOrId: testZone.id,
domain: rrsetDomain,
domainContains: rrsetDomain,
rtype: rrsetRtype,
scope: rrsetScope,
viewId: testView.id,
});
import pulumi
import pulumi_oci as oci
test_rrsets = oci.Dns.get_rrsets(zone_name_or_id=test_zone["id"],
domain=rrset_domain,
domain_contains=rrset_domain,
rtype=rrset_rtype,
scope=rrset_scope,
view_id=test_view["id"])
package main
import (
"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/Dns"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := Dns.GetRrsets(ctx, &dns.GetRrsetsArgs{
ZoneNameOrId: testZone.Id,
Domain: pulumi.StringRef(rrsetDomain),
DomainContains: pulumi.StringRef(rrsetDomain),
Rtype: pulumi.StringRef(rrsetRtype),
Scope: pulumi.StringRef(rrsetScope),
ViewId: pulumi.StringRef(testView.Id),
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;
return await Deployment.RunAsync(() =>
{
var testRrsets = Oci.Dns.GetRrsets.Invoke(new()
{
ZoneNameOrId = testZone.Id,
Domain = rrsetDomain,
DomainContains = rrsetDomain,
Rtype = rrsetRtype,
Scope = rrsetScope,
ViewId = testView.Id,
});
});
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.GetRrsetsArgs;
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 testRrsets = DnsFunctions.getRrsets(GetRrsetsArgs.builder()
.zoneNameOrId(testZone.id())
.domain(rrsetDomain)
.domainContains(rrsetDomain)
.rtype(rrsetRtype)
.scope(rrsetScope)
.viewId(testView.id())
.build());
}
}
variables:
testRrsets:
fn::invoke:
Function: oci:Dns:getRrsets
Arguments:
zoneNameOrId: ${testZone.id}
domain: ${rrsetDomain}
domainContains: ${rrsetDomain}
rtype: ${rrsetRtype}
scope: ${rrsetScope}
viewId: ${testView.id}
Using getRrsets
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 getRrsets(args: GetRrsetsArgs, opts?: InvokeOptions): Promise<GetRrsetsResult>
function getRrsetsOutput(args: GetRrsetsOutputArgs, opts?: InvokeOptions): Output<GetRrsetsResult>
def get_rrsets(domain: Optional[str] = None,
domain_contains: Optional[str] = None,
filters: Optional[Sequence[_dns.GetRrsetsFilter]] = None,
rtype: Optional[str] = None,
scope: Optional[str] = None,
view_id: Optional[str] = None,
zone_name_or_id: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetRrsetsResult
def get_rrsets_output(domain: Optional[pulumi.Input[str]] = None,
domain_contains: Optional[pulumi.Input[str]] = None,
filters: Optional[pulumi.Input[Sequence[pulumi.Input[_dns.GetRrsetsFilterArgs]]]] = 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,
opts: Optional[InvokeOptions] = None) -> Output[GetRrsetsResult]
func GetRrsets(ctx *Context, args *GetRrsetsArgs, opts ...InvokeOption) (*GetRrsetsResult, error)
func GetRrsetsOutput(ctx *Context, args *GetRrsetsOutputArgs, opts ...InvokeOption) GetRrsetsResultOutput
> Note: This function is named GetRrsets
in the Go SDK.
public static class GetRrsets
{
public static Task<GetRrsetsResult> InvokeAsync(GetRrsetsArgs args, InvokeOptions? opts = null)
public static Output<GetRrsetsResult> Invoke(GetRrsetsInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetRrsetsResult> getRrsets(GetRrsetsArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: oci:Dns/getRrsets:getRrsets
arguments:
# arguments dictionary
The following arguments are supported:
- Zone
Name stringOr Id - The name or OCID of the target zone.
- Domain string
- The target fully-qualified domain name (FQDN) within the target zone.
- Domain
Contains string - Matches any rrset whose fully-qualified domain name (FQDN) contains the provided value.
- Filters
List<Get
Rrsets Filter> - Rtype string
- Search by record type. Will match any record whose type (case-insensitive) equals the provided value.
- Scope string
- Specifies to operate only on resources that have a matching DNS scope.
- View
Id string - The OCID of the view the resource is associated with.
- Zone
Name stringOr Id - The name or OCID of the target zone.
- Domain string
- The target fully-qualified domain name (FQDN) within the target zone.
- Domain
Contains string - Matches any rrset whose fully-qualified domain name (FQDN) contains the provided value.
- Filters
[]Get
Rrsets Filter - Rtype string
- Search by record type. Will match any record whose type (case-insensitive) equals the provided value.
- Scope string
- Specifies to operate only on resources that have a matching DNS scope.
- View
Id string - The OCID of the view the resource is associated with.
- zone
Name StringOr Id - The name or OCID of the target zone.
- domain String
- The target fully-qualified domain name (FQDN) within the target zone.
- domain
Contains String - Matches any rrset whose fully-qualified domain name (FQDN) contains the provided value.
- filters
List<Get
Rrsets Filter> - rtype String
- Search by record type. Will match any record whose type (case-insensitive) equals the provided value.
- scope String
- Specifies to operate only on resources that have a matching DNS scope.
- view
Id String - The OCID of the view the resource is associated with.
- zone
Name stringOr Id - The name or OCID of the target zone.
- domain string
- The target fully-qualified domain name (FQDN) within the target zone.
- domain
Contains string - Matches any rrset whose fully-qualified domain name (FQDN) contains the provided value.
- filters
Get
Rrsets Filter[] - rtype string
- Search by record type. Will match any record whose type (case-insensitive) equals the provided value.
- scope string
- Specifies to operate only on resources that have a matching DNS scope.
- view
Id string - The OCID of the view the resource is associated with.
- zone_
name_ stror_ id - The name or OCID of the target zone.
- domain str
- The target fully-qualified domain name (FQDN) within the target zone.
- domain_
contains str - Matches any rrset whose fully-qualified domain name (FQDN) contains the provided value.
- filters
Sequence[dns.
Get Rrsets Filter] - rtype str
- Search by record type. Will match any record whose type (case-insensitive) equals the provided value.
- scope str
- Specifies to operate only on resources that have a matching DNS scope.
- view_
id str - The OCID of the view the resource is associated with.
- zone
Name StringOr Id - The name or OCID of the target zone.
- domain String
- The target fully-qualified domain name (FQDN) within the target zone.
- domain
Contains String - Matches any rrset whose fully-qualified domain name (FQDN) contains the provided value.
- filters List<Property Map>
- rtype String
- Search by record type. Will match any record whose type (case-insensitive) equals the provided value.
- scope String
- Specifies to operate only on resources that have a matching DNS scope.
- view
Id String - The OCID of the view the resource is associated with.
getRrsets Result
The following output properties are available:
- Id string
- The provider-assigned unique ID for this managed resource.
- Rrsets
List<Get
Rrsets Rrset> - The list of rrsets.
- Zone
Name stringOr Id - Domain string
- The fully qualified domain name where the record can be located.
- Domain
Contains string - Filters
List<Get
Rrsets Filter> - Rtype string
- The type of DNS record, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.
- Scope string
- View
Id string
- Id string
- The provider-assigned unique ID for this managed resource.
- Rrsets
[]Get
Rrsets Rrset - The list of rrsets.
- Zone
Name stringOr Id - Domain string
- The fully qualified domain name where the record can be located.
- Domain
Contains string - Filters
[]Get
Rrsets Filter - Rtype string
- The type of DNS record, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.
- Scope string
- View
Id string
- id String
- The provider-assigned unique ID for this managed resource.
- rrsets
List<Get
Rrsets Rrset> - The list of rrsets.
- zone
Name StringOr Id - domain String
- The fully qualified domain name where the record can be located.
- domain
Contains String - filters
List<Get
Rrsets Filter> - rtype String
- The type of DNS record, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.
- scope String
- view
Id String
- id string
- The provider-assigned unique ID for this managed resource.
- rrsets
Get
Rrsets Rrset[] - The list of rrsets.
- zone
Name stringOr Id - domain string
- The fully qualified domain name where the record can be located.
- domain
Contains string - filters
Get
Rrsets Filter[] - rtype string
- The type of DNS record, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.
- scope string
- view
Id string
- id str
- The provider-assigned unique ID for this managed resource.
- rrsets
Sequence[dns.
Get Rrsets Rrset] - The list of rrsets.
- zone_
name_ stror_ id - domain str
- The fully qualified domain name where the record can be located.
- domain_
contains str - filters
Sequence[dns.
Get Rrsets Filter] - rtype str
- The type of DNS record, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.
- scope str
- view_
id str
- id String
- The provider-assigned unique ID for this managed resource.
- rrsets List<Property Map>
- The list of rrsets.
- zone
Name StringOr Id - domain String
- The fully qualified domain name where the record can be located.
- domain
Contains String - filters List<Property Map>
- rtype String
- The type of DNS record, such as A or CNAME. For more information, see Resource Record (RR) TYPEs.
- scope String
- view
Id String
Supporting Types
GetRrsetsFilter
GetRrsetsRrset
- Domain string
- The target fully-qualified domain name (FQDN) within the target zone.
- Items
List<Get
Rrsets Rrset Item> - Rtype string
- Search by record type. Will match any record whose type (case-insensitive) equals the provided value.
- Domain string
- The target fully-qualified domain name (FQDN) within the target zone.
- Items
[]Get
Rrsets Rrset Item - Rtype string
- Search by record type. Will match any record whose type (case-insensitive) equals the provided value.
- domain String
- The target fully-qualified domain name (FQDN) within the target zone.
- items
List<Get
Rrsets Rrset Item> - rtype String
- Search by record type. Will match any record whose type (case-insensitive) equals the provided value.
- domain string
- The target fully-qualified domain name (FQDN) within the target zone.
- items
Get
Rrsets Rrset Item[] - rtype string
- Search by record type. Will match any record whose type (case-insensitive) equals the provided value.
- domain str
- The target fully-qualified domain name (FQDN) within the target zone.
- items
Sequence[dns.
Get Rrsets Rrset Item] - rtype str
- Search by record type. Will match any record whose type (case-insensitive) equals the provided value.
- domain String
- The target fully-qualified domain name (FQDN) within the target zone.
- items List<Property Map>
- rtype String
- Search by record type. Will match any record whose type (case-insensitive) equals the provided value.
GetRrsetsRrsetItem
- Domain string
- 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 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
- Record
Hash string - A unique identifier for the record within its zone.
- Rrset
Version string - The latest version of the record's zone in which its RRSet differs from the preceding version.
- Rtype string
- Search by record type. Will match any record whose type (case-insensitive) equals the provided value.
- Ttl int
- The Time To Live for the record, in seconds.
- Domain string
- 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 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
- Record
Hash string - A unique identifier for the record within its zone.
- Rrset
Version string - The latest version of the record's zone in which its RRSet differs from the preceding version.
- Rtype string
- Search by record type. Will match any record whose type (case-insensitive) equals the provided value.
- Ttl int
- The Time To Live for the record, in seconds.
- domain String
- The target fully-qualified domain name (FQDN) within the target zone.
- is
Protected 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
- record
Hash String - A unique identifier for the record within its zone.
- rrset
Version String - The latest version of the record's zone in which its RRSet differs from the preceding version.
- rtype String
- Search by record type. Will match any record whose type (case-insensitive) equals the provided value.
- ttl Integer
- The Time To Live for the record, in seconds.
- domain string
- The target fully-qualified domain name (FQDN) within the target zone.
- is
Protected 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
- record
Hash string - A unique identifier for the record within its zone.
- rrset
Version string - The latest version of the record's zone in which its RRSet differs from the preceding version.
- rtype string
- Search by record type. Will match any record whose type (case-insensitive) equals the provided value.
- 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
- Search by record type. Will match any record whose type (case-insensitive) equals the provided value.
- ttl int
- The Time To Live for the record, in seconds.
- domain String
- The target fully-qualified domain name (FQDN) within the target zone.
- is
Protected 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
- record
Hash String - A unique identifier for the record within its zone.
- rrset
Version String - The latest version of the record's zone in which its RRSet differs from the preceding version.
- rtype String
- Search by record type. Will match any record whose type (case-insensitive) equals the provided value.
- 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.