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)

出力専用。この ServiceLbPolicy リソースが作成されたときのタイムスタンプ。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

出力専用。この ServiceLbPolicy リソースが最後に更新されたタイムスタンプ。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "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

省略可。リソースの説明（フリーテキスト）。最大長は 1,024 文字です。
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 は異常とみなされます。- このオプションでは、バックエンド サービスに構成された IG/NEG の 50% を超えてドレインされることはありません。

FailoverConfig

ヘルスベースのフェイルオーバーの動作を指定するためのオプション。これは、ネットワーク ロードバランサの FailoverPolicy とは関係ありません。

JSON 表現 
{
  "failoverHealthThreshold": integer
}
フィールド
failoverHealthThreshold

integer

省略可。ロードバランサがフェイルオーバー バックエンドにトラフィックの送信を開始するしきい値の割合。MIG/NEG のエンドポイントの割合がこの値よりも小さい場合、可能であれば、トラフィックはフェイルオーバー バックエンドに送信されます。このフィールドには 1～99 の値を設定する必要があります。デフォルト値は、グローバル外部 HTTP(S) ロードバランサ（従来）とプロキシレス サービス メッシュの場合は 50、それ以外は 70 です。

メソッド

create

 指定されたプロジェクトとロケーションで新しい ServiceLbPolicy を作成します。

delete

 1 つの ServiceLbPolicy を削除します。

get

 1 つの ServiceLbPolicy の詳細を取得します。

list

 指定されたプロジェクトとロケーションの ServiceLbPolicy を一覧で表示します。

patch

 単一の ServiceLbPolicy のパラメータを更新します。