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 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

僅供輸出。這項資源上次更新時間的時間戳記。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如:"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 視為健康狀態不良。- 這個選項不會導致後端服務的 IGs/NEGs 耗用量超過 50%。

FailoverConfig

指定以健康狀態為準的容錯移轉行為的選項。這與網路負載平衡器的 FailoverPolicy 無關。

JSON 表示法
{
  "failoverHealthThreshold": integer
}
欄位
failoverHealthThreshold

integer

(非必要) 達到這個百分比門檻之後,負載平衡器就會開始將流量傳送至容錯移轉後端。如果 MIG/NEG 中的端點百分比小於這個值,系統會盡可能將流量傳送至備援後端。這個欄位應設為介於 1 至 99 之間的值。全域外部 HTTP(S) 負載平衡器 (傳統版) 和無 Proxy 服務網格預設值為 50,其他則為 70。

方法

create

在指定專案和位置中建立新的 ServiceLbPolicy。

delete

刪除單一 ServiceLbPolicy。

get

取得單一 ServiceLbPolicy 的詳細資料。

getIamPolicy

取得資源的存取權控管政策。

list

列出指定專案和位置中的 ServiceLbPolicies。

patch

更新單一 ServiceLbPolicy 的參數。

setIamPolicy

設定指定資源的存取權控管政策。

testIamPermissions

傳回呼叫者在指定資源上擁有的權限。