All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.pulumi.gcp.dns.kotlin.ResponsePolicyRuleArgs.kt Maven / Gradle / Ivy

@file:Suppress("NAME_SHADOWING", "DEPRECATION")

package com.pulumi.gcp.dns.kotlin

import com.pulumi.core.Output
import com.pulumi.core.Output.of
import com.pulumi.gcp.dns.ResponsePolicyRuleArgs.builder
import com.pulumi.gcp.dns.kotlin.inputs.ResponsePolicyRuleLocalDataArgs
import com.pulumi.gcp.dns.kotlin.inputs.ResponsePolicyRuleLocalDataArgsBuilder
import com.pulumi.kotlin.ConvertibleToJava
import com.pulumi.kotlin.PulumiTagMarker
import com.pulumi.kotlin.applySuspend
import kotlin.String
import kotlin.Suppress
import kotlin.Unit
import kotlin.jvm.JvmName

/**
 * A Response Policy Rule is a selector that applies its behavior to queries that match the selector.
 * Selectors are DNS names, which may be wildcards or exact matches.
 * Each DNS query subject to a Response Policy matches at most one ResponsePolicyRule,
 * as identified by the dns_name field with the longest matching suffix.
 * ## Example Usage
 * ### Dns Response Policy Rule Basic
 * 
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as gcp from "@pulumi/gcp";
 * const network_1 = new gcp.compute.Network("network-1", {
 *     name: "network-1",
 *     autoCreateSubnetworks: false,
 * });
 * const network_2 = new gcp.compute.Network("network-2", {
 *     name: "network-2",
 *     autoCreateSubnetworks: false,
 * });
 * const response_policy = new gcp.dns.ResponsePolicy("response-policy", {
 *     responsePolicyName: "example-response-policy",
 *     networks: [
 *         {
 *             networkUrl: network_1.id,
 *         },
 *         {
 *             networkUrl: network_2.id,
 *         },
 *     ],
 * });
 * const example_response_policy_rule = new gcp.dns.ResponsePolicyRule("example-response-policy-rule", {
 *     responsePolicy: response_policy.responsePolicyName,
 *     ruleName: "example-rule",
 *     dnsName: "dns.example.com.",
 *     localData: {
 *         localDatas: [{
 *             name: "dns.example.com.",
 *             type: "A",
 *             ttl: 300,
 *             rrdatas: ["192.0.2.91"],
 *         }],
 *     },
 * });
 * ```
 * ```python
 * import pulumi
 * import pulumi_gcp as gcp
 * network_1 = gcp.compute.Network("network-1",
 *     name="network-1",
 *     auto_create_subnetworks=False)
 * network_2 = gcp.compute.Network("network-2",
 *     name="network-2",
 *     auto_create_subnetworks=False)
 * response_policy = gcp.dns.ResponsePolicy("response-policy",
 *     response_policy_name="example-response-policy",
 *     networks=[
 *         {
 *             "network_url": network_1.id,
 *         },
 *         {
 *             "network_url": network_2.id,
 *         },
 *     ])
 * example_response_policy_rule = gcp.dns.ResponsePolicyRule("example-response-policy-rule",
 *     response_policy=response_policy.response_policy_name,
 *     rule_name="example-rule",
 *     dns_name="dns.example.com.",
 *     local_data={
 *         "local_datas": [{
 *             "name": "dns.example.com.",
 *             "type": "A",
 *             "ttl": 300,
 *             "rrdatas": ["192.0.2.91"],
 *         }],
 *     })
 * ```
 * ```csharp
 * using System.Collections.Generic;
 * using System.Linq;
 * using Pulumi;
 * using Gcp = Pulumi.Gcp;
 * return await Deployment.RunAsync(() =>
 * {
 *     var network_1 = new Gcp.Compute.Network("network-1", new()
 *     {
 *         Name = "network-1",
 *         AutoCreateSubnetworks = false,
 *     });
 *     var network_2 = new Gcp.Compute.Network("network-2", new()
 *     {
 *         Name = "network-2",
 *         AutoCreateSubnetworks = false,
 *     });
 *     var response_policy = new Gcp.Dns.ResponsePolicy("response-policy", new()
 *     {
 *         ResponsePolicyName = "example-response-policy",
 *         Networks = new[]
 *         {
 *             new Gcp.Dns.Inputs.ResponsePolicyNetworkArgs
 *             {
 *                 NetworkUrl = network_1.Id,
 *             },
 *             new Gcp.Dns.Inputs.ResponsePolicyNetworkArgs
 *             {
 *                 NetworkUrl = network_2.Id,
 *             },
 *         },
 *     });
 *     var example_response_policy_rule = new Gcp.Dns.ResponsePolicyRule("example-response-policy-rule", new()
 *     {
 *         ResponsePolicy = response_policy.ResponsePolicyName,
 *         RuleName = "example-rule",
 *         DnsName = "dns.example.com.",
 *         LocalData = new Gcp.Dns.Inputs.ResponsePolicyRuleLocalDataArgs
 *         {
 *             LocalDatas = new[]
 *             {
 *                 new Gcp.Dns.Inputs.ResponsePolicyRuleLocalDataLocalDataArgs
 *                 {
 *                     Name = "dns.example.com.",
 *                     Type = "A",
 *                     Ttl = 300,
 *                     Rrdatas = new[]
 *                     {
 *                         "192.0.2.91",
 *                     },
 *                 },
 *             },
 *         },
 *     });
 * });
 * ```
 * ```go
 * package main
 * import (
 * 	"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/compute"
 * 	"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/dns"
 * 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
 * )
 * func main() {
 * 	pulumi.Run(func(ctx *pulumi.Context) error {
 * 		_, err := compute.NewNetwork(ctx, "network-1", &compute.NetworkArgs{
 * 			Name:                  pulumi.String("network-1"),
 * 			AutoCreateSubnetworks: pulumi.Bool(false),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		_, err = compute.NewNetwork(ctx, "network-2", &compute.NetworkArgs{
 * 			Name:                  pulumi.String("network-2"),
 * 			AutoCreateSubnetworks: pulumi.Bool(false),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		_, err = dns.NewResponsePolicy(ctx, "response-policy", &dns.ResponsePolicyArgs{
 * 			ResponsePolicyName: pulumi.String("example-response-policy"),
 * 			Networks: dns.ResponsePolicyNetworkArray{
 * 				&dns.ResponsePolicyNetworkArgs{
 * 					NetworkUrl: network_1.ID(),
 * 				},
 * 				&dns.ResponsePolicyNetworkArgs{
 * 					NetworkUrl: network_2.ID(),
 * 				},
 * 			},
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		_, err = dns.NewResponsePolicyRule(ctx, "example-response-policy-rule", &dns.ResponsePolicyRuleArgs{
 * 			ResponsePolicy: response_policy.ResponsePolicyName,
 * 			RuleName:       pulumi.String("example-rule"),
 * 			DnsName:        pulumi.String("dns.example.com."),
 * 			LocalData: &dns.ResponsePolicyRuleLocalDataArgs{
 * 				LocalDatas: dns.ResponsePolicyRuleLocalDataLocalDataArray{
 * 					&dns.ResponsePolicyRuleLocalDataLocalDataArgs{
 * 						Name: pulumi.String("dns.example.com."),
 * 						Type: pulumi.String("A"),
 * 						Ttl:  pulumi.Int(300),
 * 						Rrdatas: pulumi.StringArray{
 * 							pulumi.String("192.0.2.91"),
 * 						},
 * 					},
 * 				},
 * 			},
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		return nil
 * 	})
 * }
 * ```
 * ```java
 * package generated_program;
 * import com.pulumi.Context;
 * import com.pulumi.Pulumi;
 * import com.pulumi.core.Output;
 * import com.pulumi.gcp.compute.Network;
 * import com.pulumi.gcp.compute.NetworkArgs;
 * import com.pulumi.gcp.dns.ResponsePolicy;
 * import com.pulumi.gcp.dns.ResponsePolicyArgs;
 * import com.pulumi.gcp.dns.inputs.ResponsePolicyNetworkArgs;
 * import com.pulumi.gcp.dns.ResponsePolicyRule;
 * import com.pulumi.gcp.dns.ResponsePolicyRuleArgs;
 * import com.pulumi.gcp.dns.inputs.ResponsePolicyRuleLocalDataArgs;
 * 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) {
 *         var network_1 = new Network("network-1", NetworkArgs.builder()
 *             .name("network-1")
 *             .autoCreateSubnetworks(false)
 *             .build());
 *         var network_2 = new Network("network-2", NetworkArgs.builder()
 *             .name("network-2")
 *             .autoCreateSubnetworks(false)
 *             .build());
 *         var response_policy = new ResponsePolicy("response-policy", ResponsePolicyArgs.builder()
 *             .responsePolicyName("example-response-policy")
 *             .networks(
 *                 ResponsePolicyNetworkArgs.builder()
 *                     .networkUrl(network_1.id())
 *                     .build(),
 *                 ResponsePolicyNetworkArgs.builder()
 *                     .networkUrl(network_2.id())
 *                     .build())
 *             .build());
 *         var example_response_policy_rule = new ResponsePolicyRule("example-response-policy-rule", ResponsePolicyRuleArgs.builder()
 *             .responsePolicy(response_policy.responsePolicyName())
 *             .ruleName("example-rule")
 *             .dnsName("dns.example.com.")
 *             .localData(ResponsePolicyRuleLocalDataArgs.builder()
 *                 .localDatas(ResponsePolicyRuleLocalDataLocalDataArgs.builder()
 *                     .name("dns.example.com.")
 *                     .type("A")
 *                     .ttl(300)
 *                     .rrdatas("192.0.2.91")
 *                     .build())
 *                 .build())
 *             .build());
 *     }
 * }
 * ```
 * ```yaml
 * resources:
 *   network-1:
 *     type: gcp:compute:Network
 *     properties:
 *       name: network-1
 *       autoCreateSubnetworks: false
 *   network-2:
 *     type: gcp:compute:Network
 *     properties:
 *       name: network-2
 *       autoCreateSubnetworks: false
 *   response-policy:
 *     type: gcp:dns:ResponsePolicy
 *     properties:
 *       responsePolicyName: example-response-policy
 *       networks:
 *         - networkUrl: ${["network-1"].id}
 *         - networkUrl: ${["network-2"].id}
 *   example-response-policy-rule:
 *     type: gcp:dns:ResponsePolicyRule
 *     properties:
 *       responsePolicy: ${["response-policy"].responsePolicyName}
 *       ruleName: example-rule
 *       dnsName: dns.example.com.
 *       localData:
 *         localDatas:
 *           - name: dns.example.com.
 *             type: A
 *             ttl: 300
 *             rrdatas:
 *               - 192.0.2.91
 * ```
 * 
 * ## Import
 * ResponsePolicyRule can be imported using any of these accepted formats:
 * * `projects/{{project}}/responsePolicies/{{response_policy}}/rules/{{rule_name}}`
 * * `{{project}}/{{response_policy}}/{{rule_name}}`
 * * `{{response_policy}}/{{rule_name}}`
 * When using the `pulumi import` command, ResponsePolicyRule can be imported using one of the formats above. For example:
 * ```sh
 * $ pulumi import gcp:dns/responsePolicyRule:ResponsePolicyRule default projects/{{project}}/responsePolicies/{{response_policy}}/rules/{{rule_name}}
 * ```
 * ```sh
 * $ pulumi import gcp:dns/responsePolicyRule:ResponsePolicyRule default {{project}}/{{response_policy}}/{{rule_name}}
 * ```
 * ```sh
 * $ pulumi import gcp:dns/responsePolicyRule:ResponsePolicyRule default {{response_policy}}/{{rule_name}}
 * ```
 * @property behavior Answer this query with a behavior rather than DNS data. Acceptable values are 'behaviorUnspecified', and 'bypassResponsePolicy'
 * @property dnsName The DNS name (wildcard or exact) to apply this rule to. Must be unique within the Response Policy Rule.
 * @property localData Answer this query directly with DNS data. These ResourceRecordSets override any other DNS behavior for the matched name;
 * in particular they override private zones, the public internet, and GCP internal DNS. No SOA nor NS types are allowed.
 * Structure is documented below.
 * @property project The ID of the project in which the resource belongs.
 * If it is not provided, the provider project is used.
 * @property responsePolicy Identifies the response policy addressed by this request.
 * - - -
 * @property ruleName An identifier for this rule. Must be unique with the ResponsePolicy.
 */
public data class ResponsePolicyRuleArgs(
    public val behavior: Output? = null,
    public val dnsName: Output? = null,
    public val localData: Output? = null,
    public val project: Output? = null,
    public val responsePolicy: Output? = null,
    public val ruleName: Output? = null,
) : ConvertibleToJava {
    override fun toJava(): com.pulumi.gcp.dns.ResponsePolicyRuleArgs =
        com.pulumi.gcp.dns.ResponsePolicyRuleArgs.builder()
            .behavior(behavior?.applyValue({ args0 -> args0 }))
            .dnsName(dnsName?.applyValue({ args0 -> args0 }))
            .localData(localData?.applyValue({ args0 -> args0.let({ args0 -> args0.toJava() }) }))
            .project(project?.applyValue({ args0 -> args0 }))
            .responsePolicy(responsePolicy?.applyValue({ args0 -> args0 }))
            .ruleName(ruleName?.applyValue({ args0 -> args0 })).build()
}

/**
 * Builder for [ResponsePolicyRuleArgs].
 */
@PulumiTagMarker
public class ResponsePolicyRuleArgsBuilder internal constructor() {
    private var behavior: Output? = null

    private var dnsName: Output? = null

    private var localData: Output? = null

    private var project: Output? = null

    private var responsePolicy: Output? = null

    private var ruleName: Output? = null

    /**
     * @param value Answer this query with a behavior rather than DNS data. Acceptable values are 'behaviorUnspecified', and 'bypassResponsePolicy'
     */
    @JvmName("ljqiixksgcrkfsfw")
    public suspend fun behavior(`value`: Output) {
        this.behavior = value
    }

    /**
     * @param value The DNS name (wildcard or exact) to apply this rule to. Must be unique within the Response Policy Rule.
     */
    @JvmName("bkudtvngfvjoddsu")
    public suspend fun dnsName(`value`: Output) {
        this.dnsName = value
    }

    /**
     * @param value Answer this query directly with DNS data. These ResourceRecordSets override any other DNS behavior for the matched name;
     * in particular they override private zones, the public internet, and GCP internal DNS. No SOA nor NS types are allowed.
     * Structure is documented below.
     */
    @JvmName("ahitihribxsriwkq")
    public suspend fun localData(`value`: Output) {
        this.localData = value
    }

    /**
     * @param value The ID of the project in which the resource belongs.
     * If it is not provided, the provider project is used.
     */
    @JvmName("rdywlqmbrsalehob")
    public suspend fun project(`value`: Output) {
        this.project = value
    }

    /**
     * @param value Identifies the response policy addressed by this request.
     * - - -
     */
    @JvmName("mscuotuysbcmlcto")
    public suspend fun responsePolicy(`value`: Output) {
        this.responsePolicy = value
    }

    /**
     * @param value An identifier for this rule. Must be unique with the ResponsePolicy.
     */
    @JvmName("yymtcdvqaqabebsh")
    public suspend fun ruleName(`value`: Output) {
        this.ruleName = value
    }

    /**
     * @param value Answer this query with a behavior rather than DNS data. Acceptable values are 'behaviorUnspecified', and 'bypassResponsePolicy'
     */
    @JvmName("gdoeqasqiuyctmgm")
    public suspend fun behavior(`value`: String?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.behavior = mapped
    }

    /**
     * @param value The DNS name (wildcard or exact) to apply this rule to. Must be unique within the Response Policy Rule.
     */
    @JvmName("lhqjosmywxxyiynq")
    public suspend fun dnsName(`value`: String?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.dnsName = mapped
    }

    /**
     * @param value Answer this query directly with DNS data. These ResourceRecordSets override any other DNS behavior for the matched name;
     * in particular they override private zones, the public internet, and GCP internal DNS. No SOA nor NS types are allowed.
     * Structure is documented below.
     */
    @JvmName("kbtpodrjfgdxsitw")
    public suspend fun localData(`value`: ResponsePolicyRuleLocalDataArgs?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.localData = mapped
    }

    /**
     * @param argument Answer this query directly with DNS data. These ResourceRecordSets override any other DNS behavior for the matched name;
     * in particular they override private zones, the public internet, and GCP internal DNS. No SOA nor NS types are allowed.
     * Structure is documented below.
     */
    @JvmName("pnjdvlwwgdygelkg")
    public suspend fun localData(argument: suspend ResponsePolicyRuleLocalDataArgsBuilder.() -> Unit) {
        val toBeMapped = ResponsePolicyRuleLocalDataArgsBuilder().applySuspend { argument() }.build()
        val mapped = of(toBeMapped)
        this.localData = mapped
    }

    /**
     * @param value The ID of the project in which the resource belongs.
     * If it is not provided, the provider project is used.
     */
    @JvmName("ckqmhknlapkcddip")
    public suspend fun project(`value`: String?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.project = mapped
    }

    /**
     * @param value Identifies the response policy addressed by this request.
     * - - -
     */
    @JvmName("vadkckiemjbjiasq")
    public suspend fun responsePolicy(`value`: String?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.responsePolicy = mapped
    }

    /**
     * @param value An identifier for this rule. Must be unique with the ResponsePolicy.
     */
    @JvmName("saujdcnsklowwklc")
    public suspend fun ruleName(`value`: String?) {
        val toBeMapped = value
        val mapped = toBeMapped?.let({ args0 -> of(args0) })
        this.ruleName = mapped
    }

    internal fun build(): ResponsePolicyRuleArgs = ResponsePolicyRuleArgs(
        behavior = behavior,
        dnsName = dnsName,
        localData = localData,
        project = project,
        responsePolicy = responsePolicy,
        ruleName = ruleName,
    )
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy