REST Resource: projects.locations.gateways

Recurso: Gateway

Gateway representa la configuración de un proxy, normalmente un balanceador de carga. Recoge la dirección IP y el puerto a través de los cuales el proxy expone los servicios, junto con las configuraciones de políticas. Las rutas hacen referencia a las pasarelas para determinar cómo debe enrutar las solicitudes esta pasarela. ID siguiente: 33

Representación 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)
}
Campos
name

string

Obligatorio. Nombre del recurso Gateway. Coincide con el patrón projects/*/locations/*/gateways/<gateway_name>.
createTime

string (Timestamp format)

Solo de salida. Marca de tiempo de creación del recurso.

Marca de tiempo en formato RFC3339 UTC "Zulu", con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Solo de salida. Marca de tiempo de la última actualización del recurso.

Marca de tiempo en formato RFC3339 UTC "Zulu", con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

Opcional. Conjunto de etiquetas asociadas al recurso Gateway.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }
description

string

Opcional. Descripción de texto libre del recurso. La longitud máxima es de 1024 caracteres.
type

enum (Type)

Inmutable. Tipo de la pasarela gestionada por el cliente. Este campo es obligatorio. En caso de que no se especifique ninguno, se muestra un error.
addresses[]

string

Opcional. Cero o una dirección IPv4 o IPv6 en la que la pasarela recibirá el tráfico. Si no se proporciona ninguna dirección, se asigna una IP de la subred.

Este campo solo se aplica a las pasarelas de tipo "SECURE_WEB_GATEWAY". Las pasarelas de tipo "OPEN_MESH" escuchan en 0.0.0.0 para IPv4 y en :: para IPv6.
ports[]

integer

Obligatorio. Uno o varios números de puerto (del 1 al 65535) en los que la pasarela recibirá tráfico. El proxy se vincula a los puertos especificados. Las pasarelas de tipo "SECURE_WEB_GATEWAY" están limitadas a un puerto. Las pasarelas de tipo "OPEN_MESH" escuchan en 0.0.0.0 para IPv4 y en :: para IPv6, y admiten varios puertos.
scope

string

Opcional. El ámbito determina cómo se combina la configuración de varias instancias de Gateway. La configuración de varias instancias de Gateway con el mismo ámbito se combinará y se presentará como una sola configuración al proxy o al balanceador de carga.

La longitud máxima es de 64 caracteres. El ámbito debe empezar por una letra y solo puede contener letras, números y guiones.
serverTlsPolicy

string

Opcional. Referencia de URL de ServerTlsPolicy completa. Especifica cómo se termina el tráfico TLS. Si está vacío, la terminación TLS se inhabilita.
certificateUrls[]

string

Opcional. Una referencia de URL de certificados completa. El proxy presenta un certificado (seleccionado en función de SNI) al establecer una conexión TLS. Esta función solo se aplica a las pasarelas de tipo "SECURE_WEB_GATEWAY".
gatewaySecurityPolicy

string

Opcional. Referencia de URL completa de GatewaySecurityPolicy. Define cómo debe aplicar un servidor la política de seguridad a las conexiones iniciadas entrantes (de la VM al proxy).

Por ejemplo: projects/*/locations/*/gatewaySecurityPolicies/swg-policy.

Esta política es específica de las pasarelas de tipo "SECURE_WEB_GATEWAY".
network

string

Opcional. Nombre de recurso relativo que identifica la red de VPC que usa esta configuración. Por ejemplo: projects/*/global/networks/network-1.

Actualmente, este campo es específico de las pasarelas de tipo "SECURE_WEB_GATEWAY".
subnetwork

string

Opcional. Nombre de recurso relativo que identifica la subred en la que se asigna este SWG. Por ejemplo: projects/*/regions/us-central1/subnetworks/network-1

Actualmente, este campo es específico de las pasarelas de tipo "SECURE_WEB_GATEWAY".
ipVersion

enum (IpVersion)

Opcional. La versión de IP que usará esta pasarela. Las opciones válidas son IPV4 o IPV6. El valor predeterminado es IPv4.
envoyHeaders

enum (EnvoyHeaders)

Opcional. Determina si Envoy insertará encabezados de depuración internos en las solicitudes ascendentes. Es posible que se sigan insertando otras cabeceras de Envoy. De forma predeterminada, Envoy no insertará ningún encabezado de depuración.

Tipo

Tipo de la pasarela gestionada por el cliente. Los valores posibles son: * OPEN_MESH * SECURE_WEB_GATEWAY

Enumeraciones
TYPE_UNSPECIFIED No se ha especificado el tipo de la pasarela gestionada por el cliente.
OPEN_MESH El tipo de la gateway gestionada por el cliente es Traffic Director Open Mesh.
SECURE_WEB_GATEWAY El tipo de la pasarela gestionada por el cliente es SecureWebGateway (SWG).

IpVersion

Los tipos de versión de IP de la pasarela. Los valores posibles son: * IPV4 * IPV6

Enumeraciones
IP_VERSION_UNSPECIFIED El tipo cuando no se especifica la versión de IP. El valor predeterminado es IPV4.
IPV4 El tipo de la versión 4 de IP.
IPV6 El tipo de la versión 6 de IP.

Métodos

create

 Crea una pasarela en un proyecto y una ubicación determinados.

delete

 Elimina un recurso Gateway.

get

 Obtiene los detalles de una sola pasarela.

list

 Muestra las pasarelas de un proyecto y una ubicación determinados.

patch

 Actualiza los parámetros de una única pasarela.

setIamPolicy

 Aplica la política de control de acceso del recurso especificado.

testIamPermissions

 Devuelve los permisos que tiene una sobre el recurso especificado.