google.cloud.gcp_compute_url_map_info 模块 – 收集 GCP UrlMap 的信息
注意
此模块是 google.cloud 集合（版本 1.4.1）的一部分。
如果您正在使用 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用： ansible-galaxy collection install google.cloud。您需要进一步的要求才能使用此模块，请参阅 要求 获取详细信息。
要在 playbook 中使用它，请指定： google.cloud.gcp_compute_url_map_info。
注意
由于违反了 Ansible 包含要求，google.cloud 集合将从 Ansible 12 中删除。该集合有 未解决的健全性测试失败。有关详细信息，请参阅讨论线程。
概要
收集 GCP UrlMap 的信息
要求
执行此模块的主机需要满足以下要求。
python >= 2.6
requests >= 2.18.4
google-auth >= 1.3.0
参数
参数 |
注释 |
|---|---|
如果凭据类型为 accesstoken，则为 OAuth2 访问令牌。 |
|
使用的凭据类型。 选项
|
|
指定您在此模块中运行的 Ansible 环境。 除非您知道自己在做什么，否则不应设置此项。 这只会更改任何 API 请求的用户代理字符串。 |
|
筛选器值对的列表。此处列出了可用筛选器 https://cloud.google.com/sdk/gcloud/reference/topic/filters。 列表中的每个附加筛选器都将作为 AND 条件添加（筛选器 1 和筛选器 2）。 |
|
要使用的 Google Cloud Platform 项目。 |
|
要使用的作用域数组 |
|
服务帐户 JSON 文件的内容，可以是字典形式或表示它的 JSON 字符串。 |
|
如果选择了 machineaccount 并且用户不希望使用默认电子邮件，则可选的服务帐户电子邮件地址。 |
|
如果选择 serviceaccount 作为类型，则为服务帐户 JSON 文件的路径。 |
说明
注意
对于身份验证，您可以使用
GCP_SERVICE_ACCOUNT_FILE环境变量设置 service_account_file。对于身份验证，您可以使用
GCP_SERVICE_ACCOUNT_CONTENTS环境变量设置 service_account_contents。对于身份验证，您可以使用
GCP_SERVICE_ACCOUNT_EMAIL环境变量设置 service_account_email。对于身份验证，您可以使用
GCP_ACCESS_TOKEN环境变量设置 access_token。对于身份验证，您可以使用
GCP_AUTH_KIND环境变量设置 auth_kind。对于身份验证，您可以使用
GCP_SCOPES环境变量设置 scopes。仅当未设置 playbook 值时，才会使用环境变量值。
service_account_email 和 service_account_file 选项是互斥的。
示例
- name: get info on an URL map
gcp_compute_url_map_info:
filters:
- name = test_object
project: test_project
auth_kind: serviceaccount
service_account_file: "/tmp/auth.pem"
返回值
常见的返回值记录在 此处，以下是此模块独有的字段
键 |
描述 |
|---|---|
资源列表 已返回：始终 |
|
RFC3339 文本格式的创建时间戳。 已返回：成功 |
|
当没有 hostRules 匹配时，defaultRouteAction 生效。负载均衡器在将请求转发到选定的后端之前，会执行 URL 重写、标头转换等高级路由操作。 如果 defaultRouteAction 指定了任何 weightedBackendServices，则不能设置 defaultService。相反，如果设置了 defaultService，则 defaultRouteAction 不能包含任何 weightedBackendServices。 只能设置 defaultRouteAction 或 defaultUrlRedirect 中的一个。 已返回：成功 |
|
允许客户端跨源请求的规范。请参阅[跨源资源共享的 W3C 建议](https://www.w3.org/TR/cors/) 。 已返回：成功 |
|
在响应预检请求时，将此设置为 true 表示实际请求可以包含用户凭据。 这会转换为 Access-Control-Allow-Credentials 标头。 已返回：成功 |
|
指定 Access-Control-Allow-Headers 标头的内容。 已返回：成功 |
|
指定 Access-Control-Allow-Methods 标头的内容。 已返回：成功 |
|
指定与允许的源匹配的正则表达式模式。有关正则表达式语法，请参阅 en.cppreference.com/w/cpp/regex/ecmascript 如果源与 allowOrigins 中的项或 allowOriginRegexes 中的项匹配，则允许该源。 已返回：成功 |
|
指定允许进行 CORS 请求的源列表。 如果源与 allowOrigins 中的项或 allowOriginRegexes 中的项匹配，则允许该源。 已返回：成功 |
|
如果为 true，则指定 CORS 策略已禁用。默认值为 false，表示 CORS 策略有效。 已返回：成功 |
|
指定 Access-Control-Expose-Headers 标头的内容。 已返回：成功 |
|
指定预检请求的结果可以缓存多长时间（以秒为单位）。 这会转换为 Access-Control-Max-Age 标头。 已返回：成功 |
|
用于引入到流量中以测试客户端对后端服务故障的弹性的故障注入规范。 作为故障注入的一部分，当客户端向后端服务发送请求时，负载均衡器可以在将这些请求发送到后端服务之前，对一定比例的请求引入延迟。同样，负载均衡器可以为一定比例的请求中止来自客户端的请求。 使用 faultInjectionPolicy 配置的客户端将忽略 timeout 和 retryPolicy。 已返回：成功 |
|
作为故障注入的一部分，客户端请求如何中止的规范。 已返回：成功 |
|
用于中止请求的 HTTP 状态代码。 该值必须介于 200 和 599 之间（包括 200 和 599）。 已返回：成功 |
|
作为故障注入的一部分，将被中止的流量（连接/操作/请求）的百分比。 该值必须介于 0.0 和 100.0 之间（包括 0.0 和 100.0）。 已返回：成功 |
|
客户端请求在发送到后端服务之前，作为故障注入的一部分如何延迟的规范。 已返回：成功 |
|
指定固定延迟间隔的值。 已返回：成功 |
|
以纳秒分辨率表示的一秒的小部分时间跨度。小于一秒的持续时间用 0 秒字段和正的 nanos 字段表示。必须介于 0 到 999,999,999 之间（包括 0 和 999,999,999）。 已返回：成功 |
|
以秒为单位的时间跨度。必须介于 0 到 315,576,000,000 之间（包括 0 和 315,576,000,000）。 注意：这些边界是通过以下公式计算的：60 秒/分钟 * 60 分钟/小时 * 24 小时/天 * 365.25 天/年 * 10000 年。 已返回：成功 |
|
在故障注入过程中将引入延迟的流量（连接/操作/请求）的百分比。 该值必须介于 0.0 和 100.0 之间（包括 0.0 和 100.0）。 已返回：成功 |
|
指定如何将路由的目标请求镜像到单独的镜像后端服务的策略。 负载均衡器不等待来自影子服务的响应。在将流量发送到影子服务之前，主机/授权头会附加 -shadow 后缀。 已返回：成功 |
|
要镜像到的 BackendService 资源的完整或部分 URL。 已返回：成功 |
|
指定与此路由关联的重试策略。 已返回：成功 |
|
指定允许的重试次数。此数字必须 > 0。如果未指定，则默认为 1。 已返回：成功 |
|
指定每次重试尝试的非零超时。 如果未指定，将使用 HttpRouteAction 中设置的超时。如果 HttpRouteAction 中未设置超时，将使用与该路由关联的所有后端服务中的最大超时。 已返回：成功 |
|
以纳秒分辨率表示的一秒的小部分时间跨度。小于一秒的持续时间用 0 秒字段和正的 nanos 字段表示。必须介于 0 到 999,999,999 之间（包括 0 和 999,999,999）。 已返回：成功 |
|
以秒为单位的时间跨度。必须介于 0 到 315,576,000,000 之间（包括 0 和 315,576,000,000）。 注意：这些边界是通过以下公式计算的：60 秒/分钟 * 60 分钟/小时 * 24 小时/天 * 365.25 天/年 * 10000 年。 已返回：成功 |
|
指定此重试规则应用的一个或多个条件。有效值为：* 5xx：如果后端服务返回任何 5xx 响应代码，或者后端服务根本没有响应（例如：断开连接、重置、读取超时、* 连接失败和拒绝的流），则负载均衡器将尝试重试。 * gateway-error：与 5xx 类似，但仅适用于响应代码 502、503 或 504。 * connect-failure：负载均衡器将在连接后端服务失败时重试，例如由于连接超时。 * retriable-4xx：负载均衡器将对可重试的 4xx 响应代码进行重试。 目前，唯一支持的可重试错误是 409。 * refused-stream：如果后端服务使用 REFUSED_STREAM 错误代码重置流，则负载均衡器将重试。 此重置类型表明可以安全地重试。 * cancelled：如果响应头中的 gRPC 状态代码设置为 cancelled，负载均衡器将重试 * deadline-exceeded：如果响应头中的 gRPC 状态代码设置为 deadline-exceeded，负载均衡器将重试 * resource-exhausted：如果响应头中的 gRPC 状态代码设置为 resource-exhausted，负载均衡器将重试 * unavailable：如果响应头中的 gRPC 状态代码设置为 unavailable，负载均衡器将重试。 已返回：成功 |
|
指定所选路由的超时时间。超时时间从请求被完全处理（即流结束）到响应被完全处理的时间计算。超时时间包括所有重试。 如果未指定，将使用与该路由关联的所有后端服务中的最大超时时间。 已返回：成功 |
|
以纳秒分辨率表示的一秒的小部分时间跨度。小于一秒的持续时间用 0 秒字段和正的 nanos 字段表示。必须介于 0 到 999,999,999 之间（包括 0 和 999,999,999）。 已返回：成功 |
|
以秒为单位的时间跨度。必须介于 0 到 315,576,000,000 之间（包括 0 和 315,576,000,000）。 注意：这些边界是通过以下公式计算的：60 秒/分钟 * 60 分钟/小时 * 24 小时/天 * 365.25 天/年 * 10000 年。 已返回：成功 |
|
在将请求转发到匹配的服务之前，修改请求 URL 的规范。 已返回：成功 |
|
在将请求转发到选定的服务之前，请求的主机头将被 hostRewrite 的内容替换。 该值必须介于 1 到 255 个字符之间。 已返回：成功 |
|
在将请求转发到选定的后端服务之前，请求路径的匹配部分将被 pathPrefixRewrite 替换。 该值必须介于 1 到 1024 个字符之间。 已返回：成功 |
|
发生路由匹配时要将流量发送到的加权后端服务列表。 权重决定了流向其对应后端服务的流量比例。 如果所有流量都需要流向单个后端服务，则必须有一个 weightedBackendService，其权重设置为非 0 数字。 一旦确定了后端服务，并且在将请求转发到后端服务之前，将应用诸如 URL 重写和标头转换之类的高级路由操作，具体取决于此 HttpRouteAction 中指定的其他设置。 已返回：成功 |
|
默认 BackendService 资源的完整或部分 URL。在将请求转发到 backendService 之前，负载均衡器将应用此 backendServiceWeight 中指定的任何相关 headerActions。 已返回：成功 |
|
指定需要对选定的 backendService 生效的请求和响应标头的更改。 此处指定的 headerAction 在封闭的 HttpRouteRule、PathMatcher 和 UrlMap 中的 headerAction 之前生效。 已返回：成功 |
|
在将请求转发到 backendService 之前，要添加到匹配请求的标头。 已返回：成功 |
|
要添加的标头的名称。 已返回：成功 |
|
要添加的标头的值。 已返回：成功 |
|
如果为 false，则将 headerValue 附加到标头已存在的任何值。 如果为 true，则为标头设置 headerValue，并放弃为该标头设置的任何值。 已返回：成功 |
|
在将请求转发到 backendService 之前，需要从请求中删除的标头的标头名称列表。 已返回：成功 |
|
在将响应发送回客户端之前，要添加到响应的标头。 已返回：成功 |
|
要添加的标头的名称。 已返回：成功 |
|
要添加的标头的值。 已返回：成功 |
|
如果为 false，则将 headerValue 附加到标头已存在的任何值。 如果为 true，则为标头设置 headerValue，并放弃为该标头设置的任何值。 已返回：成功 |
|
在将响应发送回客户端之前，需要从响应中删除的标头的标头名称列表。 已返回：成功 |
|
指定发送到 backendService 的流量比例，计算为 weight / (路由操作中所有 weightedBackendService 权重的总和)。 仅对新流量确定后端服务的选择。一旦用户的请求被定向到某个后端服务，后续请求将被发送到同一后端服务，这由后端服务的会话亲和性策略确定。 该值必须介于 0 到 1000 之间。 已返回：成功 |
|
如果没有 hostRules 匹配，则将流量定向到的 defaultService 资源的完整或部分 URL。如果还指定了 defaultRouteAction，则在将请求发送到后端之前，会应用 URL 重写等高级路由操作。但是，如果指定了 defaultService，则 defaultRouteAction 不能包含任何 weightedBackendServices。相反，如果 routeAction 指定了任何 weightedBackendServices，则不得指定 service。只能设置 defaultService、defaultUrlRedirect 或 defaultRouteAction.weightedBackendService 中的一个。 已返回：成功 |
|
当没有指定 hostRules 匹配时，请求将被重定向到由 defaultUrlRedirect 指定的 URL。如果指定了 defaultUrlRedirect，则不得设置 defaultService 或 defaultRouteAction。 已返回：成功 |
|
在重定向响应中将使用的主机，而不是请求中提供的主机。该值必须介于 1 到 255 个字符之间。 已返回：成功 |
|
如果设置为 true，则重定向请求中的 URL 方案将设置为 https。如果设置为 false，则重定向请求的 URL 方案将与请求的 URL 方案保持相同。这必须仅对 TargetHttpProxys 中使用的 UrlMap 进行设置。不允许为 TargetHttpsProxy 将其设置为 true。默认设置为 false。 已返回：成功 |
|
在重定向响应中将使用的路径，而不是请求中提供的路径。pathRedirect 不能与 prefixRedirect 一起提供。单独提供其中一个或两者都不提供。如果两者都不提供，则原始请求的路径将用于重定向。该值必须介于 1 到 1024 个字符之间。 已返回：成功 |
|
替换 HttpRouteRuleMatch 中指定的 prefixMatch 的前缀，保留 URL 的其余部分，然后再重定向请求。 prefixRedirect 不能与 pathRedirect 一起提供。单独提供其中一个或两者都不提供。如果两者都不提供，则原始请求的路径将用于重定向。该值必须介于 1 到 1024 个字符之间。 已返回：成功 |
|
用于此 RedirectAction 的 HTTP 状态代码。支持的值为：* MOVED_PERMANENTLY_DEFAULT，这是默认值，对应于 301。 * FOUND，对应于 302。 * SEE_OTHER，对应于 303。 * TEMPORARY_REDIRECT，对应于 307。在这种情况下，请求方法将被保留。 * PERMANENT_REDIRECT，对应于 308。在这种情况下，请求方法将被保留。 已返回：成功 |
|
如果设置为 true，则在重定向请求之前，将删除原始 URL 的任何随附查询部分。如果设置为 false，则保留原始 URL 的查询部分。默认设置为 false。 已返回：成功 |
|
此资源的可选说明。创建资源时提供此属性。 已返回：成功 |
|
此资源的指纹。存储在此对象中的内容的哈希值。此字段用于乐观锁定。 已返回：成功 |
|
指定需要对选定的 backendService 生效的请求和响应标头的更改。此处指定的 headerAction 在 pathMatcher 下指定的 headerAction 之后生效。 已返回：成功 |
|
在将请求转发到 backendService 之前，要添加到匹配请求的标头。 已返回：成功 |
|
标头的名称。 已返回：成功 |
|
要添加的标头的值。 已返回：成功 |
|
如果为 false，则将 headerValue 附加到标头已存在的任何值。如果为 true，则为标头设置 headerValue，并放弃为该标头设置的任何值。 已返回：成功 |
|
在将请求转发到 backendService 之前，需要从请求中删除的标头的标头名称列表。 已返回：成功 |
|
在将响应发送回客户端之前，要添加到响应的标头。 已返回：成功 |
|
标头的名称。 已返回：成功 |
|
要添加的标头的值。 已返回：成功 |
|
如果为 false，则将 headerValue 附加到标头已存在的任何值。如果为 true，则为标头设置 headerValue，并放弃为该标头设置的任何值。 已返回：成功 |
|
在将响应发送回客户端之前，需要从响应中删除的标头的标头名称列表。 已返回：成功 |
|
要针对 URL 使用的 HostRules 列表。 已返回：成功 |
|
此资源的可选说明。创建资源时提供此属性。 已返回：成功 |
|
要匹配的主机模式列表。它们必须是有效的主机名，除了 * 将匹配任何字符串 ([a-z0-9-.]*)。在这种情况下，* 必须是第一个字符，并且模式中必须后跟 - 或 . 已返回：成功 |
|
如果 hostRule 与 URL 的主机部分匹配，则用于匹配 URL 的路径部分的 PathMatcher 的名称。 已返回：成功 |
|
资源的唯一标识符。 已返回：成功 |
|
资源的名称。由客户端在创建资源时提供。名称长度必须为 1-63 个字符，并符合 RFC1035。具体来说，名称长度必须为 1-63 个字符，并与正则表达式 `[a-z]([-a-z0-9]*[a-z0-9])?` 匹配，这意味着第一个字符必须是小写字母，并且所有后续字符必须是破折号、小写字母或数字，但最后一个字符不能是破折号。 已返回：成功 |
|
要针对 URL 使用的命名 PathMatchers 列表。 已返回：成功 |
|
当 pathRules 或 routeRules 均不匹配时，`defaultRouteAction` 生效。负载均衡器在将请求转发到选定的后端之前，会执行诸如 URL 重写、标头转换等高级路由操作。如果 `defaultRouteAction` 指定了任何 `weightedBackendServices`，则不得设置 `defaultService`。 相反，如果设置了 `defaultService`，则 `defaultRouteAction` 不能包含任何 `weightedBackendServices`。 只能设置 defaultRouteAction 或 defaultUrlRedirect 中的一个。 已返回：成功 |
|
允许客户端跨源请求的规范。请参阅[跨源资源共享的 W3C 建议](https://www.w3.org/TR/cors/) 。 已返回：成功 |
|
在响应预检请求时，将此设置为 true 表示实际请求可以包含用户凭据。 这会转换为 Access-Control-Allow-Credentials 标头。 已返回：成功 |
|
指定 Access-Control-Allow-Headers 标头的内容。 已返回：成功 |
|
指定 Access-Control-Allow-Methods 标头的内容。 已返回：成功 |
|
指定与允许的源匹配的正则表达式模式。有关正则表达式语法，请参阅 en.cppreference.com/w/cpp/regex/ecmascript 如果源与 allowOrigins 中的项或 allowOriginRegexes 中的项匹配，则允许该源。 已返回：成功 |
|
指定允许进行 CORS 请求的源列表。 如果源与 allowOrigins 中的项或 allowOriginRegexes 中的项匹配，则允许该源。 已返回：成功 |
|
如果为 true，则指定 CORS 策略已禁用。默认值为 false，表示 CORS 策略有效。 已返回：成功 |
|
指定 Access-Control-Expose-Headers 标头的内容。 已返回：成功 |
|
指定预检请求的结果可以缓存多长时间（以秒为单位）。 这会转换为 Access-Control-Max-Age 标头。 已返回：成功 |
|
用于引入到流量中以测试客户端对后端服务故障的弹性的故障注入规范。 作为故障注入的一部分，当客户端向后端服务发送请求时，负载均衡器可以在将这些请求发送到后端服务之前，对一定比例的请求引入延迟。同样，负载均衡器可以为一定比例的请求中止来自客户端的请求。 使用 faultInjectionPolicy 配置的客户端将忽略 timeout 和 retryPolicy。 已返回：成功 |
|
作为故障注入的一部分，客户端请求如何中止的规范。 已返回：成功 |
|
用于中止请求的 HTTP 状态代码。 该值必须介于 200 和 599 之间（包括 200 和 599）。 已返回：成功 |
|
作为故障注入的一部分，将被中止的流量（连接/操作/请求）的百分比。 该值必须介于 0.0 和 100.0 之间（包括 0.0 和 100.0）。 已返回：成功 |
|
客户端请求在发送到后端服务之前，作为故障注入的一部分如何延迟的规范。 已返回：成功 |
|
指定固定延迟间隔的值。 已返回：成功 |
|
以纳秒分辨率表示的一秒的小部分时间跨度。小于一秒的持续时间用 0 秒字段和正的 nanos 字段表示。必须介于 0 到 999,999,999 之间（包括 0 和 999,999,999）。 已返回：成功 |
|
以秒为单位的时间跨度。必须介于 0 到 315,576,000,000 之间（包括 0 和 315,576,000,000）。 注意：这些边界是通过以下公式计算的：60 秒/分钟 * 60 分钟/小时 * 24 小时/天 * 365.25 天/年 * 10000 年。 已返回：成功 |
|
在故障注入过程中将引入延迟的流量（连接/操作/请求）的百分比。 该值必须介于 0.0 和 100.0 之间（包括 0.0 和 100.0）。 已返回：成功 |
|
指定如何将路由的目标请求镜像到单独的镜像后端服务的策略。 负载均衡器不等待来自影子服务的响应。在将流量发送到影子服务之前，主机/授权头会附加 -shadow 后缀。 已返回：成功 |
|
要镜像到的 BackendService 资源的完整或部分 URL。 已返回：成功 |
|
指定与此路由关联的重试策略。 已返回：成功 |
|
指定允许的重试次数。此数字必须 > 0。如果未指定，则默认为 1。 已返回：成功 |
|
指定每次重试尝试的非零超时。 如果未指定，将使用 HttpRouteAction 中设置的超时。如果 HttpRouteAction 中未设置超时，将使用与该路由关联的所有后端服务中的最大超时。 已返回：成功 |
|
以纳秒分辨率表示的一秒的小部分时间跨度。小于一秒的持续时间用 0 秒字段和正的 nanos 字段表示。必须介于 0 到 999,999,999 之间（包括 0 和 999,999,999）。 已返回：成功 |
|
以秒为单位的时间跨度。必须介于 0 到 315,576,000,000 之间（包括 0 和 315,576,000,000）。 注意：这些边界是通过以下公式计算的：60 秒/分钟 * 60 分钟/小时 * 24 小时/天 * 365.25 天/年 * 10000 年。 已返回：成功 |
|
指定此重试规则应用的一个或多个条件。有效值为：* 5xx：如果后端服务返回任何 5xx 响应代码，或者后端服务根本没有响应（例如：断开连接、重置、读取超时、* 连接失败和拒绝的流），则负载均衡器将尝试重试。 * gateway-error：与 5xx 类似，但仅适用于响应代码 502、503 或 504。 * connect-failure：负载均衡器将在连接后端服务失败时重试，例如由于连接超时。 * retriable-4xx：负载均衡器将对可重试的 4xx 响应代码进行重试。 目前，唯一支持的可重试错误是 409。 * refused-stream：如果后端服务使用 REFUSED_STREAM 错误代码重置流，则负载均衡器将重试。 此重置类型表明可以安全地重试。 * cancelled：如果响应头中的 gRPC 状态代码设置为 cancelled，负载均衡器将重试 * deadline-exceeded：如果响应头中的 gRPC 状态代码设置为 deadline-exceeded，负载均衡器将重试 * resource-exhausted：如果响应头中的 gRPC 状态代码设置为 resource-exhausted，负载均衡器将重试 * unavailable：如果响应头中的 gRPC 状态代码设置为 unavailable，负载均衡器将重试。 已返回：成功 |
|
指定所选路由的超时时间。超时时间从请求被完全处理（即流结束）到响应被完全处理的时间计算。超时时间包括所有重试。 如果未指定，将使用与该路由关联的所有后端服务中的最大超时时间。 已返回：成功 |
|
以纳秒分辨率表示的一秒的小部分时间跨度。小于一秒的持续时间用 0 秒字段和正的 nanos 字段表示。必须介于 0 到 999,999,999 之间（包括 0 和 999,999,999）。 已返回：成功 |
|
以秒为单位的时间跨度。必须介于 0 到 315,576,000,000 之间（包括 0 和 315,576,000,000）。 注意：这些边界是通过以下公式计算的：60 秒/分钟 * 60 分钟/小时 * 24 小时/天 * 365.25 天/年 * 10000 年。 已返回：成功 |
|
在将请求转发到匹配的服务之前，修改请求 URL 的规范。 已返回：成功 |
|
在将请求转发到选定的服务之前，请求的主机头将被 hostRewrite 的内容替换。 该值必须介于 1 到 255 个字符之间。 已返回：成功 |
|
在将请求转发到选定的后端服务之前，请求路径的匹配部分将被 pathPrefixRewrite 替换。 该值必须介于 1 到 1024 个字符之间。 已返回：成功 |
|
发生路由匹配时要将流量发送到的加权后端服务列表。 权重决定了流向其对应后端服务的流量比例。 如果所有流量都需要流向单个后端服务，则必须有一个 weightedBackendService，其权重设置为非 0 数字。 一旦确定了后端服务，并且在将请求转发到后端服务之前，将应用诸如 URL 重写和标头转换之类的高级路由操作，具体取决于此 HttpRouteAction 中指定的其他设置。 已返回：成功 |
|
默认 BackendService 资源的完整或部分 URL。在将请求转发到 backendService 之前，负载均衡器将应用此 backendServiceWeight 中指定的任何相关 headerActions。 已返回：成功 |
|
指定需要对选定的 backendService 生效的请求和响应标头的更改。 此处指定的 headerAction 在封闭的 HttpRouteRule、PathMatcher 和 UrlMap 中的 headerAction 之前生效。 已返回：成功 |
|
在将请求转发到 backendService 之前，要添加到匹配请求的标头。 已返回：成功 |
|
要添加的标头的名称。 已返回：成功 |
|
要添加的标头的值。 已返回：成功 |
|
如果为 false，则将 headerValue 附加到标头已存在的任何值。 如果为 true，则为标头设置 headerValue，并放弃为该标头设置的任何值。 已返回：成功 |
|
在将请求转发到 backendService 之前，需要从请求中删除的标头的标头名称列表。 已返回：成功 |
|
在将响应发送回客户端之前，要添加到响应的标头。 已返回：成功 |
|
要添加的标头的名称。 已返回：成功 |
|
要添加的标头的值。 已返回：成功 |
|
如果为 false，则将 headerValue 附加到标头已存在的任何值。 如果为 true，则为标头设置 headerValue，并放弃为该标头设置的任何值。 已返回：成功 |
|
在将响应发送回客户端之前，需要从响应中删除的标头的标头名称列表。 已返回：成功 |
|
指定发送到 backendService 的流量比例，计算为 weight / (路由操作中所有 weightedBackendService 权重的总和)。 仅对新流量确定后端服务的选择。一旦用户的请求被定向到某个后端服务，后续请求将被发送到同一后端服务，这由后端服务的会话亲和性策略确定。 该值必须介于 0 到 1000 之间。 已返回：成功 |
|
BackendService 资源的完整或部分 URL。如果此 PathMatcher 定义的任何 pathRules 或 routeRules 都不匹配，将使用此 URL。例如，以下都是 BackendService 资源的有效 URL：- https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService - compute/v1/projects/project/global/backendServices/backendService - global/backendServices/backendService。如果还指定了 `defaultRouteAction`，则在将请求发送到后端之前，将执行诸如 URL 重写等高级路由操作。但是，如果指定了 `defaultService`，则 `defaultRouteAction` 不能包含任何 `weightedBackendServices`。相反，如果 `defaultRouteAction` 指定了任何 `weightedBackendServices`，则不得指定 `defaultService`。 只能设置 `defaultService`、`defaultUrlRedirect` 或 `defaultRouteAction.weightedBackendService` 中的一个。授权需要对指定的资源 `defaultService` 具有以下一个或多个 Google IAM 权限：- compute.backendBuckets.use - compute.backendServices.use 。 已返回：成功 |
|
当没有指定 hostRules 匹配时，请求将被重定向到由 defaultUrlRedirect 指定的 URL。如果指定了 defaultUrlRedirect，则不得设置 defaultService 或 defaultRouteAction。 已返回：成功 |
|
在重定向响应中将使用的主机，而不是请求中提供的主机。该值必须介于 1 到 255 个字符之间。 已返回：成功 |
|
如果设置为 true，则重定向请求中的 URL 方案将设置为 https。如果设置为 false，则重定向请求的 URL 方案将与请求的 URL 方案保持相同。这必须仅对 TargetHttpProxys 中使用的 UrlMap 进行设置。不允许为 TargetHttpsProxy 将其设置为 true。默认设置为 false。 已返回：成功 |
|
在重定向响应中将使用的路径，而不是请求中提供的路径。pathRedirect 不能与 prefixRedirect 一起提供。单独提供其中一个或两者都不提供。如果两者都不提供，则原始请求的路径将用于重定向。该值必须介于 1 到 1024 个字符之间。 已返回：成功 |
|
替换 HttpRouteRuleMatch 中指定的 prefixMatch 的前缀，保留 URL 的其余部分，然后再重定向请求。 prefixRedirect 不能与 pathRedirect 一起提供。单独提供其中一个或两者都不提供。如果两者都不提供，则原始请求的路径将用于重定向。该值必须介于 1 到 1024 个字符之间。 已返回：成功 |
|
用于此 RedirectAction 的 HTTP 状态代码。支持的值为：* MOVED_PERMANENTLY_DEFAULT，这是默认值，对应于 301。 * FOUND，对应于 302。 * SEE_OTHER，对应于 303。 * TEMPORARY_REDIRECT，对应于 307。在这种情况下，请求方法将被保留。 * PERMANENT_REDIRECT，对应于 308。在这种情况下，请求方法将被保留。 已返回：成功 |
|
如果设置为 true，则在重定向请求之前，将删除原始 URL 中随附的任何查询部分。如果设置为 false，则保留原始 URL 的查询部分。 已返回：成功 |
|
此资源的可选说明。创建资源时提供此属性。 已返回：成功 |
|
指定需要为选定的 backendService 生效的请求和响应标头的更改。此处指定的 `HeaderAction` 在匹配的 `HttpRouteRule HeaderAction` 之后和 `UrlMap` 中的 `HeaderAction` 之前应用。 已返回：成功 |
|
在将请求转发到 backendService 之前，要添加到匹配请求的标头。 已返回：成功 |
|
标头的名称。 已返回：成功 |
|
要添加的标头的值。 已返回：成功 |
|
如果为 false，则将 headerValue 附加到标头已存在的任何值。如果为 true，则为标头设置 headerValue，并放弃为该标头设置的任何值。 已返回：成功 |
|
在将请求转发到 backendService 之前，需要从请求中删除的标头的标头名称列表。 已返回：成功 |
|
在将响应发送回客户端之前，要添加到响应的标头。 已返回：成功 |
|
标头的名称。 已返回：成功 |
|
要添加的标头的值。 已返回：成功 |
|
如果为 false，则将 headerValue 附加到标头已存在的任何值。如果为 true，则为标头设置 headerValue，并放弃为该标头设置的任何值。 已返回：成功 |
|
在将响应发送回客户端之前，需要从响应中删除的标头的标头名称列表。 已返回：成功 |
|
HostRule 引用此 PathMatcher 的名称。 已返回：成功 |
|
路径规则列表。当只需要基于简单路径匹配进行路由时，请使用此列表代替 `routeRules`。指定路径规则的顺序无关紧要。匹配始终以最长路径优先的方式完成。例如：路径为 `/a/b/c/*` 的 `pathRule` 将在 `/a/b/*` 之前匹配，而与这些路径在此列表中出现的顺序无关。在给定的 `pathMatcher` 中，只能设置 `pathRules` 或 `routeRules` 中的一个。 已返回：成功 |
|
要匹配的路径模式列表。每个模式都必须以 `/` 开头，并且唯一允许使用 `*` 的位置是 `/` 后面的结尾处。传递给路径匹配器的字符串不包括第一个 `?` 或 `#` 之后的任何文本，并且此处不允许使用这些字符。 已返回：成功 |
|
为了响应匹配的路径，负载均衡器在将请求转发到选定的后端之前，会执行诸如 URL 重写、标头转换等高级路由操作。如果 `routeAction` 指定了任何 `weightedBackendServices`，则不得设置 `service`。相反，如果设置了 `service`，则 `routeAction` 不能包含任何 `weightedBackendServices`。只能设置 `routeAction` 或 `urlRedirect` 中的一个。 已返回：成功 |
|
允许客户端跨域请求的规范。请参阅 W3C 跨域资源共享建议。 已返回：成功 |
|
为了响应预检请求，将其设置为 true 表示实际请求可以包含用户凭据。这会转换为 Access-Control-Allow-Credentials 标头。默认为 false。 已返回：成功 |
|
指定 Access-Control-Allow-Headers 标头的内容。 已返回：成功 |
|
指定 Access-Control-Allow-Methods 标头的内容。 已返回：成功 |
|
指定匹配允许的来源的正则表达式模式。有关正则表达式语法，请参阅 en.cppreference.com/w/cpp/regex/ecmascript。如果来源与 `allow_origins` 或 `allow_origin_regex` 匹配，则允许该来源。 已返回：成功 |
|
指定将允许进行 CORS 请求的来源列表。如果来源与 `allow_origins` 或 `allow_origin_regex` 匹配，则允许该来源。 已返回：成功 |
|
如果为 true，则指定禁用 CORS 策略。 已返回：成功 |
|
指定 Access-Control-Expose-Headers 标头的内容。 已返回：成功 |
|
指定可以缓存预检请求结果的时间长度。这会转换为 Access-Control-Max-Age 标头的内容。 已返回：成功 |
|
引入到流量中的故障注入规范，以测试客户端对后端服务故障的弹性。作为故障注入的一部分，当客户端向后端服务发送请求时，负载均衡器可以在将这些请求发送到后端服务之前，对一定百分比的请求引入延迟。同样，负载均衡器可以中止一定百分比的客户端请求。配置了 `fault_injection_policy` 的客户端将忽略 `timeout` 和 `retry_policy`。 已返回：成功 |
|
作为故障注入的一部分，客户端请求如何中止的规范。 已返回：成功 |
|
用于中止请求的 HTTP 状态代码。该值必须在 200 到 599 之间（包括 200 和 599）。 已返回：成功 |
|
作为故障注入的一部分将中止的流量（连接/操作/请求）的百分比。该值必须在 0.0 到 100.0 之间（包括 0.0 和 100.0）。 已返回：成功 |
|
客户端请求在发送到后端服务之前，作为故障注入的一部分如何延迟的规范。 已返回：成功 |
|
指定固定延迟间隔的值。 已返回：成功 |
|
以纳秒分辨率为单位的秒的分数的时间跨度。小于 1 秒的持续时间表示为 0 `seconds` 字段和正 `nanos` 字段。必须在 0 到 999,999,999 之间（包括 0 和 999,999,999）。 已返回：成功 |
|
以秒为单位的时间跨度。必须介于 0 到 315,576,000,000 之间（包括 0 和 315,576,000,000）。 已返回：成功 |
|
作为故障注入的一部分将引入延迟的流量（连接/操作/请求）的百分比。该值必须在 0.0 到 100.0 之间（包括 0.0 和 100.0）。 已返回：成功 |
|
指定如何将路由后端的目标请求镜像到单独的镜像后端服务的策略。负载均衡器不等待来自镜像服务的响应。在将流量发送到镜像服务之前，主机/授权标头将附加后缀“-shadow”。 已返回：成功 |
|
要镜像到的 BackendService 资源。 已返回：成功 |
|
指定与此路由关联的重试策略。 已返回：成功 |
|
指定允许的重试次数。此数字必须 > 0。 已返回：成功 |
|
指定每次重试尝试的非零超时。 已返回：成功 |
|
以纳秒分辨率为单位的秒的分数的时间跨度。小于 1 秒的持续时间表示为 0 `seconds` 字段和正 `nanos` 字段。必须在 0 到 999,999,999 之间（包括 0 和 999,999,999）。 已返回：成功 |
|
以秒为单位的时间跨度。必须介于 0 到 315,576,000,000 之间（包括 0 和 315,576,000,000）。 已返回：成功 |
|
指定此重试规则适用的一个或多个条件。有效值为：* 5xx：如果后端服务响应任何 5xx 响应代码，或者后端服务根本没有响应，则负载均衡器将尝试重试，例如：断开连接、重置、读取超时、连接失败和拒绝流。 * gateway-error：与 5xx 类似，但仅适用于响应代码 502、503 或 504。 * connect-failure：负载均衡器将在连接后端服务失败时重试，例如由于连接超时。 * retriable-4xx：负载均衡器将对可重试的 4xx 响应代码进行重试。 目前，唯一支持的可重试错误是 409。 * refused-stream：如果后端服务使用 REFUSED_STREAM 错误代码重置流，则负载均衡器将重试。此重置类型表示可以安全地重试。 * cancelled：如果响应头中的 gRPC 状态代码设置为 cancelled，负载均衡器将重试 * deadline-exceeded：如果响应头中的 gRPC 状态代码设置为 deadline-exceeded，负载均衡器将重试 * resource-exhausted：如果响应头中的 gRPC 状态代码设置为 resource-exhausted，负载均衡器将重试 * unavailable：如果响应头中的 gRPC 状态代码设置为 unavailable，负载均衡器将重试。 已返回：成功 |
|
指定所选路由的超时时间。超时时间从请求被完全处理（即，流结束）到响应被完全处理的时间计算。超时时间包括所有重试。如果未指定，则默认值为 15 秒。 已返回：成功 |
|
以纳秒分辨率为单位的秒的分数的时间跨度。小于 1 秒的持续时间表示为 0 `seconds` 字段和正 `nanos` 字段。必须在 0 到 999,999,999 之间（包括 0 和 999,999,999）。 已返回：成功 |
|
以秒为单位的时间跨度。必须介于 0 到 315,576,000,000 之间（包括 0 和 315,576,000,000）。 已返回：成功 |
|
用于修改请求 URL 的规范，在将请求转发到匹配的服务之前。 已返回：成功 |
|
在将请求转发到选定的服务之前，请求的 host 标头将替换为 `hostRewrite` 的内容。该值必须在 1 到 255 个字符之间。 已返回：成功 |
|
在将请求转发到选定的后端服务之前，请求路径的匹配部分将替换为 `pathPrefixRewrite`。该值必须在 1 到 1024 个字符之间。 已返回：成功 |
|
在发生路由匹配时要向其发送流量的加权后端服务列表。权重确定流向其对应后端服务的流量比例。如果所有流量都需要转到单个后端服务，则必须有一个权重设置为非 0 数字的 `weightedBackendService`。一旦确定了后端服务，并且在将请求转发到后端服务之前，将应用诸如 URL 重写和标头转换之类的高级路由操作，具体取决于此 HttpRouteAction 中指定的其他设置。 已返回：成功 |
|
默认 BackendService 资源。在将请求转发到 `backendService` 之前，负载均衡器将应用作为此 `backendServiceWeight` 一部分指定的任何相关 `headerActions`。 已返回：成功 |
|
指定需要为选定的 backendService 生效的请求和响应标头的更改。此处指定的 `headerAction` 在封闭的 `HttpRouteRule`、`PathMatcher` 和 `UrlMap` 中的 `headerAction` 之前生效。 已返回：成功 |
|
在将请求转发到 backendService 之前，要添加到匹配请求的标头。 已返回：成功 |
|
标头的名称。 已返回：成功 |
|
要添加的标头的值。 已返回：成功 |
|
如果为 false，则将 headerValue 附加到标头已存在的任何值。如果为 true，则为标头设置 headerValue，并放弃为该标头设置的任何值。 已返回：成功 |
|
在将请求转发到 backendService 之前，需要从请求中删除的标头的标头名称列表。 已返回：成功 |
|
在将响应发送回客户端之前，要添加到响应的标头。 已返回：成功 |
|
标头的名称。 已返回：成功 |
|
要添加的标头的值。 已返回：成功 |
|
如果为 false，则将 headerValue 附加到标头已存在的任何值。如果为 true，则为标头设置 headerValue，并放弃为该标头设置的任何值。 已返回：成功 |
|
在将响应发送回客户端之前，需要从响应中删除的标头的标头名称列表。 已返回：成功 |
|
指定发送到 `backendService` 的流量比例，计算为 `weight / (routeAction 中所有 weightedBackendService 权重的总和)`。仅针对新流量确定后端服务的选择。一旦用户的请求被定向到后端服务，后续请求将被发送到相同的后端服务，由后端服务的会话亲和性策略确定。 该值必须介于 0 到 1000 之间。 已返回：成功 |
|
如果匹配此规则，则流量定向到的后端服务资源。如果还指定了 `routeAction`，则在将请求发送到后端之前，将执行诸如 URL 重写等高级路由操作。但是，如果指定了 `service`，则 `routeAction` 不能包含任何 `weightedBackendService`。相反，如果 `routeAction` 指定了任何 `weightedBackendServices`，则不得指定 `service`。只能设置 `urlRedirect`、`service` 或 `routeAction.weightedBackendService` 中的一个。 已返回：成功 |
|
当路径模式匹配时，请求将重定向到 `urlRedirect` 指定的 URL。如果指定了 `urlRedirect`，则不得设置 `service` 或 `routeAction`。 已返回：成功 |
|
在重定向响应中将使用的主机，而不是请求中提供的主机。该值必须介于 1 到 255 个字符之间。 已返回：成功 |
|
如果设置为 true，则重定向请求中的 URL 方案将设置为 https。 如果设置为 false，则重定向请求的 URL 方案将与请求的 URL 方案保持相同。这必须仅为 `TargetHttpProxys` 中使用的 `UrlMaps` 设置。不允许为 `TargetHttpsProxy` 将其设置为 true。默认设置为 false。 已返回：成功 |
|
将在重定向响应中使用的路径，而不是请求中提供的路径。`pathRedirect` 不能与 `prefixRedirect` 一起提供。单独提供一个或两者都不提供。如果两者都没有提供，则原始请求的路径将用于重定向。 该值必须介于 1 到 1024 个字符之间。 已返回：成功 |
|
替换 `HttpRouteRuleMatch` 中指定的 `prefixMatch` 的前缀，保留 URL 的剩余部分，然后再重定向请求。`prefixRedirect` 不能与 `pathRedirect` 一起提供。单独提供一个或两者都不提供。如果两者都没有提供，则原始请求的路径将用于重定向。该值必须在 1 到 1024 个字符之间。 已返回：成功 |
|
用于此 RedirectAction 的 HTTP 状态代码。支持的值为：* MOVED_PERMANENTLY_DEFAULT，这是默认值，对应于 301。 * FOUND，对应于 302。 * SEE_OTHER，对应于 303。 * TEMPORARY_REDIRECT，对应于 307。在这种情况下，请求方法将被保留。 * PERMANENT_REDIRECT，对应于 308。在这种情况下，请求方法将被保留。 已返回：成功 |
|
如果设置为 true，则在重定向请求之前，将删除原始 URL 中随附的任何查询部分。如果设置为 false，则保留原始 URL 的查询部分。 已返回：成功 |
|
已排序的 HTTP 路由规则列表。当需要高级路由匹配和路由操作时，请使用此列表代替 `pathRules`。指定 `routeRules` 的顺序很重要：第一个匹配的规则将使其指定的路由操作生效。在给定的 `pathMatcher` 中，只能设置 `pathRules` 或 `routeRules` 中的一个。外部负载均衡器的 `UrlMaps` 中不支持 `routeRules`。 已返回：成功 |
|
指定需要为选定的 backendService 生效的请求和响应标头的更改。此处指定的 `headerAction` 在匹配的 `pathMatchers[].headerAction` 之前和 `pathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction` 之后应用。 已返回：成功 |
|
在将请求转发到 backendService 之前，要添加到匹配请求的标头。 已返回：成功 |
|
标头的名称。 已返回：成功 |
|
要添加的标头的值。 已返回：成功 |
|
如果为 false，则将 headerValue 附加到标头已存在的任何值。如果为 true，则为标头设置 headerValue，并放弃为该标头设置的任何值。 已返回：成功 |
|
在将请求转发到 backendService 之前，需要从请求中删除的标头的标头名称列表。 已返回：成功 |
|
在将响应发送回客户端之前，要添加到响应的标头。 已返回：成功 |
|
标头的名称。 已返回：成功 |
|
要添加的标头的值。 已返回：成功 |
|
如果为 false，则将 headerValue 附加到标头已存在的任何值。如果为 true，则为标头设置 headerValue，并放弃为该标头设置的任何值。 已返回：成功 |
|
在将响应发送回客户端之前，需要从响应中删除的标头的标头名称列表。 已返回：成功 |
|
用于确定匹配的规则。 已返回：成功 |
|
为了满足 `matchRule` 条件，在删除可能是原始 URL 一部分的任何查询参数和锚点后，请求的路径必须与 `fullPathMatch` 中指定的值完全匹配。`FullPathMatch` 必须在 1 到 1024 个字符之间。只能指定 `prefixMatch`、`fullPathMatch` 或 `regexMatch` 中的一个。 已返回：成功 |
|
指定标头匹配条件的列表，所有条件都必须匹配请求中的对应标头。 已返回：成功 |
|
该值应与 `exactMatch` 的内容完全匹配。只能设置 `exactMatch`、`prefixMatch`、`suffixMatch`、`regexMatch`、`presentMatch` 或 `rangeMatch` 中的一个。 已返回：成功 |
|
要匹配的 HTTP 标头的名称。为了匹配 HTTP 请求的授权，请使用标头名称为“:authority”的 `headerMatch`。为了匹配请求的方法，请使用标头名称“:method”。 已返回：成功 |
|
如果设置为 false，则当满足上述匹配条件时，headerMatch 被视为匹配。如果设置为 true，则当不满足上述匹配条件时，headerMatch 被视为匹配。默认为 false。 已返回：成功 |
|
header 的值必须以 prefixMatch 的内容开头。exactMatch、prefixMatch、suffixMatch、regexMatch、presentMatch 或 rangeMatch 中只能设置一个。 已返回：成功 |
|
必须存在具有 headerName 内容的 header。无论请求的 header 是否有值，都会进行匹配。exactMatch、prefixMatch、suffixMatch、regexMatch、presentMatch 或 rangeMatch 中只能设置一个。 已返回：成功 |
|
header 的值必须是整数，并且其值必须在 rangeMatch 中指定的范围内。如果 header 不包含整数、数字或为空，则匹配失败。例如，对于范围 [-5, 0] - -3 将匹配。- 0 将不匹配。- 0.25 将不匹配。- -3someString 将不匹配。exactMatch、prefixMatch、suffixMatch、regexMatch、presentMatch 或 rangeMatch 中只能设置一个。 已返回：成功 |
|
范围的结束值（不包含）。 已返回：成功 |
|
范围的起始值（包含）。 已返回：成功 |
|
header 的值必须与 regexMatch 中指定的正则表达式匹配。有关正则表达式语法，请参见：en.cppreference.com/w/cpp/regex/ecmascript。 要匹配 HTTP 请求中指定的端口，请使用 headerName 设置为 PORT 的 headerMatch 以及满足 RFC2616 Host header 端口规范的正则表达式。 exactMatch、prefixMatch、suffixMatch、regexMatch、presentMatch 或 rangeMatch 中只能设置一个。 已返回：成功 |
|
header 的值必须以 suffixMatch 的内容结尾。exactMatch、prefixMatch、suffixMatch、regexMatch、presentMatch 或 rangeMatch 中只能设置一个。 已返回：成功 |
|
指定 prefixMatch 和 fullPathMatch 的匹配是否区分大小写。 默认为 false。 已返回：成功 |
|
Loadbalancer 使用的不透明筛选条件，用于将路由配置限制为一组有限的符合 xDS 的客户端。在它们向 Loadbalancer 发出的 xDS 请求中，xDS 客户端会提供节点元数据。如果发生匹配，则相关的路由配置可供这些代理使用。对于此列表中的每个 metadataFilter，如果其 filterMatchCriteria 设置为 MATCH_ANY，则至少有一个 filterLabel 必须与元数据中提供的相应标签匹配。如果其 filterMatchCriteria 设置为 MATCH_ALL，则其所有 filterLabel 必须与提供的元数据中的相应标签匹配。此处指定的 metadataFilters 可以覆盖 ForwardingRule 中指定的 metadataFilters，后者引用此 UrlMap。metadataFilters 仅适用于将其 loadBalancingScheme 设置为 INTERNAL_SELF_MANAGED 的负载均衡器。 已返回：成功 |
|
必须根据 filterMatchCriteria 匹配所提供元数据中的标签的标签值对列表。此列表不能为空，最多可以有 64 个条目。 已返回：成功 |
|
元数据标签的名称。名称的最大长度为 1024 个字符，且必须至少为 1 个字符长。 已返回：成功 |
|
标签的值必须与指定的值匹配。value 的最大长度为 1024 个字符。 已返回：成功 |
|
指定 filterLabels 列表中各个 filterLabel 匹配如何对整体 metadataFilter 匹配做出贡献。支持的值包括： - MATCH_ANY：至少有一个 filterLabel 必须在提供的元数据中具有匹配的标签。
已返回：成功 |
|
为了满足 matchRule 条件，请求的路径必须以指定的 prefixMatch 开头。prefixMatch 必须以 / 开头。该值必须介于 1 到 1024 个字符之间。只能指定 prefixMatch、fullPathMatch 或 regexMatch 中的一个。 已返回：成功 |
|
指定查询参数匹配条件的列表，所有条件都必须与请求中的相应查询参数匹配。 已返回：成功 |
|
如果参数的值与 exactMatch 的内容完全匹配，则 queryParameterMatch 匹配。只能设置 presentMatch、exactMatch 和 regexMatch 中的一个。 已返回：成功 |
|
要匹配的查询参数的名称。查询参数必须存在于请求中，否则请求匹配失败。 已返回：成功 |
|
指定如果请求包含查询参数，无论参数是否有值，则 queryParameterMatch 匹配。只能设置 presentMatch、exactMatch 和 regexMatch 中的一个。 已返回：成功 |
|
如果参数的值与 regexMatch 指定的正则表达式匹配，则 queryParameterMatch 匹配。有关正则表达式语法，请参见 en.cppreference.com/w/cpp/regex/ecmascript。只能设置 presentMatch、exactMatch 和 regexMatch 中的一个。 已返回：成功 |
|
为了满足 matchRule 条件，在删除原始 URL 提供的任何查询参数和锚点后，请求的路径必须满足 regexMatch 中指定的正则表达式。有关正则表达式语法，请参见 en.cppreference.com/w/cpp/regex/ecmascript。只能指定 prefixMatch、fullPathMatch 或 regexMatch 中的一个。 已返回：成功 |
|
对于给定 pathMatcher 中的 routeRule，优先级决定了负载均衡器解释 routeRule 的顺序。routeRule 按优先级从低到高进行评估。规则的优先级随着其数字的增加而降低 (1, 2, 3, N+1)。应用与请求匹配的第一个规则。 不能配置两个或多个具有相同优先级的 routeRule。 每个规则的优先级必须设置为 0 到 2147483647（包括 0 和 2147483647）之间的数字。 优先级数字可以有间隔，这样您就可以在将来添加或删除规则，而不会影响其余规则。例如，1、2、3、4、5、9、12、16 是一系列有效的优先级数字，您可以在将来向其中添加编号为 6 到 8、10 到 11 和 13 到 15 的规则，而不会对现有规则产生任何影响。 已返回：成功 |
|
为了响应匹配的 matchRule，负载均衡器在将请求转发到选定的后端之前，会执行诸如 URL 重写、标头转换等高级路由操作。如果 routeAction 指定了任何 weightedBackendServices，则不能设置 service。相反，如果设置了 service，则 routeAction 不能包含任何 weightedBackendServices。只能设置 routeAction 或 urlRedirect 中的一个。 已返回：成功 |
|
允许客户端跨域请求的规范。请参阅 W3C 跨域资源共享建议。 已返回：成功 |
|
为了响应预检请求，将其设置为 true 表示实际请求可以包含用户凭据。这会转换为 Access-Control-Allow-Credentials 标头。默认为 false。 已返回：成功 |
|
指定 Access-Control-Allow-Headers 标头的内容。 已返回：成功 |
|
指定 Access-Control-Allow-Methods 标头的内容。 已返回：成功 |
|
指定匹配允许的来源的正则表达式模式。有关正则表达式语法，请参阅 en.cppreference.com/w/cpp/regex/ecmascript。如果来源与 `allow_origins` 或 `allow_origin_regex` 匹配，则允许该来源。 已返回：成功 |
|
指定将允许进行 CORS 请求的来源列表。如果来源与 `allow_origins` 或 `allow_origin_regex` 匹配，则允许该来源。 已返回：成功 |
|
如果为 true，则指定禁用 CORS 策略。 表示 CORS 策略有效。默认为 false。 已返回：成功 |
|
指定 Access-Control-Expose-Headers 标头的内容。 已返回：成功 |
|
指定可以缓存预检请求结果的时间长度。这会转换为 Access-Control-Max-Age 标头的内容。 已返回：成功 |
|
引入到流量中的故障注入规范，以测试客户端对后端服务故障的弹性。作为故障注入的一部分，当客户端向后端服务发送请求时，负载均衡器可以在将这些请求发送到后端服务之前，对一定百分比的请求引入延迟。同样，负载均衡器可以中止一定百分比的客户端请求。配置了 `fault_injection_policy` 的客户端将忽略 `timeout` 和 `retry_policy`。 已返回：成功 |
|
作为故障注入的一部分，客户端请求如何中止的规范。 已返回：成功 |
|
用于中止请求的 HTTP 状态代码。该值必须在 200 到 599 之间（包括 200 和 599）。 已返回：成功 |
|
作为故障注入的一部分将中止的流量（连接/操作/请求）的百分比。该值必须在 0.0 到 100.0 之间（包括 0.0 和 100.0）。 已返回：成功 |
|
客户端请求在发送到后端服务之前，作为故障注入的一部分如何延迟的规范。 已返回：成功 |
|
指定固定延迟间隔的值。 已返回：成功 |
|
以纳秒分辨率为单位的秒的分数的时间跨度。小于 1 秒的持续时间表示为 0 `seconds` 字段和正 `nanos` 字段。必须在 0 到 999,999,999 之间（包括 0 和 999,999,999）。 已返回：成功 |
|
以秒为单位的时间跨度。必须介于 0 到 315,576,000,000 之间（包括 0 和 315,576,000,000）。 已返回：成功 |
|
作为故障注入的一部分将引入延迟的流量（连接/操作/请求）的百分比。该值必须在 0.0 到 100.0 之间（包括 0.0 和 100.0）。 已返回：成功 |
|
指定如何将路由后端的目标请求镜像到单独的镜像后端服务的策略。负载均衡器不等待来自镜像服务的响应。在将流量发送到镜像服务之前，主机/授权标头将附加后缀“-shadow”。 已返回：成功 |
|
要镜像到的 BackendService 资源。 已返回：成功 |
|
指定与此路由关联的重试策略。 已返回：成功 |
|
指定允许的重试次数。此数字必须 > 0。 已返回：成功 |
|
指定每次重试尝试的非零超时。 如果未指定，将使用 HttpRouteAction 中设置的超时。如果 HttpRouteAction 中未设置超时，将使用与该路由关联的所有后端服务中的最大超时。 已返回：成功 |
|
以纳秒分辨率为单位的秒的分数的时间跨度。小于 1 秒的持续时间表示为 0 `seconds` 字段和正 `nanos` 字段。必须在 0 到 999,999,999 之间（包括 0 和 999,999,999）。 已返回：成功 |
|
以秒为单位的时间跨度。必须介于 0 到 315,576,000,000 之间（包括 0 和 315,576,000,000）。 已返回：成功 |
|
指定此重试规则生效的一个或多个条件。有效值为：* 5xx：如果后端服务响应任何 5xx 响应代码，或者后端服务根本没有响应，例如：断开连接、重置、读取超时、连接失败和拒绝的流，负载均衡器将尝试重试。 * gateway-error：与 5xx 类似，但仅适用于响应代码 502、503 或 504。 * connect-failure：负载均衡器将在连接后端服务失败时重试，例如由于连接超时。 * retriable-4xx：负载均衡器将对可重试的 4xx 响应代码进行重试。 目前，唯一支持的可重试错误是 409。 * refused-stream：如果后端服务使用 REFUSED_STREAM 错误代码重置流，则负载均衡器将重试。此重置类型表示可以安全地重试。 * cancelled：如果响应头中的 gRPC 状态代码设置为 cancelled，负载均衡器将重试 * deadline-exceeded：如果响应头中的 gRPC 状态代码设置为 deadline-exceeded，负载均衡器将重试 * resource-exhausted：如果响应头中的 gRPC 状态代码设置为 resource-exhausted，负载均衡器将重试 * unavailable：如果响应头中的 gRPC 状态代码设置为 unavailable，负载均衡器将重试。 已返回：成功 |
|
指定所选路由的超时时间。超时时间从请求被完全处理（即，流结束）到响应被完全处理的时间计算。超时时间包括所有重试。如果未指定，则默认值为 15 秒。 已返回：成功 |
|
以纳秒分辨率为单位的秒的分数的时间跨度。小于 1 秒的持续时间表示为 0 `seconds` 字段和正 `nanos` 字段。必须在 0 到 999,999,999 之间（包括 0 和 999,999,999）。 已返回：成功 |
|
以秒为单位的时间跨度。必须介于 0 到 315,576,000,000 之间（包括 0 和 315,576,000,000）。 已返回：成功 |
|
用于修改请求 URL 的规范，在将请求转发到匹配的服务之前。 已返回：成功 |
|
在将请求转发到选定的服务之前，请求的 host 标头将替换为 `hostRewrite` 的内容。该值必须在 1 到 255 个字符之间。 已返回：成功 |
|
在将请求转发到选定的后端服务之前，请求路径的匹配部分将替换为 `pathPrefixRewrite`。该值必须在 1 到 1024 个字符之间。 已返回：成功 |
|
在发生路由匹配时要向其发送流量的加权后端服务列表。权重确定流向其对应后端服务的流量比例。如果所有流量都需要转到单个后端服务，则必须有一个权重设置为非 0 数字的 `weightedBackendService`。一旦确定了后端服务，并且在将请求转发到后端服务之前，将应用诸如 URL 重写和标头转换之类的高级路由操作，具体取决于此 HttpRouteAction 中指定的其他设置。 已返回：成功 |
|
默认 BackendService 资源。在将请求转发到 `backendService` 之前，负载均衡器将应用作为此 `backendServiceWeight` 一部分指定的任何相关 `headerActions`。 已返回：成功 |
|
指定需要为选定的 backendService 生效的请求和响应标头的更改。此处指定的 `headerAction` 在封闭的 `HttpRouteRule`、`PathMatcher` 和 `UrlMap` 中的 `headerAction` 之前生效。 已返回：成功 |
|
在将请求转发到 backendService 之前，要添加到匹配请求的标头。 已返回：成功 |
|
标头的名称。 已返回：成功 |
|
要添加的标头的值。 已返回：成功 |
|
如果为 false，则将 headerValue 附加到标头已存在的任何值。如果为 true，则为标头设置 headerValue，并放弃为该标头设置的任何值。 已返回：成功 |
|
在将请求转发到 backendService 之前，需要从请求中删除的标头的标头名称列表。 已返回：成功 |
|
在将响应发送回客户端之前，要添加到响应的标头。 已返回：成功 |
|
标头的名称。 已返回：成功 |
|
要添加的标头的值。 已返回：成功 |
|
如果为 false，则将 headerValue 附加到标头已存在的任何值。如果为 true，则为标头设置 headerValue，并放弃为该标头设置的任何值。 已返回：成功 |
|
在将响应发送回客户端之前，需要从响应中删除的标头的标头名称列表。 已返回：成功 |
|
指定发送到 `backendService` 的流量比例，计算为 `weight / (routeAction 中所有 weightedBackendService 权重的总和)`。仅针对新流量确定后端服务的选择。一旦用户的请求被定向到后端服务，后续请求将被发送到相同的后端服务，由后端服务的会话亲和性策略确定。 该值必须介于 0 到 1000 之间。 已返回：成功 |
|
如果匹配此规则，则流量定向到的后端服务资源。如果还指定了 `routeAction`，则在将请求发送到后端之前，将执行诸如 URL 重写等高级路由操作。但是，如果指定了 `service`，则 `routeAction` 不能包含任何 `weightedBackendService`。相反，如果 `routeAction` 指定了任何 `weightedBackendServices`，则不得指定 `service`。只能设置 `urlRedirect`、`service` 或 `routeAction.weightedBackendService` 中的一个。 已返回：成功 |
|
当此规则匹配时，请求将重定向到 urlRedirect 指定的 URL。如果指定了 urlRedirect，则不能设置 service 或 routeAction。 已返回：成功 |
|
在重定向响应中将使用的主机，而不是请求中提供的主机。该值必须介于 1 到 255 个字符之间。 已返回：成功 |
|
如果设置为 true，则重定向请求中的 URL 方案将设置为 https。如果设置为 false，则重定向请求的 URL 方案将与请求的 URL 方案保持相同。此选项仅适用于在 TargetHttpProxy 中使用的 UrlMap。 不允许为 TargetHttpsProxy 将此项设置为 true。默认为 false。 已返回：成功 |
|
重定向响应中将使用的路径，而不是请求中提供的路径。只能指定 pathRedirect 或 prefixRedirect 中的一个。该值必须介于 1 到 1024 个字符之间。 已返回：成功 |
|
替换 HttpRouteRuleMatch 中指定的 prefixMatch 的前缀，保留 URL 的其余部分，然后再重定向请求。 已返回：成功 |
|
用于此 RedirectAction 的 HTTP 状态代码。支持的值为：* MOVED_PERMANENTLY_DEFAULT，这是默认值，对应于 301。 * FOUND，对应于 302。 * SEE_OTHER，对应于 303。 * TEMPORARY_REDIRECT，对应于 307。在这种情况下，请求方法将被保留。 * PERMANENT_REDIRECT，对应于 308。在这种情况下，请求方法将被保留。 已返回：成功 |
|
如果设置为 true，则在重定向请求之前会删除原始 URL 的任何随附查询部分。如果设置为 false，则会保留原始 URL 的查询部分。默认为 false。 已返回：成功 |
|
预期 URL 映射测试的列表。只有当所有测试用例都通过时，更新此 UrlMap 的请求才会成功。每个 UrlMap 最多可以指定 100 个测试。 已返回：成功 |
|
此测试用例的描述。 已返回：成功 |
|
URL 的主机部分。 已返回：成功 |
|
URL 的路径部分。 已返回：成功 |
|
给定 URL 应映射到的预期 BackendService 资源。 已返回：成功 |