getRecords

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

NOTE: Available since v1.0.0.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";
const recordsDs = alicloud.dns.getRecords({
domainName: "xiaozhu.top",
isLocked: false,
type: "A",
hostRecordRegex: "^@",
outputFile: "records.txt",
});
export const firstRecordId = recordsDs.then(recordsDs => recordsDs.records?.[0]?.recordId);
import pulumi
import pulumi_alicloud as alicloud
records_ds = alicloud.dns.get_records(domain_name="xiaozhu.top",
is_locked=False,
type="A",
host_record_regex="^@",
output_file="records.txt")
pulumi.export("firstRecordId", records_ds.records[0].record_id)
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;
return await Deployment.RunAsync(() =>
{
var recordsDs = AliCloud.Dns.GetRecords.Invoke(new()
{
DomainName = "xiaozhu.top",
IsLocked = false,
Type = "A",
HostRecordRegex = "^@",
OutputFile = "records.txt",
});
return new Dictionary<string, object?>
{
["firstRecordId"] = recordsDs&#46;Apply(getRecordsResult => getRecordsResult&#46;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.GetRecords(ctx, &dns.GetRecordsArgs{
DomainName: "xiaozhu.top",
IsLocked: pulumi.BoolRef(false),
Type: pulumi.StringRef("A"),
HostRecordRegex: pulumi.StringRef("^@"),
OutputFile: pulumi.StringRef("records.txt"),
}, 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.GetRecordsArgs;
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.getRecords(GetRecordsArgs.builder()
.domainName("xiaozhu.top")
.isLocked(false)
.type("A")
.hostRecordRegex("^@")
.outputFile("records.txt")
.build());
ctx.export("firstRecordId", recordsDs.records()[0].recordId());
}
}
variables:
recordsDs:
fn::invoke:
function: alicloud:dns:getRecords
arguments:
domainName: xiaozhu.top
isLocked: false
type: A
hostRecordRegex: ^@
outputFile: records.txt
outputs:
firstRecordId: ${recordsDs.records[0].recordId}

Return

A collection of values returned by getRecords.

Parameters

argument

A collection of arguments for invoking getRecords.


suspend fun getRecords(domainName: String, hostRecordRegex: String? = null, ids: List<String>? = null, isLocked: Boolean? = null, line: String? = null, outputFile: String? = null, status: String? = null, type: String? = null, valueRegex: String? = null): GetRecordsResult

Return

A collection of values returned by getRecords.

Parameters

domainName

The domain name associated to the records.

hostRecordRegex

Host record regex.

ids

A list of record IDs.

isLocked

Whether the record is locked or not.

line

ISP line. Valid items are default, telecom, unicom, mobile, oversea, edu, drpeng, btvn, .etc. For checking all resolution lines enumeration please visit Alibaba Cloud DNS doc

outputFile

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

status

Record status. Valid items are ENABLE and DISABLE.

type

Record type. Valid items are A, NS, MX, TXT, CNAME, SRV, AAAA, REDIRECT_URL, FORWORD_URL .

valueRegex

Host record value regex.

See also


suspend fun getRecords(argument: suspend GetRecordsPlainArgsBuilder.() -> Unit): GetRecordsResult

Return

A collection of values returned by getRecords.

Parameters

argument

Builder for com.pulumi.alicloud.dns.kotlin.inputs.GetRecordsPlainArgs.

See also