Try AWS Native preview for resources not in the classic version.
aws.appmesh.getGatewayRoute
Explore with Pulumi AI
Try AWS Native preview for resources not in the classic version.
The App Mesh Gateway Route data source allows details of an App Mesh Gateway Route to be retrieved by its name, mesh_name, virtual_gateway_name, and optionally the mesh_owner.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const test = aws.appmesh.getGatewayRoute({
    name: "test-route",
    meshName: "test-mesh",
    virtualGatewayName: "test-gateway",
});
import pulumi
import pulumi_aws as aws
test = aws.appmesh.get_gateway_route(name="test-route",
    mesh_name="test-mesh",
    virtual_gateway_name="test-gateway")
package main
import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/appmesh"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := appmesh.LookupGatewayRoute(ctx, &appmesh.LookupGatewayRouteArgs{
			Name:               "test-route",
			MeshName:           "test-mesh",
			VirtualGatewayName: "test-gateway",
		}, 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.GetGatewayRoute.Invoke(new()
    {
        Name = "test-route",
        MeshName = "test-mesh",
        VirtualGatewayName = "test-gateway",
    });
});
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.GetGatewayRouteArgs;
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.getGatewayRoute(GetGatewayRouteArgs.builder()
            .name("test-route")
            .meshName("test-mesh")
            .virtualGatewayName("test-gateway")
            .build());
    }
}
variables:
  test:
    fn::invoke:
      Function: aws:appmesh:getGatewayRoute
      Arguments:
        name: test-route
        meshName: test-mesh
        virtualGatewayName: test-gateway
Using getGatewayRoute
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 getGatewayRoute(args: GetGatewayRouteArgs, opts?: InvokeOptions): Promise<GetGatewayRouteResult>
function getGatewayRouteOutput(args: GetGatewayRouteOutputArgs, opts?: InvokeOptions): Output<GetGatewayRouteResult>def get_gateway_route(mesh_name: Optional[str] = None,
                      mesh_owner: Optional[str] = None,
                      name: Optional[str] = None,
                      tags: Optional[Mapping[str, str]] = None,
                      virtual_gateway_name: Optional[str] = None,
                      opts: Optional[InvokeOptions] = None) -> GetGatewayRouteResult
def get_gateway_route_output(mesh_name: Optional[pulumi.Input[str]] = None,
                      mesh_owner: Optional[pulumi.Input[str]] = None,
                      name: Optional[pulumi.Input[str]] = None,
                      tags: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                      virtual_gateway_name: Optional[pulumi.Input[str]] = None,
                      opts: Optional[InvokeOptions] = None) -> Output[GetGatewayRouteResult]func LookupGatewayRoute(ctx *Context, args *LookupGatewayRouteArgs, opts ...InvokeOption) (*LookupGatewayRouteResult, error)
func LookupGatewayRouteOutput(ctx *Context, args *LookupGatewayRouteOutputArgs, opts ...InvokeOption) LookupGatewayRouteResultOutput> Note: This function is named LookupGatewayRoute in the Go SDK.
public static class GetGatewayRoute 
{
    public static Task<GetGatewayRouteResult> InvokeAsync(GetGatewayRouteArgs args, InvokeOptions? opts = null)
    public static Output<GetGatewayRouteResult> Invoke(GetGatewayRouteInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetGatewayRouteResult> getGatewayRoute(GetGatewayRouteArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
  function: aws:appmesh/getGatewayRoute:getGatewayRoute
  arguments:
    # arguments dictionaryThe following arguments are supported:
- Mesh
Name string - Name of the service mesh in which the virtual gateway exists.
 - Name string
 - Name of the gateway route.
 - Virtual
Gateway stringName  - Name of the virtual gateway in which the route exists.
 - Mesh
Owner string - AWS account ID of the service mesh's owner.
 - Dictionary<string, string>
 - Map of tags.
 
- Mesh
Name string - Name of the service mesh in which the virtual gateway exists.
 - Name string
 - Name of the gateway route.
 - Virtual
Gateway stringName  - Name of the virtual gateway in which the route exists.
 - Mesh
Owner string - AWS account ID of the service mesh's owner.
 - map[string]string
 - Map of tags.
 
- mesh
Name String - Name of the service mesh in which the virtual gateway exists.
 - name String
 - Name of the gateway route.
 - virtual
Gateway StringName  - Name of the virtual gateway in which the route exists.
 - mesh
Owner String - AWS account ID of the service mesh's owner.
 - Map<String,String>
 - Map of tags.
 
- mesh
Name string - Name of the service mesh in which the virtual gateway exists.
 - name string
 - Name of the gateway route.
 - virtual
Gateway stringName  - Name of the virtual gateway in which the route exists.
 - mesh
Owner string - AWS account ID of the service mesh's owner.
 - {[key: string]: string}
 - Map of tags.
 
- mesh_
name str - Name of the service mesh in which the virtual gateway exists.
 - name str
 - Name of the gateway route.
 - virtual_
gateway_ strname  - Name of the virtual gateway in which the route exists.
 - mesh_
owner str - AWS account ID of the service mesh's owner.
 - Mapping[str, str]
 - Map of tags.
 
- mesh
Name String - Name of the service mesh in which the virtual gateway exists.
 - name String
 - Name of the gateway route.
 - virtual
Gateway StringName  - Name of the virtual gateway in which the route exists.
 - mesh
Owner String - AWS account ID of the service mesh's owner.
 - Map<String>
 - Map of tags.
 
getGatewayRoute Result
The following output properties are available:
- Arn string
 - ARN of the gateway route.
 - Created
Date string - Creation date of the gateway route.
 - Id string
 - The provider-assigned unique ID for this managed resource.
 - Last
Updated stringDate  - Last update date of the gateway route.
 - Mesh
Name string - Mesh
Owner string - Name string
 - Resource
Owner string - Resource owner's AWS account ID.
 - Specs
List<Get
Gateway Route Spec>  - Gateway route specification. See the 
aws.appmesh.GatewayRouteresource for details. - Dictionary<string, string>
 - Map of tags.
 - Virtual
Gateway stringName  
- Arn string
 - ARN of the gateway route.
 - Created
Date string - Creation date of the gateway route.
 - Id string
 - The provider-assigned unique ID for this managed resource.
 - Last
Updated stringDate  - Last update date of the gateway route.
 - Mesh
Name string - Mesh
Owner string - Name string
 - Resource
Owner string - Resource owner's AWS account ID.
 - Specs
[]Get
Gateway Route Spec  - Gateway route specification. See the 
aws.appmesh.GatewayRouteresource for details. - map[string]string
 - Map of tags.
 - Virtual
Gateway stringName  
- arn String
 - ARN of the gateway route.
 - created
Date String - Creation date of the gateway route.
 - id String
 - The provider-assigned unique ID for this managed resource.
 - last
Updated StringDate  - Last update date of the gateway route.
 - mesh
Name String - mesh
Owner String - name String
 - resource
Owner String - Resource owner's AWS account ID.
 - specs
List<Get
Gateway Route Spec>  - Gateway route specification. See the 
aws.appmesh.GatewayRouteresource for details. - Map<String,String>
 - Map of tags.
 - virtual
Gateway StringName  
- arn string
 - ARN of the gateway route.
 - created
Date string - Creation date of the gateway route.
 - id string
 - The provider-assigned unique ID for this managed resource.
 - last
Updated stringDate  - Last update date of the gateway route.
 - mesh
Name string - mesh
Owner string - name string
 - resource
Owner string - Resource owner's AWS account ID.
 - specs
Get
Gateway Route Spec[]  - Gateway route specification. See the 
aws.appmesh.GatewayRouteresource for details. - {[key: string]: string}
 - Map of tags.
 - virtual
Gateway stringName  
- arn str
 - ARN of the gateway route.
 - created_
date str - Creation date of the gateway route.
 - id str
 - The provider-assigned unique ID for this managed resource.
 - last_
updated_ strdate  - Last update date of the gateway route.
 - mesh_
name str - mesh_
owner str - name str
 - resource_
owner str - Resource owner's AWS account ID.
 - specs
Sequence[Get
Gateway Route Spec]  - Gateway route specification. See the 
aws.appmesh.GatewayRouteresource for details. - Mapping[str, str]
 - Map of tags.
 - virtual_
gateway_ strname  
- arn String
 - ARN of the gateway route.
 - created
Date String - Creation date of the gateway route.
 - id String
 - The provider-assigned unique ID for this managed resource.
 - last
Updated StringDate  - Last update date of the gateway route.
 - mesh
Name String - mesh
Owner String - name String
 - resource
Owner String - Resource owner's AWS account ID.
 - specs List<Property Map>
 - Gateway route specification. See the 
aws.appmesh.GatewayRouteresource for details. - Map<String>
 - Map of tags.
 - virtual
Gateway StringName  
Supporting Types
GetGatewayRouteSpec   
GetGatewayRouteSpecGrpcRoute     
GetGatewayRouteSpecGrpcRouteAction      
GetGatewayRouteSpecGrpcRouteActionTarget       
GetGatewayRouteSpecGrpcRouteActionTargetVirtualService         
- Virtual
Service stringName  
- Virtual
Service stringName  
- virtual
Service StringName  
- virtual
Service stringName  
- virtual
Service StringName  
GetGatewayRouteSpecGrpcRouteMatch      
- Port int
 - Service
Name string 
- Port int
 - Service
Name string 
- port Integer
 - service
Name String 
- port number
 - service
Name string 
- port int
 - service_
name str 
- port Number
 - service
Name String 
GetGatewayRouteSpecHttp2Route    
GetGatewayRouteSpecHttp2RouteAction     
GetGatewayRouteSpecHttp2RouteActionRewrite      
GetGatewayRouteSpecHttp2RouteActionRewriteHostname       
- Default
Target stringHostname  
- Default
Target stringHostname  
- default
Target StringHostname  
- default
Target stringHostname  
- default
Target StringHostname  
GetGatewayRouteSpecHttp2RouteActionRewritePath       
- Exact string
 
- Exact string
 
- exact String
 
- exact string
 
- exact str
 
- exact String
 
GetGatewayRouteSpecHttp2RouteActionRewritePrefix       
- Default
Prefix string - Value string
 
- Default
Prefix string - Value string
 
- default
Prefix String - value String
 
- default
Prefix string - value string
 
- default_
prefix str - value str
 
- default
Prefix String - value String
 
GetGatewayRouteSpecHttp2RouteActionTarget      
GetGatewayRouteSpecHttp2RouteActionTargetVirtualService        
- Virtual
Service stringName  
- Virtual
Service stringName  
- virtual
Service StringName  
- virtual
Service stringName  
- virtual
Service StringName  
GetGatewayRouteSpecHttp2RouteMatch     
GetGatewayRouteSpecHttp2RouteMatchHeader      
- Invert bool
 - Matches
List<Get
Gateway Route Spec Http2Route Match Header Match>  - Name string
 - Name of the gateway route.
 
- Invert bool
 - Matches
[]Get
Gateway Route Spec Http2Route Match Header Match  - Name string
 - Name of the gateway route.
 
- invert Boolean
 - matches
List<Get
Gateway Route Spec Http2Route Match Header Match>  - name String
 - Name of the gateway route.
 
- invert boolean
 - matches
Get
Gateway Route Spec Http2Route Match Header Match[]  - name string
 - Name of the gateway route.
 
- invert bool
 - matches
Sequence[Get
Gateway Route Spec Http2Route Match Header Match]  - name str
 - Name of the gateway route.
 
- invert Boolean
 - matches List<Property Map>
 - name String
 - Name of the gateway route.
 
GetGatewayRouteSpecHttp2RouteMatchHeaderMatch       
GetGatewayRouteSpecHttp2RouteMatchHeaderMatchRange        
GetGatewayRouteSpecHttp2RouteMatchHostname      
GetGatewayRouteSpecHttp2RouteMatchPath      
GetGatewayRouteSpecHttp2RouteMatchQueryParameter       
- Matches
List<Get
Gateway Route Spec Http2Route Match Query Parameter Match>  - Name string
 - Name of the gateway route.
 
- Matches
[]Get
Gateway Route Spec Http2Route Match Query Parameter Match  - Name string
 - Name of the gateway route.
 
- matches
List<Get
Gateway Route Spec Http2Route Match Query Parameter Match>  - name String
 - Name of the gateway route.
 
- matches
Get
Gateway Route Spec Http2Route Match Query Parameter Match[]  - name string
 - Name of the gateway route.
 
- matches
Sequence[Get
Gateway Route Spec Http2Route Match Query Parameter Match]  - name str
 - Name of the gateway route.
 
- matches List<Property Map>
 - name String
 - Name of the gateway route.
 
GetGatewayRouteSpecHttp2RouteMatchQueryParameterMatch        
- Exact string
 
- Exact string
 
- exact String
 
- exact string
 
- exact str
 
- exact String
 
GetGatewayRouteSpecHttpRoute     
GetGatewayRouteSpecHttpRouteAction      
GetGatewayRouteSpecHttpRouteActionRewrite       
GetGatewayRouteSpecHttpRouteActionRewriteHostname        
- Default
Target stringHostname  
- Default
Target stringHostname  
- default
Target StringHostname  
- default
Target stringHostname  
- default
Target StringHostname  
GetGatewayRouteSpecHttpRouteActionRewritePath        
- Exact string
 
- Exact string
 
- exact String
 
- exact string
 
- exact str
 
- exact String
 
GetGatewayRouteSpecHttpRouteActionRewritePrefix        
- Default
Prefix string - Value string
 
- Default
Prefix string - Value string
 
- default
Prefix String - value String
 
- default
Prefix string - value string
 
- default_
prefix str - value str
 
- default
Prefix String - value String
 
GetGatewayRouteSpecHttpRouteActionTarget       
GetGatewayRouteSpecHttpRouteActionTargetVirtualService         
- Virtual
Service stringName  
- Virtual
Service stringName  
- virtual
Service StringName  
- virtual
Service stringName  
- virtual
Service StringName  
GetGatewayRouteSpecHttpRouteMatch      
GetGatewayRouteSpecHttpRouteMatchHeader       
- Invert bool
 - Matches
List<Get
Gateway Route Spec Http Route Match Header Match>  - Name string
 - Name of the gateway route.
 
- Invert bool
 - Matches
[]Get
Gateway Route Spec Http Route Match Header Match  - Name string
 - Name of the gateway route.
 
- invert Boolean
 - matches
List<Get
Gateway Route Spec Http Route Match Header Match>  - name String
 - Name of the gateway route.
 
- invert boolean
 - matches
Get
Gateway Route Spec Http Route Match Header Match[]  - name string
 - Name of the gateway route.
 
- invert bool
 - matches
Sequence[Get
Gateway Route Spec Http Route Match Header Match]  - name str
 - Name of the gateway route.
 
- invert Boolean
 - matches List<Property Map>
 - name String
 - Name of the gateway route.
 
GetGatewayRouteSpecHttpRouteMatchHeaderMatch        
GetGatewayRouteSpecHttpRouteMatchHeaderMatchRange         
GetGatewayRouteSpecHttpRouteMatchHostname       
GetGatewayRouteSpecHttpRouteMatchPath       
GetGatewayRouteSpecHttpRouteMatchQueryParameter        
- Matches
List<Get
Gateway Route Spec Http Route Match Query Parameter Match>  - Name string
 - Name of the gateway route.
 
- Matches
[]Get
Gateway Route Spec Http Route Match Query Parameter Match  - Name string
 - Name of the gateway route.
 
- matches
List<Get
Gateway Route Spec Http Route Match Query Parameter Match>  - name String
 - Name of the gateway route.
 
- matches
Get
Gateway Route Spec Http Route Match Query Parameter Match[]  - name string
 - Name of the gateway route.
 
- matches
Sequence[Get
Gateway Route Spec Http Route Match Query Parameter Match]  - name str
 - Name of the gateway route.
 
- matches List<Property Map>
 - name String
 - Name of the gateway route.
 
GetGatewayRouteSpecHttpRouteMatchQueryParameterMatch         
- Exact string
 
- Exact string
 
- exact String
 
- exact string
 
- exact str
 
- exact String
 
Package Details
- Repository
 - AWS Classic pulumi/pulumi-aws
 - License
 - Apache-2.0
 - Notes
 - This Pulumi package is based on the 
awsTerraform Provider. 
Try AWS Native preview for resources not in the classic version.