REST Resource: projects.locations.tlsRoutes

Risorsa: TlsRoute

TlsRoute definisce la modalitร  di routing 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" RFC3339 UTC, 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. Il timestamp di aggiornamento della risorsa.

Un timestamp in formato "Zulu" RFC3339 UTC, 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 le modalitร  di routing e gestione del traffico. รˆ necessario specificare almeno una RouteRule. Se sono presenti piรน regole, l'azione intrapresa sarร  la prima regola corrispondente.

meshes[]

string

Facoltativo. I mesh definiscono un elenco di mesh a cui รจ collegato questa TlsRoute come una delle regole di routing per instradare le richieste gestite dal mesh.

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

Il mesh collegato deve essere di tipo SIDECAR

gateways[]

string

Facoltativo. Gateway definisce un elenco di gateway a cui รจ collegato 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 etichetta associati alla risorsa TlsRoute.

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

RouteRule

Specifica come far corrispondere il traffico e come instradarlo in caso di corrispondenza del traffico.

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. Piรน tipi di corrispondenza sono contrassegnati con "OR" per la valutazione.

action

object (RouteAction)

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

RouteMatch

RouteMatch definisce il predicato utilizzato per abbinare le richieste a una determinata azione. Piรน tipi di corrispondenza vengono contrassegnati con l'operatore "AND" per la valutazione. Se non viene specificato alcun campo routeMatch, questa regola corrisponderร  in modo incondizionato al traffico.

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

string

Facoltativo. SNI (indicatore del nome del server) con cui stabilire una corrispondenza. Verrร  effettuata una corrispondenza di SNI con tutti i domini con caratteri jolly, ad esempio www.example.com verrร  prima confrontata con www.example.com, poi *.example.com e infine *.com. I caratteri jolly parziali non sono supportati e i valori come *w.example.com non sono validi. รˆ obbligatorio specificare almeno un valore sniHost e alpn. รˆ possibile impostare fino a 100 host sni in tutte le corrispondenze.

alpn[]

string

Facoltativo. ALPN (Application- Layer Protocol Negoziazione) con cui stabilire una corrispondenza. Esempi: "http/1.1", "h2". รˆ obbligatorio specificare almeno un valore 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 di inattivitร  per la route selezionata. Per timeout di inattivitร  si intende il periodo in cui non vengono inviati o ricevuti byte sulla connessione upstream o downstream. Se non viene configurato, il timeout di inattivitร  predefinito รจ di 1 ora. Se impostato su 0s, 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 instradare il traffico.

weight

integer

Facoltativo. Specifica la proporzione di richieste inviate al backend a cui fa riferimento il campo serviceName. Questo valore viene calcolato come: - peso/Somma(ponderazioni nelle destinazioni) I pesi in tutte le destinazioni non devono sommare fino a 100.

Metodi

create

Crea un nuovo TlsRoute in un progetto e una localitร  specifici.

delete

Elimina un singolo TlsRoute.

get

Recupera i dettagli di una singola TlsRoute.

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 un chiamante dispone per la risorsa specificata.