REST Resource: projects.locations.gateways

リソース: Gateway

Gateway は、プロキシの構成を表します(通常はロードバランサ)。Gateway は、サービスがプロキシで公開される ip:port とポリシー構成を取得します。ルートには、リクエストがこの Gateway でルーティングされる方法を指定するために、Gateway への参照があります。次の ID: 33

JSON 表現
{
  "name": string,
  "selfLink": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "description": string,
  "type": enum (Type),
  "addresses": [
    string
  ],
  "ports": [
    integer
  ],
  "scope": string,
  "serverTlsPolicy": string,
  "certificateUrls": [
    string
  ],
  "gatewaySecurityPolicy": string,
  "network": string,
  "subnetwork": string,
  "ipVersion": enum (IpVersion),
  "envoyHeaders": enum (EnvoyHeaders)
}
フィールド
name

string

必須。Gateway リソースの名前。パターン projects/*/locations/*/gateways/<gateway_name> と一致します。

createTime

string (Timestamp format)

出力専用。リソース作成時のタイムスタンプ。

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

updateTime

string (Timestamp format)

出力専用。リソース最終更新時のタイムスタンプ。

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

labels

map (key: string, value: string)

省略可。Gateway リソースに関連付けられたラベルタグのセット。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

description

string

省略可。リソースのフリーテキストによる説明。最大長は 1,024 文字です。

type

enum (Type)

変更不可。顧客管理のゲートウェイのタイプ。このフィールドは必須です。指定しない場合はエラーが返されます。

addresses[]

string

省略可。Gateway がトラフィックを受信する IPv4 アドレスまたは IPv6 アドレス(0 個または 1 個)。アドレスが指定されていない場合、サブネットワークの IP が割り振られます。

このフィールドは、'SECURE_WEB_GATEWAY' タイプのゲートウェイにのみ適用されます。'OPEN_MESH' タイプのゲートウェイは、IPv4 では 0.0.0.0、IPv6 では :: をリッスンします。

ports[]

integer

必須。Gateway がトラフィックを受信する 1 つ以上のポート番号(1~65535)。プロキシは、指定されたポートにバインドされます。'SECURE_WEB_GATEWAY' タイプの Gateway は 1 ポートに制限されます。'OPEN_MESH' タイプのゲートウェイは、IPv4 では 0.0.0.0、IPv6 では :: をリッスンし、複数のポートをサポートします。

scope

string

省略可。スコープは、複数の Gateway インスタンスの構成を統合する方法を示します。同じスコープを持つ複数の Gateway インスタンスの構成は、プロキシ / ロードバランサに対する単一の構成として統合されます。

最大 64 文字です。スコープは文字で始まり、文字、数字、ハイフンのみを使用できます。

serverTlsPolicy

string

省略可。ServerTLSPolicy の完全修飾 URL リファレンス。TLS トラフィックの終端方法を指定します。空の場合、TLS 終端は無効になります。

certificateUrls[]

string

省略可。Certificates の完全修飾 URL リファレンス。プロキシは、TLS 接続の確立時に Certificate(SNI に基づいて選択)を提示します。この機能は、'SECURE_WEB_GATEWAY' タイプのゲートウェイにのみ適用されます。

gatewaySecurityPolicy

string

省略可。GatewaySecurityPolicy の完全修飾 URL リファレンス。サーバーが、受信(VM からプロキシ)によって開始された接続にセキュリティ ポリシーを適用する方法を定義します。

例: projects/*/locations/*/gatewaySecurityPolicies/swg-policy

このポリシーは、'SECURE_WEB_GATEWAY' タイプのゲートウェイに固有のものです。

network

string

省略可。この構成を使用している VPC ネットワークを識別する関連リソース名。例: projects/*/global/networks/network-1

現在、このフィールドは 'SECURE_WEB_GATEWAY' タイプのゲートウェイに固有のものです。

subnetwork

string

省略可。この SWG が割り振られているサブネットワークを識別する関連リソース名。例: projects/*/regions/us-central1/subnetworks/network-1

現在、このフィールドは 'SECURE_WEB_GATEWAY' タイプのゲートウェイに固有のものです。

ipVersion

enum (IpVersion)

省略可。このゲートウェイで使用される IP バージョン。有効なオプションは IPV4 または IPV6 です。デフォルトは IPV4 です。

envoyHeaders

enum (EnvoyHeaders)

省略可。envoy が内部デバッグ ヘッダーをアップストリーム リクエストに挿入するかどうかを指定します。他の Envoy ヘッダーが挿入される可能性もあります。デフォルトでは、envoy はデバッグ ヘッダーを挿入しません。

タイプ

顧客管理のゲートウェイのタイプ。有効な値は、* OPEN_MESH * SECURE_WEB_GATEWAY です。

列挙型
TYPE_UNSPECIFIED 顧客管理のゲートウェイのタイプは指定されていません。
OPEN_MESH 顧客管理のゲートウェイのタイプは TrafficDirector Open Mesh です。
SECURE_WEB_GATEWAY 顧客管理のゲートウェイのタイプは SecureWebGateway(SWG)です。

IpVersion

ゲートウェイの IP バージョンのタイプ。有効な値は、* IPV4 * IPV6 です。

列挙型
IP_VERSION_UNSPECIFIED IP バージョンが指定されていない場合のタイプ。デフォルトは IPV4 です。
IPV4 IP バージョン 4 のタイプ。
IPV6 IP バージョン 6 のタイプ。

メソッド

create

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

delete

1 つの Gateway を削除します。

get

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

list

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

patch

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