AWS Classic
Route
Provides an AWS App Mesh route resource.
Example Usage
HTTP Routing
using Pulumi;
using Aws = Pulumi.Aws;
class MyStack : Stack
{
public MyStack()
{
var serviceb = new Aws.AppMesh.Route("serviceb", new Aws.AppMesh.RouteArgs
{
MeshName = aws_appmesh_mesh.Simple.Id,
VirtualRouterName = aws_appmesh_virtual_router.Serviceb.Name,
Spec = new Aws.AppMesh.Inputs.RouteSpecArgs
{
HttpRoute = new Aws.AppMesh.Inputs.RouteSpecHttpRouteArgs
{
Match = new Aws.AppMesh.Inputs.RouteSpecHttpRouteMatchArgs
{
Prefix = "/",
},
Action = new Aws.AppMesh.Inputs.RouteSpecHttpRouteActionArgs
{
WeightedTargets =
{
new Aws.AppMesh.Inputs.RouteSpecHttpRouteActionWeightedTargetArgs
{
VirtualNode = aws_appmesh_virtual_node.Serviceb1.Name,
Weight = 90,
},
new Aws.AppMesh.Inputs.RouteSpecHttpRouteActionWeightedTargetArgs
{
VirtualNode = aws_appmesh_virtual_node.Serviceb2.Name,
Weight = 10,
},
},
},
},
},
});
}
}
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/appmesh"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := appmesh.NewRoute(ctx, "serviceb", &appmesh.RouteArgs{
MeshName: pulumi.Any(aws_appmesh_mesh.Simple.Id),
VirtualRouterName: pulumi.Any(aws_appmesh_virtual_router.Serviceb.Name),
Spec: &appmesh.RouteSpecArgs{
HttpRoute: &appmesh.RouteSpecHttpRouteArgs{
Match: &appmesh.RouteSpecHttpRouteMatchArgs{
Prefix: pulumi.String("/"),
},
Action: &appmesh.RouteSpecHttpRouteActionArgs{
WeightedTargets: appmesh.RouteSpecHttpRouteActionWeightedTargetArray{
&appmesh.RouteSpecHttpRouteActionWeightedTargetArgs{
VirtualNode: pulumi.Any(aws_appmesh_virtual_node.Serviceb1.Name),
Weight: pulumi.Int(90),
},
&appmesh.RouteSpecHttpRouteActionWeightedTargetArgs{
VirtualNode: pulumi.Any(aws_appmesh_virtual_node.Serviceb2.Name),
Weight: pulumi.Int(10),
},
},
},
},
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import java.util.*;
import java.io.*;
import java.nio.*;
import com.pulumi.*;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var serviceb = new Route("serviceb", RouteArgs.builder()
.meshName(aws_appmesh_mesh.simple().id())
.virtualRouterName(aws_appmesh_virtual_router.serviceb().name())
.spec(RouteSpecArgs.builder()
.httpRoute(RouteSpecHttpRouteArgs.builder()
.match(RouteSpecHttpRouteMatchArgs.builder()
.prefix("/")
.build())
.action(RouteSpecHttpRouteActionArgs.builder()
.weightedTargets(
RouteSpecHttpRouteActionWeightedTargetArgs.builder()
.virtualNode(aws_appmesh_virtual_node.serviceb1().name())
.weight(90)
.build(),
RouteSpecHttpRouteActionWeightedTargetArgs.builder()
.virtualNode(aws_appmesh_virtual_node.serviceb2().name())
.weight(10)
.build())
.build())
.build())
.build())
.build());
}
}
import pulumi
import pulumi_aws as aws
serviceb = aws.appmesh.Route("serviceb",
mesh_name=aws_appmesh_mesh["simple"]["id"],
virtual_router_name=aws_appmesh_virtual_router["serviceb"]["name"],
spec=aws.appmesh.RouteSpecArgs(
http_route=aws.appmesh.RouteSpecHttpRouteArgs(
match=aws.appmesh.RouteSpecHttpRouteMatchArgs(
prefix="/",
),
action=aws.appmesh.RouteSpecHttpRouteActionArgs(
weighted_targets=[
aws.appmesh.RouteSpecHttpRouteActionWeightedTargetArgs(
virtual_node=aws_appmesh_virtual_node["serviceb1"]["name"],
weight=90,
),
aws.appmesh.RouteSpecHttpRouteActionWeightedTargetArgs(
virtual_node=aws_appmesh_virtual_node["serviceb2"]["name"],
weight=10,
),
],
),
),
))
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const serviceb = new aws.appmesh.Route("serviceb", {
meshName: aws_appmesh_mesh.simple.id,
virtualRouterName: aws_appmesh_virtual_router.serviceb.name,
spec: {
httpRoute: {
match: {
prefix: "/",
},
action: {
weightedTargets: [
{
virtualNode: aws_appmesh_virtual_node.serviceb1.name,
weight: 90,
},
{
virtualNode: aws_appmesh_virtual_node.serviceb2.name,
weight: 10,
},
],
},
},
},
});
resources:
serviceb:
type: aws:appmesh:Route
properties:
meshName: ${aws_appmesh_mesh.simple.id}
virtualRouterName: ${aws_appmesh_virtual_router.serviceb.name}
spec:
httpRoute:
match:
prefix: /
action:
weightedTargets:
- virtualNode: ${aws_appmesh_virtual_node.serviceb1.name}
weight: 90
- virtualNode: ${aws_appmesh_virtual_node.serviceb2.name}
weight: 10
HTTP Header Routing
using Pulumi;
using Aws = Pulumi.Aws;
class MyStack : Stack
{
public MyStack()
{
var serviceb = new Aws.AppMesh.Route("serviceb", new Aws.AppMesh.RouteArgs
{
MeshName = aws_appmesh_mesh.Simple.Id,
VirtualRouterName = aws_appmesh_virtual_router.Serviceb.Name,
Spec = new Aws.AppMesh.Inputs.RouteSpecArgs
{
HttpRoute = new Aws.AppMesh.Inputs.RouteSpecHttpRouteArgs
{
Match = new Aws.AppMesh.Inputs.RouteSpecHttpRouteMatchArgs
{
Method = "POST",
Prefix = "/",
Scheme = "https",
Headers =
{
new Aws.AppMesh.Inputs.RouteSpecHttpRouteMatchHeaderArgs
{
Name = "clientRequestId",
Match = new Aws.AppMesh.Inputs.RouteSpecHttpRouteMatchHeaderMatchArgs
{
Prefix = "123",
},
},
},
},
Action = new Aws.AppMesh.Inputs.RouteSpecHttpRouteActionArgs
{
WeightedTargets =
{
new Aws.AppMesh.Inputs.RouteSpecHttpRouteActionWeightedTargetArgs
{
VirtualNode = aws_appmesh_virtual_node.Serviceb.Name,
Weight = 100,
},
},
},
},
},
});
}
}
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/appmesh"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := appmesh.NewRoute(ctx, "serviceb", &appmesh.RouteArgs{
MeshName: pulumi.Any(aws_appmesh_mesh.Simple.Id),
VirtualRouterName: pulumi.Any(aws_appmesh_virtual_router.Serviceb.Name),
Spec: &appmesh.RouteSpecArgs{
HttpRoute: &appmesh.RouteSpecHttpRouteArgs{
Match: &appmesh.RouteSpecHttpRouteMatchArgs{
Method: pulumi.String("POST"),
Prefix: pulumi.String("/"),
Scheme: pulumi.String("https"),
Headers: appmesh.RouteSpecHttpRouteMatchHeaderArray{
&appmesh.RouteSpecHttpRouteMatchHeaderArgs{
Name: pulumi.String("clientRequestId"),
Match: &appmesh.RouteSpecHttpRouteMatchHeaderMatchArgs{
Prefix: pulumi.String("123"),
},
},
},
},
Action: &appmesh.RouteSpecHttpRouteActionArgs{
WeightedTargets: appmesh.RouteSpecHttpRouteActionWeightedTargetArray{
&appmesh.RouteSpecHttpRouteActionWeightedTargetArgs{
VirtualNode: pulumi.Any(aws_appmesh_virtual_node.Serviceb.Name),
Weight: pulumi.Int(100),
},
},
},
},
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import java.util.*;
import java.io.*;
import java.nio.*;
import com.pulumi.*;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var serviceb = new Route("serviceb", RouteArgs.builder()
.meshName(aws_appmesh_mesh.simple().id())
.virtualRouterName(aws_appmesh_virtual_router.serviceb().name())
.spec(RouteSpecArgs.builder()
.httpRoute(RouteSpecHttpRouteArgs.builder()
.match(RouteSpecHttpRouteMatchArgs.builder()
.method("POST")
.prefix("/")
.scheme("https")
.headers(RouteSpecHttpRouteMatchHeaderArgs.builder()
.name("clientRequestId")
.match(RouteSpecHttpRouteMatchHeaderMatchArgs.builder()
.prefix("123")
.build())
.build())
.build())
.action(RouteSpecHttpRouteActionArgs.builder()
.weightedTargets(RouteSpecHttpRouteActionWeightedTargetArgs.builder()
.virtualNode(aws_appmesh_virtual_node.serviceb().name())
.weight(100)
.build())
.build())
.build())
.build())
.build());
}
}
import pulumi
import pulumi_aws as aws
serviceb = aws.appmesh.Route("serviceb",
mesh_name=aws_appmesh_mesh["simple"]["id"],
virtual_router_name=aws_appmesh_virtual_router["serviceb"]["name"],
spec=aws.appmesh.RouteSpecArgs(
http_route=aws.appmesh.RouteSpecHttpRouteArgs(
match=aws.appmesh.RouteSpecHttpRouteMatchArgs(
method="POST",
prefix="/",
scheme="https",
headers=[aws.appmesh.RouteSpecHttpRouteMatchHeaderArgs(
name="clientRequestId",
match=aws.appmesh.RouteSpecHttpRouteMatchHeaderMatchArgs(
prefix="123",
),
)],
),
action=aws.appmesh.RouteSpecHttpRouteActionArgs(
weighted_targets=[aws.appmesh.RouteSpecHttpRouteActionWeightedTargetArgs(
virtual_node=aws_appmesh_virtual_node["serviceb"]["name"],
weight=100,
)],
),
),
))
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const serviceb = new aws.appmesh.Route("serviceb", {
meshName: aws_appmesh_mesh.simple.id,
virtualRouterName: aws_appmesh_virtual_router.serviceb.name,
spec: {
httpRoute: {
match: {
method: "POST",
prefix: "/",
scheme: "https",
headers: [{
name: "clientRequestId",
match: {
prefix: "123",
},
}],
},
action: {
weightedTargets: [{
virtualNode: aws_appmesh_virtual_node.serviceb.name,
weight: 100,
}],
},
},
},
});
resources:
serviceb:
type: aws:appmesh:Route
properties:
meshName: ${aws_appmesh_mesh.simple.id}
virtualRouterName: ${aws_appmesh_virtual_router.serviceb.name}
spec:
httpRoute:
match:
method: POST
prefix: /
scheme: https
headers:
- name: clientRequestId
match:
prefix: 123
action:
weightedTargets:
- virtualNode: ${aws_appmesh_virtual_node.serviceb.name}
weight: 100
Retry Policy
using Pulumi;
using Aws = Pulumi.Aws;
class MyStack : Stack
{
public MyStack()
{
var serviceb = new Aws.AppMesh.Route("serviceb", new Aws.AppMesh.RouteArgs
{
MeshName = aws_appmesh_mesh.Simple.Id,
VirtualRouterName = aws_appmesh_virtual_router.Serviceb.Name,
Spec = new Aws.AppMesh.Inputs.RouteSpecArgs
{
HttpRoute = new Aws.AppMesh.Inputs.RouteSpecHttpRouteArgs
{
Match = new Aws.AppMesh.Inputs.RouteSpecHttpRouteMatchArgs
{
Prefix = "/",
},
RetryPolicy = new Aws.AppMesh.Inputs.RouteSpecHttpRouteRetryPolicyArgs
{
HttpRetryEvents =
{
"server-error",
},
MaxRetries = 1,
PerRetryTimeout = new Aws.AppMesh.Inputs.RouteSpecHttpRouteRetryPolicyPerRetryTimeoutArgs
{
Unit = "s",
Value = 15,
},
},
Action = new Aws.AppMesh.Inputs.RouteSpecHttpRouteActionArgs
{
WeightedTargets =
{
new Aws.AppMesh.Inputs.RouteSpecHttpRouteActionWeightedTargetArgs
{
VirtualNode = aws_appmesh_virtual_node.Serviceb.Name,
Weight = 100,
},
},
},
},
},
});
}
}
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/appmesh"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := appmesh.NewRoute(ctx, "serviceb", &appmesh.RouteArgs{
MeshName: pulumi.Any(aws_appmesh_mesh.Simple.Id),
VirtualRouterName: pulumi.Any(aws_appmesh_virtual_router.Serviceb.Name),
Spec: &appmesh.RouteSpecArgs{
HttpRoute: &appmesh.RouteSpecHttpRouteArgs{
Match: &appmesh.RouteSpecHttpRouteMatchArgs{
Prefix: pulumi.String("/"),
},
RetryPolicy: &appmesh.RouteSpecHttpRouteRetryPolicyArgs{
HttpRetryEvents: pulumi.StringArray{
pulumi.String("server-error"),
},
MaxRetries: pulumi.Int(1),
PerRetryTimeout: &appmesh.RouteSpecHttpRouteRetryPolicyPerRetryTimeoutArgs{
Unit: pulumi.String("s"),
Value: pulumi.Int(15),
},
},
Action: &appmesh.RouteSpecHttpRouteActionArgs{
WeightedTargets: appmesh.RouteSpecHttpRouteActionWeightedTargetArray{
&appmesh.RouteSpecHttpRouteActionWeightedTargetArgs{
VirtualNode: pulumi.Any(aws_appmesh_virtual_node.Serviceb.Name),
Weight: pulumi.Int(100),
},
},
},
},
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import java.util.*;
import java.io.*;
import java.nio.*;
import com.pulumi.*;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var serviceb = new Route("serviceb", RouteArgs.builder()
.meshName(aws_appmesh_mesh.simple().id())
.virtualRouterName(aws_appmesh_virtual_router.serviceb().name())
.spec(RouteSpecArgs.builder()
.httpRoute(RouteSpecHttpRouteArgs.builder()
.match(RouteSpecHttpRouteMatchArgs.builder()
.prefix("/")
.build())
.retryPolicy(RouteSpecHttpRouteRetryPolicyArgs.builder()
.httpRetryEvents("server-error")
.maxRetries(1)
.perRetryTimeout(RouteSpecHttpRouteRetryPolicyPerRetryTimeoutArgs.builder()
.unit("s")
.value(15)
.build())
.build())
.action(RouteSpecHttpRouteActionArgs.builder()
.weightedTargets(RouteSpecHttpRouteActionWeightedTargetArgs.builder()
.virtualNode(aws_appmesh_virtual_node.serviceb().name())
.weight(100)
.build())
.build())
.build())
.build())
.build());
}
}
import pulumi
import pulumi_aws as aws
serviceb = aws.appmesh.Route("serviceb",
mesh_name=aws_appmesh_mesh["simple"]["id"],
virtual_router_name=aws_appmesh_virtual_router["serviceb"]["name"],
spec=aws.appmesh.RouteSpecArgs(
http_route=aws.appmesh.RouteSpecHttpRouteArgs(
match=aws.appmesh.RouteSpecHttpRouteMatchArgs(
prefix="/",
),
retry_policy=aws.appmesh.RouteSpecHttpRouteRetryPolicyArgs(
http_retry_events=["server-error"],
max_retries=1,
per_retry_timeout=aws.appmesh.RouteSpecHttpRouteRetryPolicyPerRetryTimeoutArgs(
unit="s",
value=15,
),
),
action=aws.appmesh.RouteSpecHttpRouteActionArgs(
weighted_targets=[aws.appmesh.RouteSpecHttpRouteActionWeightedTargetArgs(
virtual_node=aws_appmesh_virtual_node["serviceb"]["name"],
weight=100,
)],
),
),
))
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const serviceb = new aws.appmesh.Route("serviceb", {
meshName: aws_appmesh_mesh.simple.id,
virtualRouterName: aws_appmesh_virtual_router.serviceb.name,
spec: {
httpRoute: {
match: {
prefix: "/",
},
retryPolicy: {
httpRetryEvents: ["server-error"],
maxRetries: 1,
perRetryTimeout: {
unit: "s",
value: 15,
},
},
action: {
weightedTargets: [{
virtualNode: aws_appmesh_virtual_node.serviceb.name,
weight: 100,
}],
},
},
},
});
resources:
serviceb:
type: aws:appmesh:Route
properties:
meshName: ${aws_appmesh_mesh.simple.id}
virtualRouterName: ${aws_appmesh_virtual_router.serviceb.name}
spec:
httpRoute:
match:
prefix: /
retryPolicy:
httpRetryEvents:
- server-error
maxRetries: 1
perRetryTimeout:
unit: s
value: 15
action:
weightedTargets:
- virtualNode: ${aws_appmesh_virtual_node.serviceb.name}
weight: 100
TCP Routing
using Pulumi;
using Aws = Pulumi.Aws;
class MyStack : Stack
{
public MyStack()
{
var serviceb = new Aws.AppMesh.Route("serviceb", new Aws.AppMesh.RouteArgs
{
MeshName = aws_appmesh_mesh.Simple.Id,
VirtualRouterName = aws_appmesh_virtual_router.Serviceb.Name,
Spec = new Aws.AppMesh.Inputs.RouteSpecArgs
{
TcpRoute = new Aws.AppMesh.Inputs.RouteSpecTcpRouteArgs
{
Action = new Aws.AppMesh.Inputs.RouteSpecTcpRouteActionArgs
{
WeightedTargets =
{
new Aws.AppMesh.Inputs.RouteSpecTcpRouteActionWeightedTargetArgs
{
VirtualNode = aws_appmesh_virtual_node.Serviceb1.Name,
Weight = 100,
},
},
},
},
},
});
}
}
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/appmesh"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := appmesh.NewRoute(ctx, "serviceb", &appmesh.RouteArgs{
MeshName: pulumi.Any(aws_appmesh_mesh.Simple.Id),
VirtualRouterName: pulumi.Any(aws_appmesh_virtual_router.Serviceb.Name),
Spec: &appmesh.RouteSpecArgs{
TcpRoute: &appmesh.RouteSpecTcpRouteArgs{
Action: &appmesh.RouteSpecTcpRouteActionArgs{
WeightedTargets: appmesh.RouteSpecTcpRouteActionWeightedTargetArray{
&appmesh.RouteSpecTcpRouteActionWeightedTargetArgs{
VirtualNode: pulumi.Any(aws_appmesh_virtual_node.Serviceb1.Name),
Weight: pulumi.Int(100),
},
},
},
},
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import java.util.*;
import java.io.*;
import java.nio.*;
import com.pulumi.*;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var serviceb = new Route("serviceb", RouteArgs.builder()
.meshName(aws_appmesh_mesh.simple().id())
.virtualRouterName(aws_appmesh_virtual_router.serviceb().name())
.spec(RouteSpecArgs.builder()
.tcpRoute(RouteSpecTcpRouteArgs.builder()
.action(RouteSpecTcpRouteActionArgs.builder()
.weightedTargets(RouteSpecTcpRouteActionWeightedTargetArgs.builder()
.virtualNode(aws_appmesh_virtual_node.serviceb1().name())
.weight(100)
.build())
.build())
.build())
.build())
.build());
}
}
import pulumi
import pulumi_aws as aws
serviceb = aws.appmesh.Route("serviceb",
mesh_name=aws_appmesh_mesh["simple"]["id"],
virtual_router_name=aws_appmesh_virtual_router["serviceb"]["name"],
spec=aws.appmesh.RouteSpecArgs(
tcp_route=aws.appmesh.RouteSpecTcpRouteArgs(
action=aws.appmesh.RouteSpecTcpRouteActionArgs(
weighted_targets=[aws.appmesh.RouteSpecTcpRouteActionWeightedTargetArgs(
virtual_node=aws_appmesh_virtual_node["serviceb1"]["name"],
weight=100,
)],
),
),
))
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const serviceb = new aws.appmesh.Route("serviceb", {
meshName: aws_appmesh_mesh.simple.id,
virtualRouterName: aws_appmesh_virtual_router.serviceb.name,
spec: {
tcpRoute: {
action: {
weightedTargets: [{
virtualNode: aws_appmesh_virtual_node.serviceb1.name,
weight: 100,
}],
},
},
},
});
resources:
serviceb:
type: aws:appmesh:Route
properties:
meshName: ${aws_appmesh_mesh.simple.id}
virtualRouterName: ${aws_appmesh_virtual_router.serviceb.name}
spec:
tcpRoute:
action:
weightedTargets:
- virtualNode: ${aws_appmesh_virtual_node.serviceb1.name}
weight: 100
Create a Route Resource
new Route(name: string, args: RouteArgs, opts?: CustomResourceOptions);
@overload
def Route(resource_name: str,
opts: Optional[ResourceOptions] = None,
mesh_name: Optional[str] = None,
mesh_owner: Optional[str] = None,
name: Optional[str] = None,
spec: Optional[RouteSpecArgs] = None,
tags: Optional[Mapping[str, str]] = None,
virtual_router_name: Optional[str] = None)
@overload
def Route(resource_name: str,
args: RouteArgs,
opts: Optional[ResourceOptions] = None)
func NewRoute(ctx *Context, name string, args RouteArgs, opts ...ResourceOption) (*Route, error)
public Route(string name, RouteArgs args, CustomResourceOptions? opts = null)
type: aws:appmesh:Route
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args RouteArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args RouteArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args RouteArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args RouteArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args RouteArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Route Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The Route resource accepts the following input properties:
- Mesh
Name string The name of the service mesh in which to create the route. Must be between 1 and 255 characters in length.
- Spec
Route
Spec Args The route specification to apply.
- Virtual
Router stringName The name of the virtual router in which to create the route. Must be between 1 and 255 characters in length.
- Mesh
Owner string The AWS account ID of the service mesh's owner. Defaults to the account ID the AWS provider is currently connected to.
- Name string
The name to use for the route. Must be between 1 and 255 characters in length.
- Dictionary<string, string>
A map of tags to assign to the resource. .If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- Mesh
Name string The name of the service mesh in which to create the route. Must be between 1 and 255 characters in length.
- Spec
Route
Spec Args The route specification to apply.
- Virtual
Router stringName The name of the virtual router in which to create the route. Must be between 1 and 255 characters in length.
- Mesh
Owner string The AWS account ID of the service mesh's owner. Defaults to the account ID the AWS provider is currently connected to.
- Name string
The name to use for the route. Must be between 1 and 255 characters in length.
- map[string]string
A map of tags to assign to the resource. .If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- mesh
Name String The name of the service mesh in which to create the route. Must be between 1 and 255 characters in length.
- spec
Route
Spec Args The route specification to apply.
- virtual
Router StringName The name of the virtual router in which to create the route. Must be between 1 and 255 characters in length.
- mesh
Owner String The AWS account ID of the service mesh's owner. Defaults to the account ID the AWS provider is currently connected to.
- name String
The name to use for the route. Must be between 1 and 255 characters in length.
- Map<String,String>
A map of tags to assign to the resource. .If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- mesh
Name string The name of the service mesh in which to create the route. Must be between 1 and 255 characters in length.
- spec
Route
Spec Args The route specification to apply.
- virtual
Router stringName The name of the virtual router in which to create the route. Must be between 1 and 255 characters in length.
- mesh
Owner string The AWS account ID of the service mesh's owner. Defaults to the account ID the AWS provider is currently connected to.
- name string
The name to use for the route. Must be between 1 and 255 characters in length.
- {[key: string]: string}
A map of tags to assign to the resource. .If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- mesh_
name str The name of the service mesh in which to create the route. Must be between 1 and 255 characters in length.
- spec
Route
Spec Args The route specification to apply.
- virtual_
router_ strname The name of the virtual router in which to create the route. Must be between 1 and 255 characters in length.
- mesh_
owner str The AWS account ID of the service mesh's owner. Defaults to the account ID the AWS provider is currently connected to.
- name str
The name to use for the route. Must be between 1 and 255 characters in length.
- Mapping[str, str]
A map of tags to assign to the resource. .If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- mesh
Name String The name of the service mesh in which to create the route. Must be between 1 and 255 characters in length.
- spec Property Map
The route specification to apply.
- virtual
Router StringName The name of the virtual router in which to create the route. Must be between 1 and 255 characters in length.
- mesh
Owner String The AWS account ID of the service mesh's owner. Defaults to the account ID the AWS provider is currently connected to.
- name String
The name to use for the route. Must be between 1 and 255 characters in length.
- Map<String>
A map of tags to assign to the resource. .If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
Outputs
All input properties are implicitly available as output properties. Additionally, the Route resource produces the following output properties:
- Arn string
The ARN of the route.
- Created
Date string The creation date of the route.
- Id string
The provider-assigned unique ID for this managed resource.
- Last
Updated stringDate The last update date of the route.
- Resource
Owner string The resource owner's AWS account ID.
- Dictionary<string, string>
A map of tags assigned to the resource, including those inherited from the provider .
- Arn string
The ARN of the route.
- Created
Date string The creation date of the route.
- Id string
The provider-assigned unique ID for this managed resource.
- Last
Updated stringDate The last update date of the route.
- Resource
Owner string The resource owner's AWS account ID.
- map[string]string
A map of tags assigned to the resource, including those inherited from the provider .
- arn String
The ARN of the route.
- created
Date String The creation date of the route.
- id String
The provider-assigned unique ID for this managed resource.
- last
Updated StringDate The last update date of the route.
- resource
Owner String The resource owner's AWS account ID.
- Map<String,String>
A map of tags assigned to the resource, including those inherited from the provider .
- arn string
The ARN of the route.
- created
Date string The creation date of the route.
- id string
The provider-assigned unique ID for this managed resource.
- last
Updated stringDate The last update date of the route.
- resource
Owner string The resource owner's AWS account ID.
- {[key: string]: string}
A map of tags assigned to the resource, including those inherited from the provider .
- arn str
The ARN of the route.
- created_
date str The creation date of the route.
- id str
The provider-assigned unique ID for this managed resource.
- last_
updated_ strdate The last update date of the route.
- resource_
owner str The resource owner's AWS account ID.
- Mapping[str, str]
A map of tags assigned to the resource, including those inherited from the provider .
- arn String
The ARN of the route.
- created
Date String The creation date of the route.
- id String
The provider-assigned unique ID for this managed resource.
- last
Updated StringDate The last update date of the route.
- resource
Owner String The resource owner's AWS account ID.
- Map<String>
A map of tags assigned to the resource, including those inherited from the provider .
Look up an Existing Route Resource
Get an existing Route resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: RouteState, opts?: CustomResourceOptions): Route
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
arn: Optional[str] = None,
created_date: Optional[str] = None,
last_updated_date: Optional[str] = None,
mesh_name: Optional[str] = None,
mesh_owner: Optional[str] = None,
name: Optional[str] = None,
resource_owner: Optional[str] = None,
spec: Optional[RouteSpecArgs] = None,
tags: Optional[Mapping[str, str]] = None,
tags_all: Optional[Mapping[str, str]] = None,
virtual_router_name: Optional[str] = None) -> Route
func GetRoute(ctx *Context, name string, id IDInput, state *RouteState, opts ...ResourceOption) (*Route, error)
public static Route Get(string name, Input<string> id, RouteState? state, CustomResourceOptions? opts = null)
public static Route get(String name, Output<String> id, RouteState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Arn string
The ARN of the route.
- Created
Date string The creation date of the route.
- Last
Updated stringDate The last update date of the route.
- Mesh
Name string The name of the service mesh in which to create the route. Must be between 1 and 255 characters in length.
- Mesh
Owner string The AWS account ID of the service mesh's owner. Defaults to the account ID the AWS provider is currently connected to.
- Name string
The name to use for the route. Must be between 1 and 255 characters in length.
- Resource
Owner string The resource owner's AWS account ID.
- Spec
Route
Spec Args The route specification to apply.
- Dictionary<string, string>
A map of tags to assign to the resource. .If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- Dictionary<string, string>
A map of tags assigned to the resource, including those inherited from the provider .
- Virtual
Router stringName The name of the virtual router in which to create the route. Must be between 1 and 255 characters in length.
- Arn string
The ARN of the route.
- Created
Date string The creation date of the route.
- Last
Updated stringDate The last update date of the route.
- Mesh
Name string The name of the service mesh in which to create the route. Must be between 1 and 255 characters in length.
- Mesh
Owner string The AWS account ID of the service mesh's owner. Defaults to the account ID the AWS provider is currently connected to.
- Name string
The name to use for the route. Must be between 1 and 255 characters in length.
- Resource
Owner string The resource owner's AWS account ID.
- Spec
Route
Spec Args The route specification to apply.
- map[string]string
A map of tags to assign to the resource. .If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- map[string]string
A map of tags assigned to the resource, including those inherited from the provider .
- Virtual
Router stringName The name of the virtual router in which to create the route. Must be between 1 and 255 characters in length.
- arn String
The ARN of the route.
- created
Date String The creation date of the route.
- last
Updated StringDate The last update date of the route.
- mesh
Name String The name of the service mesh in which to create the route. Must be between 1 and 255 characters in length.
- mesh
Owner String The AWS account ID of the service mesh's owner. Defaults to the account ID the AWS provider is currently connected to.
- name String
The name to use for the route. Must be between 1 and 255 characters in length.
- resource
Owner String The resource owner's AWS account ID.
- spec
Route
Spec Args The route specification to apply.
- Map<String,String>
A map of tags to assign to the resource. .If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- Map<String,String>
A map of tags assigned to the resource, including those inherited from the provider .
- virtual
Router StringName The name of the virtual router in which to create the route. Must be between 1 and 255 characters in length.
- arn string
The ARN of the route.
- created
Date string The creation date of the route.
- last
Updated stringDate The last update date of the route.
- mesh
Name string The name of the service mesh in which to create the route. Must be between 1 and 255 characters in length.
- mesh
Owner string The AWS account ID of the service mesh's owner. Defaults to the account ID the AWS provider is currently connected to.
- name string
The name to use for the route. Must be between 1 and 255 characters in length.
- resource
Owner string The resource owner's AWS account ID.
- spec
Route
Spec Args The route specification to apply.
- {[key: string]: string}
A map of tags to assign to the resource. .If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- {[key: string]: string}
A map of tags assigned to the resource, including those inherited from the provider .
- virtual
Router stringName The name of the virtual router in which to create the route. Must be between 1 and 255 characters in length.
- arn str
The ARN of the route.
- created_
date str The creation date of the route.
- last_
updated_ strdate The last update date of the route.
- mesh_
name str The name of the service mesh in which to create the route. Must be between 1 and 255 characters in length.
- mesh_
owner str The AWS account ID of the service mesh's owner. Defaults to the account ID the AWS provider is currently connected to.
- name str
The name to use for the route. Must be between 1 and 255 characters in length.
- resource_
owner str The resource owner's AWS account ID.
- spec
Route
Spec Args The route specification to apply.
- Mapping[str, str]
A map of tags to assign to the resource. .If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- Mapping[str, str]
A map of tags assigned to the resource, including those inherited from the provider .
- virtual_
router_ strname The name of the virtual router in which to create the route. Must be between 1 and 255 characters in length.
- arn String
The ARN of the route.
- created
Date String The creation date of the route.
- last
Updated StringDate The last update date of the route.
- mesh
Name String The name of the service mesh in which to create the route. Must be between 1 and 255 characters in length.
- mesh
Owner String The AWS account ID of the service mesh's owner. Defaults to the account ID the AWS provider is currently connected to.
- name String
The name to use for the route. Must be between 1 and 255 characters in length.
- resource
Owner String The resource owner's AWS account ID.
- spec Property Map
The route specification to apply.
- Map<String>
A map of tags to assign to the resource. .If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.- Map<String>
A map of tags assigned to the resource, including those inherited from the provider .
- virtual
Router StringName The name of the virtual router in which to create the route. Must be between 1 and 255 characters in length.
Supporting Types
RouteSpec
- Grpc
Route RouteSpec Grpc Route The gRPC routing information for the route.
- Http2Route
Route
Spec Http2Route The HTTP/2 routing information for the route.
- Http
Route RouteSpec Http Route The HTTP routing information for the route.
- Priority int
The priority for the route, between
0
and1000
. Routes are matched based on the specified value, where0
is the highest priority.- Tcp
Route RouteSpec Tcp Route The TCP routing information for the route.
- Grpc
Route RouteSpec Grpc Route The gRPC routing information for the route.
- Http2Route
Route
Spec Http2Route The HTTP/2 routing information for the route.
- Http
Route RouteSpec Http Route The HTTP routing information for the route.
- Priority int
The priority for the route, between
0
and1000
. Routes are matched based on the specified value, where0
is the highest priority.- Tcp
Route RouteSpec Tcp Route The TCP routing information for the route.
- grpc
Route RouteSpec Grpc Route The gRPC routing information for the route.
- http2Route
Route
Spec Http2Route The HTTP/2 routing information for the route.
- http
Route RouteSpec Http Route The HTTP routing information for the route.
- priority Integer
The priority for the route, between
0
and1000
. Routes are matched based on the specified value, where0
is the highest priority.- tcp
Route RouteSpec Tcp Route The TCP routing information for the route.
- grpc
Route RouteSpec Grpc Route The gRPC routing information for the route.
- http2Route
Route
Spec Http2Route The HTTP/2 routing information for the route.
- http
Route RouteSpec Http Route The HTTP routing information for the route.
- priority number
The priority for the route, between
0
and1000
. Routes are matched based on the specified value, where0
is the highest priority.- tcp
Route RouteSpec Tcp Route The TCP routing information for the route.
- grpc_
route RouteSpec Grpc Route The gRPC routing information for the route.
- http2_
route RouteSpec Http2Route The HTTP/2 routing information for the route.
- http_
route RouteSpec Http Route The HTTP routing information for the route.
- priority int
The priority for the route, between
0
and1000
. Routes are matched based on the specified value, where0
is the highest priority.- tcp_
route RouteSpec Tcp Route The TCP routing information for the route.
- grpc
Route Property Map The gRPC routing information for the route.
- http2Route Property Map
The HTTP/2 routing information for the route.
- http
Route Property Map The HTTP routing information for the route.
- priority Number
The priority for the route, between
0
and1000
. Routes are matched based on the specified value, where0
is the highest priority.- tcp
Route Property Map The TCP routing information for the route.
RouteSpecGrpcRoute
- Action
Route
Spec Grpc Route Action The action to take if a match is determined.
- Match
Route
Spec Grpc Route Match The criteria for determining an gRPC request match.
- Retry
Policy RouteSpec Grpc Route Retry Policy The retry policy.
- Timeout
Route
Spec Grpc Route Timeout The types of timeouts.
- Action
Route
Spec Grpc Route Action The action to take if a match is determined.
- Match
Route
Spec Grpc Route Match The criteria for determining an gRPC request match.
- Retry
Policy RouteSpec Grpc Route Retry Policy The retry policy.
- Timeout
Route
Spec Grpc Route Timeout The types of timeouts.
- action
Route
Spec Grpc Route Action The action to take if a match is determined.
- match
Route
Spec Grpc Route Match The criteria for determining an gRPC request match.
- retry
Policy RouteSpec Grpc Route Retry Policy The retry policy.
- timeout
Route
Spec Grpc Route Timeout The types of timeouts.
- action
Route
Spec Grpc Route Action The action to take if a match is determined.
- match
Route
Spec Grpc Route Match The criteria for determining an gRPC request match.
- retry
Policy RouteSpec Grpc Route Retry Policy The retry policy.
- timeout
Route
Spec Grpc Route Timeout The types of timeouts.
- action
Route
Spec Grpc Route Action The action to take if a match is determined.
- match
Route
Spec Grpc Route Match The criteria for determining an gRPC request match.
- retry_
policy RouteSpec Grpc Route Retry Policy The retry policy.
- timeout
Route
Spec Grpc Route Timeout The types of timeouts.
- action Property Map
The action to take if a match is determined.
- match Property Map
The criteria for determining an gRPC request match.
- retry
Policy Property Map The retry policy.
- timeout Property Map
The types of timeouts.
RouteSpecGrpcRouteAction
- Weighted
Targets List<RouteSpec Grpc Route Action Weighted Target> The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- Weighted
Targets []RouteSpec Grpc Route Action Weighted Target The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- weighted
Targets List<RouteSpec Grpc Route Action Weighted Target> The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- weighted
Targets RouteSpec Grpc Route Action Weighted Target[] The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- weighted_
targets Sequence[RouteSpec Grpc Route Action Weighted Target] The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- weighted
Targets List<Property Map> The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
RouteSpecGrpcRouteActionWeightedTarget
- Virtual
Node string The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- Weight int
The relative weight of the weighted target. An integer between 0 and 100.
- Virtual
Node string The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- Weight int
The relative weight of the weighted target. An integer between 0 and 100.
- virtual
Node String The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- weight Integer
The relative weight of the weighted target. An integer between 0 and 100.
- virtual
Node string The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- weight number
The relative weight of the weighted target. An integer between 0 and 100.
- virtual_
node str The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- weight int
The relative weight of the weighted target. An integer between 0 and 100.
- virtual
Node String The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- weight Number
The relative weight of the weighted target. An integer between 0 and 100.
RouteSpecGrpcRouteMatch
- Metadatas
List<Route
Spec Grpc Route Match Metadata> The data to match from the gRPC request.
- Method
Name string The method name to match from the request. If you specify a name, you must also specify a
service_name
.- Prefix string
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- Service
Name string The fully qualified domain name for the service to match from the request.
- Metadatas
[]Route
Spec Grpc Route Match Metadata The data to match from the gRPC request.
- Method
Name string The method name to match from the request. If you specify a name, you must also specify a
service_name
.- Prefix string
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- Service
Name string The fully qualified domain name for the service to match from the request.
- metadatas
List<Route
Spec Grpc Route Match Metadata> The data to match from the gRPC request.
- method
Name String The method name to match from the request. If you specify a name, you must also specify a
service_name
.- prefix String
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- service
Name String The fully qualified domain name for the service to match from the request.
- metadatas
Route
Spec Grpc Route Match Metadata[] The data to match from the gRPC request.
- method
Name string The method name to match from the request. If you specify a name, you must also specify a
service_name
.- prefix string
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- service
Name string The fully qualified domain name for the service to match from the request.
- metadatas
Sequence[Route
Spec Grpc Route Match Metadata] The data to match from the gRPC request.
- method_
name str The method name to match from the request. If you specify a name, you must also specify a
service_name
.- prefix str
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- service_
name str The fully qualified domain name for the service to match from the request.
- metadatas List<Property Map>
The data to match from the gRPC request.
- method
Name String The method name to match from the request. If you specify a name, you must also specify a
service_name
.- prefix String
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- service
Name String The fully qualified domain name for the service to match from the request.
RouteSpecGrpcRouteMatchMetadata
- Name string
The name of the route. Must be between 1 and 50 characters in length.
- Invert bool
If
true
, the match is on the opposite of thematch
criteria. Default isfalse
.- Match
Route
Spec Grpc Route Match Metadata Match The data to match from the request.
- Name string
The name of the route. Must be between 1 and 50 characters in length.
- Invert bool
If
true
, the match is on the opposite of thematch
criteria. Default isfalse
.- Match
Route
Spec Grpc Route Match Metadata Match The data to match from the request.
- name String
The name of the route. Must be between 1 and 50 characters in length.
- invert Boolean
If
true
, the match is on the opposite of thematch
criteria. Default isfalse
.- match
Route
Spec Grpc Route Match Metadata Match The data to match from the request.
- name string
The name of the route. Must be between 1 and 50 characters in length.
- invert boolean
If
true
, the match is on the opposite of thematch
criteria. Default isfalse
.- match
Route
Spec Grpc Route Match Metadata Match The data to match from the request.
- name str
The name of the route. Must be between 1 and 50 characters in length.
- invert bool
If
true
, the match is on the opposite of thematch
criteria. Default isfalse
.- match
Route
Spec Grpc Route Match Metadata Match The data to match from the request.
- name String
The name of the route. Must be between 1 and 50 characters in length.
- invert Boolean
If
true
, the match is on the opposite of thematch
criteria. Default isfalse
.- match Property Map
The data to match from the request.
RouteSpecGrpcRouteMatchMetadataMatch
- Exact string
The value sent by the client must match the specified value exactly. Must be between 1 and 255 characters in length.
- Prefix string
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- Range
Route
Spec Grpc Route Match Metadata Match Range The object that specifies the range of numbers that the value sent by the client must be included in.
- Regex string
The value sent by the client must include the specified characters. Must be between 1 and 255 characters in length.
- Suffix string
The value sent by the client must end with the specified characters. Must be between 1 and 255 characters in length.
- Exact string
The value sent by the client must match the specified value exactly. Must be between 1 and 255 characters in length.
- Prefix string
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- Range
Route
Spec Grpc Route Match Metadata Match Range The object that specifies the range of numbers that the value sent by the client must be included in.
- Regex string
The value sent by the client must include the specified characters. Must be between 1 and 255 characters in length.
- Suffix string
The value sent by the client must end with the specified characters. Must be between 1 and 255 characters in length.
- exact String
The value sent by the client must match the specified value exactly. Must be between 1 and 255 characters in length.
- prefix String
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- range
Route
Spec Grpc Route Match Metadata Match Range The object that specifies the range of numbers that the value sent by the client must be included in.
- regex String
The value sent by the client must include the specified characters. Must be between 1 and 255 characters in length.
- suffix String
The value sent by the client must end with the specified characters. Must be between 1 and 255 characters in length.
- exact string
The value sent by the client must match the specified value exactly. Must be between 1 and 255 characters in length.
- prefix string
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- range
Route
Spec Grpc Route Match Metadata Match Range The object that specifies the range of numbers that the value sent by the client must be included in.
- regex string
The value sent by the client must include the specified characters. Must be between 1 and 255 characters in length.
- suffix string
The value sent by the client must end with the specified characters. Must be between 1 and 255 characters in length.
- exact str
The value sent by the client must match the specified value exactly. Must be between 1 and 255 characters in length.
- prefix str
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- range
Route
Spec Grpc Route Match Metadata Match Range The object that specifies the range of numbers that the value sent by the client must be included in.
- regex str
The value sent by the client must include the specified characters. Must be between 1 and 255 characters in length.
- suffix str
The value sent by the client must end with the specified characters. Must be between 1 and 255 characters in length.
- exact String
The value sent by the client must match the specified value exactly. Must be between 1 and 255 characters in length.
- prefix String
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- range Property Map
The object that specifies the range of numbers that the value sent by the client must be included in.
- regex String
The value sent by the client must include the specified characters. Must be between 1 and 255 characters in length.
- suffix String
The value sent by the client must end with the specified characters. Must be between 1 and 255 characters in length.
RouteSpecGrpcRouteMatchMetadataMatchRange
RouteSpecGrpcRouteRetryPolicy
- Max
Retries int The maximum number of retries.
- Per
Retry RouteTimeout Spec Grpc Route Retry Policy Per Retry Timeout The per-retry timeout.
- Grpc
Retry List<string>Events List of gRPC retry events. Valid values:
cancelled
,deadline-exceeded
,internal
,resource-exhausted
,unavailable
.- Http
Retry List<string>Events List of HTTP retry events. Valid values:
client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream). Valid values:client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream).- Tcp
Retry List<string>Events List of TCP retry events. The only valid value is
connection-error
.
- Max
Retries int The maximum number of retries.
- Per
Retry RouteTimeout Spec Grpc Route Retry Policy Per Retry Timeout The per-retry timeout.
- Grpc
Retry []stringEvents List of gRPC retry events. Valid values:
cancelled
,deadline-exceeded
,internal
,resource-exhausted
,unavailable
.- Http
Retry []stringEvents List of HTTP retry events. Valid values:
client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream). Valid values:client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream).- Tcp
Retry []stringEvents List of TCP retry events. The only valid value is
connection-error
.
- max
Retries Integer The maximum number of retries.
- per
Retry RouteTimeout Spec Grpc Route Retry Policy Per Retry Timeout The per-retry timeout.
- grpc
Retry List<String>Events List of gRPC retry events. Valid values:
cancelled
,deadline-exceeded
,internal
,resource-exhausted
,unavailable
.- http
Retry List<String>Events List of HTTP retry events. Valid values:
client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream). Valid values:client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream).- tcp
Retry List<String>Events List of TCP retry events. The only valid value is
connection-error
.
- max
Retries number The maximum number of retries.
- per
Retry RouteTimeout Spec Grpc Route Retry Policy Per Retry Timeout The per-retry timeout.
- grpc
Retry string[]Events List of gRPC retry events. Valid values:
cancelled
,deadline-exceeded
,internal
,resource-exhausted
,unavailable
.- http
Retry string[]Events List of HTTP retry events. Valid values:
client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream). Valid values:client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream).- tcp
Retry string[]Events List of TCP retry events. The only valid value is
connection-error
.
- max_
retries int The maximum number of retries.
- per_
retry_ Routetimeout Spec Grpc Route Retry Policy Per Retry Timeout The per-retry timeout.
- grpc_
retry_ Sequence[str]events List of gRPC retry events. Valid values:
cancelled
,deadline-exceeded
,internal
,resource-exhausted
,unavailable
.- http_
retry_ Sequence[str]events List of HTTP retry events. Valid values:
client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream). Valid values:client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream).- tcp_
retry_ Sequence[str]events List of TCP retry events. The only valid value is
connection-error
.
- max
Retries Number The maximum number of retries.
- per
Retry Property MapTimeout The per-retry timeout.
- grpc
Retry List<String>Events List of gRPC retry events. Valid values:
cancelled
,deadline-exceeded
,internal
,resource-exhausted
,unavailable
.- http
Retry List<String>Events List of HTTP retry events. Valid values:
client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream). Valid values:client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream).- tcp
Retry List<String>Events List of TCP retry events. The only valid value is
connection-error
.
RouteSpecGrpcRouteRetryPolicyPerRetryTimeout
RouteSpecGrpcRouteTimeout
- Idle
Route
Spec Grpc Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- Per
Request RouteSpec Grpc Route Timeout Per Request The per request timeout.
- Idle
Route
Spec Grpc Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- Per
Request RouteSpec Grpc Route Timeout Per Request The per request timeout.
- idle
Route
Spec Grpc Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- per
Request RouteSpec Grpc Route Timeout Per Request The per request timeout.
- idle
Route
Spec Grpc Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- per
Request RouteSpec Grpc Route Timeout Per Request The per request timeout.
- idle
Route
Spec Grpc Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- per_
request RouteSpec Grpc Route Timeout Per Request The per request timeout.
- idle Property Map
The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- per
Request Property Map The per request timeout.
RouteSpecGrpcRouteTimeoutIdle
RouteSpecGrpcRouteTimeoutPerRequest
RouteSpecHttp2Route
- Action
Route
Spec Http2Route Action The action to take if a match is determined.
- Match
Route
Spec Http2Route Match The criteria for determining an gRPC request match.
- Retry
Policy RouteSpec Http2Route Retry Policy The retry policy.
- Timeout
Route
Spec Http2Route Timeout The types of timeouts.
- Action
Route
Spec Http2Route Action The action to take if a match is determined.
- Match
Route
Spec Http2Route Match The criteria for determining an gRPC request match.
- Retry
Policy RouteSpec Http2Route Retry Policy The retry policy.
- Timeout
Route
Spec Http2Route Timeout The types of timeouts.
- action
Route
Spec Http2Route Action The action to take if a match is determined.
- match
Route
Spec Http2Route Match The criteria for determining an gRPC request match.
- retry
Policy RouteSpec Http2Route Retry Policy The retry policy.
- timeout
Route
Spec Http2Route Timeout The types of timeouts.
- action
Route
Spec Http2Route Action The action to take if a match is determined.
- match
Route
Spec Http2Route Match The criteria for determining an gRPC request match.
- retry
Policy RouteSpec Http2Route Retry Policy The retry policy.
- timeout
Route
Spec Http2Route Timeout The types of timeouts.
- action
Route
Spec Http2Route Action The action to take if a match is determined.
- match
Route
Spec Http2Route Match The criteria for determining an gRPC request match.
- retry_
policy RouteSpec Http2Route Retry Policy The retry policy.
- timeout
Route
Spec Http2Route Timeout The types of timeouts.
- action Property Map
The action to take if a match is determined.
- match Property Map
The criteria for determining an gRPC request match.
- retry
Policy Property Map The retry policy.
- timeout Property Map
The types of timeouts.
RouteSpecHttp2RouteAction
- Weighted
Targets List<RouteSpec Http2Route Action Weighted Target> The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- Weighted
Targets []RouteSpec Http2Route Action Weighted Target The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- weighted
Targets List<RouteSpec Http2Route Action Weighted Target> The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- weighted
Targets RouteSpec Http2Route Action Weighted Target[] The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- weighted_
targets Sequence[RouteSpec Http2Route Action Weighted Target] The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- weighted
Targets List<Property Map> The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
RouteSpecHttp2RouteActionWeightedTarget
- Virtual
Node string The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- Weight int
The relative weight of the weighted target. An integer between 0 and 100.
- Virtual
Node string The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- Weight int
The relative weight of the weighted target. An integer between 0 and 100.
- virtual
Node String The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- weight Integer
The relative weight of the weighted target. An integer between 0 and 100.
- virtual
Node string The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- weight number
The relative weight of the weighted target. An integer between 0 and 100.
- virtual_
node str The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- weight int
The relative weight of the weighted target. An integer between 0 and 100.
- virtual
Node String The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- weight Number
The relative weight of the weighted target. An integer between 0 and 100.
RouteSpecHttp2RouteMatch
- Prefix string
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- Headers
List<Route
Spec Http2Route Match Header> The client request headers to match on.
- Method string
The client request header method to match on. Valid values:
GET
,HEAD
,POST
,PUT
,DELETE
,CONNECT
,OPTIONS
,TRACE
,PATCH
.- Scheme string
The client request header scheme to match on. Valid values:
http
,https
.
- Prefix string
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- Headers
[]Route
Spec Http2Route Match Header The client request headers to match on.
- Method string
The client request header method to match on. Valid values:
GET
,HEAD
,POST
,PUT
,DELETE
,CONNECT
,OPTIONS
,TRACE
,PATCH
.- Scheme string
The client request header scheme to match on. Valid values:
http
,https
.
- prefix String
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- headers
List<Route
Spec Http2Route Match Header> The client request headers to match on.
- method String
The client request header method to match on. Valid values:
GET
,HEAD
,POST
,PUT
,DELETE
,CONNECT
,OPTIONS
,TRACE
,PATCH
.- scheme String
The client request header scheme to match on. Valid values:
http
,https
.
- prefix string
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- headers
Route
Spec Http2Route Match Header[] The client request headers to match on.
- method string
The client request header method to match on. Valid values:
GET
,HEAD
,POST
,PUT
,DELETE
,CONNECT
,OPTIONS
,TRACE
,PATCH
.- scheme string
The client request header scheme to match on. Valid values:
http
,https
.
- prefix str
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- headers
Sequence[Route
Spec Http2Route Match Header] The client request headers to match on.
- method str
The client request header method to match on. Valid values:
GET
,HEAD
,POST
,PUT
,DELETE
,CONNECT
,OPTIONS
,TRACE
,PATCH
.- scheme str
The client request header scheme to match on. Valid values:
http
,https
.
- prefix String
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- headers List<Property Map>
The client request headers to match on.
- method String
The client request header method to match on. Valid values:
GET
,HEAD
,POST
,PUT
,DELETE
,CONNECT
,OPTIONS
,TRACE
,PATCH
.- scheme String
The client request header scheme to match on. Valid values:
http
,https
.
RouteSpecHttp2RouteMatchHeader
- Name string
A name for the HTTP header in the client request that will be matched on.
- Invert bool
If
true
, the match is on the opposite of thematch
method and value. Default isfalse
.- Match
Route
Spec Http2Route Match Header Match The method and value to match the header value sent with a request. Specify one match method.
- Name string
A name for the HTTP header in the client request that will be matched on.
- Invert bool
If
true
, the match is on the opposite of thematch
method and value. Default isfalse
.- Match
Route
Spec Http2Route Match Header Match The method and value to match the header value sent with a request. Specify one match method.
- name String
A name for the HTTP header in the client request that will be matched on.
- invert Boolean
If
true
, the match is on the opposite of thematch
method and value. Default isfalse
.- match
Route
Spec Http2Route Match Header Match The method and value to match the header value sent with a request. Specify one match method.
- name string
A name for the HTTP header in the client request that will be matched on.
- invert boolean
If
true
, the match is on the opposite of thematch
method and value. Default isfalse
.- match
Route
Spec Http2Route Match Header Match The method and value to match the header value sent with a request. Specify one match method.
- name str
A name for the HTTP header in the client request that will be matched on.
- invert bool
If
true
, the match is on the opposite of thematch
method and value. Default isfalse
.- match
Route
Spec Http2Route Match Header Match The method and value to match the header value sent with a request. Specify one match method.
- name String
A name for the HTTP header in the client request that will be matched on.
- invert Boolean
If
true
, the match is on the opposite of thematch
method and value. Default isfalse
.- match Property Map
The method and value to match the header value sent with a request. Specify one match method.
RouteSpecHttp2RouteMatchHeaderMatch
- Exact string
The value sent by the client must match the specified value exactly. Must be between 1 and 255 characters in length.
- Prefix string
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- Range
Route
Spec Http2Route Match Header Match Range The object that specifies the range of numbers that the value sent by the client must be included in.
- Regex string
The value sent by the client must include the specified characters. Must be between 1 and 255 characters in length.
- Suffix string
The value sent by the client must end with the specified characters. Must be between 1 and 255 characters in length.
- Exact string
The value sent by the client must match the specified value exactly. Must be between 1 and 255 characters in length.
- Prefix string
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- Range
Route
Spec Http2Route Match Header Match Range The object that specifies the range of numbers that the value sent by the client must be included in.
- Regex string
The value sent by the client must include the specified characters. Must be between 1 and 255 characters in length.
- Suffix string
The value sent by the client must end with the specified characters. Must be between 1 and 255 characters in length.
- exact String
The value sent by the client must match the specified value exactly. Must be between 1 and 255 characters in length.
- prefix String
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- range
Route
Spec Http2Route Match Header Match Range The object that specifies the range of numbers that the value sent by the client must be included in.
- regex String
The value sent by the client must include the specified characters. Must be between 1 and 255 characters in length.
- suffix String
The value sent by the client must end with the specified characters. Must be between 1 and 255 characters in length.
- exact string
The value sent by the client must match the specified value exactly. Must be between 1 and 255 characters in length.
- prefix string
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- range
Route
Spec Http2Route Match Header Match Range The object that specifies the range of numbers that the value sent by the client must be included in.
- regex string
The value sent by the client must include the specified characters. Must be between 1 and 255 characters in length.
- suffix string
The value sent by the client must end with the specified characters. Must be between 1 and 255 characters in length.
- exact str
The value sent by the client must match the specified value exactly. Must be between 1 and 255 characters in length.
- prefix str
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- range
Route
Spec Http2Route Match Header Match Range The object that specifies the range of numbers that the value sent by the client must be included in.
- regex str
The value sent by the client must include the specified characters. Must be between 1 and 255 characters in length.
- suffix str
The value sent by the client must end with the specified characters. Must be between 1 and 255 characters in length.
- exact String
The value sent by the client must match the specified value exactly. Must be between 1 and 255 characters in length.
- prefix String
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- range Property Map
The object that specifies the range of numbers that the value sent by the client must be included in.
- regex String
The value sent by the client must include the specified characters. Must be between 1 and 255 characters in length.
- suffix String
The value sent by the client must end with the specified characters. Must be between 1 and 255 characters in length.
RouteSpecHttp2RouteMatchHeaderMatchRange
RouteSpecHttp2RouteRetryPolicy
- Max
Retries int The maximum number of retries.
- Per
Retry RouteTimeout Spec Http2Route Retry Policy Per Retry Timeout The per-retry timeout.
- Http
Retry List<string>Events List of HTTP retry events. Valid values:
client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream). Valid values:client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream).- Tcp
Retry List<string>Events List of TCP retry events. The only valid value is
connection-error
.
- Max
Retries int The maximum number of retries.
- Per
Retry RouteTimeout Spec Http2Route Retry Policy Per Retry Timeout The per-retry timeout.
- Http
Retry []stringEvents List of HTTP retry events. Valid values:
client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream). Valid values:client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream).- Tcp
Retry []stringEvents List of TCP retry events. The only valid value is
connection-error
.
- max
Retries Integer The maximum number of retries.
- per
Retry RouteTimeout Spec Http2Route Retry Policy Per Retry Timeout The per-retry timeout.
- http
Retry List<String>Events List of HTTP retry events. Valid values:
client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream). Valid values:client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream).- tcp
Retry List<String>Events List of TCP retry events. The only valid value is
connection-error
.
- max
Retries number The maximum number of retries.
- per
Retry RouteTimeout Spec Http2Route Retry Policy Per Retry Timeout The per-retry timeout.
- http
Retry string[]Events List of HTTP retry events. Valid values:
client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream). Valid values:client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream).- tcp
Retry string[]Events List of TCP retry events. The only valid value is
connection-error
.
- max_
retries int The maximum number of retries.
- per_
retry_ Routetimeout Spec Http2Route Retry Policy Per Retry Timeout The per-retry timeout.
- http_
retry_ Sequence[str]events List of HTTP retry events. Valid values:
client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream). Valid values:client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream).- tcp_
retry_ Sequence[str]events List of TCP retry events. The only valid value is
connection-error
.
- max
Retries Number The maximum number of retries.
- per
Retry Property MapTimeout The per-retry timeout.
- http
Retry List<String>Events List of HTTP retry events. Valid values:
client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream). Valid values:client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream).- tcp
Retry List<String>Events List of TCP retry events. The only valid value is
connection-error
.
RouteSpecHttp2RouteRetryPolicyPerRetryTimeout
RouteSpecHttp2RouteTimeout
- Idle
Route
Spec Http2Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- Per
Request RouteSpec Http2Route Timeout Per Request The per request timeout.
- Idle
Route
Spec Http2Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- Per
Request RouteSpec Http2Route Timeout Per Request The per request timeout.
- idle
Route
Spec Http2Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- per
Request RouteSpec Http2Route Timeout Per Request The per request timeout.
- idle
Route
Spec Http2Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- per
Request RouteSpec Http2Route Timeout Per Request The per request timeout.
- idle
Route
Spec Http2Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- per_
request RouteSpec Http2Route Timeout Per Request The per request timeout.
- idle Property Map
The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- per
Request Property Map The per request timeout.
RouteSpecHttp2RouteTimeoutIdle
RouteSpecHttp2RouteTimeoutPerRequest
RouteSpecHttpRoute
- Action
Route
Spec Http Route Action The action to take if a match is determined.
- Match
Route
Spec Http Route Match The criteria for determining an HTTP request match.
- Retry
Policy RouteSpec Http Route Retry Policy The retry policy.
- Timeout
Route
Spec Http Route Timeout The types of timeouts.
- Action
Route
Spec Http Route Action The action to take if a match is determined.
- Match
Route
Spec Http Route Match The criteria for determining an HTTP request match.
- Retry
Policy RouteSpec Http Route Retry Policy The retry policy.
- Timeout
Route
Spec Http Route Timeout The types of timeouts.
- action
Route
Spec Http Route Action The action to take if a match is determined.
- match
Route
Spec Http Route Match The criteria for determining an HTTP request match.
- retry
Policy RouteSpec Http Route Retry Policy The retry policy.
- timeout
Route
Spec Http Route Timeout The types of timeouts.
- action
Route
Spec Http Route Action The action to take if a match is determined.
- match
Route
Spec Http Route Match The criteria for determining an HTTP request match.
- retry
Policy RouteSpec Http Route Retry Policy The retry policy.
- timeout
Route
Spec Http Route Timeout The types of timeouts.
- action
Route
Spec Http Route Action The action to take if a match is determined.
- match
Route
Spec Http Route Match The criteria for determining an HTTP request match.
- retry_
policy RouteSpec Http Route Retry Policy The retry policy.
- timeout
Route
Spec Http Route Timeout The types of timeouts.
- action Property Map
The action to take if a match is determined.
- match Property Map
The criteria for determining an HTTP request match.
- retry
Policy Property Map The retry policy.
- timeout Property Map
The types of timeouts.
RouteSpecHttpRouteAction
- Weighted
Targets List<RouteSpec Http Route Action Weighted Target> The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- Weighted
Targets []RouteSpec Http Route Action Weighted Target The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- weighted
Targets List<RouteSpec Http Route Action Weighted Target> The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- weighted
Targets RouteSpec Http Route Action Weighted Target[] The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- weighted_
targets Sequence[RouteSpec Http Route Action Weighted Target] The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- weighted
Targets List<Property Map> The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
RouteSpecHttpRouteActionWeightedTarget
- Virtual
Node string The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- Weight int
The relative weight of the weighted target. An integer between 0 and 100.
- Virtual
Node string The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- Weight int
The relative weight of the weighted target. An integer between 0 and 100.
- virtual
Node String The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- weight Integer
The relative weight of the weighted target. An integer between 0 and 100.
- virtual
Node string The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- weight number
The relative weight of the weighted target. An integer between 0 and 100.
- virtual_
node str The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- weight int
The relative weight of the weighted target. An integer between 0 and 100.
- virtual
Node String The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- weight Number
The relative weight of the weighted target. An integer between 0 and 100.
RouteSpecHttpRouteMatch
- Prefix string
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- Headers
List<Route
Spec Http Route Match Header> The client request headers to match on.
- Method string
The client request header method to match on. Valid values:
GET
,HEAD
,POST
,PUT
,DELETE
,CONNECT
,OPTIONS
,TRACE
,PATCH
.- Scheme string
The client request header scheme to match on. Valid values:
http
,https
.
- Prefix string
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- Headers
[]Route
Spec Http Route Match Header The client request headers to match on.
- Method string
The client request header method to match on. Valid values:
GET
,HEAD
,POST
,PUT
,DELETE
,CONNECT
,OPTIONS
,TRACE
,PATCH
.- Scheme string
The client request header scheme to match on. Valid values:
http
,https
.
- prefix String
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- headers
List<Route
Spec Http Route Match Header> The client request headers to match on.
- method String
The client request header method to match on. Valid values:
GET
,HEAD
,POST
,PUT
,DELETE
,CONNECT
,OPTIONS
,TRACE
,PATCH
.- scheme String
The client request header scheme to match on. Valid values:
http
,https
.
- prefix string
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- headers
Route
Spec Http Route Match Header[] The client request headers to match on.
- method string
The client request header method to match on. Valid values:
GET
,HEAD
,POST
,PUT
,DELETE
,CONNECT
,OPTIONS
,TRACE
,PATCH
.- scheme string
The client request header scheme to match on. Valid values:
http
,https
.
- prefix str
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- headers
Sequence[Route
Spec Http Route Match Header] The client request headers to match on.
- method str
The client request header method to match on. Valid values:
GET
,HEAD
,POST
,PUT
,DELETE
,CONNECT
,OPTIONS
,TRACE
,PATCH
.- scheme str
The client request header scheme to match on. Valid values:
http
,https
.
- prefix String
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- headers List<Property Map>
The client request headers to match on.
- method String
The client request header method to match on. Valid values:
GET
,HEAD
,POST
,PUT
,DELETE
,CONNECT
,OPTIONS
,TRACE
,PATCH
.- scheme String
The client request header scheme to match on. Valid values:
http
,https
.
RouteSpecHttpRouteMatchHeader
- Name string
A name for the HTTP header in the client request that will be matched on.
- Invert bool
If
true
, the match is on the opposite of thematch
method and value. Default isfalse
.- Match
Route
Spec Http Route Match Header Match The method and value to match the header value sent with a request. Specify one match method.
- Name string
A name for the HTTP header in the client request that will be matched on.
- Invert bool
If
true
, the match is on the opposite of thematch
method and value. Default isfalse
.- Match
Route
Spec Http Route Match Header Match The method and value to match the header value sent with a request. Specify one match method.
- name String
A name for the HTTP header in the client request that will be matched on.
- invert Boolean
If
true
, the match is on the opposite of thematch
method and value. Default isfalse
.- match
Route
Spec Http Route Match Header Match The method and value to match the header value sent with a request. Specify one match method.
- name string
A name for the HTTP header in the client request that will be matched on.
- invert boolean
If
true
, the match is on the opposite of thematch
method and value. Default isfalse
.- match
Route
Spec Http Route Match Header Match The method and value to match the header value sent with a request. Specify one match method.
- name str
A name for the HTTP header in the client request that will be matched on.
- invert bool
If
true
, the match is on the opposite of thematch
method and value. Default isfalse
.- match
Route
Spec Http Route Match Header Match The method and value to match the header value sent with a request. Specify one match method.
- name String
A name for the HTTP header in the client request that will be matched on.
- invert Boolean
If
true
, the match is on the opposite of thematch
method and value. Default isfalse
.- match Property Map
The method and value to match the header value sent with a request. Specify one match method.
RouteSpecHttpRouteMatchHeaderMatch
- Exact string
The value sent by the client must match the specified value exactly. Must be between 1 and 255 characters in length.
- Prefix string
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- Range
Route
Spec Http Route Match Header Match Range The object that specifies the range of numbers that the value sent by the client must be included in.
- Regex string
The value sent by the client must include the specified characters. Must be between 1 and 255 characters in length.
- Suffix string
The value sent by the client must end with the specified characters. Must be between 1 and 255 characters in length.
- Exact string
The value sent by the client must match the specified value exactly. Must be between 1 and 255 characters in length.
- Prefix string
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- Range
Route
Spec Http Route Match Header Match Range The object that specifies the range of numbers that the value sent by the client must be included in.
- Regex string
The value sent by the client must include the specified characters. Must be between 1 and 255 characters in length.
- Suffix string
The value sent by the client must end with the specified characters. Must be between 1 and 255 characters in length.
- exact String
The value sent by the client must match the specified value exactly. Must be between 1 and 255 characters in length.
- prefix String
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- range
Route
Spec Http Route Match Header Match Range The object that specifies the range of numbers that the value sent by the client must be included in.
- regex String
The value sent by the client must include the specified characters. Must be between 1 and 255 characters in length.
- suffix String
The value sent by the client must end with the specified characters. Must be between 1 and 255 characters in length.
- exact string
The value sent by the client must match the specified value exactly. Must be between 1 and 255 characters in length.
- prefix string
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- range
Route
Spec Http Route Match Header Match Range The object that specifies the range of numbers that the value sent by the client must be included in.
- regex string
The value sent by the client must include the specified characters. Must be between 1 and 255 characters in length.
- suffix string
The value sent by the client must end with the specified characters. Must be between 1 and 255 characters in length.
- exact str
The value sent by the client must match the specified value exactly. Must be between 1 and 255 characters in length.
- prefix str
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- range
Route
Spec Http Route Match Header Match Range The object that specifies the range of numbers that the value sent by the client must be included in.
- regex str
The value sent by the client must include the specified characters. Must be between 1 and 255 characters in length.
- suffix str
The value sent by the client must end with the specified characters. Must be between 1 and 255 characters in length.
- exact String
The value sent by the client must match the specified value exactly. Must be between 1 and 255 characters in length.
- prefix String
The value sent by the client must begin with the specified characters. Must be between 1 and 255 characters in length. This parameter must always start with /, which by itself matches all requests to the virtual router service name.
- range Property Map
The object that specifies the range of numbers that the value sent by the client must be included in.
- regex String
The value sent by the client must include the specified characters. Must be between 1 and 255 characters in length.
- suffix String
The value sent by the client must end with the specified characters. Must be between 1 and 255 characters in length.
RouteSpecHttpRouteMatchHeaderMatchRange
RouteSpecHttpRouteRetryPolicy
- Max
Retries int The maximum number of retries.
- Per
Retry RouteTimeout Spec Http Route Retry Policy Per Retry Timeout The per-retry timeout.
- Http
Retry List<string>Events List of HTTP retry events. Valid values:
client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream). Valid values:client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream).- Tcp
Retry List<string>Events List of TCP retry events. The only valid value is
connection-error
.
- Max
Retries int The maximum number of retries.
- Per
Retry RouteTimeout Spec Http Route Retry Policy Per Retry Timeout The per-retry timeout.
- Http
Retry []stringEvents List of HTTP retry events. Valid values:
client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream). Valid values:client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream).- Tcp
Retry []stringEvents List of TCP retry events. The only valid value is
connection-error
.
- max
Retries Integer The maximum number of retries.
- per
Retry RouteTimeout Spec Http Route Retry Policy Per Retry Timeout The per-retry timeout.
- http
Retry List<String>Events List of HTTP retry events. Valid values:
client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream). Valid values:client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream).- tcp
Retry List<String>Events List of TCP retry events. The only valid value is
connection-error
.
- max
Retries number The maximum number of retries.
- per
Retry RouteTimeout Spec Http Route Retry Policy Per Retry Timeout The per-retry timeout.
- http
Retry string[]Events List of HTTP retry events. Valid values:
client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream). Valid values:client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream).- tcp
Retry string[]Events List of TCP retry events. The only valid value is
connection-error
.
- max_
retries int The maximum number of retries.
- per_
retry_ Routetimeout Spec Http Route Retry Policy Per Retry Timeout The per-retry timeout.
- http_
retry_ Sequence[str]events List of HTTP retry events. Valid values:
client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream). Valid values:client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream).- tcp_
retry_ Sequence[str]events List of TCP retry events. The only valid value is
connection-error
.
- max
Retries Number The maximum number of retries.
- per
Retry Property MapTimeout The per-retry timeout.
- http
Retry List<String>Events List of HTTP retry events. Valid values:
client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream). Valid values:client-error
(HTTP status code 409),gateway-error
(HTTP status codes 502, 503, and 504),server-error
(HTTP status codes 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, and 511),stream-error
(retry on refused stream).- tcp
Retry List<String>Events List of TCP retry events. The only valid value is
connection-error
.
RouteSpecHttpRouteRetryPolicyPerRetryTimeout
RouteSpecHttpRouteTimeout
- Idle
Route
Spec Http Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- Per
Request RouteSpec Http Route Timeout Per Request The per request timeout.
- Idle
Route
Spec Http Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- Per
Request RouteSpec Http Route Timeout Per Request The per request timeout.
- idle
Route
Spec Http Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- per
Request RouteSpec Http Route Timeout Per Request The per request timeout.
- idle
Route
Spec Http Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- per
Request RouteSpec Http Route Timeout Per Request The per request timeout.
- idle
Route
Spec Http Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- per_
request RouteSpec Http Route Timeout Per Request The per request timeout.
- idle Property Map
The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- per
Request Property Map The per request timeout.
RouteSpecHttpRouteTimeoutIdle
RouteSpecHttpRouteTimeoutPerRequest
RouteSpecTcpRoute
- Action
Route
Spec Tcp Route Action The action to take if a match is determined.
- Timeout
Route
Spec Tcp Route Timeout The types of timeouts.
- Action
Route
Spec Tcp Route Action The action to take if a match is determined.
- Timeout
Route
Spec Tcp Route Timeout The types of timeouts.
- action
Route
Spec Tcp Route Action The action to take if a match is determined.
- timeout
Route
Spec Tcp Route Timeout The types of timeouts.
- action
Route
Spec Tcp Route Action The action to take if a match is determined.
- timeout
Route
Spec Tcp Route Timeout The types of timeouts.
- action
Route
Spec Tcp Route Action The action to take if a match is determined.
- timeout
Route
Spec Tcp Route Timeout The types of timeouts.
- action Property Map
The action to take if a match is determined.
- timeout Property Map
The types of timeouts.
RouteSpecTcpRouteAction
- Weighted
Targets List<RouteSpec Tcp Route Action Weighted Target> The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- Weighted
Targets []RouteSpec Tcp Route Action Weighted Target The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- weighted
Targets List<RouteSpec Tcp Route Action Weighted Target> The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- weighted
Targets RouteSpec Tcp Route Action Weighted Target[] The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- weighted_
targets Sequence[RouteSpec Tcp Route Action Weighted Target] The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
- weighted
Targets List<Property Map> The targets that traffic is routed to when a request matches the route. You can specify one or more targets and their relative weights with which to distribute traffic.
RouteSpecTcpRouteActionWeightedTarget
- Virtual
Node string The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- Weight int
The relative weight of the weighted target. An integer between 0 and 100.
- Virtual
Node string The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- Weight int
The relative weight of the weighted target. An integer between 0 and 100.
- virtual
Node String The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- weight Integer
The relative weight of the weighted target. An integer between 0 and 100.
- virtual
Node string The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- weight number
The relative weight of the weighted target. An integer between 0 and 100.
- virtual_
node str The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- weight int
The relative weight of the weighted target. An integer between 0 and 100.
- virtual
Node String The virtual node to associate with the weighted target. Must be between 1 and 255 characters in length.
- weight Number
The relative weight of the weighted target. An integer between 0 and 100.
RouteSpecTcpRouteTimeout
- Idle
Route
Spec Tcp Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- Idle
Route
Spec Tcp Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- idle
Route
Spec Tcp Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- idle
Route
Spec Tcp Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- idle
Route
Spec Tcp Route Timeout Idle The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
- idle Property Map
The idle timeout. An idle timeout bounds the amount of time that a connection may be idle.
RouteSpecTcpRouteTimeoutIdle
Import
App Mesh virtual routes can be imported using mesh_name
and virtual_router_name
together with the route’s name
, e.g.,
$ pulumi import aws:appmesh/route:Route serviceb simpleapp/serviceB/serviceB-route
[1]/docs/providers/aws/index.html
Package Details
- Repository
- https://github.com/pulumi/pulumi-aws
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
aws
Terraform Provider.