REST Resource: projects.locations.tlsRoutes

Risorsa: TlsRoute

TlsRoute definisce il modo in cui il traffico deve essere instradato in base all'SNI e ad altri attributi L3 corrispondenti.

Rappresentazione JSON 
{
  "name": string,
  "selfLink": string,
  "createTime": string,
  "updateTime": string,
  "description": string,
  "rules": [
    {
      object (RouteRule)
    }
  ],
  "meshes": [
    string
  ],
  "gateways": [
    string
  ],
  "labels": {
    string: string,
    ...
  }
}
Campi
name

string

Identificatore. Nome della risorsa TlsRoute. Corrisponde al pattern projects/*/locations/global/tlsRoutes/tls_route_name>.
createTime

string (Timestamp format)

Solo output. Timestamp di creazione della risorsa.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Timestamp dell'aggiornamento della risorsa.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
description

string

Facoltativo. Una descrizione in formato libero della risorsa. Lunghezza massima 1024 caratteri.
rules[]

object (RouteRule)

Obbligatorio. Regole che definiscono come viene instradato e gestito il traffico. Deve essere fornita almeno una RouteRule. Se sono presenti più regole, l'azione intrapresa sarà la prima regola corrispondente.
meshes[]

string

Facoltativo. Mesh definisce un elenco di mesh a cui è collegata questa TlsRoute, come una delle regole di routing per instradare le richieste gestite dalla mesh.

Ogni riferimento alla mesh deve corrispondere al pattern: projects/*/locations/global/meshes/<mesh_name>

Il mesh allegato deve essere di tipo SIDECAR
gateways[]

string

Facoltativo. Gateways definisce un elenco di gateway a cui è collegata questa TlsRoute, come una delle regole di routing per instradare le richieste gestite dal gateway.

Ogni riferimento al gateway deve corrispondere al pattern: projects/*/locations/global/gateways/<gateway_name>
labels

map (key: string, value: string)

Facoltativo. Set di tag di etichette associati alla risorsa TlsRoute.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

RouteRule

Specifica come trovare la corrispondenza del traffico e come instradarlo quando viene trovata una corrispondenza.

Rappresentazione JSON 
{
  "matches": [
    {
      object (RouteMatch)
    }
  ],
  "action": {
    object (RouteAction)
  }
}
Campi
matches[]

object (RouteMatch)

Obbligatorio. RouteMatch definisce il predicato utilizzato per abbinare le richieste a una determinata azione. Per la valutazione, i vari tipi di corrispondenza vengono combinati con l'operatore "OR". Deve essere fornita almeno una corrispondenza della route.
action

object (RouteAction)

Obbligatorio. La regola dettagliata che definisce come instradare il traffico corrispondente.

RouteMatch

RouteMatch definisce il predicato utilizzato per abbinare le richieste a una determinata azione. Per la valutazione vengono utilizzati più tipi di corrispondenza con l'operatore booleano "AND".

Rappresentazione JSON 
{
  "sniHost": [
    string
  ],
  "alpn": [
    string
  ]
}
Campi
sniHost[]

string

Facoltativo. SNI (indicatore del nome del server) da confrontare. L'SNI verrà confrontato con tutti i domini con caratteri jolly, ad esempio www.example.com verrà confrontato prima con www.example.com, poi con *.example.com e infine con *.com.. I caratteri jolly parziali non sono supportati e i valori come *w.example.com non sono validi. È obbligatorio specificare almeno uno dei valori sniHost e alpn. È possibile impostare fino a 100 host di snippet in tutte le partite.
alpn[]

string

Facoltativo. ALPN (Application-Layer Protocol Negotiation) per la corrispondenza. Esempi: "http/1.1", "h2". È obbligatorio specificare almeno uno dei valori sniHost e alpn. È possibile impostare fino a 5 alpns in tutte le corrispondenze.

RouteAction

Le specifiche per il routing del traffico e l'applicazione dei criteri associati.

Rappresentazione JSON 
{
  "destinations": [
    {
      object (RouteDestination)
    }
  ],
  "idleTimeout": string
}
Campi
destinations[]

object (RouteDestination)

Obbligatorio. I servizi di destinazione a cui deve essere inoltrato il traffico. È necessario almeno un servizio di destinazione.
idleTimeout

string (Duration format)

Facoltativo. Specifica il timeout di inattività per la route selezionata. Il timeout di inattività è definito come il periodo in cui non vengono inviati o ricevuti byte sulla connessione upstream o downstream. Se non viene impostato, il timeout di inattività predefinito è 1 ora. Se impostato su 0 secondi, il timeout verrà disattivato.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

RouteDestination

Descrivi la destinazione a cui indirizzare il traffico.

Rappresentazione JSON 
{
  "serviceName": string,
  "weight": integer
}
Campi
serviceName

string

Obbligatorio. L'URL di un BackendService a cui indirizzare il traffico.
weight

integer

Facoltativo. Specifica la proporzione di richieste inoltrate al backend a cui fa riferimento il campo serviceName. Viene calcolato come: - peso/somma(pesi nelle destinazioni). La somma dei pesi in tutte le destinazioni non deve essere pari a 100.

Metodi

create

 Crea una nuova TlsRoute in un determinato progetto e una determinata località.

delete

 Elimina una singola TlsRoute.

get

 Recupera i dettagli di una singola TlsRoute.

list

 Elenca TlsRoute in un determinato progetto e località.

patch

 Aggiorna i parametri di una singola TlsRoute.

setIamPolicy

 Imposta il criterio di controllo dell'accesso sulla risorsa specificata.

testIamPermissions

 Restituisce le autorizzazioni di cui dispone un chiamante per la risorsa specificata.