# GatewayRouteBaseProps

Basic configuration properties for a GatewayRoute.

Used as argument in: [IVirtualGateway.addGatewayRoute](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_appmesh.IVirtualGateway.html#addgatewayroute)

- Source: [`aws-appmesh/lib/gateway-route.ts`](https://github.com/aws/aws-cdk/blob/v2.278.0/packages/aws-cdk-lib/aws-appmesh/lib/gateway-route.ts#L40)

## Example

TypeScript:

```ts
declare const gateway: appmesh.VirtualGateway;
declare const virtualService: appmesh.VirtualService;

gateway.addGatewayRoute('gateway-route-grpc', {
  routeSpec: appmesh.GatewayRouteSpec.grpc({
    routeTarget: virtualService,
    match: {
      hostname: appmesh.GatewayRouteHostnameMatch.exactly('example.com'),
      // This disables the default rewrite to virtual service name and retain original request.
      rewriteRequestHostname: false,
    },
  }),
});
```

Python:

```python
# gateway: appmesh.VirtualGateway
# virtual_service: appmesh.VirtualService

gateway.add_gateway_route("gateway-route-grpc",
    route_spec=appmesh.GatewayRouteSpec.grpc(
        route_target=virtual_service,
        match=appmesh.GrpcGatewayRouteMatch(
            hostname=appmesh.GatewayRouteHostnameMatch.exactly("example.com"),
            # This disables the default rewrite to virtual service name and retain original request.
            rewrite_request_hostname=False
        )
    )
)
```

Java:

```java
VirtualGateway gateway;
VirtualService virtualService;

gateway.addGatewayRoute("gateway-route-grpc", GatewayRouteBaseProps.builder()
        .routeSpec(GatewayRouteSpec.grpc(GrpcGatewayRouteSpecOptions.builder()
                .routeTarget(virtualService)
                .match(GrpcGatewayRouteMatch.builder()
                        .hostname(GatewayRouteHostnameMatch.exactly("example.com"))
                        // This disables the default rewrite to virtual service name and retain original request.
                        .rewriteRequestHostname(false)
                        .build())
                .build()))
        .build());
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
VirtualGateway gateway;
VirtualService virtualService;

gateway.AddGatewayRoute("gateway-route-grpc", new GatewayRouteBaseProps {
    RouteSpec = GatewayRouteSpec.Grpc(new GrpcGatewayRouteSpecOptions {
        RouteTarget = virtualService,
        Match = new GrpcGatewayRouteMatch {
            Hostname = GatewayRouteHostnameMatch.Exactly("example.com"),
            // This disables the default rewrite to virtual service name and retain original request.
            RewriteRequestHostname = false
        }
    })
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
var gateway VirtualGateway
var virtualService VirtualService

gateway.addGatewayRoute(jsii.String("gateway-route-grpc"), &GatewayRouteBaseProps{
	RouteSpec: appmesh.GatewayRouteSpec_Grpc(&GrpcGatewayRouteSpecOptions{
		RouteTarget: virtualService,
		Match: &GrpcGatewayRouteMatch{
			Hostname: appmesh.GatewayRouteHostnameMatch_Exactly(jsii.String("example.com")),
			// This disables the default rewrite to virtual service name and retain original request.
			RewriteRequestHostname: jsii.Boolean(false),
		},
	}),
})
```

## Properties

- `gatewayRouteName`: string — The name of the GatewayRoute.

  **Default:** an automatically generated name

- `routeSpec`: [GatewayRouteSpec](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_appmesh.GatewayRouteSpec.html) (required) — What protocol the route uses.
