REST Resource: projects.locations.tlsRoutes

Risorsa: TlsRoute

TlsRoute definisce come deve essere indirizzato il traffico 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 con normalizzazione Z 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 di aggiornamento della risorsa.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z 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 indirizzato e gestito il traffico. È necessario specificare almeno una RouteRule. Se sono presenti più regole, l'azione intrapresa sarà la prima regola corrispondente.
meshes[]

string

Facoltativo. Meshes definisce un elenco di mesh a cui è collegata questa risorsa TlsRoute, come una delle regole di routing per indirizzare le richieste gestite dal mesh.

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

Il mesh collegato deve essere di tipo SIDECAR
gateways[]

string

Facoltativo. Gateways definisce un elenco di gateway a cui è collegata questa risorsa TlsRoute, come una delle regole di routing per indirizzare 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. Insieme 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 indirizzarlo una volta trovata la corrispondenza.

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

object (RouteMatch)

Obbligatorio. RouteMatch definisce il predicato utilizzato per determinare le richieste corrispondenti a una determinata azione. Per la valutazione, i vari tipi di corrispondenza vengono combinati con l'operatore "OR". È necessario specificare almeno una RouteMatch.
action

object (RouteAction)

Obbligatorio. Regola dettagliata che definisce come indirizzare il traffico corrispondente.

RouteMatch

RouteMatch definisce il predicato utilizzato per determinare le richieste corrispondenti a una determinata azione. Per la valutazione, i vari tipi di corrispondenza vengono combinati con l'operatore "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 delle policy associate.

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 è di 1 ora. Se impostato su 0 secondi, il timeout verrà disabilitato.

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. Questo valore viene calcolato come: - ponderazione/somma(ponderazioni nelle destinazioni). La somma delle ponderazioni in tutte le destinazioni non deve necessariamente raggiungere il 100%.

Metodi

create

 Crea una nuova risorsa TlsRoute in un progetto e una località specifici.

delete

 Elimina una singola risorsa TlsRoute.

get

 Recupera i dettagli di una singola risorsa TlsRoute.

list

 Elenca la risorsa TlsRoute in un progetto e una località specifici.

patch

 Aggiorna i parametri di una singola risorsa TlsRoute.

setIamPolicy

 Imposta la policy di controllo dell'accesso sulla risorsa specificata.

testIamPermissions

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