aws.appmesh.getRoute

Start a Neo task

Explain and create an aws.appmesh.getRoute resource

AWS v7.11.0 published on Wednesday, Nov 5, 2025 by Pulumi

pulumi/pulumi-aws

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const test = aws.appmesh.getRoute({
    name: "test-route",
    meshName: "test-mesh",
    virtualRouterName: "test-router",
});

import pulumi
import pulumi_aws as aws

test = aws.appmesh.get_route(name="test-route",
    mesh_name="test-mesh",
    virtual_router_name="test-router")

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/appmesh"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := appmesh.LookupRoute(ctx, &appmesh.LookupRouteArgs{
			Name:              "test-route",
			MeshName:          "test-mesh",
			VirtualRouterName: "test-router",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var test = Aws.AppMesh.GetRoute.Invoke(new()
    {
        Name = "test-route",
        MeshName = "test-mesh",
        VirtualRouterName = "test-router",
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.appmesh.AppmeshFunctions;
import com.pulumi.aws.appmesh.inputs.GetRouteArgs;
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 test = AppmeshFunctions.getRoute(GetRouteArgs.builder()
            .name("test-route")
            .meshName("test-mesh")
            .virtualRouterName("test-router")
            .build());

    }
}

variables:
  test:
    fn::invoke:
      function: aws:appmesh:getRoute
      arguments:
        name: test-route
        meshName: test-mesh
        virtualRouterName: test-router

Using getRoute

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getRoute(args: GetRouteArgs, opts?: InvokeOptions): Promise<GetRouteResult>
function getRouteOutput(args: GetRouteOutputArgs, opts?: InvokeOptions): Output<GetRouteResult>

def get_route(mesh_name: Optional[str] = None,
              mesh_owner: Optional[str] = None,
              name: Optional[str] = None,
              region: Optional[str] = None,
              tags: Optional[Mapping[str, str]] = None,
              virtual_router_name: Optional[str] = None,
              opts: Optional[InvokeOptions] = None) -> GetRouteResult
def get_route_output(mesh_name: Optional[pulumi.Input[str]] = None,
              mesh_owner: Optional[pulumi.Input[str]] = None,
              name: Optional[pulumi.Input[str]] = None,
              region: Optional[pulumi.Input[str]] = None,
              tags: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
              virtual_router_name: Optional[pulumi.Input[str]] = None,
              opts: Optional[InvokeOptions] = None) -> Output[GetRouteResult]

func LookupRoute(ctx *Context, args *LookupRouteArgs, opts ...InvokeOption) (*LookupRouteResult, error)
func LookupRouteOutput(ctx *Context, args *LookupRouteOutputArgs, opts ...InvokeOption) LookupRouteResultOutput

> Note: This function is named LookupRoute in the Go SDK.

public static class GetRoute 
{
    public static Task<GetRouteResult> InvokeAsync(GetRouteArgs args, InvokeOptions? opts = null)
    public static Output<GetRouteResult> Invoke(GetRouteInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetRouteResult> getRoute(GetRouteArgs args, InvokeOptions options)
public static Output<GetRouteResult> getRoute(GetRouteArgs args, InvokeOptions options)

fn::invoke:
  function: aws:appmesh/getRoute:getRoute
  arguments:
    # arguments dictionary

The following arguments are supported:

MeshName string: Name of the service mesh in which the virtual router exists.
Name string: Name of the route.
VirtualRouterName string: Name of the virtual router in which the route exists.
MeshOwner string: AWS account ID of the service mesh's owner.
Region string: Region where this resource will be managed. Defaults to the Region set in the provider configuration.
Tags Dictionary<string, string>: Map of tags.

MeshName string: Name of the service mesh in which the virtual router exists.
Name string: Name of the route.
VirtualRouterName string: Name of the virtual router in which the route exists.
MeshOwner string: AWS account ID of the service mesh's owner.
Region string: Region where this resource will be managed. Defaults to the Region set in the provider configuration.
Tags map[string]string: Map of tags.

meshName String: Name of the service mesh in which the virtual router exists.
name String: Name of the route.
virtualRouterName String: Name of the virtual router in which the route exists.
meshOwner String: AWS account ID of the service mesh's owner.
region String: Region where this resource will be managed. Defaults to the Region set in the provider configuration.
tags Map<String,String>: Map of tags.

meshName string: Name of the service mesh in which the virtual router exists.
name string: Name of the route.
virtualRouterName string: Name of the virtual router in which the route exists.
meshOwner string: AWS account ID of the service mesh's owner.
region string: Region where this resource will be managed. Defaults to the Region set in the provider configuration.
tags {[key: string]: string}: Map of tags.

mesh_name str: Name of the service mesh in which the virtual router exists.
name str: Name of the route.
virtual_router_name str: Name of the virtual router in which the route exists.
mesh_owner str: AWS account ID of the service mesh's owner.
region str: Region where this resource will be managed. Defaults to the Region set in the provider configuration.
tags Mapping[str, str]: Map of tags.

meshName String: Name of the service mesh in which the virtual router exists.
name String: Name of the route.
virtualRouterName String: Name of the virtual router in which the route exists.
meshOwner String: AWS account ID of the service mesh's owner.
region String: Region where this resource will be managed. Defaults to the Region set in the provider configuration.
tags Map<String>: Map of tags.

getRoute Result

The following output properties are available:

Arn string: ARN of the route.
CreatedDate string: Creation date of the route.
Id string: The provider-assigned unique ID for this managed resource.
LastUpdatedDate string: Last update date of the route.
MeshName string
MeshOwner string
Name string
Region string
ResourceOwner string: Resource owner's AWS account ID.
Specs List<GetRouteSpec>: Route specification. See the aws.appmesh.Route resource for details.
Tags Dictionary<string, string>: Map of tags.
VirtualRouterName string

Arn string: ARN of the route.
CreatedDate string: Creation date of the route.
Id string: The provider-assigned unique ID for this managed resource.
LastUpdatedDate string: Last update date of the route.
MeshName string
MeshOwner string
Name string
Region string
ResourceOwner string: Resource owner's AWS account ID.
Specs []GetRouteSpec: Route specification. See the aws.appmesh.Route resource for details.
Tags map[string]string: Map of tags.
VirtualRouterName string

arn String: ARN of the route.
createdDate String: Creation date of the route.
id String: The provider-assigned unique ID for this managed resource.
lastUpdatedDate String: Last update date of the route.
meshName String
meshOwner String
name String
region String
resourceOwner String: Resource owner's AWS account ID.
specs List<GetRouteSpec>: Route specification. See the aws.appmesh.Route resource for details.
tags Map<String,String>: Map of tags.
virtualRouterName String

arn string: ARN of the route.
createdDate string: Creation date of the route.
id string: The provider-assigned unique ID for this managed resource.
lastUpdatedDate string: Last update date of the route.
meshName string
meshOwner string
name string
region string
resourceOwner string: Resource owner's AWS account ID.
specs GetRouteSpec[]: Route specification. See the aws.appmesh.Route resource for details.
tags {[key: string]: string}: Map of tags.
virtualRouterName string

arn str: ARN of the route.
created_date str: Creation date of the route.
id str: The provider-assigned unique ID for this managed resource.
last_updated_date str: Last update date of the route.
mesh_name str
mesh_owner str
name str
region str
resource_owner str: Resource owner's AWS account ID.
specs Sequence[GetRouteSpec]: Route specification. See the aws.appmesh.Route resource for details.
tags Mapping[str, str]: Map of tags.
virtual_router_name str

arn String: ARN of the route.
createdDate String: Creation date of the route.
id String: The provider-assigned unique ID for this managed resource.
lastUpdatedDate String: Last update date of the route.
meshName String
meshOwner String
name String
region String
resourceOwner String: Resource owner's AWS account ID.
specs List<Property Map>: Route specification. See the aws.appmesh.Route resource for details.
tags Map<String>: Map of tags.
virtualRouterName String