REST Resource: projects.locations.tcpRoutes

Recurso: TcpRoute

TcpRoute es el recurso que define cómo un recurso de malla/puerta de enlace debe enrutar el tráfico de TCP.

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

Obligatorio. Nombre del recurso TcpRoute. Coincide con el patrón projects/*/locations/global/tcpRoutes/tcp_route_name>.

createTime

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC “Zulú”, 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 salida. Marca de tiempo de la actualización del recurso.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, 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".

description

string

Opcional. Es una descripción de texto libre del recurso. Longitud máxima: 1,024 caracteres.

rules[]

object (RouteRule)

Obligatorio. Son las reglas que definen cómo se enruta y maneja el tráfico. Se debe proporcionar al menos una RouteRule. Si hay varias reglas, la acción que se realice será la primera regla que coincida.

meshes[]

string

Opcional. Las mallas definen una lista de mallas a las que se adjunta esta TcpRoute, 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>

La malla adjunta debe ser del tipo SIDECAR.

gateways[]

string

Opcional. Las puertas de enlace definen una lista de puertas de enlace a las que se adjunta esta TcpRoute, 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. Conjunto de etiquetas de etiquetas asociadas con el recurso TcpRoute.

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 coincide.

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

object (RouteMatch)

Opcional. RouteMatch define el predicado que se usa para hacer coincidir las solicitudes con una acción determinada. Los tipos de concordancia múltiples se combinan con el operador "O" para la evaluación. Si no se especifica un campo routeMatch, esta regla coincidirá con el tráfico de forma incondicional.

action

object (RouteAction)

Obligatorio. 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. Los tipos de concordancia múltiples se combinan con el operador "O" para la evaluación. Si no se especifica un campo routeMatch, esta regla coincidirá con el tráfico de forma incondicional.

Representación JSON
{
  "address": string,
  "port": string
}
Campos
address

string

Obligatorio. Se debe especificar en el formato de rango CIDR. Un rango CIDR consta de una dirección IP y una longitud de prefijo para construir la máscara de subred. De forma predeterminada, la longitud del prefijo es 32 (es decir, coincide con una sola dirección IP). Solo se admiten direcciones IPv4. Ejemplos: “10.0.0.1”. coincide con esta dirección IP exacta. “10.0.0.0/8” coincide con cualquier dirección IP dentro de la subred 10.0.0.0 y la máscara 255.255.255.0. "0.0.0.0/0": Coincide con cualquier dirección IP.

port

string

Obligatorio. Especifica el puerto de destino con el que debe coincidir.

RouteAction

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

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

object (RouteDestination)

Opcional. Los servicios de destino a los que se debe reenviar el tráfico. Se requiere al menos un servicio de destino. Solo se puede establecer un destino de ruta o un destino original.

originalDestination

boolean

Opcional. Si es verdadero, el router usará la IP y el puerto de destino de la conexión original como destino de la solicitud. La configuración predeterminada es False. Solo se puede establecer uno de los destinos de la ruta o el destino original.

idleTimeout

string (Duration format)

Opcional. Especifica el tiempo de espera inactivo para la ruta seleccionada. El tiempo de espera inactivo 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 la estableces, el tiempo de espera de inactividad predeterminado es de 30 segundos. 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. 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. Esto se calcula de la siguiente manera: - peso/suma(pesos en esta lista de destino). Para los valores distintos de cero, puede haber algún epsilon de la proporción exacta definida aquí según la precisión que admita una implementación.

Si solo se especifica un serviceName y tiene un peso superior a 0, el 100% del tráfico se reenvía a ese backend.

Si se especifican pesos para un nombre de servicio, se deben especificar para todos.

Si no se especifican los pesos para todos los servicios, el tráfico se distribuye en proporciones iguales para todos ellos.

Métodos

create

Crea una TcpRoute nueva en una ubicación y proyecto determinados.

delete

Borra una sola TcpRoute.

get

Obtiene los detalles de un solo TcpRoute.

getIamPolicy

Permite obtener la política de control de acceso de un recurso.

list

Muestra una lista de TcpRoute de un proyecto y una ubicación determinados.

patch

Actualiza los parámetros de una sola TcpRoute.

setIamPolicy

Permite configurar la política de control de acceso en el recurso especificado.

testIamPermissions

Permite mostrar los permisos que tiene un emisor para un recurso especificado.