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)
  },
  "isolationConfig": {
    object (IsolationConfig)
  }
}
欄位
name

string

ID。ServiceLbPolicy 資源的名稱。符合模式 projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_name}。
createTime

string (Timestamp format)

僅供輸出。這項資源的建立時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

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

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
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)

(非必要) 與健康狀態容錯移轉相關的設定。
isolationConfig

object (IsolationConfig)

(非必要) 為相關聯的後端服務提供隔離支援功能的設定。

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。

IsolationConfig

為相關聯的後端服務提供隔離支援功能的設定。

JSON 表示法 
{
  "isolationGranularity": enum (IsolationGranularity)
}
欄位
isolationGranularity

enum (IsolationGranularity)

(非必要) 負載平衡器的隔離精細程度。

IsolationGranularity

此隔離限制的精細程度。

列舉
ISOLATION_GRANULARITY_UNSPECIFIED 未為後端服務設定隔離機制。流量可能會根據負載平衡演算法溢出。
REGION 這項服務的流量會在最近的雲端區域中隔離。

方法

create

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

delete

 刪除單一 ServiceLbPolicy。

get

 取得單一 ServiceLbPolicy 的詳細資料。

getIamPolicy

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

list

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

patch

 更新單一 ServiceLbPolicy 的參數。

setIamPolicy

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

testIamPermissions

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