REST Resource: projects.locations.tlsRoutes

Recurso: TlsRoute

TlsRoute define cómo se debe enrutar el tráfico en función de SNI y otros atributos de nivel 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. Nombre del recurso TlsRoute. Coincide con el patrón projects/*/locations/global/tlsRoutes/tls_route_name>.
createTime

string (Timestamp format)

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

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "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 de salida. Marca de tiempo de la última actualización del recurso.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
description

string

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

object (RouteRule)

Obligatorio. Reglas que definen cómo se enruta y se gestiona el tráfico. Se debe proporcionar al menos un RouteRule. Si hay varias reglas, se aplicará la primera 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 atendidas por la malla.

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

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

string

Opcional. Gateways define una lista de pasarelas a las que está asociada esta TlsRoute como una de las reglas de enrutamiento para enrutar las solicitudes atendidas por la pasarela.

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

map (key: string, value: string)

Opcional. Conjunto de etiquetas asociadas al recurso TlsRoute.

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

RouteRule

Especifica cómo se debe hacer coincidir el tráfico y cómo se debe enrutar cuando se encuentre una coincidencia.

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

object (RouteMatch)

Obligatorio. RouteMatch define el predicado que se usa para asociar solicitudes a una acción determinada. Para la evaluación, se aplica el operador lógico "O" a varios tipos de concordancia. Se debe proporcionar al menos un RouteMatch.
action

object (RouteAction)

Obligatorio. Regla detallada que define cómo enrutar el tráfico coincidente.

RouteMatch

RouteMatch define el predicado que se usa para asociar solicitudes a una acción determinada. Se aplican varias concordancias a la vez para la evaluación.

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

string

Opcional. SNI (indicador de nombre de servidor) con el que se establecen coincidencias. La SNI se comparará con todos los dominios comodín.Por ejemplo, www.example.com se comparará primero con www.example.com, después con *.example.com y, por último, con *.com.. No se admiten comodines parciales, por lo que los valores como *w.example.com no son válidos. Se requiere al menos uno de los valores sniHost y alpn. Se pueden definir hasta 100 anfitriones de sni en todos los partidos.
alpn[]

string

Opcional. ALPN (negociación del protocolo de la capa de la aplicación) con el que se va a comparar. Ejemplos: "http/1.1", "h2". Se requiere al menos uno de los valores sniHost y alpn. Se pueden definir hasta 5 alpns en todas las coincidencias.

RouteAction

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. Los servicios de destino a los que se debe reenviar el tráfico. Es obligatorio indicar al menos un servicio de destino.
idleTimeout

string (Duration format)

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

Duración en segundos con hasta nueve decimales, que termina con "s". Por ejemplo: "3.5s".

RouteDestination

Describe el destino al que se debe dirigir el tráfico.

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

string

Obligatorio. URL de un BackendService al que dirigir el tráfico.
weight

integer

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

Métodos

create

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

delete

 Elimina un solo TlsRoute.

get

 Obtiene los detalles de un solo TlsRoute.

list

 Muestra los TlsRoute de un proyecto y una ubicación determinados.

patch

 Actualiza los parámetros de un solo TlsRoute.

setIamPolicy

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

testIamPermissions

 Devuelve los permisos que tiene una sobre el recurso especificado.