1. Packages
  2. Alibaba Cloud
  3. API Docs
  4. dns
  5. getAlidnsRecords
Alibaba Cloud v3.44.0 published on Thursday, Sep 28, 2023 by Pulumi

alicloud.dns.getAlidnsRecords

Explore with Pulumi AI

alicloud logo
Alibaba Cloud v3.44.0 published on Thursday, Sep 28, 2023 by Pulumi

    This data source provides a list of Alidns Domain Records in an Alibaba Cloud account according to the specified filters.

    NOTE: Available in 1.86.0+.

    Example Usage

    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using AliCloud = Pulumi.AliCloud;
    
    return await Deployment.RunAsync(() => 
    {
        var recordsDs = AliCloud.Dns.GetAlidnsRecords.Invoke(new()
        {
            DomainName = "xiaozhu.top",
            Ids = new[]
            {
                "1978593525779****",
            },
            OutputFile = "records.txt",
            Type = "A",
        });
    
        return new Dictionary<string, object?>
        {
            ["firstRecordId"] = recordsDs.Apply(getAlidnsRecordsResult => getAlidnsRecordsResult.Records[0]?.RecordId),
        };
    });
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/dns"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		recordsDs, err := dns.GetAlidnsRecords(ctx, &dns.GetAlidnsRecordsArgs{
    			DomainName: "xiaozhu.top",
    			Ids: []string{
    				"1978593525779****",
    			},
    			OutputFile: pulumi.StringRef("records.txt"),
    			Type:       pulumi.StringRef("A"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		ctx.Export("firstRecordId", recordsDs.Records[0].RecordId)
    		return nil
    	})
    }
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.alicloud.dns.DnsFunctions;
    import com.pulumi.alicloud.dns.inputs.GetAlidnsRecordsArgs;
    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 recordsDs = DnsFunctions.getAlidnsRecords(GetAlidnsRecordsArgs.builder()
                .domainName("xiaozhu.top")
                .ids("1978593525779****")
                .outputFile("records.txt")
                .type("A")
                .build());
    
            ctx.export("firstRecordId", recordsDs.applyValue(getAlidnsRecordsResult -> getAlidnsRecordsResult.records()[0].recordId()));
        }
    }
    
    import pulumi
    import pulumi_alicloud as alicloud
    
    records_ds = alicloud.dns.get_alidns_records(domain_name="xiaozhu.top",
        ids=["1978593525779****"],
        output_file="records.txt",
        type="A")
    pulumi.export("firstRecordId", records_ds.records[0].record_id)
    
    import * as pulumi from "@pulumi/pulumi";
    import * as alicloud from "@pulumi/alicloud";
    
    const recordsDs = alicloud.dns.getAlidnsRecords({
        domainName: "xiaozhu.top",
        ids: ["1978593525779****"],
        outputFile: "records.txt",
        type: "A",
    });
    export const firstRecordId = recordsDs.then(recordsDs => recordsDs.records?.[0]?.recordId);
    
    variables:
      recordsDs:
        fn::invoke:
          Function: alicloud:dns:getAlidnsRecords
          Arguments:
            domainName: xiaozhu.top
            ids:
              - 1978593525779****
            outputFile: records.txt
            type: A
    outputs:
      firstRecordId: ${recordsDs.records[0].recordId}
    

    Using getAlidnsRecords

    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 getAlidnsRecords(args: GetAlidnsRecordsArgs, opts?: InvokeOptions): Promise<GetAlidnsRecordsResult>
    function getAlidnsRecordsOutput(args: GetAlidnsRecordsOutputArgs, opts?: InvokeOptions): Output<GetAlidnsRecordsResult>
    def get_alidns_records(direction: Optional[str] = None,
                           domain_name: Optional[str] = None,
                           group_id: Optional[int] = None,
                           ids: Optional[Sequence[str]] = None,
                           key_word: Optional[str] = None,
                           lang: Optional[str] = None,
                           line: Optional[str] = None,
                           order_by: Optional[str] = None,
                           output_file: Optional[str] = None,
                           rr_key_word: Optional[str] = None,
                           rr_regex: Optional[str] = None,
                           search_mode: Optional[str] = None,
                           status: Optional[str] = None,
                           type: Optional[str] = None,
                           type_key_word: Optional[str] = None,
                           value_key_word: Optional[str] = None,
                           value_regex: Optional[str] = None,
                           opts: Optional[InvokeOptions] = None) -> GetAlidnsRecordsResult
    def get_alidns_records_output(direction: Optional[pulumi.Input[str]] = None,
                           domain_name: Optional[pulumi.Input[str]] = None,
                           group_id: Optional[pulumi.Input[int]] = None,
                           ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                           key_word: Optional[pulumi.Input[str]] = None,
                           lang: Optional[pulumi.Input[str]] = None,
                           line: Optional[pulumi.Input[str]] = None,
                           order_by: Optional[pulumi.Input[str]] = None,
                           output_file: Optional[pulumi.Input[str]] = None,
                           rr_key_word: Optional[pulumi.Input[str]] = None,
                           rr_regex: Optional[pulumi.Input[str]] = None,
                           search_mode: Optional[pulumi.Input[str]] = None,
                           status: Optional[pulumi.Input[str]] = None,
                           type: Optional[pulumi.Input[str]] = None,
                           type_key_word: Optional[pulumi.Input[str]] = None,
                           value_key_word: Optional[pulumi.Input[str]] = None,
                           value_regex: Optional[pulumi.Input[str]] = None,
                           opts: Optional[InvokeOptions] = None) -> Output[GetAlidnsRecordsResult]
    func GetAlidnsRecords(ctx *Context, args *GetAlidnsRecordsArgs, opts ...InvokeOption) (*GetAlidnsRecordsResult, error)
    func GetAlidnsRecordsOutput(ctx *Context, args *GetAlidnsRecordsOutputArgs, opts ...InvokeOption) GetAlidnsRecordsResultOutput

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

    public static class GetAlidnsRecords 
    {
        public static Task<GetAlidnsRecordsResult> InvokeAsync(GetAlidnsRecordsArgs args, InvokeOptions? opts = null)
        public static Output<GetAlidnsRecordsResult> Invoke(GetAlidnsRecordsInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetAlidnsRecordsResult> getAlidnsRecords(GetAlidnsRecordsArgs args, InvokeOptions options)
    // Output-based functions aren't available in Java yet
    
    fn::invoke:
      function: alicloud:dns/getAlidnsRecords:getAlidnsRecords
      arguments:
        # arguments dictionary

    The following arguments are supported:

    DomainName string

    The domain name associated to the records.

    Direction string

    Sorting direction. Valid values: DESC,ASC. Default to AESC.

    GroupId int

    Domain name group ID.

    Ids List<string>

    A list of record IDs.

    KeyWord string

    Keywords.

    Lang string

    User language.

    Line string

    ISP line. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc

    OrderBy string

    Sort by. Sort from newest to oldest according to the time added by resolution.

    OutputFile string

    File name where to save data source results (after running pulumi preview).

    RrKeyWord string

    The keywords recorded by the host are searched according to the %RRKeyWord% mode, and are not case sensitive.

    RrRegex string

    Host record regex.

    SearchMode string

    Search mode, Valid values: LIKE, EXACT, ADVANCED, LIKE (fuzzy), EXACT (accurate) search supports KeyWord field, ADVANCED (advanced) mode supports other fields.

    Status string

    Record status. Valid values: ENABLE and DISABLE.

    Type string

    Record type. Valid values: A, NS, MX, TXT, CNAME, SRV, AAAA, REDIRECT_URL, FORWORD_URL .

    TypeKeyWord string

    Analyze type keywords, search by full match, not case sensitive.

    ValueKeyWord string

    The keywords of the recorded value are searched according to the %ValueKeyWord% mode, and are not case sensitive.

    ValueRegex string

    Host record value regex.

    DomainName string

    The domain name associated to the records.

    Direction string

    Sorting direction. Valid values: DESC,ASC. Default to AESC.

    GroupId int

    Domain name group ID.

    Ids []string

    A list of record IDs.

    KeyWord string

    Keywords.

    Lang string

    User language.

    Line string

    ISP line. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc

    OrderBy string

    Sort by. Sort from newest to oldest according to the time added by resolution.

    OutputFile string

    File name where to save data source results (after running pulumi preview).

    RrKeyWord string

    The keywords recorded by the host are searched according to the %RRKeyWord% mode, and are not case sensitive.

    RrRegex string

    Host record regex.

    SearchMode string

    Search mode, Valid values: LIKE, EXACT, ADVANCED, LIKE (fuzzy), EXACT (accurate) search supports KeyWord field, ADVANCED (advanced) mode supports other fields.

    Status string

    Record status. Valid values: ENABLE and DISABLE.

    Type string

    Record type. Valid values: A, NS, MX, TXT, CNAME, SRV, AAAA, REDIRECT_URL, FORWORD_URL .

    TypeKeyWord string

    Analyze type keywords, search by full match, not case sensitive.

    ValueKeyWord string

    The keywords of the recorded value are searched according to the %ValueKeyWord% mode, and are not case sensitive.

    ValueRegex string

    Host record value regex.

    domainName String

    The domain name associated to the records.

    direction String

    Sorting direction. Valid values: DESC,ASC. Default to AESC.

    groupId Integer

    Domain name group ID.

    ids List<String>

    A list of record IDs.

    keyWord String

    Keywords.

    lang String

    User language.

    line String

    ISP line. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc

    orderBy String

    Sort by. Sort from newest to oldest according to the time added by resolution.

    outputFile String

    File name where to save data source results (after running pulumi preview).

    rrKeyWord String

    The keywords recorded by the host are searched according to the %RRKeyWord% mode, and are not case sensitive.

    rrRegex String

    Host record regex.

    searchMode String

    Search mode, Valid values: LIKE, EXACT, ADVANCED, LIKE (fuzzy), EXACT (accurate) search supports KeyWord field, ADVANCED (advanced) mode supports other fields.

    status String

    Record status. Valid values: ENABLE and DISABLE.

    type String

    Record type. Valid values: A, NS, MX, TXT, CNAME, SRV, AAAA, REDIRECT_URL, FORWORD_URL .

    typeKeyWord String

    Analyze type keywords, search by full match, not case sensitive.

    valueKeyWord String

    The keywords of the recorded value are searched according to the %ValueKeyWord% mode, and are not case sensitive.

    valueRegex String

    Host record value regex.

    domainName string

    The domain name associated to the records.

    direction string

    Sorting direction. Valid values: DESC,ASC. Default to AESC.

    groupId number

    Domain name group ID.

    ids string[]

    A list of record IDs.

    keyWord string

    Keywords.

    lang string

    User language.

    line string

    ISP line. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc

    orderBy string

    Sort by. Sort from newest to oldest according to the time added by resolution.

    outputFile string

    File name where to save data source results (after running pulumi preview).

    rrKeyWord string

    The keywords recorded by the host are searched according to the %RRKeyWord% mode, and are not case sensitive.

    rrRegex string

    Host record regex.

    searchMode string

    Search mode, Valid values: LIKE, EXACT, ADVANCED, LIKE (fuzzy), EXACT (accurate) search supports KeyWord field, ADVANCED (advanced) mode supports other fields.

    status string

    Record status. Valid values: ENABLE and DISABLE.

    type string

    Record type. Valid values: A, NS, MX, TXT, CNAME, SRV, AAAA, REDIRECT_URL, FORWORD_URL .

    typeKeyWord string

    Analyze type keywords, search by full match, not case sensitive.

    valueKeyWord string

    The keywords of the recorded value are searched according to the %ValueKeyWord% mode, and are not case sensitive.

    valueRegex string

    Host record value regex.

    domain_name str

    The domain name associated to the records.

    direction str

    Sorting direction. Valid values: DESC,ASC. Default to AESC.

    group_id int

    Domain name group ID.

    ids Sequence[str]

    A list of record IDs.

    key_word str

    Keywords.

    lang str

    User language.

    line str

    ISP line. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc

    order_by str

    Sort by. Sort from newest to oldest according to the time added by resolution.

    output_file str

    File name where to save data source results (after running pulumi preview).

    rr_key_word str

    The keywords recorded by the host are searched according to the %RRKeyWord% mode, and are not case sensitive.

    rr_regex str

    Host record regex.

    search_mode str

    Search mode, Valid values: LIKE, EXACT, ADVANCED, LIKE (fuzzy), EXACT (accurate) search supports KeyWord field, ADVANCED (advanced) mode supports other fields.

    status str

    Record status. Valid values: ENABLE and DISABLE.

    type str

    Record type. Valid values: A, NS, MX, TXT, CNAME, SRV, AAAA, REDIRECT_URL, FORWORD_URL .

    type_key_word str

    Analyze type keywords, search by full match, not case sensitive.

    value_key_word str

    The keywords of the recorded value are searched according to the %ValueKeyWord% mode, and are not case sensitive.

    value_regex str

    Host record value regex.

    domainName String

    The domain name associated to the records.

    direction String

    Sorting direction. Valid values: DESC,ASC. Default to AESC.

    groupId Number

    Domain name group ID.

    ids List<String>

    A list of record IDs.

    keyWord String

    Keywords.

    lang String

    User language.

    line String

    ISP line. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc

    orderBy String

    Sort by. Sort from newest to oldest according to the time added by resolution.

    outputFile String

    File name where to save data source results (after running pulumi preview).

    rrKeyWord String

    The keywords recorded by the host are searched according to the %RRKeyWord% mode, and are not case sensitive.

    rrRegex String

    Host record regex.

    searchMode String

    Search mode, Valid values: LIKE, EXACT, ADVANCED, LIKE (fuzzy), EXACT (accurate) search supports KeyWord field, ADVANCED (advanced) mode supports other fields.

    status String

    Record status. Valid values: ENABLE and DISABLE.

    type String

    Record type. Valid values: A, NS, MX, TXT, CNAME, SRV, AAAA, REDIRECT_URL, FORWORD_URL .

    typeKeyWord String

    Analyze type keywords, search by full match, not case sensitive.

    valueKeyWord String

    The keywords of the recorded value are searched according to the %ValueKeyWord% mode, and are not case sensitive.

    valueRegex String

    Host record value regex.

    getAlidnsRecords Result

    The following output properties are available:

    DomainName string

    Name of the domain record belongs to.

    Id string

    The provider-assigned unique ID for this managed resource.

    Ids List<string>

    A list of record IDs.

    Records List<Pulumi.AliCloud.Dns.Outputs.GetAlidnsRecordsRecord>

    A list of records. Each element contains the following attributes:

    Direction string
    GroupId int
    KeyWord string
    Lang string
    Line string

    ISP line of the record.

    OrderBy string
    OutputFile string
    RrKeyWord string
    RrRegex string
    SearchMode string
    Status string

    Status of the record.

    Type string

    Type of the record.

    TypeKeyWord string
    ValueKeyWord string
    ValueRegex string
    DomainName string

    Name of the domain record belongs to.

    Id string

    The provider-assigned unique ID for this managed resource.

    Ids []string

    A list of record IDs.

    Records []GetAlidnsRecordsRecord

    A list of records. Each element contains the following attributes:

    Direction string
    GroupId int
    KeyWord string
    Lang string
    Line string

    ISP line of the record.

    OrderBy string
    OutputFile string
    RrKeyWord string
    RrRegex string
    SearchMode string
    Status string

    Status of the record.

    Type string

    Type of the record.

    TypeKeyWord string
    ValueKeyWord string
    ValueRegex string
    domainName String

    Name of the domain record belongs to.

    id String

    The provider-assigned unique ID for this managed resource.

    ids List<String>

    A list of record IDs.

    records List<GetAliRecordsRecord>

    A list of records. Each element contains the following attributes:

    direction String
    groupId Integer
    keyWord String
    lang String
    line String

    ISP line of the record.

    orderBy String
    outputFile String
    rrKeyWord String
    rrRegex String
    searchMode String
    status String

    Status of the record.

    type String

    Type of the record.

    typeKeyWord String
    valueKeyWord String
    valueRegex String
    domainName string

    Name of the domain record belongs to.

    id string

    The provider-assigned unique ID for this managed resource.

    ids string[]

    A list of record IDs.

    records GetAlidnsRecordsRecord[]

    A list of records. Each element contains the following attributes:

    direction string
    groupId number
    keyWord string
    lang string
    line string

    ISP line of the record.

    orderBy string
    outputFile string
    rrKeyWord string
    rrRegex string
    searchMode string
    status string

    Status of the record.

    type string

    Type of the record.

    typeKeyWord string
    valueKeyWord string
    valueRegex string
    domain_name str

    Name of the domain record belongs to.

    id str

    The provider-assigned unique ID for this managed resource.

    ids Sequence[str]

    A list of record IDs.

    records Sequence[GetAlidnsRecordsRecord]

    A list of records. Each element contains the following attributes:

    direction str
    group_id int
    key_word str
    lang str
    line str

    ISP line of the record.

    order_by str
    output_file str
    rr_key_word str
    rr_regex str
    search_mode str
    status str

    Status of the record.

    type str

    Type of the record.

    type_key_word str
    value_key_word str
    value_regex str
    domainName String

    Name of the domain record belongs to.

    id String

    The provider-assigned unique ID for this managed resource.

    ids List<String>

    A list of record IDs.

    records List<Property Map>

    A list of records. Each element contains the following attributes:

    direction String
    groupId Number
    keyWord String
    lang String
    line String

    ISP line of the record.

    orderBy String
    outputFile String
    rrKeyWord String
    rrRegex String
    searchMode String
    status String

    Status of the record.

    type String

    Type of the record.

    typeKeyWord String
    valueKeyWord String
    valueRegex String

    Supporting Types

    GetAlidnsRecordsRecord

    DomainName string

    The domain name associated to the records.

    Id string

    ID of the resource.

    Line string

    ISP line. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc

    Locked bool

    Indicates whether the record is locked.

    Priority int

    Priority of the MX record.

    RecordId string

    ID of the record.

    Remark string

    The remark of the domain record. NOTE: Available in 1.144.0+.

    Rr string

    Host record of the domain.

    Status string

    Record status. Valid values: ENABLE and DISABLE.

    Ttl int

    TTL of the record.

    Type string

    Record type. Valid values: A, NS, MX, TXT, CNAME, SRV, AAAA, REDIRECT_URL, FORWORD_URL .

    Value string

    Host record value of the domain.

    DomainName string

    The domain name associated to the records.

    Id string

    ID of the resource.

    Line string

    ISP line. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc

    Locked bool

    Indicates whether the record is locked.

    Priority int

    Priority of the MX record.

    RecordId string

    ID of the record.

    Remark string

    The remark of the domain record. NOTE: Available in 1.144.0+.

    Rr string

    Host record of the domain.

    Status string

    Record status. Valid values: ENABLE and DISABLE.

    Ttl int

    TTL of the record.

    Type string

    Record type. Valid values: A, NS, MX, TXT, CNAME, SRV, AAAA, REDIRECT_URL, FORWORD_URL .

    Value string

    Host record value of the domain.

    domainName String

    The domain name associated to the records.

    id String

    ID of the resource.

    line String

    ISP line. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc

    locked Boolean

    Indicates whether the record is locked.

    priority Integer

    Priority of the MX record.

    recordId String

    ID of the record.

    remark String

    The remark of the domain record. NOTE: Available in 1.144.0+.

    rr String

    Host record of the domain.

    status String

    Record status. Valid values: ENABLE and DISABLE.

    ttl Integer

    TTL of the record.

    type String

    Record type. Valid values: A, NS, MX, TXT, CNAME, SRV, AAAA, REDIRECT_URL, FORWORD_URL .

    value String

    Host record value of the domain.

    domainName string

    The domain name associated to the records.

    id string

    ID of the resource.

    line string

    ISP line. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc

    locked boolean

    Indicates whether the record is locked.

    priority number

    Priority of the MX record.

    recordId string

    ID of the record.

    remark string

    The remark of the domain record. NOTE: Available in 1.144.0+.

    rr string

    Host record of the domain.

    status string

    Record status. Valid values: ENABLE and DISABLE.

    ttl number

    TTL of the record.

    type string

    Record type. Valid values: A, NS, MX, TXT, CNAME, SRV, AAAA, REDIRECT_URL, FORWORD_URL .

    value string

    Host record value of the domain.

    domain_name str

    The domain name associated to the records.

    id str

    ID of the resource.

    line str

    ISP line. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc

    locked bool

    Indicates whether the record is locked.

    priority int

    Priority of the MX record.

    record_id str

    ID of the record.

    remark str

    The remark of the domain record. NOTE: Available in 1.144.0+.

    rr str

    Host record of the domain.

    status str

    Record status. Valid values: ENABLE and DISABLE.

    ttl int

    TTL of the record.

    type str

    Record type. Valid values: A, NS, MX, TXT, CNAME, SRV, AAAA, REDIRECT_URL, FORWORD_URL .

    value str

    Host record value of the domain.

    domainName String

    The domain name associated to the records.

    id String

    ID of the resource.

    line String

    ISP line. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc

    locked Boolean

    Indicates whether the record is locked.

    priority Number

    Priority of the MX record.

    recordId String

    ID of the record.

    remark String

    The remark of the domain record. NOTE: Available in 1.144.0+.

    rr String

    Host record of the domain.

    status String

    Record status. Valid values: ENABLE and DISABLE.

    ttl Number

    TTL of the record.

    type String

    Record type. Valid values: A, NS, MX, TXT, CNAME, SRV, AAAA, REDIRECT_URL, FORWORD_URL .

    value String

    Host record value of the domain.

    Package Details

    Repository
    Alibaba Cloud pulumi/pulumi-alicloud
    License
    Apache-2.0
    Notes

    This Pulumi package is based on the alicloud Terraform Provider.

    alicloud logo
    Alibaba Cloud v3.44.0 published on Thursday, Sep 28, 2023 by Pulumi