REST Resource: projects.locations.tlsRoutes

Recurso: TlsRoute

A TlsRoute define como o tráfego deve ser roteado com base no SNI e em outros atributos correspondentes da camada 3.

Representação 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. Nome do recurso TlsRoute. Ele corresponde ao padrão projects/*/locations/global/tlsRoutes/tls_route_name>.
createTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o recurso foi criado.

Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30";
updateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o recurso foi atualizado.

Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30";
description

string

Opcional. Uma descrição de texto livre do recurso. Comprimento máximo de 1.024 caracteres.
rules[]

object (RouteRule)

Obrigatório. Regras que definem como o tráfego é roteado e processado. É necessário fornecer pelo menos uma RouteRule. Se houver várias regras, a ação tomada será a da primeira regra correspondente.
meshes[]

string

Opcional. "Meshes" define uma lista de malhas a que essa TlsRoute está anexada, como uma das regras de roteamento para rotear as solicitações atendidas pela malha.

Cada referência de malha precisa corresponder ao padrão: projects/*/locations/global/meshes/<mesh_name>

A malha anexada precisa ser do tipo SIDECAR
gateways[]

string

Opcional. "Gateways" define uma lista de gateways a que essa TlsRoute está anexada, como uma das regras de roteamento para rotear as solicitações atendidas pelo gateway.

Cada referência de gateway precisa corresponder ao padrão: projects/*/locations/global/gateways/<gateway_name>
labels

map (key: string, value: string)

Opcional. Conjunto de tags de rótulo associadas ao recurso TlsRoute.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

RouteRule

Especifica como fazer a correspondência e o roteamento do tráfego.

Representação JSON 
{
  "matches": [
    {
      object (RouteMatch)
    }
  ],
  "action": {
    object (RouteAction)
  }
}
Campos
matches[]

object (RouteMatch)

Obrigatório. O RouteMatch define o predicado usado para corresponder solicitações a uma determinada ação. Vários tipos de correspondência são combinados com "OR" para avaliação. É necessário fornecer pelo menos um RouteMatch.
action

object (RouteAction)

Obrigatório. A regra detalhada que define como rotear o tráfego correspondente.

RouteMatch

O RouteMatch define o predicado usado para corresponder solicitações a uma determinada ação. Vários tipos de correspondência são combinados com "AND" para avaliação.

Representação JSON 
{
  "sniHost": [
    string
  ],
  "alpn": [
    string
  ]
}
Campos
sniHost[]

string

Opcional. SNI (indicador de nome do servidor) para correspondência. O SNI será comparado com todos os domínios curinga.Por exemplo, www.example.com será comparado primeiro com www.example.com, depois com *.example.com e, por fim, com *.com.. Não há suporte para caracteres curinga parciais, e valores como *w.example.com são inválidos. É necessário incluir pelo menos um dos campos "sniHost" e "alpn". É possível definir até 100 hosts de sni em todas as correspondências.
alpn[]

string

Opcional. ALPN (negociação de protocolo na camada do app) para correspondência. Exemplos: "http/1.1", "h2". É necessário incluir pelo menos um dos campos "sniHost" e "alpn". É possível definir até cinco ALPNs em todas as correspondências.

RouteAction

As especificações para rotear o tráfego e aplicar as políticas associadas.

Representação JSON 
{
  "destinations": [
    {
      object (RouteDestination)
    }
  ],
  "idleTimeout": string
}
Campos
destinations[]

object (RouteDestination)

Obrigatório. Os serviços de destino para os quais o tráfego deve ser encaminhado. É necessário pelo menos um serviço de destino.
idleTimeout

string (Duration format)

Opcional. Especifica o tempo limite de inatividade da rota selecionada. O tempo limite de inatividade é definido como o período em que não há bytes enviados ou recebidos na conexão upstream ou downstream. Se não for definido, o tempo limite de inatividade padrão será de uma hora. Se for definido como 0s, o tempo limite será desativado.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

RouteDestination

Descreva o destino para onde o tráfego será encaminhado.

Representação JSON 
{
  "serviceName": string,
  "weight": integer
}
Campos
serviceName

string

Obrigatório. O URL de um BackendService para encaminhar o tráfego.
weight

integer

Opcional. Especifica a proporção de solicitações encaminhadas ao back-end referenciado pelo campo "serviceName". O cálculo é feito da seguinte forma: - peso/Soma(pesos nos destinos). Não é necessário que a soma dos pesos em todos os destinos seja igual a 100.

Métodos

create

 Cria uma nova TlsRoute em um determinado projeto e local.

delete

 Exclui uma única TlsRoute.

get

 Recebe detalhes de um único TlsRoute.

list

 Lista TlsRoute em um determinado projeto e local.

patch

 Atualiza os parâmetros de uma única TlsRoute.