@pulumi/linode/getDomainRecord.d.ts

A Pulumi package for creating and managing linode cloud resources.

import * as pulumi from "@pulumi/pulumi";
/**
 * Provides information about a Linode Domain Record.
 * For more information, see the [Linode APIv4 docs](https://techdocs.akamai.com/linode-api/reference/get-domain-record).
 *
 * ## Example Usage
 *
 * The following example shows how one might use this data source to access information about a Linode Domain Record.
 *
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as linode from "@pulumi/linode";
 *
 * const myRecord = linode.getDomainRecord({
 *     id: 14950401,
 *     domainId: 3150401,
 * });
 * const myWwwRecord = linode.getDomainRecord({
 *     name: "www",
 *     domainId: 3150401,
 * });
 * ```
 */
export declare function getDomainRecord(args: GetDomainRecordArgs, opts?: pulumi.InvokeOptions): Promise<GetDomainRecordResult>;
/**
 * A collection of arguments for invoking getDomainRecord.
 */
export interface GetDomainRecordArgs {
    /**
     * The associated domain's unique ID.
     */
    domainId: number;
    /**
     * The unique ID of the Domain Record.
     */
    id?: number;
    /**
     * The name of the Record.
     */
    name?: string;
}
/**
 * A collection of values returned by getDomainRecord.
 */
export interface GetDomainRecordResult {
    /**
     * The associated domain's unique ID.
     */
    readonly domainId: number;
    /**
     * The unique ID of the Domain Record.
     */
    readonly id?: number;
    /**
     * The name of the Record.
     */
    readonly name?: string;
    /**
     * The port this Record points to.
     */
    readonly port: number;
    /**
     * The priority of the target host. Lower values are preferred.
     */
    readonly priority: number;
    /**
     * The protocol this Record's service communicates with. Only valid for SRV records.
     */
    readonly protocol: string;
    /**
     * The service this Record identified. Only valid for SRV records.
     */
    readonly service: string;
    /**
     * The tag portion of a CAA record.
     */
    readonly tag: string;
    /**
     * The target for this Record. This field's actual usage depends on the type of record this represents. For A and AAAA records, this is the address the named Domain should resolve to.
     */
    readonly target: string;
    /**
     * The amount of time in seconds that this Domain's records may be cached by resolvers or other domain servers.
     */
    readonly ttlSec: number;
    /**
     * The type of Record this is in the DNS system. See all record types [here](https://techdocs.akamai.com/linode-api/reference/get-domain-record).
     */
    readonly type: string;
    /**
     * The relative weight of this Record. Higher values are preferred.
     */
    readonly weight: number;
}
/**
 * Provides information about a Linode Domain Record.
 * For more information, see the [Linode APIv4 docs](https://techdocs.akamai.com/linode-api/reference/get-domain-record).
 *
 * ## Example Usage
 *
 * The following example shows how one might use this data source to access information about a Linode Domain Record.
 *
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as linode from "@pulumi/linode";
 *
 * const myRecord = linode.getDomainRecord({
 *     id: 14950401,
 *     domainId: 3150401,
 * });
 * const myWwwRecord = linode.getDomainRecord({
 *     name: "www",
 *     domainId: 3150401,
 * });
 * ```
 */
export declare function getDomainRecordOutput(args: GetDomainRecordOutputArgs, opts?: pulumi.InvokeOutputOptions): pulumi.Output<GetDomainRecordResult>;
/**
 * A collection of arguments for invoking getDomainRecord.
 */
export interface GetDomainRecordOutputArgs {
    /**
     * The associated domain's unique ID.
     */
    domainId: pulumi.Input<number>;
    /**
     * The unique ID of the Domain Record.
     */
    id?: pulumi.Input<number>;
    /**
     * The name of the Record.
     */
    name?: pulumi.Input<string>;
}