本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
路线
重要
终止支持通知:2026 年 9 月 30 日, Amazon 将停止对的支持。 Amazon App Mesh 2026 年 9 月 30 日之后,您将无法再访问 Amazon App Mesh 控制台或 Amazon App Mesh 资源。如需了解更多信息,请访问此博客文章从迁移 Amazon App Mesh 到 Amazon S ECS ervice Connect
路由与虚拟路由器关联。该路由用于匹配对虚拟路由器的请求并将流量分发到其关联的虚拟节点。如果路由与请求匹配,它可以将流量分配到一个或多个目标虚拟节点。您可以为每个虚拟节点指定相对权重。本主题可帮助您处理服务网格中的路由。
创建路由
(可选)匹配
-
(可选)输入目标服务的服务名称以匹配请求。如果您不指定名称,则会匹配对任何服务的请求。
-
(可选)输入目标方法的方法名称以匹配请求。如果不指定名称,则会匹配对任何方法的请求。如果指定方法名称,则必须指定服务名称。
(可选)元数据
选择添加元数据。
-
(可选)输入要作为路由依据的元数据名称,选择匹配类型,然后输入匹配值。选择反转将匹配相反情况。例如,如果您将元数据名称指定为
myMetadata
,将匹配类型指定为精确,将匹配值指定为123
,然后选择反转,则该路由将匹配元数据名称以123
之外的任何值开头的请求。 -
(可选)选择添加元数据以添加最多十个元数据项。
(可选)重试策略
重试策略使客户端可以保护自己免受间歇性网络故障或间歇性服务器端故障的影响。重试策略是可选的,但建议使用。重试超时值定义每次重试尝试(包括初次尝试)的超时时间。如果您未定义重试策略,那么 App Mesh 可能会自动为每条路由创建默认策略。有关更多信息,请参阅 默认路由重试策略。
-
对于重试超时,输入超时持续时间的单位数。如果您选择任何协议重试事件,则必须输入一个值。
-
在重试超时单位中,选择一个单位。如果您选择任何协议重试事件,则必须输入一个值。
-
对于最大重试次数,输入请求失败时进行的最大重试次数。如果您选择任何协议重试事件,则必须输入一个值。我们建议至少将值设置为2。
-
选择一个或多个HTTP重试事件。我们建议至少选择流错误和网关错误。
-
选择一个TCP重试事件。
-
选择一个或多个 g RPC 重试事件。我们建议至少选择已取消且不可用。
(可选)超时
-
默认值为 15 秒。如果您指定了重试策略,则在此处指定的持续时间应始终大于或等于重试持续时间乘以您在重试策略中定义的最大重试次数,这样您的重试策略才能完成。如果您指定的持续时间大于 15 秒,请确保为任何虚拟节点 Target 的侦听器指定的超时时间也大于 15 秒。有关更多信息,请参阅虚拟节点。
-
0
值禁用超时。 -
路径可以处于空闲状态的最长时间。
(可选)匹配
-
指定路由应匹配的前缀。例如,如果您的虚拟服务名称为
service-b.local
,并且您希望路由将请求匹配到service-b.local/metrics
,则前缀应为/metrics
。指定所有流量的/
路由。 -
(可选)选择一种方法。
-
(可选)选择一个方案。仅适用于HTTP2路线。
(可选)标头
-
(可选)选择添加标头。输入要作为路由依据的标头名称,选择匹配类型,然后输入匹配值。选择反转将匹配相反情况。例如,如果您指定一个带前缀
123
且名为clientRequestId
的标头,然后选择反转,则该路由将与标头是以123
之外的任何值开头的请求相匹配。 -
(可选)选择添加标头。您最多可以添加十个标头。
(可选)重试策略
重试策略使客户端可以保护自己免受间歇性网络故障或间歇性服务器端故障的影响。重试策略是可选的,但建议使用。重试超时值定义每次重试尝试(包括初次尝试)的超时时间。如果您未定义重试策略,那么 App Mesh 可能会自动为每条路由创建默认策略。有关更多信息,请参阅 默认路由重试策略。
-
对于重试超时,输入超时持续时间的单位数。如果您选择任何协议重试事件,则必须输入一个值。
-
在重试超时单位中,选择一个单位。如果您选择任何协议重试事件,则必须输入一个值。
-
对于最大重试次数,输入请求失败时进行的最大重试次数。如果您选择任何协议重试事件,则必须输入一个值。我们建议至少将值设置为2。
-
选择一个或多个HTTP重试事件。我们建议至少选择流错误和网关错误。
-
选择一个TCP重试事件。
(可选)超时
-
请求超时 — 默认超时时间为 15 秒。如果您指定了重试策略,则在此处指定的持续时间应始终大于或等于重试持续时间乘以您在重试策略中定义的最大重试次数,这样您的重试策略才能完成。
-
空闲时长 — 默认值为 300 秒。
-
0
值禁用超时。
注意
如果您指定的超时时间大于默认值,请确保为所有虚拟节点参与者侦听器指定的超时时间也大于默认值。但是,如果您将超时时间缩短到低于默认值的值,则可以选择更新虚拟节点的超时时间。有关更多信息,请参阅虚拟节点。
(可选)超时
-
空闲时长 — 默认值为 300 秒。
-
0
值禁用超时。