get Records
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.Apply(getRecordsResult => getRecordsResult.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
A collection of arguments for invoking getRecords.
Return
A collection of values returned by getRecords.
Parameters
The domain name associated to the records.
Host record regex.
A list of record IDs.
Whether the record is locked or not.
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
File name where to save data source results (after running pulumi preview
).
Record status. Valid items are ENABLE
and DISABLE
.
Record type. Valid items are A
, NS
, MX
, TXT
, CNAME
, SRV
, AAAA
, REDIRECT_URL
, FORWORD_URL
.
Host record value regex.
See also
Return
A collection of values returned by getRecords.
Parameters
Builder for com.pulumi.alicloud.dns.kotlin.inputs.GetRecordsPlainArgs.