REST Resource: projects.locations.tlsRoutes

Recurso: TlsRoute

TlsRoute define cómo se debe enrutar el tráfico según la SNI y otros atributos de capa 3 coincidentes.

Representación JSON 
{
  "name": string,
  "selfLink": string,
  "createTime": string,
  "updateTime": string,
  "description": string,
  "rules": [
    {
      object (RouteRule)
    }
  ],
  "meshes": [
    string
  ],
  "gateways": [
    string
  ],
  "labels": {
    string: string,
    ...
  }
}
Campos
name

string

Identificador. Es el nombre del recurso TlsRoute. Coincide con el patrón projects/*/locations/global/tlsRoutes/tls_route_name>.
createTime

string (Timestamp format)

Solo salida. Marca de tiempo cuando se creó el recurso.

Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. La marca de tiempo cuando se creó el recurso.

Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
description

string

Opcional. Es una descripción de texto libre del recurso. La longitud máxima es de 1,024 caracteres.
rules[]

object (RouteRule)

Obligatorio. Son reglas que definen cómo se enruta y controla el tráfico. Se debe proporcionar al menos un RouteRule. Si hay varias reglas, la acción que se tomará será la de la primera regla que coincida.
meshes[]

string

Opcional. Meshes define una lista de mallas a las que se adjunta este TlsRoute, como una de las reglas de enrutamiento para enrutar las solicitudes que entrega la malla.

Cada referencia de malla debe coincidir con el patrón projects/*/locations/global/meshes/<mesh_name>.

El Mesh adjunto debe ser de tipo SIDECAR.
gateways[]

string

Opcional. Gateways define una lista de puertas de enlace a las que se adjunta este TlsRoute, como una de las reglas de enrutamiento para enrutar las solicitudes que entrega la puerta de enlace.

Cada referencia de puerta de enlace debe coincidir con el patrón projects/*/locations/global/gateways/<gateway_name>.
labels

map (key: string, value: string)

Opcional. Es un conjunto de etiquetas asociadas con el recurso TlsRoute.

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

RouteRule

Especifica cómo hacer coincidir el tráfico y cómo enrutarlo cuando se encuentra una coincidencia.

Representación JSON 
{
  "matches": [
    {
      object (RouteMatch)
    }
  ],
  "action": {
    object (RouteAction)
  }
}
Campos
matches[]

object (RouteMatch)

Obligatorio. RouteMatch define el predicado que se usa para hacer coincidir las solicitudes con una acción determinada. Se aplica el operador "O" a varios tipos de concordancia para la evaluación. Se debe proporcionar al menos un objeto RouteMatch.
action

object (RouteAction)

Obligatorio. Es la regla detallada que define cómo enrutar el tráfico coincidente.

RouteMatch

RouteMatch define el predicado que se usa para hacer coincidir las solicitudes con una acción determinada. Se aplica el operador "Y" a varios tipos de concordancia para la evaluación.

Representación JSON 
{
  "sniHost": [
    string
  ],
  "alpn": [
    string
  ]
}
Campos
sniHost[]

string

Opcional. Es el SNI (indicador de nombre del servidor) con el que se debe hacer la coincidencia. El SNI se comparará con todos los dominios de comodín, es decir, www.example.com se comparará primero con www.example.com, luego con *.example.com y, por último, con *.com.. No se admiten comodines parciales, y los valores como *w.example.com no son válidos. Se requiere al menos uno de los campos sniHost y alpn. Se pueden configurar hasta 100 hosts de SNI en todas las coincidencias.
alpn[]

string

Opcional. ALPN (negociación del protocolo de la capa de aplicación) con el que se debe hacer coincidir. Ejemplos: “http/1.1”, “h2”. Se requiere al menos uno de los campos sniHost y alpn. Se pueden establecer hasta 5 ALPN en todas las coincidencias.

RouteAction

Son las especificaciones para enrutar el tráfico y aplicar las políticas asociadas.

Representación JSON 
{
  "destinations": [
    {
      object (RouteDestination)
    }
  ],
  "idleTimeout": string
}
Campos
destinations[]

object (RouteDestination)

Obligatorio. Son los servicios de destino a los que se debe reenviar el tráfico. Se requiere al menos un servicio de destino.
idleTimeout

string (Duration format)

Opcional. Especifica el tiempo de espera por inactividad para la ruta seleccionada. El tiempo de espera por inactividad se define como el período en el que no se envían ni reciben bytes en la conexión ascendente o descendente. Si no se configura, el tiempo de espera predeterminado es de 1 hora. Si se establece en 0 s, se inhabilitará el tiempo de espera.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

RouteDestination

Describe el destino al que se enrutará el tráfico.

Representación JSON 
{
  "serviceName": string,
  "weight": integer
}
Campos
serviceName

string

Obligatorio. Es la URL de un BackendService al que se enrutará el tráfico.
weight

integer

Opcional. Especifica la proporción de solicitudes que se reenvían al backend al que hace referencia el campo serviceName. Se calcula de la siguiente manera: - peso/Suma(pesos en los destinos). No es necesario que los pesos en todos los destinos sumen 100.

Métodos

create

 Crea un nuevo TlsRoute en un proyecto y una ubicación determinados.

delete

 Borra un solo objeto TlsRoute.

get

 Obtiene los detalles de una sola TlsRoute.

list

 Enumera objetos TlsRoute en una ubicación y un proyecto determinados.

patch

 Actualiza los parámetros de un solo TlsRoute.