REST Resource: projects.locations.tlsRoutes

Risorsa: TlsRoute

TlsRoute definisce la modalità di instradamento del traffico in base a SNI e 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

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

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Solo output. Timestamp di aggiornamento della risorsa.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
description

string

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

object (RouteRule)

Obbligatorio. Regole che definiscono la modalità di instradamento e gestione del traffico. Devi specificare almeno una RouteRule. Se sono presenti più regole, verrà intrapresa l'azione della prima regola che corrisponde.
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>

La mesh collegata deve essere di tipo SIDECAR
gateways[]

string

Facoltativo. I gateway definiscono un elenco di gateway a cui è collegato questo TlsRoute, come una delle regole di routing per instradare le richieste gestite dal gateway.

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

map (key: string, value: string)

Facoltativo. Insieme di tag di etichetta associati alla risorsa TlsRoute.

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

RouteRule

Specifica come abbinare il traffico e come instradarlo quando il traffico corrisponde.

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

object (RouteMatch)

Obbligatorio. RouteMatch definisce il predicato utilizzato per associare le richieste a una determinata azione. Per la valutazione vengono utilizzati più tipi di corrispondenza con l'operatore OR.
action

object (RouteAction)

Obbligatorio. La regola dettagliata che definisce il modo in cui instradare il traffico corrispondente.

RouteMatch

RouteMatch definisce il predicato utilizzato per associare le richieste a una determinata azione. Più tipi di corrispondenza vengono contrassegnati con "AND" per la valutazione. Se non viene specificato alcun campo routeMatch, questa regola corrisponderà incondizionatamente al traffico.

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

string

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

string

Facoltativo. ALPN (Application- Layer Protocol Negoziazione) con cui trovare una corrispondenza. Esempi: "http/1.1", "h2". È obbligatorio specificare almeno uno tra sniHost e alpn. È possibile impostare fino a 5 alpn 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. È richiesto almeno un servizio di destinazione.
idleTimeout

string (Duration format)

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

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

RouteDestination

Descrivi la destinazione del traffico da instradare.

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

string

Obbligatorio. L'URL di un servizio di backend a cui instradare il traffico.
weight

integer

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

Metodi

create

 Crea una nuova TlsRoute in un determinato progetto e posizione.

delete

 Consente di eliminare un singolo TlsRoute.

get

 Restituisce i dettagli di un singolo TlsRoute.

getIamPolicy

 Ottiene il criterio di controllo dell'accesso per una risorsa.

list

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

patch

 Aggiorna i parametri di un singolo TlsRoute.

setIamPolicy

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

testIamPermissions

 Restituisce le autorizzazioni di cui dispone un chiamante sulla risorsa specificata.