pulumi-alicloud-kotlin/com.pulumi.alicloud.dns.kotlin/DnsFunctions/getRecords

getRecords

suspend fun getRecords(argument: GetRecordsPlainArgs): GetRecordsResult

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

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")
            .hostRecordRegex("^@")
            .isLocked(false)
            .outputFile("records.txt")
            .type("A")
            .build());
        ctx.export("firstRecordId", recordsDs.applyValue(getRecordsResult -> getRecordsResult.records()[0].recordId()));
    }
}
Content copied to clipboard

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.

See also

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.

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

Return

A collection of values returned by getRecords.

See also

Parameters

argument

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