pulumi-azure-kotlin/com.pulumi.azure.network.kotlin/Route

Route

class Route : KotlinCustomResource

Manages a Route within a Route Table.

NOTE on Route Tables and Routes: This provider currently provides both a standalone Route resource, and allows for Routes to be defined in-line within the Route Table resource. At this time you cannot use a Route Table with in-line Routes in conjunction with any Route resources. Doing so will cause a conflict of Route configurations and will overwrite Routes.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";
const example = new azure.core.ResourceGroup("example", {
    name: "example-resources",
    location: "West Europe",
});
const exampleRouteTable = new azure.network.RouteTable("example", {
    name: "acceptanceTestRouteTable1",
    location: example.location,
    resourceGroupName: example.name,
});
const exampleRoute = new azure.network.Route("example", {
    name: "acceptanceTestRoute1",
    resourceGroupName: example.name,
    routeTableName: exampleRouteTable.name,
    addressPrefix: "10.1.0.0/16",
    nextHopType: "VnetLocal",
});

import pulumi
import pulumi_azure as azure
example = azure.core.ResourceGroup("example",
    name="example-resources",
    location="West Europe")
example_route_table = azure.network.RouteTable("example",
    name="acceptanceTestRouteTable1",
    location=example.location,
    resource_group_name=example.name)
example_route = azure.network.Route("example",
    name="acceptanceTestRoute1",
    resource_group_name=example.name,
    route_table_name=example_route_table.name,
    address_prefix="10.1.0.0/16",
    next_hop_type="VnetLocal")

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Azure = Pulumi.Azure;
return await Deployment.RunAsync(() =>
{
    var example = new Azure.Core.ResourceGroup("example", new()
    {
        Name = "example-resources",
        Location = "West Europe",
    });
    var exampleRouteTable = new Azure.Network.RouteTable("example", new()
    {
        Name = "acceptanceTestRouteTable1",
        Location = example.Location,
        ResourceGroupName = example.Name,
    });
    var exampleRoute = new Azure.Network.Route("example", new()
    {
        Name = "acceptanceTestRoute1",
        ResourceGroupName = example.Name,
        RouteTableName = exampleRouteTable.Name,
        AddressPrefix = "10.1.0.0/16",
        NextHopType = "VnetLocal",
    });
});

package main
import (
	"github.com/pulumi/pulumi-azure/sdk/v6/go/azure/core"
	"github.com/pulumi/pulumi-azure/sdk/v6/go/azure/network"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := core.NewResourceGroup(ctx, "example", &core.ResourceGroupArgs{
			Name:     pulumi.String("example-resources"),
			Location: pulumi.String("West Europe"),
		})
		if err != nil {
			return err
		}
		exampleRouteTable, err := network.NewRouteTable(ctx, "example", &network.RouteTableArgs{
			Name:              pulumi.String("acceptanceTestRouteTable1"),
			Location:          example.Location,
			ResourceGroupName: example.Name,
		})
		if err != nil {
			return err
		}
		_, err = network.NewRoute(ctx, "example", &network.RouteArgs{
			Name:              pulumi.String("acceptanceTestRoute1"),
			ResourceGroupName: example.Name,
			RouteTableName:    exampleRouteTable.Name,
			AddressPrefix:     pulumi.String("10.1.0.0/16"),
			NextHopType:       pulumi.String("VnetLocal"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azure.core.ResourceGroup;
import com.pulumi.azure.core.ResourceGroupArgs;
import com.pulumi.azure.network.RouteTable;
import com.pulumi.azure.network.RouteTableArgs;
import com.pulumi.azure.network.Route;
import com.pulumi.azure.network.RouteArgs;
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 example = new ResourceGroup("example", ResourceGroupArgs.builder()
            .name("example-resources")
            .location("West Europe")
            .build());
        var exampleRouteTable = new RouteTable("exampleRouteTable", RouteTableArgs.builder()
            .name("acceptanceTestRouteTable1")
            .location(example.location())
            .resourceGroupName(example.name())
            .build());
        var exampleRoute = new Route("exampleRoute", RouteArgs.builder()
            .name("acceptanceTestRoute1")
            .resourceGroupName(example.name())
            .routeTableName(exampleRouteTable.name())
            .addressPrefix("10.1.0.0/16")
            .nextHopType("VnetLocal")
            .build());
    }
}

resources:
  example:
    type: azure:core:ResourceGroup
    properties:
      name: example-resources
      location: West Europe
  exampleRouteTable:
    type: azure:network:RouteTable
    name: example
    properties:
      name: acceptanceTestRouteTable1
      location: ${example.location}
      resourceGroupName: ${example.name}
  exampleRoute:
    type: azure:network:Route
    name: example
    properties:
      name: acceptanceTestRoute1
      resourceGroupName: ${example.name}
      routeTableName: ${exampleRouteTable.name}
      addressPrefix: 10.1.0.0/16
      nextHopType: VnetLocal

Import

Routes can be imported using the resource id, e.g.

$ pulumi import azure:network/route:Route exampleRoute /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Network/routeTables/mytable1/routes/myroute1

Properties

addressPrefix

val addressPrefix: Output<String>

The destination to which the route applies. Can be CIDR (such as 10.1.0.0/16) or Azure Service Tag (such as ApiManagement, AzureBackup or AzureMonitor) format.

val id: Output<String>

name

val name: Output<String>

The name of the route. Changing this forces a new resource to be created.

nextHopInIpAddress

val nextHopInIpAddress: Output<String>?

Contains the IP address packets should be forwarded to. Next hop values are only allowed in routes where the next hop type is VirtualAppliance.

nextHopType

val nextHopType: Output<String>

The type of Azure hop the packet should be sent to. Possible values are VirtualNetworkGateway, VnetLocal, Internet, VirtualAppliance and None.

pulumiChildResources

val pulumiChildResources: Set<KotlinResource>

pulumiResourceName

val pulumiResourceName: String

pulumiResourceType

val pulumiResourceType: String

resourceGroupName

val resourceGroupName: Output<String>

The name of the resource group in which to create the route. Changing this forces a new resource to be created.

routeTableName

val routeTableName: Output<String>

The name of the route table within which create the route. Changing this forces a new resource to be created.

urn

val urn: Output<String>