1. Packages
  2. Gcore Provider
  3. API Docs
  4. getDnsZoneRrset
Viewing docs for gcore 2.0.0-alpha.2
published on Tuesday, Mar 24, 2026 by g-core
gcore logo
Viewing docs for gcore 2.0.0-alpha.2
published on Tuesday, Mar 24, 2026 by g-core

    DNS resource record sets (RRsets) define individual DNS records such as A, AAAA, CNAME, MX, and TXT with TTL and geo-balancing settings.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as gcore from "@pulumi/gcore";
    
    const exampleDnsZoneRrset = gcore.getDnsZoneRrset({
        zoneName: "zoneName",
        rrsetName: "rrsetName",
        rrsetType: "rrsetType",
    });
    
    import pulumi
    import pulumi_gcore as gcore
    
    example_dns_zone_rrset = gcore.get_dns_zone_rrset(zone_name="zoneName",
        rrset_name="rrsetName",
        rrset_type="rrsetType")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/v2/gcore"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := gcore.LookupDnsZoneRrset(ctx, &gcore.LookupDnsZoneRrsetArgs{
    			ZoneName:  "zoneName",
    			RrsetName: "rrsetName",
    			RrsetType: "rrsetType",
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Gcore = Pulumi.Gcore;
    
    return await Deployment.RunAsync(() => 
    {
        var exampleDnsZoneRrset = Gcore.GetDnsZoneRrset.Invoke(new()
        {
            ZoneName = "zoneName",
            RrsetName = "rrsetName",
            RrsetType = "rrsetType",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.gcore.GcoreFunctions;
    import com.pulumi.gcore.inputs.GetDnsZoneRrsetArgs;
    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 exampleDnsZoneRrset = GcoreFunctions.getDnsZoneRrset(GetDnsZoneRrsetArgs.builder()
                .zoneName("zoneName")
                .rrsetName("rrsetName")
                .rrsetType("rrsetType")
                .build());
    
        }
    }
    
    variables:
      exampleDnsZoneRrset:
        fn::invoke:
          function: gcore:getDnsZoneRrset
          arguments:
            zoneName: zoneName
            rrsetName: rrsetName
            rrsetType: rrsetType
    

    Using getDnsZoneRrset

    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 getDnsZoneRrset(args: GetDnsZoneRrsetArgs, opts?: InvokeOptions): Promise<GetDnsZoneRrsetResult>
    function getDnsZoneRrsetOutput(args: GetDnsZoneRrsetOutputArgs, opts?: InvokeOptions): Output<GetDnsZoneRrsetResult>
    def get_dns_zone_rrset(rrset_name: Optional[str] = None,
                           rrset_type: Optional[str] = None,
                           zone_name: Optional[str] = None,
                           opts: Optional[InvokeOptions] = None) -> GetDnsZoneRrsetResult
    def get_dns_zone_rrset_output(rrset_name: Optional[pulumi.Input[str]] = None,
                           rrset_type: Optional[pulumi.Input[str]] = None,
                           zone_name: Optional[pulumi.Input[str]] = None,
                           opts: Optional[InvokeOptions] = None) -> Output[GetDnsZoneRrsetResult]
    func LookupDnsZoneRrset(ctx *Context, args *LookupDnsZoneRrsetArgs, opts ...InvokeOption) (*LookupDnsZoneRrsetResult, error)
    func LookupDnsZoneRrsetOutput(ctx *Context, args *LookupDnsZoneRrsetOutputArgs, opts ...InvokeOption) LookupDnsZoneRrsetResultOutput

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

    public static class GetDnsZoneRrset 
    {
        public static Task<GetDnsZoneRrsetResult> InvokeAsync(GetDnsZoneRrsetArgs args, InvokeOptions? opts = null)
        public static Output<GetDnsZoneRrsetResult> Invoke(GetDnsZoneRrsetInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetDnsZoneRrsetResult> getDnsZoneRrset(GetDnsZoneRrsetArgs args, InvokeOptions options)
    public static Output<GetDnsZoneRrsetResult> getDnsZoneRrset(GetDnsZoneRrsetArgs args, InvokeOptions options)
    
    fn::invoke:
      function: gcore:index/getDnsZoneRrset:getDnsZoneRrset
      arguments:
        # arguments dictionary

    The following arguments are supported:

    RrsetName string
    RrsetType string
    ZoneName string
    RrsetName string
    RrsetType string
    ZoneName string
    rrsetName String
    rrsetType String
    zoneName String
    rrsetName string
    rrsetType string
    zoneName string
    rrsetName String
    rrsetType String
    zoneName String

    getDnsZoneRrset Result

    The following output properties are available:

    FilterSetId double
    Id string
    The provider-assigned unique ID for this managed resource.
    Meta Dictionary<string, string>
    Name string
    Pickers List<GetDnsZoneRrsetPicker>
    ResourceRecords List<GetDnsZoneRrsetResourceRecord>
    RrsetName string
    RrsetType string
    Ttl double
    Type string
    UpdatedAt string
    Warning string
    Warnings List<GetDnsZoneRrsetWarning>
    ZoneName string
    FilterSetId float64
    Id string
    The provider-assigned unique ID for this managed resource.
    Meta map[string]string
    Name string
    Pickers []GetDnsZoneRrsetPicker
    ResourceRecords []GetDnsZoneRrsetResourceRecord
    RrsetName string
    RrsetType string
    Ttl float64
    Type string
    UpdatedAt string
    Warning string
    Warnings []GetDnsZoneRrsetWarning
    ZoneName string
    filterSetId Double
    id String
    The provider-assigned unique ID for this managed resource.
    meta Map<String,String>
    name String
    pickers List<GetDnsZoneRrsetPicker>
    resourceRecords List<GetDnsZoneRrsetResourceRecord>
    rrsetName String
    rrsetType String
    ttl Double
    type String
    updatedAt String
    warning String
    warnings List<GetDnsZoneRrsetWarning>
    zoneName String
    filterSetId number
    id string
    The provider-assigned unique ID for this managed resource.
    meta {[key: string]: string}
    name string
    pickers GetDnsZoneRrsetPicker[]
    resourceRecords GetDnsZoneRrsetResourceRecord[]
    rrsetName string
    rrsetType string
    ttl number
    type string
    updatedAt string
    warning string
    warnings GetDnsZoneRrsetWarning[]
    zoneName string
    filterSetId Number
    id String
    The provider-assigned unique ID for this managed resource.
    meta Map<String>
    name String
    pickers List<Property Map>
    resourceRecords List<Property Map>
    rrsetName String
    rrsetType String
    ttl Number
    type String
    updatedAt String
    warning String
    warnings List<Property Map>
    zoneName String

    Supporting Types

    GetDnsZoneRrsetPicker

    Limit double
    Limits the number of records returned by the filter Can be a positive value for a specific limit. Use zero or leave it blank to indicate no limits.
    Strict bool
    if strict=false, then the filter will return all records if no records match the filter
    Type string
    Filter type Available values: "geodns", "asn", "country", "continent", "region", "ip", "geodistance", <span pulumi-lang-nodejs=""weightedShuffle"" pulumi-lang-dotnet=""WeightedShuffle"" pulumi-lang-go=""weightedShuffle"" pulumi-lang-python=""weighted_shuffle"" pulumi-lang-yaml=""weightedShuffle"" pulumi-lang-java=""weightedShuffle"">"weighted_shuffle", "default", <span pulumi-lang-nodejs=""firstN"" pulumi-lang-dotnet=""FirstN"" pulumi-lang-go=""firstN"" pulumi-lang-python=""first_n"" pulumi-lang-yaml=""firstN"" pulumi-lang-java=""firstN"">"first_n".
    Limit float64
    Limits the number of records returned by the filter Can be a positive value for a specific limit. Use zero or leave it blank to indicate no limits.
    Strict bool
    if strict=false, then the filter will return all records if no records match the filter
    Type string
    Filter type Available values: "geodns", "asn", "country", "continent", "region", "ip", "geodistance", <span pulumi-lang-nodejs=""weightedShuffle"" pulumi-lang-dotnet=""WeightedShuffle"" pulumi-lang-go=""weightedShuffle"" pulumi-lang-python=""weighted_shuffle"" pulumi-lang-yaml=""weightedShuffle"" pulumi-lang-java=""weightedShuffle"">"weighted_shuffle", "default", <span pulumi-lang-nodejs=""firstN"" pulumi-lang-dotnet=""FirstN"" pulumi-lang-go=""firstN"" pulumi-lang-python=""first_n"" pulumi-lang-yaml=""firstN"" pulumi-lang-java=""firstN"">"first_n".
    limit Double
    Limits the number of records returned by the filter Can be a positive value for a specific limit. Use zero or leave it blank to indicate no limits.
    strict Boolean
    if strict=false, then the filter will return all records if no records match the filter
    type String
    Filter type Available values: "geodns", "asn", "country", "continent", "region", "ip", "geodistance", <span pulumi-lang-nodejs=""weightedShuffle"" pulumi-lang-dotnet=""WeightedShuffle"" pulumi-lang-go=""weightedShuffle"" pulumi-lang-python=""weighted_shuffle"" pulumi-lang-yaml=""weightedShuffle"" pulumi-lang-java=""weightedShuffle"">"weighted_shuffle", "default", <span pulumi-lang-nodejs=""firstN"" pulumi-lang-dotnet=""FirstN"" pulumi-lang-go=""firstN"" pulumi-lang-python=""first_n"" pulumi-lang-yaml=""firstN"" pulumi-lang-java=""firstN"">"first_n".
    limit number
    Limits the number of records returned by the filter Can be a positive value for a specific limit. Use zero or leave it blank to indicate no limits.
    strict boolean
    if strict=false, then the filter will return all records if no records match the filter
    type string
    Filter type Available values: "geodns", "asn", "country", "continent", "region", "ip", "geodistance", <span pulumi-lang-nodejs=""weightedShuffle"" pulumi-lang-dotnet=""WeightedShuffle"" pulumi-lang-go=""weightedShuffle"" pulumi-lang-python=""weighted_shuffle"" pulumi-lang-yaml=""weightedShuffle"" pulumi-lang-java=""weightedShuffle"">"weighted_shuffle", "default", <span pulumi-lang-nodejs=""firstN"" pulumi-lang-dotnet=""FirstN"" pulumi-lang-go=""firstN"" pulumi-lang-python=""first_n"" pulumi-lang-yaml=""firstN"" pulumi-lang-java=""firstN"">"first_n".
    limit float
    Limits the number of records returned by the filter Can be a positive value for a specific limit. Use zero or leave it blank to indicate no limits.
    strict bool
    if strict=false, then the filter will return all records if no records match the filter
    type str
    Filter type Available values: "geodns", "asn", "country", "continent", "region", "ip", "geodistance", <span pulumi-lang-nodejs=""weightedShuffle"" pulumi-lang-dotnet=""WeightedShuffle"" pulumi-lang-go=""weightedShuffle"" pulumi-lang-python=""weighted_shuffle"" pulumi-lang-yaml=""weightedShuffle"" pulumi-lang-java=""weightedShuffle"">"weighted_shuffle", "default", <span pulumi-lang-nodejs=""firstN"" pulumi-lang-dotnet=""FirstN"" pulumi-lang-go=""firstN"" pulumi-lang-python=""first_n"" pulumi-lang-yaml=""firstN"" pulumi-lang-java=""firstN"">"first_n".
    limit Number
    Limits the number of records returned by the filter Can be a positive value for a specific limit. Use zero or leave it blank to indicate no limits.
    strict Boolean
    if strict=false, then the filter will return all records if no records match the filter
    type String
    Filter type Available values: "geodns", "asn", "country", "continent", "region", "ip", "geodistance", <span pulumi-lang-nodejs=""weightedShuffle"" pulumi-lang-dotnet=""WeightedShuffle"" pulumi-lang-go=""weightedShuffle"" pulumi-lang-python=""weighted_shuffle"" pulumi-lang-yaml=""weightedShuffle"" pulumi-lang-java=""weightedShuffle"">"weighted_shuffle", "default", <span pulumi-lang-nodejs=""firstN"" pulumi-lang-dotnet=""FirstN"" pulumi-lang-go=""firstN"" pulumi-lang-python=""first_n"" pulumi-lang-yaml=""firstN"" pulumi-lang-java=""firstN"">"first_n".

    GetDnsZoneRrsetResourceRecord

    Contents List<string>
    Content of resource record The exact length of the array depends on the type of rrset, each individual record parameter must be a separate element of the array. For example

    • SRV-record: [100, 1, 5061, "example.com"]
    • CNAME-record: [ "the.target.domain" ]
    • A-record: [ "1.2.3.4", "5.6.7.8" ]
    • AAAA-record: [ "2001:db8::1", "2001:db8::2" ]
    • MX-record: [ "mail1.example.com", "mail2.example.com" ]
    • SVCB/HTTPS-record: [ 1, ".", ["alpn", "h3", "h2"], [ "port", 1443 ], [ "ipv4hint", "10.0.0.1" ], [ "ech", "AEn+DQBFKwAgACABWIHUGj4u+PIggYXcR5JF0gYk3dCRioBW8uJq9H4mKAAIAAEAAQABAANAEnB1YmxpYy50bHMtZWNoLmRldgAA" ] ]
    Enabled bool
    Id double
    Meta Dictionary<string, string>

    Meta information for record Map with string key and any valid json as value, with valid keys

    1. asn (array of int)
    2. continents (array of string)
    3. countries (array of string)
    4. latlong (array of float64, latitude and longitude)
    5. backup (bool)
    6. notes (string)
    7. weight (float)
    8. ip (string)
    9. default (bool)

    Some keys are reserved for balancing, @see https://api.gcore.com/dns/v2/info/meta

    This meta will be used to decide which resource record should pass through filters from the filter set

    Contents []string
    Content of resource record The exact length of the array depends on the type of rrset, each individual record parameter must be a separate element of the array. For example

    • SRV-record: [100, 1, 5061, "example.com"]
    • CNAME-record: [ "the.target.domain" ]
    • A-record: [ "1.2.3.4", "5.6.7.8" ]
    • AAAA-record: [ "2001:db8::1", "2001:db8::2" ]
    • MX-record: [ "mail1.example.com", "mail2.example.com" ]
    • SVCB/HTTPS-record: [ 1, ".", ["alpn", "h3", "h2"], [ "port", 1443 ], [ "ipv4hint", "10.0.0.1" ], [ "ech", "AEn+DQBFKwAgACABWIHUGj4u+PIggYXcR5JF0gYk3dCRioBW8uJq9H4mKAAIAAEAAQABAANAEnB1YmxpYy50bHMtZWNoLmRldgAA" ] ]
    Enabled bool
    Id float64
    Meta map[string]string

    Meta information for record Map with string key and any valid json as value, with valid keys

    1. asn (array of int)
    2. continents (array of string)
    3. countries (array of string)
    4. latlong (array of float64, latitude and longitude)
    5. backup (bool)
    6. notes (string)
    7. weight (float)
    8. ip (string)
    9. default (bool)

    Some keys are reserved for balancing, @see https://api.gcore.com/dns/v2/info/meta

    This meta will be used to decide which resource record should pass through filters from the filter set

    contents List<String>
    Content of resource record The exact length of the array depends on the type of rrset, each individual record parameter must be a separate element of the array. For example

    • SRV-record: [100, 1, 5061, "example.com"]
    • CNAME-record: [ "the.target.domain" ]
    • A-record: [ "1.2.3.4", "5.6.7.8" ]
    • AAAA-record: [ "2001:db8::1", "2001:db8::2" ]
    • MX-record: [ "mail1.example.com", "mail2.example.com" ]
    • SVCB/HTTPS-record: [ 1, ".", ["alpn", "h3", "h2"], [ "port", 1443 ], [ "ipv4hint", "10.0.0.1" ], [ "ech", "AEn+DQBFKwAgACABWIHUGj4u+PIggYXcR5JF0gYk3dCRioBW8uJq9H4mKAAIAAEAAQABAANAEnB1YmxpYy50bHMtZWNoLmRldgAA" ] ]
    enabled Boolean
    id Double
    meta Map<String,String>

    Meta information for record Map with string key and any valid json as value, with valid keys

    1. asn (array of int)
    2. continents (array of string)
    3. countries (array of string)
    4. latlong (array of float64, latitude and longitude)
    5. backup (bool)
    6. notes (string)
    7. weight (float)
    8. ip (string)
    9. default (bool)

    Some keys are reserved for balancing, @see https://api.gcore.com/dns/v2/info/meta

    This meta will be used to decide which resource record should pass through filters from the filter set

    contents string[]
    Content of resource record The exact length of the array depends on the type of rrset, each individual record parameter must be a separate element of the array. For example

    • SRV-record: [100, 1, 5061, "example.com"]
    • CNAME-record: [ "the.target.domain" ]
    • A-record: [ "1.2.3.4", "5.6.7.8" ]
    • AAAA-record: [ "2001:db8::1", "2001:db8::2" ]
    • MX-record: [ "mail1.example.com", "mail2.example.com" ]
    • SVCB/HTTPS-record: [ 1, ".", ["alpn", "h3", "h2"], [ "port", 1443 ], [ "ipv4hint", "10.0.0.1" ], [ "ech", "AEn+DQBFKwAgACABWIHUGj4u+PIggYXcR5JF0gYk3dCRioBW8uJq9H4mKAAIAAEAAQABAANAEnB1YmxpYy50bHMtZWNoLmRldgAA" ] ]
    enabled boolean
    id number
    meta {[key: string]: string}

    Meta information for record Map with string key and any valid json as value, with valid keys

    1. asn (array of int)
    2. continents (array of string)
    3. countries (array of string)
    4. latlong (array of float64, latitude and longitude)
    5. backup (bool)
    6. notes (string)
    7. weight (float)
    8. ip (string)
    9. default (bool)

    Some keys are reserved for balancing, @see https://api.gcore.com/dns/v2/info/meta

    This meta will be used to decide which resource record should pass through filters from the filter set

    contents Sequence[str]
    Content of resource record The exact length of the array depends on the type of rrset, each individual record parameter must be a separate element of the array. For example

    • SRV-record: [100, 1, 5061, "example.com"]
    • CNAME-record: [ "the.target.domain" ]
    • A-record: [ "1.2.3.4", "5.6.7.8" ]
    • AAAA-record: [ "2001:db8::1", "2001:db8::2" ]
    • MX-record: [ "mail1.example.com", "mail2.example.com" ]
    • SVCB/HTTPS-record: [ 1, ".", ["alpn", "h3", "h2"], [ "port", 1443 ], [ "ipv4hint", "10.0.0.1" ], [ "ech", "AEn+DQBFKwAgACABWIHUGj4u+PIggYXcR5JF0gYk3dCRioBW8uJq9H4mKAAIAAEAAQABAANAEnB1YmxpYy50bHMtZWNoLmRldgAA" ] ]
    enabled bool
    id float
    meta Mapping[str, str]

    Meta information for record Map with string key and any valid json as value, with valid keys

    1. asn (array of int)
    2. continents (array of string)
    3. countries (array of string)
    4. latlong (array of float64, latitude and longitude)
    5. backup (bool)
    6. notes (string)
    7. weight (float)
    8. ip (string)
    9. default (bool)

    Some keys are reserved for balancing, @see https://api.gcore.com/dns/v2/info/meta

    This meta will be used to decide which resource record should pass through filters from the filter set

    contents List<String>
    Content of resource record The exact length of the array depends on the type of rrset, each individual record parameter must be a separate element of the array. For example

    • SRV-record: [100, 1, 5061, "example.com"]
    • CNAME-record: [ "the.target.domain" ]
    • A-record: [ "1.2.3.4", "5.6.7.8" ]
    • AAAA-record: [ "2001:db8::1", "2001:db8::2" ]
    • MX-record: [ "mail1.example.com", "mail2.example.com" ]
    • SVCB/HTTPS-record: [ 1, ".", ["alpn", "h3", "h2"], [ "port", 1443 ], [ "ipv4hint", "10.0.0.1" ], [ "ech", "AEn+DQBFKwAgACABWIHUGj4u+PIggYXcR5JF0gYk3dCRioBW8uJq9H4mKAAIAAEAAQABAANAEnB1YmxpYy50bHMtZWNoLmRldgAA" ] ]
    enabled Boolean
    id Number
    meta Map<String>

    Meta information for record Map with string key and any valid json as value, with valid keys

    1. asn (array of int)
    2. continents (array of string)
    3. countries (array of string)
    4. latlong (array of float64, latitude and longitude)
    5. backup (bool)
    6. notes (string)
    7. weight (float)
    8. ip (string)
    9. default (bool)

    Some keys are reserved for balancing, @see https://api.gcore.com/dns/v2/info/meta

    This meta will be used to decide which resource record should pass through filters from the filter set

    GetDnsZoneRrsetWarning

    Key string
    Message string
    Key string
    Message string
    key String
    message String
    key string
    message string
    key str
    message str
    key String
    message String

    Package Details

    Repository
    gcore g-core/terraform-provider-gcore
    License
    Notes
    This Pulumi package is based on the gcore Terraform Provider.
    gcore logo
    Viewing docs for gcore 2.0.0-alpha.2
    published on Tuesday, Mar 24, 2026 by g-core
      Try Pulumi Cloud free. Your team will thank you.