Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Azure Native v2
  3. API Docs
  4. network
  5. getRecordSet
These are the docs for Azure Native v2. We recommenend using the latest version, Azure Native v3.
Azure Native v2 v2.90.0 published on Thursday, Mar 27, 2025 by Pulumi
pulumi/pulumi-azure-native

azure-native-v2.network.getRecordSet

Explore with Pulumi AI

azure-native-v2 logo
These are the docs for Azure Native v2. We recommenend using the latest version, Azure Native v3.
Azure Native v2 v2.90.0 published on Thursday, Mar 27, 2025 by Pulumi
pulumi/pulumi-azure-native

    Gets a record set. Azure REST API version: 2018-05-01.

    Other available API versions: 2023-07-01-preview.

    Using getRecordSet

    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 getRecordSet(args: GetRecordSetArgs, opts?: InvokeOptions): Promise<GetRecordSetResult>
function getRecordSetOutput(args: GetRecordSetOutputArgs, opts?: InvokeOptions): Output<GetRecordSetResult>
    def get_record_set(record_type: Optional[str] = None,
                   relative_record_set_name: Optional[str] = None,
                   resource_group_name: Optional[str] = None,
                   zone_name: Optional[str] = None,
                   opts: Optional[InvokeOptions] = None) -> GetRecordSetResult
def get_record_set_output(record_type: Optional[pulumi.Input[str]] = None,
                   relative_record_set_name: Optional[pulumi.Input[str]] = None,
                   resource_group_name: Optional[pulumi.Input[str]] = None,
                   zone_name: Optional[pulumi.Input[str]] = None,
                   opts: Optional[InvokeOptions] = None) -> Output[GetRecordSetResult]
    func LookupRecordSet(ctx *Context, args *LookupRecordSetArgs, opts ...InvokeOption) (*LookupRecordSetResult, error)
func LookupRecordSetOutput(ctx *Context, args *LookupRecordSetOutputArgs, opts ...InvokeOption) LookupRecordSetResultOutput

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

    public static class GetRecordSet 
{
    public static Task<GetRecordSetResult> InvokeAsync(GetRecordSetArgs args, InvokeOptions? opts = null)
    public static Output<GetRecordSetResult> Invoke(GetRecordSetInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetRecordSetResult> getRecordSet(GetRecordSetArgs args, InvokeOptions options)
public static Output<GetRecordSetResult> getRecordSet(GetRecordSetArgs args, InvokeOptions options)

    fn::invoke:
  function: azure-native:network:getRecordSet
  arguments:
    # arguments dictionary

    The following arguments are supported:

    RecordType string
    The type of DNS record in this record set.
    RelativeRecordSetName string
    The name of the record set, relative to the name of the zone.
    ResourceGroupName string
    The name of the resource group.
    ZoneName string
    The name of the DNS zone (without a terminating dot).
    RecordType string
    The type of DNS record in this record set.
    RelativeRecordSetName string
    The name of the record set, relative to the name of the zone.
    ResourceGroupName string
    The name of the resource group.
    ZoneName string
    The name of the DNS zone (without a terminating dot).
    recordType String
    The type of DNS record in this record set.
    relativeRecordSetName String
    The name of the record set, relative to the name of the zone.
    resourceGroupName String
    The name of the resource group.
    zoneName String
    The name of the DNS zone (without a terminating dot).
    recordType string
    The type of DNS record in this record set.
    relativeRecordSetName string
    The name of the record set, relative to the name of the zone.
    resourceGroupName string
    The name of the resource group.
    zoneName string
    The name of the DNS zone (without a terminating dot).
    record_type str
    The type of DNS record in this record set.
    relative_record_set_name str
    The name of the record set, relative to the name of the zone.
    resource_group_name str
    The name of the resource group.
    zone_name str
    The name of the DNS zone (without a terminating dot).
    recordType String
    The type of DNS record in this record set.
    relativeRecordSetName String
    The name of the record set, relative to the name of the zone.
    resourceGroupName String
    The name of the resource group.
    zoneName String
    The name of the DNS zone (without a terminating dot).

    getRecordSet Result

    The following output properties are available:

    Fqdn string
    Fully qualified domain name of the record set.
    Id string
    The ID of the record set.
    Name string
    The name of the record set.
    ProvisioningState string
    provisioning State of the record set.
    Type string
    The type of the record set.
    ARecords List<Pulumi.AzureNative.Network.Outputs.ARecordResponse>
    The list of A records in the record set.
    AaaaRecords List<Pulumi.AzureNative.Network.Outputs.AaaaRecordResponse>
    The list of AAAA records in the record set.
    CaaRecords List<Pulumi.AzureNative.Network.Outputs.CaaRecordResponse>
    The list of CAA records in the record set.
    CnameRecord Pulumi.AzureNative.Network.Outputs.CnameRecordResponse
    The CNAME record in the record set.
    Etag string
    The etag of the record set.
    Metadata Dictionary<string, string>
    The metadata attached to the record set.
    MxRecords List<Pulumi.AzureNative.Network.Outputs.MxRecordResponse>
    The list of MX records in the record set.
    NsRecords List<Pulumi.AzureNative.Network.Outputs.NsRecordResponse>
    The list of NS records in the record set.
    PtrRecords List<Pulumi.AzureNative.Network.Outputs.PtrRecordResponse>
    The list of PTR records in the record set.
    SoaRecord Pulumi.AzureNative.Network.Outputs.SoaRecordResponse
    The SOA record in the record set.
    SrvRecords List<Pulumi.AzureNative.Network.Outputs.SrvRecordResponse>
    The list of SRV records in the record set.
    TargetResource Pulumi.AzureNative.Network.Outputs.SubResourceResponse
    A reference to an azure resource from where the dns resource value is taken.
    Ttl double
    The TTL (time-to-live) of the records in the record set.
    TxtRecords List<Pulumi.AzureNative.Network.Outputs.TxtRecordResponse>
    The list of TXT records in the record set.
    Fqdn string
    Fully qualified domain name of the record set.
    Id string
    The ID of the record set.
    Name string
    The name of the record set.
    ProvisioningState string
    provisioning State of the record set.
    Type string
    The type of the record set.
    ARecords []ARecordResponse
    The list of A records in the record set.
    AaaaRecords []AaaaRecordResponse
    The list of AAAA records in the record set.
    CaaRecords []CaaRecordResponse
    The list of CAA records in the record set.
    CnameRecord CnameRecordResponse
    The CNAME record in the record set.
    Etag string
    The etag of the record set.
    Metadata map[string]string
    The metadata attached to the record set.
    MxRecords []MxRecordResponse
    The list of MX records in the record set.
    NsRecords []NsRecordResponse
    The list of NS records in the record set.
    PtrRecords []PtrRecordResponse
    The list of PTR records in the record set.
    SoaRecord SoaRecordResponse
    The SOA record in the record set.
    SrvRecords []SrvRecordResponse
    The list of SRV records in the record set.
    TargetResource SubResourceResponse
    A reference to an azure resource from where the dns resource value is taken.
    Ttl float64
    The TTL (time-to-live) of the records in the record set.
    TxtRecords []TxtRecordResponse
    The list of TXT records in the record set.
    fqdn String
    Fully qualified domain name of the record set.
    id String
    The ID of the record set.
    name String
    The name of the record set.
    provisioningState String
    provisioning State of the record set.
    type String
    The type of the record set.
    aRecords List<ARecordResponse>
    The list of A records in the record set.
    aaaaRecords List<AaaaRecordResponse>
    The list of AAAA records in the record set.
    caaRecords List<CaaRecordResponse>
    The list of CAA records in the record set.
    cnameRecord CnameRecordResponse
    The CNAME record in the record set.
    etag String
    The etag of the record set.
    metadata Map<String,String>
    The metadata attached to the record set.
    mxRecords List<MxRecordResponse>
    The list of MX records in the record set.
    nsRecords List<NsRecordResponse>
    The list of NS records in the record set.
    ptrRecords List<PtrRecordResponse>
    The list of PTR records in the record set.
    soaRecord SoaRecordResponse
    The SOA record in the record set.
    srvRecords List<SrvRecordResponse>
    The list of SRV records in the record set.
    targetResource SubResourceResponse
    A reference to an azure resource from where the dns resource value is taken.
    ttl Double
    The TTL (time-to-live) of the records in the record set.
    txtRecords List<TxtRecordResponse>
    The list of TXT records in the record set.
    fqdn string
    Fully qualified domain name of the record set.
    id string
    The ID of the record set.
    name string
    The name of the record set.
    provisioningState string
    provisioning State of the record set.
    type string
    The type of the record set.
    aRecords ARecordResponse[]
    The list of A records in the record set.
    aaaaRecords AaaaRecordResponse[]
    The list of AAAA records in the record set.
    caaRecords CaaRecordResponse[]
    The list of CAA records in the record set.
    cnameRecord CnameRecordResponse
    The CNAME record in the record set.
    etag string
    The etag of the record set.
    metadata {[key: string]: string}
    The metadata attached to the record set.
    mxRecords MxRecordResponse[]
    The list of MX records in the record set.
    nsRecords NsRecordResponse[]
    The list of NS records in the record set.
    ptrRecords PtrRecordResponse[]
    The list of PTR records in the record set.
    soaRecord SoaRecordResponse
    The SOA record in the record set.
    srvRecords SrvRecordResponse[]
    The list of SRV records in the record set.
    targetResource SubResourceResponse
    A reference to an azure resource from where the dns resource value is taken.
    ttl number
    The TTL (time-to-live) of the records in the record set.
    txtRecords TxtRecordResponse[]
    The list of TXT records in the record set.
    fqdn str
    Fully qualified domain name of the record set.
    id str
    The ID of the record set.
    name str
    The name of the record set.
    provisioning_state str
    provisioning State of the record set.
    type str
    The type of the record set.
    a_records Sequence[ARecordResponse]
    The list of A records in the record set.
    aaaa_records Sequence[AaaaRecordResponse]
    The list of AAAA records in the record set.
    caa_records Sequence[CaaRecordResponse]
    The list of CAA records in the record set.
    cname_record CnameRecordResponse
    The CNAME record in the record set.
    etag str
    The etag of the record set.
    metadata Mapping[str, str]
    The metadata attached to the record set.
    mx_records Sequence[MxRecordResponse]
    The list of MX records in the record set.
    ns_records Sequence[NsRecordResponse]
    The list of NS records in the record set.
    ptr_records Sequence[PtrRecordResponse]
    The list of PTR records in the record set.
    soa_record SoaRecordResponse
    The SOA record in the record set.
    srv_records Sequence[SrvRecordResponse]
    The list of SRV records in the record set.
    target_resource SubResourceResponse
    A reference to an azure resource from where the dns resource value is taken.
    ttl float
    The TTL (time-to-live) of the records in the record set.
    txt_records Sequence[TxtRecordResponse]
    The list of TXT records in the record set.
    fqdn String
    Fully qualified domain name of the record set.
    id String
    The ID of the record set.
    name String
    The name of the record set.
    provisioningState String
    provisioning State of the record set.
    type String
    The type of the record set.
    aRecords List<Property Map>
    The list of A records in the record set.
    aaaaRecords List<Property Map>
    The list of AAAA records in the record set.
    caaRecords List<Property Map>
    The list of CAA records in the record set.
    cnameRecord Property Map
    The CNAME record in the record set.
    etag String
    The etag of the record set.
    metadata Map<String>
    The metadata attached to the record set.
    mxRecords List<Property Map>
    The list of MX records in the record set.
    nsRecords List<Property Map>
    The list of NS records in the record set.
    ptrRecords List<Property Map>
    The list of PTR records in the record set.
    soaRecord Property Map
    The SOA record in the record set.
    srvRecords List<Property Map>
    The list of SRV records in the record set.
    targetResource Property Map
    A reference to an azure resource from where the dns resource value is taken.
    ttl Number
    The TTL (time-to-live) of the records in the record set.
    txtRecords List<Property Map>
    The list of TXT records in the record set.

    Supporting Types

    ARecordResponse

    Ipv4Address string
    The IPv4 address of this A record.
    Ipv4Address string
    The IPv4 address of this A record.
    ipv4Address String
    The IPv4 address of this A record.
    ipv4Address string
    The IPv4 address of this A record.
    ipv4_address str
    The IPv4 address of this A record.
    ipv4Address String
    The IPv4 address of this A record.

    AaaaRecordResponse

    Ipv6Address string
    The IPv6 address of this AAAA record.
    Ipv6Address string
    The IPv6 address of this AAAA record.
    ipv6Address String
    The IPv6 address of this AAAA record.
    ipv6Address string
    The IPv6 address of this AAAA record.
    ipv6_address str
    The IPv6 address of this AAAA record.
    ipv6Address String
    The IPv6 address of this AAAA record.

    CaaRecordResponse

    Flags int
    The flags for this CAA record as an integer between 0 and 255.
    Tag string
    The tag for this CAA record.
    Value string
    The value for this CAA record.
    Flags int
    The flags for this CAA record as an integer between 0 and 255.
    Tag string
    The tag for this CAA record.
    Value string
    The value for this CAA record.
    flags Integer
    The flags for this CAA record as an integer between 0 and 255.
    tag String
    The tag for this CAA record.
    value String
    The value for this CAA record.
    flags number
    The flags for this CAA record as an integer between 0 and 255.
    tag string
    The tag for this CAA record.
    value string
    The value for this CAA record.
    flags int
    The flags for this CAA record as an integer between 0 and 255.
    tag str
    The tag for this CAA record.
    value str
    The value for this CAA record.
    flags Number
    The flags for this CAA record as an integer between 0 and 255.
    tag String
    The tag for this CAA record.
    value String
    The value for this CAA record.

    CnameRecordResponse

    Cname string
    The canonical name for this CNAME record.
    Cname string
    The canonical name for this CNAME record.
    cname String
    The canonical name for this CNAME record.
    cname string
    The canonical name for this CNAME record.
    cname str
    The canonical name for this CNAME record.
    cname String
    The canonical name for this CNAME record.

    MxRecordResponse

    Exchange string
    The domain name of the mail host for this MX record.
    Preference int
    The preference value for this MX record.
    Exchange string
    The domain name of the mail host for this MX record.
    Preference int
    The preference value for this MX record.
    exchange String
    The domain name of the mail host for this MX record.
    preference Integer
    The preference value for this MX record.
    exchange string
    The domain name of the mail host for this MX record.
    preference number
    The preference value for this MX record.
    exchange str
    The domain name of the mail host for this MX record.
    preference int
    The preference value for this MX record.
    exchange String
    The domain name of the mail host for this MX record.
    preference Number
    The preference value for this MX record.

    NsRecordResponse

    Nsdname string
    The name server name for this NS record.
    Nsdname string
    The name server name for this NS record.
    nsdname String
    The name server name for this NS record.
    nsdname string
    The name server name for this NS record.
    nsdname str
    The name server name for this NS record.
    nsdname String
    The name server name for this NS record.

    PtrRecordResponse

    Ptrdname string
    The PTR target domain name for this PTR record.
    Ptrdname string
    The PTR target domain name for this PTR record.
    ptrdname String
    The PTR target domain name for this PTR record.
    ptrdname string
    The PTR target domain name for this PTR record.
    ptrdname str
    The PTR target domain name for this PTR record.
    ptrdname String
    The PTR target domain name for this PTR record.

    SoaRecordResponse

    Email string
    The email contact for this SOA record.
    ExpireTime double
    The expire time for this SOA record.
    Host string
    The domain name of the authoritative name server for this SOA record.
    MinimumTtl double
    The minimum value for this SOA record. By convention this is used to determine the negative caching duration.
    RefreshTime double
    The refresh value for this SOA record.
    RetryTime double
    The retry time for this SOA record.
    SerialNumber double
    The serial number for this SOA record.
    Email string
    The email contact for this SOA record.
    ExpireTime float64
    The expire time for this SOA record.
    Host string
    The domain name of the authoritative name server for this SOA record.
    MinimumTtl float64
    The minimum value for this SOA record. By convention this is used to determine the negative caching duration.
    RefreshTime float64
    The refresh value for this SOA record.
    RetryTime float64
    The retry time for this SOA record.
    SerialNumber float64
    The serial number for this SOA record.
    email String
    The email contact for this SOA record.
    expireTime Double
    The expire time for this SOA record.
    host String
    The domain name of the authoritative name server for this SOA record.
    minimumTtl Double
    The minimum value for this SOA record. By convention this is used to determine the negative caching duration.
    refreshTime Double
    The refresh value for this SOA record.
    retryTime Double
    The retry time for this SOA record.
    serialNumber Double
    The serial number for this SOA record.
    email string
    The email contact for this SOA record.
    expireTime number
    The expire time for this SOA record.
    host string
    The domain name of the authoritative name server for this SOA record.
    minimumTtl number
    The minimum value for this SOA record. By convention this is used to determine the negative caching duration.
    refreshTime number
    The refresh value for this SOA record.
    retryTime number
    The retry time for this SOA record.
    serialNumber number
    The serial number for this SOA record.
    email str
    The email contact for this SOA record.
    expire_time float
    The expire time for this SOA record.
    host str
    The domain name of the authoritative name server for this SOA record.
    minimum_ttl float
    The minimum value for this SOA record. By convention this is used to determine the negative caching duration.
    refresh_time float
    The refresh value for this SOA record.
    retry_time float
    The retry time for this SOA record.
    serial_number float
    The serial number for this SOA record.
    email String
    The email contact for this SOA record.
    expireTime Number
    The expire time for this SOA record.
    host String
    The domain name of the authoritative name server for this SOA record.
    minimumTtl Number
    The minimum value for this SOA record. By convention this is used to determine the negative caching duration.
    refreshTime Number
    The refresh value for this SOA record.
    retryTime Number
    The retry time for this SOA record.
    serialNumber Number
    The serial number for this SOA record.

    SrvRecordResponse

    Port int
    The port value for this SRV record.
    Priority int
    The priority value for this SRV record.
    Target string
    The target domain name for this SRV record.
    Weight int
    The weight value for this SRV record.
    Port int
    The port value for this SRV record.
    Priority int
    The priority value for this SRV record.
    Target string
    The target domain name for this SRV record.
    Weight int
    The weight value for this SRV record.
    port Integer
    The port value for this SRV record.
    priority Integer
    The priority value for this SRV record.
    target String
    The target domain name for this SRV record.
    weight Integer
    The weight value for this SRV record.
    port number
    The port value for this SRV record.
    priority number
    The priority value for this SRV record.
    target string
    The target domain name for this SRV record.
    weight number
    The weight value for this SRV record.
    port int
    The port value for this SRV record.
    priority int
    The priority value for this SRV record.
    target str
    The target domain name for this SRV record.
    weight int
    The weight value for this SRV record.
    port Number
    The port value for this SRV record.
    priority Number
    The priority value for this SRV record.
    target String
    The target domain name for this SRV record.
    weight Number
    The weight value for this SRV record.

    SubResourceResponse

    Id string
    Resource ID.
    Id string
    Resource ID.
    id String
    Resource ID.
    id string
    Resource ID.
    id str
    Resource ID.
    id String
    Resource ID.

    TxtRecordResponse

    Value List<string>
    The text value of this TXT record.
    Value []string
    The text value of this TXT record.
    value List<String>
    The text value of this TXT record.
    value string[]
    The text value of this TXT record.
    value Sequence[str]
    The text value of this TXT record.
    value List<String>
    The text value of this TXT record.

    Package Details

    Repository
    azure-native-v2 pulumi/pulumi-azure-native
    License
    Apache-2.0
    azure-native-v2 logo
    These are the docs for Azure Native v2. We recommenend using the latest version, Azure Native v3.
    Azure Native v2 v2.90.0 published on Thursday, Mar 27, 2025 by Pulumi
    pulumi/pulumi-azure-native