REST Resource: projects.locations.gateways

资源：网关

网关表示代理（通常是负载均衡器）的配置。它捕获代理公开服务的 ip:port 以及所有政策配置。路由会引用网关，以规定通过此网关路由请求的方式。下一个 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

必需。网关资源的名称。它与模式 projects/*/locations/*/gateways/<gateway_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)

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

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

string

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

enum (Type)

不可变。客户管理网关的类型。此字段为必填字段。如果未指定，则会返回错误。
addresses[]

string

可选。网关将用来接收流量的零个或一个 IPv4 或 IPv6 地址。如果未提供地址，系统会分配子网中的 IP

此字段仅适用于“SECURE_WEB_GATEWAY”类型的网关。“OPEN_MESH”类型的网关在 0.0.0.0 上监听 IPv4，在 :: 上监听 IPv6。
ports[]

integer

必需。一个或多个端口号 (1-65535)，网关将通过这些端口号接收流量。代理会绑定到指定的端口。“SECURE_WEB_GATEWAY”类型的网关仅限 1 个端口。“OPEN_MESH”类型的网关在 0.0.0.0 上监听 IPv4，在 :: 上监听 IPv6，并且支持多个端口。
scope

string

可选。范围决定了如何合并多个网关实例的配置。具有相同范围的多个网关实例的配置将合并为代理/负载均衡器的单个配置。

长度上限为 64 个字符。范围应以字母开头，且只能包含字母、数字和连字符。
serverTlsPolicy

string

可选。完全限定的 ServerTLSPolicy 网址引用。指定 TLS 流量的终止方式。如果留空，系统会停用 TLS 终结。
certificateUrls[]

string

可选。完全限定证书网址参考。在建立 TLS 连接时，代理提供证书（基于 SNI 选择）。此功能仅适用于“SECURE_WEB_GATEWAY”类型的网关。
gatewaySecurityPolicy

string

可选。完全限定的 GatewaySecurityPolicy 网址引用。定义服务器应如何将安全政策应用于入站（虚拟机到代理）发起的连接。

例如：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

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

delete

 删除单个网关。

get

 获取单个网关的详细信息。

list

 列出给定项目和位置中的网关。

patch

 更新单个网关的参数。

setIamPolicy

 设置对指定资源的访问权限控制政策。

testIamPermissions

 返回调用者对指定资源拥有的权限。