google.cloud.gcp_compute_region_backend_service 模块 – 创建 GCP RegionBackendService

注意

此模块是 google.cloud 集合 (版本 1.4.1) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install google.cloud。您需要其他要求才能使用此模块，有关详细信息，请参阅 要求。

要在 playbook 中使用它，请指定： google.cloud.gcp_compute_region_backend_service。

注意

由于违反了 Ansible 包含要求，google.cloud 集合将在 Ansible 12 中移除。该集合存在 未解决的健全性测试失败。有关更多信息，请参阅 讨论主题。

概要

  • 区域后端服务定义了一个区域范围的虚拟机组，这些虚拟机将为负载均衡提供流量。

要求

执行此模块的主机需要以下要求。

  • python >= 2.6

  • requests >= 2.18.4

  • google-auth >= 1.3.0

参数

参数

注释

access_token

字符串

如果凭据类型为 accesstoken，则为 OAuth2 访问令牌。

整数

如果 session_affinity 为 GENERATED_COOKIE，则为 Cookie 的生命周期（以秒为单位）。如果设置为 0，则 Cookie 为非持久性 Cookie，仅持续到浏览器会话结束（或等效会话结束）。TTL 的最大允许值为一天。

当负载均衡方案为 INTERNAL 时，此字段不用于。

auth_kind

字符串 / 必需

使用的凭据类型。

选项

  • "application"

  • "machineaccount"

  • "serviceaccount"

  • "accesstoken"

backends

列表 / 元素=字典

为该 RegionBackendService 提供服务的后台集合。

balancing_mode

字符串

指定此后端的平衡模式。

一些有效的选项包括：“UTILIZATION”、“RATE”、“CONNECTION”

默认值： "CONNECTION"

capacity_scaler

字符串

应用于组的最大服务容量（基于 UTILIZATION、RATE 或 CONNECTION）的乘数。

~>**注意**: 此字段不能为内部区域后端服务（默认 loadBalancingScheme）设置，但对于非内部后端服务是必需的。所有后端的总 capacity_scaler 必须非零。

设置为 0 表示该组已完全耗尽，提供 0% 的可用容量。有效范围是 [0.0,1.0]。

description

字符串

此资源的可选描述。

创建资源时提供此属性。

failover

布尔值

此字段指定这是否是故障转移后端。可以为给定的 RegionBackendService 配置多个故障转移后端。

选项

  • false

  • true

group

字符串 / 必需

实例组或网络端点组资源的完全限定 URL。对于实例组，这定义了提供流量的实例列表。每个实例组的成员虚拟机实例必须与实例组本身位于同一区域。后端服务的两个后端不允许使用相同的实例组资源。

对于网络端点组，这定义了端点列表。网络端点组的所有端点必须托管在与网络端点组位于同一区域的实例上。

后端服务不能混合实例组和网络端点组后端。

当 `load_balancing_scheme` 为 INTERNAL 时，仅支持实例组。

请注意，您必须使用完全限定的 URL（而不是部分 URL）来指定实例组或网络端点组资源。

max_connections

整数

组的同时连接的最大数量。可与 CONNECTION 或 UTILIZATION 平衡模式一起使用。

不能为内部后端服务设置。

对于 CONNECTION 模式，必须设置 maxConnections 或 maxConnectionsPerInstance 或 maxConnectionsPerEndpoint 中的一个，这取决于组类型。

max_connections_per_endpoint

整数

单个后端网络端点可以处理的同时连接的最大数量。不能为内部后端服务设置。

这用于计算组的容量。可用于 CONNECTION 或 UTILIZATION 平衡模式。对于 CONNECTION 模式，必须设置 maxConnections 或 maxConnectionsPerEndpoint。

max_connections_per_instance

整数

单个后端实例可以处理的同时连接的最大数量。不能为内部后端服务设置。

这用于计算组的容量。

可用于 CONNECTION 或 UTILIZATION 平衡模式。

对于 CONNECTION 模式，必须设置 maxConnections 或 maxConnectionsPerInstance。

max_rate

整数

组每秒最大请求数 (RPS)。不能为内部后端服务设置。

可与 RATE 或 UTILIZATION 平衡模式一起使用，但如果使用 RATE 模式则为必需。必须设置 maxRate 或 maxRatePerInstance 或 maxRatePerEndpoint 中的一个，这取决于组类型。

max_rate_per_endpoint

字符串

单个后端网络端点可以处理的每秒最大请求数 (RPS)。这用于计算组的容量。可用于任何平衡模式。对于 RATE 模式，必须设置 maxRate 或 maxRatePerEndpoint。不能为内部后端服务设置。

max_rate_per_instance

字符串

单个后端实例可以处理的每秒最大请求数 (RPS)。这用于计算组的容量。可用于任何平衡模式。对于 RATE 模式，必须设置 maxRate 或 maxRatePerInstance。不能为内部后端服务设置。

max_utilization

字符串

在 balancingMode 为 UTILIZATION 时使用。此比率定义组的 CPU 利用率目标。有效范围为 [0.0, 1.0]。

不能为内部后端服务设置。

cdn_policy

字典

此 BackendService 的 Cloud CDN 配置。

cache_key_policy

字典

此 CdnPolicy 的 CacheKeyPolicy。

include_host

布尔值

如果为 true，则对不同主机的请求将分别缓存。

选项

  • false

  • true

include_protocol

布尔值

如果为 true，则 http 和 https 请求将分别缓存。

选项

  • false

  • true

include_query_string

布尔值

如果为 true，则根据 query_string_whitelist 和 query_string_blacklist 将查询字符串参数包含在缓存键中。如果两者均未设置，则将包含整个查询字符串。

如果为 false，则查询字符串将完全从缓存键中排除。

选项

  • false

  • true

query_string_blacklist

列表 / 元素=字符串

要从缓存键中排除的查询字符串参数的名称。

将包含所有其他参数。指定 query_string_whitelist 或 query_string_blacklist，两者不能同时指定。

‘&’ 和 ‘=’ 将进行百分比编码，不会被视为分隔符。

query_string_whitelist

列表 / 元素=字符串

要包含在缓存键中的查询字符串参数的名称。

将排除所有其他参数。指定 query_string_whitelist 或 query_string_blacklist，两者不能同时指定。

‘&’ 和 ‘=’ 将进行百分比编码，不会被视为分隔符。

cache_mode

字符串

指定此后端所有响应的缓存设置。

可能的值为：USE_ORIGIN_HEADERS、FORCE_CACHE_ALL 和 CACHE_ALL_STATIC。

一些有效选项包括：“USE_ORIGIN_HEADERS”、“FORCE_CACHE_ALL”、“CACHE_ALL_STATIC”

client_ttl

整数

指定此来源提供的缓存内容的最大允许 TTL。

default_ttl

整数

指定此来源提供的缓存内容的默认 TTL，用于没有现有有效 TTL（max-age 或 s-max-age）的响应。

max_ttl

整数

指定此来源提供的缓存内容的最大允许 TTL。

negative_caching

布尔值

负缓存允许设置每个状态码 TTL，以便对常见的错误或重定向应用细粒度的缓存。

选项

  • false

  • true

negative_caching_policy

列表 / 元素=字典

为指定的 HTTP 状态码设置缓存 TTL。必须启用 negativeCaching 才能配置 negativeCachingPolicy。

省略策略并启用 negativeCaching 将使用 Cloud CDN 的默认缓存 TTL。

code

整数

要针对其定义 TTL 的 HTTP 状态码。只能将 HTTP 状态码 300、301、308、404、405、410、421、451 和 501 指定为值，并且不能多次指定状态码。

serve_while_stale

整数

在使用来源重新验证内容时，或在刷新缓存时遇到错误时，从缓存（如果可用）提供现有内容。

signed_url_cache_max_age_sec

整数

对签名 URL 请求的响应将被视为新鲜的最大秒数，默认为 1 小时 (3600 秒)。在此时间段后，将在提供响应之前重新验证响应。

在为签名 URL 请求提供响应时，Cloud CDN 在内部的行为就好像来自此后端的所有响应都具有“Cache-Control: public, max-age=[TTL]”标头一样，而不管任何现有的 Cache-Control 标头如何。响应中提供的实际标头不会更改。

默认值： 3600

circuit_breakers

字典

控制与后端服务的连接量的设置。仅当 `load_balancing_scheme` 设置为 INTERNAL_MANAGED 且 `protocol` 设置为 HTTP、HTTPS 或 HTTP2 时，此字段才适用。

max_connections

整数

与后端集群的最大连接数。

默认为 1024。

默认值： 1024

max_pending_requests

整数

对后端集群的待处理请求的最大数量。

默认为 1024。

默认值： 1024

max_requests

整数

对后端集群的并行请求的最大数量。

默认为 1024。

默认值： 1024

max_requests_per_connection

整数

单个后端连接的最大请求数。HTTP/1.1 和 HTTP/2 实现都遵守此参数。如果未指定，则没有限制。将此参数设置为 1 将有效地禁用保持活动状态。

max_retries

整数

对后端集群的并行重试的最大数量。

默认为 3。

默认值： 3

connection_draining

字典

连接耗尽的设置。

draining_timeout_sec

整数

实例将被耗尽的时间（不接受新连接，但仍努力完成已启动的连接）。

默认值： 300

consistent_hash

字典

基于一致性哈希的负载均衡可用于根据 HTTP 标头、Cookie 或其他属性提供软会话关联。此负载均衡策略仅适用于 HTTP 连接。当一个或多个主机从目标服务中添加/移除时，对特定目标主机的关联将丢失。此字段指定控制一致性哈希的参数。

仅当满足以下所有条件时，此字段才适用 - * `load_balancing_scheme` 设置为 INTERNAL_MANAGED * `protocol` 设置为 HTTP、HTTPS 或 HTTP2 * `locality_lb_policy` 设置为 MAGLEV 或 RING_HASH。

字典

哈希基于 HTTP Cookie。此字段描述将用作一致性哈希负载均衡器的哈希键的 HTTP Cookie。如果 Cookie 不存在，则将生成它。

如果 sessionAffinity 设置为 HTTP_COOKIE，则此字段适用。

字符串

Cookie 的名称。

字符串

为 Cookie 设置的路径。

字典

Cookie 的生命周期。

整数

以纳秒分辨率表示的秒数的一部分。小于一秒的持续时间用 0 秒字段和正纳秒字段表示。必须在 0 到 999,999,999（含）之间。

整数 / 必需

以秒为单位表示的时间跨度。

必须在 0 到 315,576,000,000（含）之间。

http_header_name

字符串

基于指定标头字段的值的哈希。

如果 sessionAffinity 设置为 HEADER_FIELD，则此字段适用。

minimum_ring_size

整数

哈希环要使用的虚拟节点的最小数量。

较大的环尺寸会导致更细粒度的负载分配。如果负载均衡池中的主机数量大于环尺寸，则每个主机将分配一个虚拟节点。

默认为 1024。

默认值： 1024

description

字符串

此资源的可选描述。

enable_cdn

布尔值

如果为 true，则为此 RegionBackendService 启用 Cloud CDN。

选项

  • false

  • true

env_type

字符串

指定您在其中运行此模块的 Ansible 环境。

除非您知道自己在做什么，否则不应设置此项。

这只会更改任何 API 请求的用户代理字符串。

failover_policy

字典

故障转移策略。

disable_connection_drain_on_failover

布尔值

在故障转移或故障恢复时，此字段指示是否将遵守连接耗尽。将其设置为 true 会产生以下效果：不会耗尽对旧活动池的连接。对新活动池的连接使用 10 分钟的超时（当前固定）。设置为 false 会产生以下效果：旧连接和新连接都将具有 10 分钟的耗尽超时。

只有当协议为 TCP 时，才能将其设置为 true。

默认为 false。

选项

  • false

  • true

drop_traffic_if_unhealthy

布尔值

此选项仅在主实例组和备份实例组中未检测到任何运行正常的 VM 时使用。当设置为 true 时，流量将被丢弃。当设置为 false 时，新连接将通过主组中的所有 VM 发送。

默认为 false。

选项

  • false

  • true

failover_ratio

字符串

此字段的值必须在 [0, 1] 中。如果主后端中运行正常的 VM 的比率低于或等于此数字，则到达负载均衡 IP 的流量将被定向到故障转移后端。

如果未设置“failoverRatio”或备份后端中的所有 VM 均不运行正常，则流量将以“强制”模式定向回主后端，其中流量将尽力分散到运行正常的 VM，或者在没有 VM 运行正常时分散到所有 VM。

此字段仅与 L4 负载均衡一起使用。

health_checks

列表 / 元素=字符串

用于健康检查此 RegionBackendService 的 HealthCheck 资源的 URL 集。目前最多可以指定一个健康检查。

除非后端服务使用互联网或无服务器 NEG 作为后端，否则必须指定健康检查。

load_balancing_scheme

字符串

指示此区域后端服务将用于哪种负载均衡。为一种负载均衡类型创建的后端服务不能与其他类型一起使用。

一些有效选项包括：“EXTERNAL”、“INTERNAL”、“INTERNAL_MANAGED”

默认值： "INTERNAL"

locality_lb_policy

字符串

在局部范围内部使用的负载均衡算法。

可能的值为 - * ROUND_ROBIN - 这是一种简单的策略，其中每个运行正常的后端都按循环顺序选择。

* LEAST_REQUEST - 选择两个随机的运行正常的服务器，然后选择活动请求较少的服务器的算法。

* RING_HASH - 环/模哈希负载均衡器对后端实现一致性哈希。该算法具有以下属性：从 N 个主机集中添加/移除主机只会影响 1/N 的请求。

* RANDOM - 负载均衡器选择一个随机的运行正常的服务器。

* ORIGINAL_DESTINATION - 后端主机根据客户端连接元数据选择，即在连接被重定向到负载均衡器之前，连接将打开到与传入连接的目标地址相同的地址。

* MAGLEV - 用作环哈希负载均衡器的直接替代品。

Maglev 不像环哈希那样稳定，但构建时间和主机选择时间更快。有关 Maglev 的更多信息，请参阅 https://ai.google/research/pubs/pub44824 此字段仅当 `load_balancing_scheme` 设置为 INTERNAL_MANAGED 且 `protocol` 设置为 HTTP、HTTPS 或 HTTP2 时才适用。

一些有效选项包括：“ROUND_ROBIN”、“LEAST_REQUEST”、“RING_HASH”、“RANDOM”、“ORIGINAL_DESTINATION”、“MAGLEV”

log_config

字典

此字段表示此后端服务提供的负载均衡流量的日志记录选项。

如果启用了日志记录，则日志将导出到 Stackdriver。

enable

布尔值

是否为由此后端服务提供的负载均衡流量启用日志记录。

选项

  • false

  • true

sample_rate

字符串

只有在此后端服务的日志记录已启用时才能指定此字段。此字段的值必须在 [0, 1] 中。这将配置对负载均衡器的请求的采样率，其中 1.0 表示报告所有已记录的请求，而 0.0 表示不报告任何已记录的请求。

默认值为 1.0。

name

字符串 / 必需

资源的名称。在创建资源时由客户端提供。名称必须为 1-63 个字符长，并符合 RFC1035。具体而言，名称必须为 1-63 个字符长，并与正则表达式 `[a-z]([-a-z0-9]*[a-z0-9])?` 匹配，这意味着第一个字符必须是小写字母，所有后续字符必须是短划线、小写字母或数字，但最后一个字符除外，最后一个字符不能是短划线。

network

字典

此后端服务所属网络的 URL。

只有当负载均衡方案设置为 INTERNAL 时，才能指定此字段。

此字段表示指向 GCP 中网络资源的链接。它可以通过两种方式指定。首先，您可以放置一个键为“selfLink”且值为您的资源的 selfLink 的字典。或者，您可以将 `register: name-of-resource` 添加到 gcp_compute_network 任务中，然后将此 network 字段设置为“{{ name-of-resource }}”

outlier_detection

字典

控制从负载均衡池中逐出不健康主机的设置。

仅当 `load_balancing_scheme` 设置为 INTERNAL_MANAGED 且 `protocol` 设置为 HTTP、HTTPS 或 HTTP2 时，此字段才适用。

base_ejection_time

字典

主机被逐出的基本时间。实际时间等于基本时间乘以主机被逐出的次数。默认为 30000 毫秒或 30 秒。

nanos

整数

以纳秒为单位表示的时间跨度，精度为纳秒级。小于一秒的持续时间用 `seconds` 字段为 0 和 `nanos` 字段为正数来表示。必须在 0 到 999,999,999（含）之间。

seconds

整数 / 必需

以秒为单位表示的时间跨度。必须在 0 到 315,576,000,000（含）之间。

consecutive_errors

整数

主机从连接池中被逐出之前的错误次数。当通过 HTTP 访问后端主机时，5xx 返回代码算作错误。

默认为 5。

默认值： 5

consecutive_gateway_failure

整数

连续网关故障（502、503、504 状态或映射到这些状态码之一的连接错误）的次数，之后会发生连续网关故障逐出。默认为 5。

默认值： 5

enforcing_consecutive_errors

整数

当通过连续的 5xx 检测到异常状态时，主机实际被逐出的概率（百分比）。此设置可用于禁用逐出或缓慢地增加逐出率。默认为 100。

默认值： 100

enforcing_consecutive_gateway_failure

整数

当通过连续的网关故障检测到异常状态时，主机实际被逐出的概率（百分比）。此设置可用于禁用逐出或缓慢地增加逐出率。默认为 0。

enforcing_success_rate

整数

当通过成功率统计检测到异常状态时，主机实际被逐出的概率（百分比）。此设置可用于禁用逐出或缓慢地增加逐出率。默认为 100。

默认值： 100

interval

字典

逐出扫描分析之间的时间间隔。这可能导致新的逐出以及主机返回服务。默认为 10 秒。

nanos

整数

以纳秒为单位表示的时间跨度，精度为纳秒级。小于一秒的持续时间用 `seconds` 字段为 0 和 `nanos` 字段为正数来表示。必须在 0 到 999,999,999（含）之间。

seconds

整数 / 必需

以秒为单位表示的时间跨度。必须在 0 到 315,576,000,000（含）之间。

max_ejection_percent

整数

后端服务的负载均衡池中可以被逐出的主机最大百分比。默认为 10%。

默认值： 10

success_rate_minimum_hosts

整数

集群中必须有足够请求量才能检测到成功率异常的主机数量。如果主机数量小于此设置，则不会对集群中的任何主机执行基于成功率统计的异常检测。默认为 5。

默认值： 5

success_rate_request_volume

整数

在一个区间内（如上所述的区间持续时间）必须收集的总请求的最小数量，才能将此主机包含在基于成功率的异常检测中。如果数量低于此设置，则不会对该主机执行基于成功率统计的异常检测。默认为 100。

默认值： 100

success_rate_stdev_factor

整数

此因子用于确定成功率异常逐出的逐出阈值。逐出阈值是平均成功率与该因子和平均成功率的标准差的乘积之间的差值：平均值 - (标准差 * success_rate_stdev_factor)。此因子除以一千以获得双精度浮点数。也就是说，如果所需的因子是 1.9，则运行时值应为 1900。默认为 1900。

默认值： 1900

port_name

字符串

后端实例组上的命名端口，表示与该组中后端虚拟机的通信端口。当 loadBalancingScheme 为 EXTERNAL、INTERNAL_MANAGED 或 INTERNAL_SELF_MANAGED 且后端为实例组时，需要此端口。命名端口必须在每个后端实例组上定义。如果后端是 NEG，则此参数没有任何意义。如果没有给出，API 将默认设置为“http”。

当 loadBalancingScheme 为 INTERNAL（内部 TCP/UDP 负载均衡）时，必须省略。

project

字符串

要使用的 Google Cloud Platform 项目。

protocol

字符串

此 RegionBackendService 用于与后端通信的协议。

默认为 HTTP。**注意：**HTTP2 仅适用于 Beta 版 HTTP/2 负载均衡器类型，如果与 GA API 一起使用，可能会导致错误。

一些有效的选项包括：“HTTP”、“HTTPS”、“HTTP2”、“SSL”、“TCP”、“UDP”、“GRPC”

region

字符串 / 必需

区域后端服务所在的区域的引用。

scopes

列表 / 元素=字符串

要使用的作用域数组

service_account_contents

jsonarg

服务帐户 JSON 文件的内容，可以是字典或表示它的 JSON 字符串。

service_account_email

字符串

如果选择 machineaccount 并且用户不想使用默认电子邮件，则可以选择的服务帐户电子邮件地址。

service_account_file

path

如果选择 serviceaccount 作为类型，则为服务帐户 JSON 文件的路径。

session_affinity

字符串

要使用的会话关联类型。默认为 NONE。如果协议是 UDP，则会话关联不适用。

一些有效的选项包括：“NONE”、“CLIENT_IP”、“CLIENT_IP_PORT_PROTO”、“CLIENT_IP_PROTO”、“GENERATED_COOKIE”、“HEADER_FIELD”、“HTTP_COOKIE”

state

字符串

给定对象是否应该存在于 GCP 中

选项

  • "present" ← (默认)

  • "absent"

timeout_sec

整数

在将后端视为失败请求之前等待后端多少秒。默认为 30 秒。有效范围是 [1, 86400]。

备注

注意

  • API 参考：https://cloud.google.com/compute/docs/reference/latest/regionBackendServices

  • 内部 TCP/UDP 负载均衡：https://cloud.google.com/compute/docs/load-balancing/internal/

  • 对于身份验证，您可以使用 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: create a health check
  google.cloud.gcp_compute_health_check:
    name: "{{ resource_name }}"
    type: TCP
    tcp_health_check:
      port: 80
    check_interval_sec: 1
    timeout_sec: 1
    project: "{{ gcp_project }}"
    auth_kind: "{{ gcp_cred_kind }}"
    service_account_file: "{{ gcp_cred_file }}"
    state: present
  register: healthcheck

- name: create a region backend service
  google.cloud.gcp_compute_region_backend_service:
    name: test_object
    region: us-central1
    health_checks:
    - "{{ healthcheck.selfLink }}"
    connection_draining:
      draining_timeout_sec: 10
    session_affinity: CLIENT_IP
    project: test_project
    auth_kind: serviceaccount
    service_account_file: "/tmp/auth.pem"
    state: present

返回值

常见的返回值已在 此处 记录，以下是此模块特有的字段

键

描述

affinityCookieTtlSec

整数

如果 session_affinity 为 GENERATED_COOKIE，则为 Cookie 的生命周期（以秒为单位）。如果设置为 0，则 Cookie 为非持久性 Cookie，仅持续到浏览器会话结束（或等效会话结束）。TTL 的最大允许值为一天。

当负载均衡方案为 INTERNAL 时，此字段不用于。

返回：成功

backends

复杂

为该 RegionBackendService 提供服务的后台集合。

返回：成功

balancingMode

字符串

指定此后端的平衡模式。

返回：成功

capacityScaler

字符串

应用于组的最大服务容量（基于 UTILIZATION、RATE 或 CONNECTION）的乘数。

~>**注意**: 此字段不能为内部区域后端服务（默认 loadBalancingScheme）设置，但对于非内部后端服务是必需的。所有后端的总 capacity_scaler 必须非零。

设置为 0 表示该组已完全耗尽，提供 0% 的可用容量。有效范围是 [0.0,1.0]。

返回：成功

description

字符串

此资源的可选描述。

创建资源时提供此属性。

返回：成功

failover

布尔值

此字段指定这是否是故障转移后端。可以为给定的 RegionBackendService 配置多个故障转移后端。

返回：成功

group

字符串

实例组或网络端点组资源的完全限定 URL。对于实例组，这定义了提供流量的实例列表。每个实例组的成员虚拟机实例必须与实例组本身位于同一区域。后端服务的两个后端不允许使用相同的实例组资源。

对于网络端点组，这定义了端点列表。网络端点组的所有端点必须托管在与网络端点组位于同一区域的实例上。

后端服务不能混合实例组和网络端点组后端。

当 `load_balancing_scheme` 为 INTERNAL 时，仅支持实例组。

请注意，您必须使用完全限定的 URL（而不是部分 URL）来指定实例组或网络端点组资源。

返回：成功

maxConnections

整数

组的同时连接的最大数量。可与 CONNECTION 或 UTILIZATION 平衡模式一起使用。

不能为内部后端服务设置。

对于 CONNECTION 模式，必须设置 maxConnections 或 maxConnectionsPerInstance 或 maxConnectionsPerEndpoint 中的一个，这取决于组类型。

返回：成功

maxConnectionsPerEndpoint

整数

单个后端网络端点可以处理的同时连接的最大数量。不能为内部后端服务设置。

这用于计算组的容量。可用于 CONNECTION 或 UTILIZATION 平衡模式。对于 CONNECTION 模式，必须设置 maxConnections 或 maxConnectionsPerEndpoint。

返回：成功

maxConnectionsPerInstance

整数

单个后端实例可以处理的同时连接的最大数量。不能为内部后端服务设置。

这用于计算组的容量。

可用于 CONNECTION 或 UTILIZATION 平衡模式。

对于 CONNECTION 模式，必须设置 maxConnections 或 maxConnectionsPerInstance。

返回：成功

maxRate

整数

组每秒最大请求数 (RPS)。不能为内部后端服务设置。

可与 RATE 或 UTILIZATION 平衡模式一起使用，但如果使用 RATE 模式则为必需。必须设置 maxRate 或 maxRatePerInstance 或 maxRatePerEndpoint 中的一个，这取决于组类型。

返回：成功

maxRatePerEndpoint

字符串

单个后端网络端点可以处理的每秒最大请求数 (RPS)。这用于计算组的容量。可用于任何平衡模式。对于 RATE 模式，必须设置 maxRate 或 maxRatePerEndpoint。不能为内部后端服务设置。

返回：成功

maxRatePerInstance

字符串

单个后端实例可以处理的每秒最大请求数 (RPS)。这用于计算组的容量。可用于任何平衡模式。对于 RATE 模式，必须设置 maxRate 或 maxRatePerInstance。不能为内部后端服务设置。

返回：成功

maxUtilization

字符串

在 balancingMode 为 UTILIZATION 时使用。此比率定义组的 CPU 利用率目标。有效范围为 [0.0, 1.0]。

不能为内部后端服务设置。

返回：成功

cdnPolicy

复杂

此 BackendService 的 Cloud CDN 配置。

返回：成功

cacheKeyPolicy

复杂

此 CdnPolicy 的 CacheKeyPolicy。

返回：成功

includeHost

布尔值

如果为 true，则对不同主机的请求将分别缓存。

返回：成功

includeProtocol

布尔值

如果为 true，则 http 和 https 请求将分别缓存。

返回：成功

includeQueryString

布尔值

如果为 true，则根据 query_string_whitelist 和 query_string_blacklist 将查询字符串参数包含在缓存键中。如果两者均未设置，则将包含整个查询字符串。

如果为 false，则查询字符串将完全从缓存键中排除。

返回：成功

queryStringBlacklist

列表 / 元素=字符串

要从缓存键中排除的查询字符串参数的名称。

将包含所有其他参数。指定 query_string_whitelist 或 query_string_blacklist，两者不能同时指定。

‘&’ 和 ‘=’ 将进行百分比编码，不会被视为分隔符。

返回：成功

queryStringWhitelist

列表 / 元素=字符串

要包含在缓存键中的查询字符串参数的名称。

将排除所有其他参数。指定 query_string_whitelist 或 query_string_blacklist，两者不能同时指定。

‘&’ 和 ‘=’ 将进行百分比编码，不会被视为分隔符。

返回：成功

cacheMode

字符串

指定此后端所有响应的缓存设置。

可能的值为：USE_ORIGIN_HEADERS、FORCE_CACHE_ALL 和 CACHE_ALL_STATIC。

返回：成功

clientTtl

整数

指定此来源提供的缓存内容的最大允许 TTL。

返回：成功

defaultTtl

整数

指定此来源提供的缓存内容的默认 TTL，用于没有现有有效 TTL（max-age 或 s-max-age）的响应。

返回：成功

maxTtl

整数

指定此来源提供的缓存内容的最大允许 TTL。

返回：成功

negativeCaching

布尔值

负缓存允许设置每个状态码 TTL，以便对常见的错误或重定向应用细粒度的缓存。

返回：成功

negativeCachingPolicy

复杂

为指定的 HTTP 状态码设置缓存 TTL。必须启用 negativeCaching 才能配置 negativeCachingPolicy。

省略策略并启用 negativeCaching 将使用 Cloud CDN 的默认缓存 TTL。

返回：成功

code

整数

要针对其定义 TTL 的 HTTP 状态码。只能将 HTTP 状态码 300、301、308、404、405、410、421、451 和 501 指定为值，并且不能多次指定状态码。

返回：成功

serveWhileStale

整数

在使用来源重新验证内容时，或在刷新缓存时遇到错误时，从缓存（如果可用）提供现有内容。

返回：成功

signedUrlCacheMaxAgeSec

整数

对签名 URL 请求的响应将被视为新鲜的最大秒数，默认为 1 小时 (3600 秒)。在此时间段后，将在提供响应之前重新验证响应。

在为签名 URL 请求提供响应时，Cloud CDN 在内部的行为就好像来自此后端的所有响应都具有“Cache-Control: public, max-age=[TTL]”标头一样，而不管任何现有的 Cache-Control 标头如何。响应中提供的实际标头不会更改。

返回：成功

circuitBreakers

复杂

控制与后端服务的连接量的设置。仅当 `load_balancing_scheme` 设置为 INTERNAL_MANAGED 且 `protocol` 设置为 HTTP、HTTPS 或 HTTP2 时，此字段才适用。

返回：成功

maxConnections

整数

与后端集群的最大连接数。

默认为 1024。

返回：成功

maxPendingRequests

整数

对后端集群的待处理请求的最大数量。

默认为 1024。

返回：成功

maxRequests

整数

对后端集群的并行请求的最大数量。

默认为 1024。

返回：成功

maxRequestsPerConnection

整数

单个后端连接的最大请求数。HTTP/1.1 和 HTTP/2 实现都遵守此参数。如果未指定，则没有限制。将此参数设置为 1 将有效地禁用保持活动状态。

返回：成功

maxRetries

整数

对后端集群的并行重试的最大数量。

默认为 3。

返回：成功

connectionDraining

复杂

连接耗尽的设置。

返回：成功

drainingTimeoutSec

整数

实例将被耗尽的时间（不接受新连接，但仍努力完成已启动的连接）。

返回：成功

consistentHash

复杂

基于一致性哈希的负载均衡可用于根据 HTTP 标头、Cookie 或其他属性提供软会话关联。此负载均衡策略仅适用于 HTTP 连接。当一个或多个主机从目标服务中添加/移除时，对特定目标主机的关联将丢失。此字段指定控制一致性哈希的参数。

仅当满足以下所有条件时，此字段才适用 - * `load_balancing_scheme` 设置为 INTERNAL_MANAGED * `protocol` 设置为 HTTP、HTTPS 或 HTTP2 * `locality_lb_policy` 设置为 MAGLEV 或 RING_HASH。

返回：成功

httpCookie

复杂

哈希基于 HTTP Cookie。此字段描述将用作一致性哈希负载均衡器的哈希键的 HTTP Cookie。如果 Cookie 不存在，则将生成它。

如果 sessionAffinity 设置为 HTTP_COOKIE，则此字段适用。

返回：成功

name

字符串

Cookie 的名称。

返回：成功

path

字符串

为 Cookie 设置的路径。

返回：成功

ttl

复杂

Cookie 的生命周期。

返回：成功

nanos

整数

以纳秒分辨率表示的秒数的一部分。小于一秒的持续时间用 0 秒字段和正纳秒字段表示。必须在 0 到 999,999,999（含）之间。

返回：成功

seconds

整数

以秒为单位表示的时间跨度。

必须在 0 到 315,576,000,000（含）之间。

返回：成功

httpHeaderName

字符串

基于指定标头字段的值的哈希。

如果 sessionAffinity 设置为 HEADER_FIELD，则此字段适用。

返回：成功

minimumRingSize

整数

哈希环要使用的虚拟节点的最小数量。

较大的环尺寸会导致更细粒度的负载分配。如果负载均衡池中的主机数量大于环尺寸，则每个主机将分配一个虚拟节点。

默认为 1024。

返回：成功

creationTimestamp

字符串

以 RFC3339 文本格式表示的创建时间戳。

返回：成功

description

字符串

此资源的可选描述。

返回：成功

enableCDN

布尔值

如果为 true，则为此 RegionBackendService 启用 Cloud CDN。

返回：成功

failoverPolicy

复杂

故障转移策略。

返回：成功

disableConnectionDrainOnFailover

布尔值

在故障转移或故障恢复时，此字段指示是否将遵守连接耗尽。将其设置为 true 会产生以下效果：不会耗尽对旧活动池的连接。对新活动池的连接使用 10 分钟的超时（当前固定）。设置为 false 会产生以下效果：旧连接和新连接都将具有 10 分钟的耗尽超时。

只有当协议为 TCP 时，才能将其设置为 true。

默认为 false。

返回：成功

dropTrafficIfUnhealthy

布尔值

此选项仅在主实例组和备份实例组中未检测到任何运行正常的 VM 时使用。当设置为 true 时，流量将被丢弃。当设置为 false 时，新连接将通过主组中的所有 VM 发送。

默认为 false。

返回：成功

failoverRatio

字符串

此字段的值必须在 [0, 1] 中。如果主后端中运行正常的 VM 的比率低于或等于此数字，则到达负载均衡 IP 的流量将被定向到故障转移后端。

如果未设置“failoverRatio”或备份后端中的所有 VM 均不运行正常，则流量将以“强制”模式定向回主后端，其中流量将尽力分散到运行正常的 VM，或者在没有 VM 运行正常时分散到所有 VM。

此字段仅与 L4 负载均衡一起使用。

返回：成功

fingerprint

字符串

此资源的指纹。此对象中存储的内容的哈希值。此字段用于乐观锁。

返回：成功

healthChecks

列表 / 元素=字符串

用于健康检查此 RegionBackendService 的 HealthCheck 资源的 URL 集。目前最多可以指定一个健康检查。

除非后端服务使用互联网或无服务器 NEG 作为后端，否则必须指定健康检查。

返回：成功

id

整数

资源的唯一标识符。

返回：成功

loadBalancingScheme

字符串

指示此区域后端服务将用于哪种负载均衡。为一种负载均衡类型创建的后端服务不能与其他类型一起使用。

返回：成功

localityLbPolicy

字符串

在局部范围内部使用的负载均衡算法。

可能的值为 - * ROUND_ROBIN - 这是一种简单的策略，其中每个运行正常的后端都按循环顺序选择。

* LEAST_REQUEST - 选择两个随机的运行正常的服务器，然后选择活动请求较少的服务器的算法。

* RING_HASH - 环/模哈希负载均衡器对后端实现一致性哈希。该算法具有以下属性：从 N 个主机集中添加/移除主机只会影响 1/N 的请求。

* RANDOM - 负载均衡器选择一个随机的运行正常的服务器。

* ORIGINAL_DESTINATION - 后端主机根据客户端连接元数据选择，即在连接被重定向到负载均衡器之前，连接将打开到与传入连接的目标地址相同的地址。

* MAGLEV - 用作环哈希负载均衡器的直接替代品。

Maglev 不像环哈希那样稳定，但构建时间和主机选择时间更快。有关 Maglev 的更多信息，请参阅 https://ai.google/research/pubs/pub44824 此字段仅当 `load_balancing_scheme` 设置为 INTERNAL_MANAGED 且 `protocol` 设置为 HTTP、HTTPS 或 HTTP2 时才适用。

返回：成功

logConfig

复杂

此字段表示此后端服务提供的负载均衡流量的日志记录选项。

如果启用了日志记录，则日志将导出到 Stackdriver。

返回：成功

enable

布尔值

是否为由此后端服务提供的负载均衡流量启用日志记录。

返回：成功

sampleRate

字符串

只有在此后端服务的日志记录已启用时才能指定此字段。此字段的值必须在 [0, 1] 中。这将配置对负载均衡器的请求的采样率，其中 1.0 表示报告所有已记录的请求，而 0.0 表示不报告任何已记录的请求。

默认值为 1.0。

返回：成功

name

字符串

资源的名称。在创建资源时由客户端提供。名称必须为 1-63 个字符长，并符合 RFC1035。具体而言，名称必须为 1-63 个字符长，并与正则表达式 `[a-z]([-a-z0-9]*[a-z0-9])?` 匹配，这意味着第一个字符必须是小写字母，所有后续字符必须是短划线、小写字母或数字，但最后一个字符除外，最后一个字符不能是短划线。

返回：成功

network

字典

此后端服务所属网络的 URL。

只有当负载均衡方案设置为 INTERNAL 时，才能指定此字段。

返回：成功

outlierDetection

复杂

控制从负载均衡池中逐出不健康主机的设置。

仅当 `load_balancing_scheme` 设置为 INTERNAL_MANAGED 且 `protocol` 设置为 HTTP、HTTPS 或 HTTP2 时，此字段才适用。

返回：成功

baseEjectionTime

复杂

主机被逐出的基本时间。实际时间等于基本时间乘以主机被逐出的次数。默认为 30000 毫秒或 30 秒。

返回：成功

nanos

整数

以纳秒为单位表示的时间跨度，精度为纳秒级。小于一秒的持续时间用 `seconds` 字段为 0 和 `nanos` 字段为正数来表示。必须在 0 到 999,999,999（含）之间。

返回：成功

seconds

整数

以秒为单位表示的时间跨度。必须在 0 到 315,576,000,000（含）之间。

返回：成功

consecutiveErrors

整数

主机从连接池中被逐出之前的错误次数。当通过 HTTP 访问后端主机时，5xx 返回代码算作错误。

默认为 5。

返回：成功

consecutiveGatewayFailure

整数

连续网关故障（502、503、504 状态或映射到这些状态码之一的连接错误）的次数，之后会发生连续网关故障逐出。默认为 5。

返回：成功

enforcingConsecutiveErrors

整数

当通过连续的 5xx 检测到异常状态时，主机实际被逐出的概率（百分比）。此设置可用于禁用逐出或缓慢地增加逐出率。默认为 100。

返回：成功

enforcingConsecutiveGatewayFailure

整数

当通过连续的网关故障检测到异常状态时，主机实际被逐出的概率（百分比）。此设置可用于禁用逐出或缓慢地增加逐出率。默认为 0。

返回：成功

enforcingSuccessRate

整数

当通过成功率统计检测到异常状态时，主机实际被逐出的概率（百分比）。此设置可用于禁用逐出或缓慢地增加逐出率。默认为 100。

返回：成功

interval

复杂

逐出扫描分析之间的时间间隔。这可能导致新的逐出以及主机返回服务。默认为 10 秒。

返回：成功

nanos

整数

以纳秒为单位表示的时间跨度，精度为纳秒级。小于一秒的持续时间用 `seconds` 字段为 0 和 `nanos` 字段为正数来表示。必须在 0 到 999,999,999（含）之间。

返回：成功

seconds

整数

以秒为单位表示的时间跨度。必须在 0 到 315,576,000,000（含）之间。

返回：成功

maxEjectionPercent

整数

后端服务的负载均衡池中可以被逐出的主机最大百分比。默认为 10%。

返回：成功

successRateMinimumHosts

整数

集群中必须有足够请求量才能检测到成功率异常的主机数量。如果主机数量小于此设置，则不会对集群中的任何主机执行基于成功率统计的异常检测。默认为 5。

返回：成功

successRateRequestVolume

整数

在一个区间内（如上所述的区间持续时间）必须收集的总请求的最小数量，才能将此主机包含在基于成功率的异常检测中。如果数量低于此设置，则不会对该主机执行基于成功率统计的异常检测。默认为 100。

返回：成功

successRateStdevFactor

整数

此因子用于确定成功率异常逐出的逐出阈值。逐出阈值是平均成功率与该因子和平均成功率的标准差的乘积之间的差值：平均值 - (标准差 * success_rate_stdev_factor)。此因子除以一千以获得双精度浮点数。也就是说，如果所需的因子是 1.9，则运行时值应为 1900。默认为 1900。

返回：成功

portName

字符串

后端实例组上的命名端口，表示与该组中后端虚拟机的通信端口。当 loadBalancingScheme 为 EXTERNAL、INTERNAL_MANAGED 或 INTERNAL_SELF_MANAGED 且后端为实例组时，需要此端口。命名端口必须在每个后端实例组上定义。如果后端是 NEG，则此参数没有任何意义。如果没有给出，API 将默认设置为“http”。

当 loadBalancingScheme 为 INTERNAL（内部 TCP/UDP 负载均衡）时，必须省略。

返回：成功

protocol

字符串

此 RegionBackendService 用于与后端通信的协议。

默认为 HTTP。**注意：**HTTP2 仅适用于 Beta 版 HTTP/2 负载均衡器类型，如果与 GA API 一起使用，可能会导致错误。

返回：成功

region

字符串

区域后端服务所在的区域的引用。

返回：成功

sessionAffinity

字符串

要使用的会话关联类型。默认为 NONE。如果协议是 UDP，则会话关联不适用。

返回：成功

timeoutSec

整数

在将后端视为失败请求之前等待后端多少秒。默认为 30 秒。有效范围是 [1, 86400]。

返回：成功

作者

  • Google Inc. (@googlecloudplatform)