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

com.pulumi.azure.trafficmanager.kotlin.Profile.kt Maven / Gradle / Ivy

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

package com.pulumi.azure.trafficmanager.kotlin

import com.pulumi.azure.trafficmanager.kotlin.outputs.ProfileDnsConfig
import com.pulumi.azure.trafficmanager.kotlin.outputs.ProfileMonitorConfig
import com.pulumi.core.Output
import com.pulumi.kotlin.KotlinCustomResource
import com.pulumi.kotlin.PulumiTagMarker
import com.pulumi.kotlin.ResourceMapper
import com.pulumi.kotlin.options.CustomResourceOptions
import com.pulumi.kotlin.options.CustomResourceOptionsBuilder
import com.pulumi.resources.Resource
import kotlin.Boolean
import kotlin.Deprecated
import kotlin.Int
import kotlin.String
import kotlin.Suppress
import kotlin.Unit
import kotlin.collections.Map
import com.pulumi.azure.trafficmanager.kotlin.outputs.ProfileDnsConfig.Companion.toKotlin as profileDnsConfigToKotlin
import com.pulumi.azure.trafficmanager.kotlin.outputs.ProfileMonitorConfig.Companion.toKotlin as profileMonitorConfigToKotlin

/**
 * Builder for [Profile].
 */
@PulumiTagMarker
@Deprecated(
    message = """
azure.trafficmanager.Profile has been deprecated in favor of azure.network.TrafficManagerProfile
""",
)
public class ProfileResourceBuilder internal constructor() {
    public var name: String? = null

    public var args: ProfileArgs = ProfileArgs()

    public var opts: CustomResourceOptions = CustomResourceOptions()

    /**
     * @param name The _unique_ name of the resulting resource.
     */
    public fun name(`value`: String) {
        this.name = value
    }

    /**
     * @param block The arguments to use to populate this resource's properties.
     */
    public suspend fun args(block: suspend ProfileArgsBuilder.() -> Unit) {
        val builder = ProfileArgsBuilder()
        block(builder)
        this.args = builder.build()
    }

    /**
     * @param block A bag of options that control this resource's behavior.
     */
    public suspend fun opts(block: suspend CustomResourceOptionsBuilder.() -> Unit) {
        this.opts = com.pulumi.kotlin.options.CustomResourceOptions.opts(block)
    }

    internal fun build(): Profile {
        val builtJavaResource = com.pulumi.azure.trafficmanager.Profile(
            this.name,
            this.args.toJava(),
            this.opts.toJava(),
        )
        return Profile(builtJavaResource)
    }
}

/**
 * Manages a Traffic Manager Profile to which multiple endpoints can be attached.
 * ## Example Usage
 * 
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as azure from "@pulumi/azure";
 * import * as random from "@pulumi/random";
 * const server = new random.RandomId("server", {
 *     keepers: {
 *         azi_id: "1",
 *     },
 *     byteLength: 8,
 * });
 * const example = new azure.core.ResourceGroup("example", {
 *     name: "trafficmanagerProfile",
 *     location: "West Europe",
 * });
 * const exampleTrafficManagerProfile = new azure.network.TrafficManagerProfile("example", {
 *     name: server.hex,
 *     resourceGroupName: example.name,
 *     trafficRoutingMethod: "Weighted",
 *     dnsConfig: {
 *         relativeName: server.hex,
 *         ttl: 100,
 *     },
 *     monitorConfig: {
 *         protocol: "HTTP",
 *         port: 80,
 *         path: "/",
 *         intervalInSeconds: 30,
 *         timeoutInSeconds: 9,
 *         toleratedNumberOfFailures: 3,
 *     },
 *     tags: {
 *         environment: "Production",
 *     },
 * });
 * ```
 * ```python
 * import pulumi
 * import pulumi_azure as azure
 * import pulumi_random as random
 * server = random.RandomId("server",
 *     keepers={
 *         "azi_id": "1",
 *     },
 *     byte_length=8)
 * example = azure.core.ResourceGroup("example",
 *     name="trafficmanagerProfile",
 *     location="West Europe")
 * example_traffic_manager_profile = azure.network.TrafficManagerProfile("example",
 *     name=server.hex,
 *     resource_group_name=example.name,
 *     traffic_routing_method="Weighted",
 *     dns_config={
 *         "relative_name": server.hex,
 *         "ttl": 100,
 *     },
 *     monitor_config={
 *         "protocol": "HTTP",
 *         "port": 80,
 *         "path": "/",
 *         "interval_in_seconds": 30,
 *         "timeout_in_seconds": 9,
 *         "tolerated_number_of_failures": 3,
 *     },
 *     tags={
 *         "environment": "Production",
 *     })
 * ```
 * ```csharp
 * using System.Collections.Generic;
 * using System.Linq;
 * using Pulumi;
 * using Azure = Pulumi.Azure;
 * using Random = Pulumi.Random;
 * return await Deployment.RunAsync(() =>
 * {
 *     var server = new Random.RandomId("server", new()
 *     {
 *         Keepers =
 *         {
 *             { "azi_id", "1" },
 *         },
 *         ByteLength = 8,
 *     });
 *     var example = new Azure.Core.ResourceGroup("example", new()
 *     {
 *         Name = "trafficmanagerProfile",
 *         Location = "West Europe",
 *     });
 *     var exampleTrafficManagerProfile = new Azure.Network.TrafficManagerProfile("example", new()
 *     {
 *         Name = server.Hex,
 *         ResourceGroupName = example.Name,
 *         TrafficRoutingMethod = "Weighted",
 *         DnsConfig = new Azure.Network.Inputs.TrafficManagerProfileDnsConfigArgs
 *         {
 *             RelativeName = server.Hex,
 *             Ttl = 100,
 *         },
 *         MonitorConfig = new Azure.Network.Inputs.TrafficManagerProfileMonitorConfigArgs
 *         {
 *             Protocol = "HTTP",
 *             Port = 80,
 *             Path = "/",
 *             IntervalInSeconds = 30,
 *             TimeoutInSeconds = 9,
 *             ToleratedNumberOfFailures = 3,
 *         },
 *         Tags =
 *         {
 *             { "environment", "Production" },
 *         },
 *     });
 * });
 * ```
 * ```go
 * package main
 * import (
 * 	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/core"
 * 	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/network"
 * 	"github.com/pulumi/pulumi-random/sdk/v4/go/random"
 * 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
 * )
 * func main() {
 * 	pulumi.Run(func(ctx *pulumi.Context) error {
 * 		server, err := random.NewRandomId(ctx, "server", &random.RandomIdArgs{
 * 			Keepers: pulumi.StringMap{
 * 				"azi_id": pulumi.String("1"),
 * 			},
 * 			ByteLength: pulumi.Int(8),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		example, err := core.NewResourceGroup(ctx, "example", &core.ResourceGroupArgs{
 * 			Name:     pulumi.String("trafficmanagerProfile"),
 * 			Location: pulumi.String("West Europe"),
 * 		})
 * 		if err != nil {
 * 			return err
 * 		}
 * 		_, err = network.NewTrafficManagerProfile(ctx, "example", &network.TrafficManagerProfileArgs{
 * 			Name:                 server.Hex,
 * 			ResourceGroupName:    example.Name,
 * 			TrafficRoutingMethod: pulumi.String("Weighted"),
 * 			DnsConfig: &network.TrafficManagerProfileDnsConfigArgs{
 * 				RelativeName: server.Hex,
 * 				Ttl:          pulumi.Int(100),
 * 			},
 * 			MonitorConfig: &network.TrafficManagerProfileMonitorConfigArgs{
 * 				Protocol:                  pulumi.String("HTTP"),
 * 				Port:                      pulumi.Int(80),
 * 				Path:                      pulumi.String("/"),
 * 				IntervalInSeconds:         pulumi.Int(30),
 * 				TimeoutInSeconds:          pulumi.Int(9),
 * 				ToleratedNumberOfFailures: pulumi.Int(3),
 * 			},
 * 			Tags: pulumi.StringMap{
 * 				"environment": pulumi.String("Production"),
 * 			},
 * 		})
 * 		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.random.RandomId;
 * import com.pulumi.random.RandomIdArgs;
 * import com.pulumi.azure.core.ResourceGroup;
 * import com.pulumi.azure.core.ResourceGroupArgs;
 * import com.pulumi.azure.network.TrafficManagerProfile;
 * import com.pulumi.azure.network.TrafficManagerProfileArgs;
 * import com.pulumi.azure.network.inputs.TrafficManagerProfileDnsConfigArgs;
 * import com.pulumi.azure.network.inputs.TrafficManagerProfileMonitorConfigArgs;
 * 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 server = new RandomId("server", RandomIdArgs.builder()
 *             .keepers(Map.of("azi_id", 1))
 *             .byteLength(8)
 *             .build());
 *         var example = new ResourceGroup("example", ResourceGroupArgs.builder()
 *             .name("trafficmanagerProfile")
 *             .location("West Europe")
 *             .build());
 *         var exampleTrafficManagerProfile = new TrafficManagerProfile("exampleTrafficManagerProfile", TrafficManagerProfileArgs.builder()
 *             .name(server.hex())
 *             .resourceGroupName(example.name())
 *             .trafficRoutingMethod("Weighted")
 *             .dnsConfig(TrafficManagerProfileDnsConfigArgs.builder()
 *                 .relativeName(server.hex())
 *                 .ttl(100)
 *                 .build())
 *             .monitorConfig(TrafficManagerProfileMonitorConfigArgs.builder()
 *                 .protocol("HTTP")
 *                 .port(80)
 *                 .path("/")
 *                 .intervalInSeconds(30)
 *                 .timeoutInSeconds(9)
 *                 .toleratedNumberOfFailures(3)
 *                 .build())
 *             .tags(Map.of("environment", "Production"))
 *             .build());
 *     }
 * }
 * ```
 * ```yaml
 * resources:
 *   server:
 *     type: random:RandomId
 *     properties:
 *       keepers:
 *         azi_id: 1
 *       byteLength: 8
 *   example:
 *     type: azure:core:ResourceGroup
 *     properties:
 *       name: trafficmanagerProfile
 *       location: West Europe
 *   exampleTrafficManagerProfile:
 *     type: azure:network:TrafficManagerProfile
 *     name: example
 *     properties:
 *       name: ${server.hex}
 *       resourceGroupName: ${example.name}
 *       trafficRoutingMethod: Weighted
 *       dnsConfig:
 *         relativeName: ${server.hex}
 *         ttl: 100
 *       monitorConfig:
 *         protocol: HTTP
 *         port: 80
 *         path: /
 *         intervalInSeconds: 30
 *         timeoutInSeconds: 9
 *         toleratedNumberOfFailures: 3
 *       tags:
 *         environment: Production
 * ```
 * 
 * ## Import
 * Traffic Manager Profiles can be imported using the `resource id`, e.g.
 * ```sh
 * $ pulumi import azure:trafficmanager/profile:Profile exampleProfile /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Network/trafficManagerProfiles/mytrafficmanagerprofile1
 * ```
 */
@Deprecated(
    message = """
azure.trafficmanager.Profile has been deprecated in favor of azure.network.TrafficManagerProfile
""",
)
public class Profile internal constructor(
    override val javaResource: com.pulumi.azure.trafficmanager.Profile,
) : KotlinCustomResource(javaResource, ProfileMapper) {
    /**
     * This block specifies the DNS configuration of the Profile. One `dns_config` block as defined below.
     */
    public val dnsConfig: Output
        get() = javaResource.dnsConfig().applyValue({ args0 ->
            args0.let({ args0 ->
                profileDnsConfigToKotlin(args0)
            })
        })

    /**
     * The FQDN of the created Profile.
     */
    public val fqdn: Output
        get() = javaResource.fqdn().applyValue({ args0 -> args0 })

    /**
     * The amount of endpoints to return for DNS queries to this Profile. Possible values range from `1` to `8`.
     * > **NOTE:** `max_return` must be set when the `traffic_routing_method` is `MultiValue`.
     */
    public val maxReturn: Output?
        get() = javaResource.maxReturn().applyValue({ args0 -> args0.map({ args0 -> args0 }).orElse(null) })

    /**
     * This block specifies the Endpoint monitoring configuration for the Profile. One `monitor_config` block as defined below.
     */
    public val monitorConfig: Output
        get() = javaResource.monitorConfig().applyValue({ args0 ->
            args0.let({ args0 ->
                profileMonitorConfigToKotlin(args0)
            })
        })

    /**
     * The name of the Traffic Manager profile. Changing this forces a new resource to be created.
     */
    public val name: Output
        get() = javaResource.name().applyValue({ args0 -> args0 })

    /**
     * The status of the profile, can be set to either `Enabled` or `Disabled`. Defaults to `Enabled`.
     */
    public val profileStatus: Output
        get() = javaResource.profileStatus().applyValue({ args0 -> args0 })

    /**
     * The name of the resource group in which to create the Traffic Manager profile. Changing this forces a new resource to be created.
     */
    public val resourceGroupName: Output
        get() = javaResource.resourceGroupName().applyValue({ args0 -> args0 })

    /**
     * A mapping of tags to assign to the resource.
     */
    public val tags: Output>?
        get() = javaResource.tags().applyValue({ args0 ->
            args0.map({ args0 ->
                args0.map({ args0 ->
                    args0.key.to(args0.value)
                }).toMap()
            }).orElse(null)
        })

    /**
     * Specifies the algorithm used to route traffic. Possible values are `Geographic`, `Weighted`, `Performance`, `Priority`, `Subnet` and `MultiValue`.
     * * `Geographic` - Traffic is routed based on Geographic regions specified in the Endpoint.
     * * `MultiValue` - All healthy Endpoints are returned.  MultiValue routing method works only if all the endpoints of type `External` and are specified as IPv4 or IPv6 addresses.
     * * `Performance` - Traffic is routed via the User's closest Endpoint
     * * `Priority` - Traffic is routed to the Endpoint with the lowest `priority` value.
     * * `Subnet` - Traffic is routed based on a mapping of sets of end-user IP address ranges to a specific Endpoint within a Traffic Manager profile.
     * * `Weighted` - Traffic is spread across Endpoints proportional to their `weight` value.
     */
    public val trafficRoutingMethod: Output
        get() = javaResource.trafficRoutingMethod().applyValue({ args0 -> args0 })

    /**
     * Indicates whether Traffic View is enabled for the Traffic Manager profile.
     */
    public val trafficViewEnabled: Output?
        get() = javaResource.trafficViewEnabled().applyValue({ args0 ->
            args0.map({ args0 ->
                args0
            }).orElse(null)
        })
}

public object ProfileMapper : ResourceMapper {
    override fun supportsMappingOfType(javaResource: Resource): Boolean =
        com.pulumi.azure.trafficmanager.Profile::class == javaResource::class

    override fun map(javaResource: Resource): Profile = Profile(
        javaResource as
            com.pulumi.azure.trafficmanager.Profile,
    )
}

/**
 * @see [Profile].
 * @param name The _unique_ name of the resulting resource.
 * @param block Builder for [Profile].
 */
@Deprecated(
    message = """
azure.trafficmanager.Profile has been deprecated in favor of azure.network.TrafficManagerProfile
""",
)
public suspend fun profile(name: String, block: suspend ProfileResourceBuilder.() -> Unit): Profile {
    val builder = ProfileResourceBuilder()
    builder.name(name)
    block(builder)
    return builder.build()
}

/**
 * @see [Profile].
 * @param name The _unique_ name of the resulting resource.
 */
@Deprecated(
    message = """
azure.trafficmanager.Profile has been deprecated in favor of azure.network.TrafficManagerProfile
""",
)
public fun profile(name: String): Profile {
    val builder = ProfileResourceBuilder()
    builder.name(name)
    return builder.build()
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy