published on Tuesday, Mar 24, 2026 by g-core
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 dictionaryThe following arguments are supported:
- rrset_
name str - rrset_
type str - zone_
name str
getDnsZoneRrset Result
The following output properties are available:
- Filter
Set doubleId - Id string
- The provider-assigned unique ID for this managed resource.
- Meta Dictionary<string, string>
- Name string
- Pickers
List<Get
Dns Zone Rrset Picker> - Resource
Records List<GetDns Zone Rrset Resource Record> - Rrset
Name string - Rrset
Type string - Ttl double
- Type string
- Updated
At string - Warning string
- Warnings
List<Get
Dns Zone Rrset Warning> - Zone
Name string
- Filter
Set float64Id - Id string
- The provider-assigned unique ID for this managed resource.
- Meta map[string]string
- Name string
- Pickers
[]Get
Dns Zone Rrset Picker - Resource
Records []GetDns Zone Rrset Resource Record - Rrset
Name string - Rrset
Type string - Ttl float64
- Type string
- Updated
At string - Warning string
- Warnings
[]Get
Dns Zone Rrset Warning - Zone
Name string
- filter
Set DoubleId - id String
- The provider-assigned unique ID for this managed resource.
- meta Map<String,String>
- name String
- pickers
List<Get
Dns Zone Rrset Picker> - resource
Records List<GetDns Zone Rrset Resource Record> - rrset
Name String - rrset
Type String - ttl Double
- type String
- updated
At String - warning String
- warnings
List<Get
Dns Zone Rrset Warning> - zone
Name String
- filter
Set numberId - id string
- The provider-assigned unique ID for this managed resource.
- meta {[key: string]: string}
- name string
- pickers
Get
Dns Zone Rrset Picker[] - resource
Records GetDns Zone Rrset Resource Record[] - rrset
Name string - rrset
Type string - ttl number
- type string
- updated
At string - warning string
- warnings
Get
Dns Zone Rrset Warning[] - zone
Name string
- filter_
set_ floatid - id str
- The provider-assigned unique ID for this managed resource.
- meta Mapping[str, str]
- name str
- pickers
Sequence[Get
Dns Zone Rrset Picker] - resource_
records Sequence[GetDns Zone Rrset Resource Record] - rrset_
name str - rrset_
type str - ttl float
- type str
- updated_
at str - warning str
- warnings
Sequence[Get
Dns Zone Rrset Warning] - zone_
name str
- filter
Set NumberId - id String
- The provider-assigned unique ID for this managed resource.
- meta Map<String>
- name String
- pickers List<Property Map>
- resource
Records List<Property Map> - rrset
Name String - rrset
Type String - ttl Number
- type String
- updated
At String - warning String
- warnings List<Property Map>
- zone
Name 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" ] ]
- SRV-record:
- 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
asn(array of int)continents(array of string)countries(array of string)latlong(array of float64, latitude and longitude)backup(bool)notes(string)weight(float)ip(string)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" ] ]
- SRV-record:
- 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
asn(array of int)continents(array of string)countries(array of string)latlong(array of float64, latitude and longitude)backup(bool)notes(string)weight(float)ip(string)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" ] ]
- SRV-record:
- 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
asn(array of int)continents(array of string)countries(array of string)latlong(array of float64, latitude and longitude)backup(bool)notes(string)weight(float)ip(string)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" ] ]
- SRV-record:
- 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
asn(array of int)continents(array of string)countries(array of string)latlong(array of float64, latitude and longitude)backup(bool)notes(string)weight(float)ip(string)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" ] ]
- SRV-record:
- 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
asn(array of int)continents(array of string)countries(array of string)latlong(array of float64, latitude and longitude)backup(bool)notes(string)weight(float)ip(string)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" ] ]
- SRV-record:
- enabled Boolean
- id Number
- meta Map<String>
Meta information for record Map with string key and any valid json as value, with valid keys
asn(array of int)continents(array of string)countries(array of string)latlong(array of float64, latitude and longitude)backup(bool)notes(string)weight(float)ip(string)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
Package Details
- Repository
- gcore g-core/terraform-provider-gcore
- License
- Notes
- This Pulumi package is based on the
gcoreTerraform Provider.
published on Tuesday, Mar 24, 2026 by g-core
