REST Resource: projects.locations.serviceLbPolicies

资源:ServiceLbPolicy

ServiceLbPolicy 包含可应用于 BackendService 的全球负载均衡和流量分配配置。

JSON 表示法
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "description": string,
  "loadBalancingAlgorithm": enum (LoadBalancingAlgorithm),
  "autoCapacityDrain": {
    object (AutoCapacityDrain)
  },
  "failoverConfig": {
    object (FailoverConfig)
  }
}
字段
name

string

必需。ServiceLbPolicy 资源的名称。它与模式 projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name} 匹配。

createTime

string (Timestamp format)

仅限输出。创建此资源时的时间戳。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

仅限输出。上次更新此资源时的时间戳。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

labels

map (key: string, value: string)

可选。与 ServiceLbPolicy 资源关联的标签标记集。

包含一系列 "key": value 对的对象。示例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

description

string

可选。资源的自由文本说明。长度上限为 1024 个字符。

loadBalancingAlgorithm

enum (LoadBalancingAlgorithm)

可选。要使用的负载均衡算法的类型。默认行为是 WATERFALL_BY_REGION。

autoCapacityDrain

object (AutoCapacityDrain)

可选。用于自动为关联后端服务的健康状况不佳的 IG/NEG 转移流量的配置。

failoverConfig

object (FailoverConfig)

可选。与基于运行状况的故障切换相关的配置。

LoadBalancingAlgorithm

要使用的全球负载均衡算法。

枚举
LOAD_BALANCING_ALGORITHM_UNSPECIFIED 未指定负载均衡算法的类型。
SPRAY_TO_WORLD 根据容量按比例平衡全球所有后端的流量。
SPRAY_TO_REGION 将流量定向到具有端点和容量的最近区域,然后再溢出到其他区域,并将来自每个客户端的流量分配到一个区域中的所有 MIG/NEG。
WATERFALL_BY_REGION 将流量定向到具有端点和容量的最近区域,然后再溢出到其他区域。同一区域内的所有 MIG/NEG 都会均匀加载,但每个客户端可能不会将流量分散到该区域中的所有 MIG/NEG。
WATERFALL_BY_ZONE 尽量将流量保留在最靠近客户端的一个可用区中,然后再溢出到其他可用区。

AutoCapacityDrain

用于指定是否应考虑将运行状况不佳的 IG/NEG 用于全球负载均衡和流量路由的选项。

JSON 表示法
{
  "enable": boolean
}
字段
enable

boolean

可选。如果设置为“True”,则运行状况不佳的 IG/NEG 将被设置为已排空。- 如果 IG/NEG 中运行状况良好的实例/端点少于 25%,则 IG/NEG 被视为运行状况不佳。- 此选项绝不会导致为后端服务排空超过 50% 的已配置 IG/NEG。

FailoverConfig

用于指定基于运行状况的故障切换行为的选项。这与网络负载均衡器 FailoverPolicy 无关。

JSON 表示法
{
  "failoverHealthThreshold": integer
}
字段
failoverHealthThreshold

integer

可选。负载均衡器将开始向故障切换后端发送流量的百分比阈值。如果 MIG/NEG 中的端点百分比小于此值,则系统会尽可能将流量发送到故障切换后端。此字段应设置为 1 到 99 之间的值。全球外部 HTTP(S) 负载均衡器(传统版)和无代理服务网格的默认值为 50,其他的默认值为 70。

方法

create

在给定的项目和位置中创建新的 ServiceLbPolicy。

delete

删除单个 ServiceLbPolicy。

get

获取单个 ServiceLbPolicy 的详细信息。

list

列出给定项目和位置的 ServiceLbPolicies。

patch

更新单个 ServiceLbPolicy 的参数。