Recurso: Gateway
La puerta de enlace representa la configuración de un proxy, por lo general, un balanceador de cargas. Captura la IP:puerto sobre el que el proxy expone los servicios, junto con cualquier configuración de política. Las rutas tienen referencia a las puertas de enlace para dictar cómo esta puerta de enlace debe enrutar las solicitudes.
| Representación JSON |
|---|
{ "name": string, "selfLink": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "description": string, "type": enum ( |
| Campos | |
|---|---|
name |
Es el identificador. Es el nombre del recurso de puerta de enlace. Coincide con el patrón |
selfLink |
Solo salida. URL de este recurso definida por el servidor |
createTime |
Solo salida. Marca de tiempo cuando se creó el recurso. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
updateTime |
Solo salida. La marca de tiempo cuando se creó el recurso. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
labels |
Es opcional. Es un conjunto de etiquetas asociadas con el recurso de puerta de enlace. Un objeto que contiene una lista de pares |
description |
Es opcional. Es una descripción de texto libre del recurso. La longitud máxima es de 1,024 caracteres. |
type |
Inmutable. Es el tipo de puerta de enlace administrada por el cliente. Este campo es obligatorio. Si no se especifica, se muestra un mensaje de error. |
addresses[] |
Es opcional. Cero o una dirección IPv4 o IPv6 en la que la puerta de enlace recibirá el tráfico. Cuando no se proporciona ninguna dirección, se asigna una IP de la subred Este campo solo se aplica a las puertas de enlace del tipo "SECURE_WEB_GATEWAY". Las puertas de enlace del tipo "OPEN_MESH" escuchan en 0.0.0.0 para IPv4 y :: para IPv6. |
ports[] |
Obligatorio. Uno o más números de puerto (del 1 al 65535) en los que la puerta de enlace recibirá tráfico. El proxy se vincula a los puertos especificados. Las puertas de enlace del tipo "SECURE_WEB_GATEWAY" están limitadas a 5 puertos. Las puertas de enlace de tipo "OPEN_MESH" escuchan en 0.0.0.0 para IPv4 y :: para IPv6, y admiten varios puertos. |
allPorts |
Es opcional. Si es verdadero, la puerta de enlace escuchará en todos los puertos. Este campo es mutuamente excluyente con el campo |
scope |
Es opcional. El alcance determina cómo se combina la configuración en varias instancias de Gateway. La configuración de varias instancias de Gateway con el mismo alcance se combinará y se presentará como una sola configuración para el proxy o el balanceador de cargas. La longitud máxima es de 64 caracteres. El permiso debe comenzar con una letra y solo puede tener letras, números y guiones. |
serverTlsPolicy |
Es opcional. Es una referencia de URL de ServerTLSPolicy completamente calificada. Especifica cómo se finaliza el tráfico de TLS. Si está vacío, la finalización de TLS se inhabilita. |
certificateUrls[] |
Es opcional. Es una referencia de URL de certificados completamente calificada. El proxy presenta un certificado (seleccionado según la SNI) cuando establece una conexión TLS. Esta función solo se aplica a las puertas de enlace del tipo "SECURE_WEB_GATEWAY". |
gatewaySecurityPolicy |
Es opcional. Es una referencia de URL de GatewaySecurityPolicy completamente calificada. Define cómo un servidor debe aplicar la política de seguridad a las conexiones iniciadas entrantes (de VM a proxy). Por ejemplo: Esta política es específica para las puertas de enlace del tipo "SECURE_WEB_GATEWAY". |
network |
Es opcional. Es el nombre de recurso relativo que identifica la red de VPC que usa esta configuración. Por ejemplo: Actualmente, este campo es específico de las puertas de enlace del tipo "SECURE_WEB_GATEWAY". |
subnetwork |
Es opcional. Es el nombre de recurso relativo que identifica la subred en la que se asigna esta SWG. Por ejemplo: Actualmente, este campo es específico de las puertas de enlace del tipo "SECURE_WEB_GATEWAY". |
ipVersion |
Es opcional. Es la versión de IP que usará esta puerta de enlace. Las opciones válidas son IPV4 o IPV6. El valor predeterminado es IPV4. |
routingMode |
Es opcional. Es el modo de enrutamiento de la puerta de enlace. Este campo solo se puede configurar para las puertas de enlace del tipo SECURE_WEB_GATEWAY. Este campo es obligatorio para las puertas de enlace del tipo SECURE_WEB_GATEWAY. |
allowGlobalAccess |
Es opcional. Si es verdadero, la puerta de enlace permitirá el tráfico de clientes fuera de la región en la que se encuentra la puerta de enlace. Este campo solo se puede configurar para las puertas de enlace del tipo SECURE_WEB_GATEWAY. |
envoyHeaders |
Es opcional. Determina si Envoy insertará encabezados de depuración internos en las solicitudes ascendentes. Es posible que se sigan insertando otros encabezados de Envoy. De forma predeterminada, Envoy no insertará ningún encabezado de depuración. |
Tipo
Es el tipo de puerta de enlace administrada por el cliente. Los valores posibles son los siguientes: * OPEN_MESH * SECURE_WEB_GATEWAY
| Enums | |
|---|---|
TYPE_UNSPECIFIED |
No se especificó el tipo de puerta de enlace administrada por el cliente. |
OPEN_MESH |
El tipo de puerta de enlace administrada por el cliente es TrafficDirector Open Mesh. |
SECURE_WEB_GATEWAY |
El tipo de puerta de enlace administrada por el cliente es SecureWebGateway (SWG). |
IpVersion
Son los tipos de versión de IP para la puerta de enlace. Los valores posibles son los siguientes: * IPV4 * IPV6
| Enums | |
|---|---|
IP_VERSION_UNSPECIFIED |
Es el tipo cuando no se especifica la versión de IP. La configuración predeterminada es IPV4. |
IPV4 |
Es el tipo para la versión 4 de IP. |
IPV6 |
El tipo para la versión 6 de IP. |
RoutingMode
Es el modo de enrutamiento de la puerta de enlace, que determina cómo esta enruta el tráfico. Actualmente, este campo solo se aplica a las puertas de enlace del tipo SECURE_WEB_GATEWAY. Los valores posibles son los siguientes: * EXPLICIT_ROUTING_MODE * NEXT_HOP_ROUTING_MODE
| Enums | |
|---|---|
EXPLICIT_ROUTING_MODE |
El modo de enrutamiento es explícito; los clientes están configurados para enviar tráfico a través de la puerta de enlace. Este es el modo de enrutamiento predeterminado. |
NEXT_HOP_ROUTING_MODE |
El modo de enrutamiento es de próximo salto. Los clientes no conocen la puerta de enlace, y se puede configurar una ruta (ruta avanzada o de otro tipo) para dirigir el tráfico del cliente a la puerta de enlace. Luego, la puerta de enlace actúa como un próximo salto hacia el destino. |
Métodos |
|
|---|---|
|
Crea una puerta de enlace nueva en un proyecto y una ubicación determinados. |
|
Borra una sola puerta de enlace. |
|
Obtiene los detalles de una sola puerta de enlace. |
|
Enumera las puertas de enlace en una ubicación y un proyecto determinados. |
|
Actualiza los parámetros de una sola puerta de enlace. |
|
Permite configurar la política de control de acceso en el recurso especificado. |
|
Permite mostrar los permisos que tiene un emisor para un recurso especificado. |