REST Resource: projects.locations.httpRoutes

Risorsa: HttpRoute

HttpRoute è la risorsa che definisce in che modo il traffico HTTP deve essere indirizzato da una risorsa Mesh o Gateway.

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

string

Obbligatorio. Nome della risorsa HttpRoute. Corrisponde al pattern projects/*/locations/global/httpRoutes/http_route_name>.
description

string

Facoltativo. Una descrizione in testo libero della risorsa. Lunghezza massima: 1024 caratteri.
createTime

string (Timestamp format)

Solo output. Timestamp di creazione della risorsa.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo 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 dell'aggiornamento della risorsa.

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

string

Obbligatorio. I nomi host definiscono un insieme di host che devono corrispondere all'intestazione dell'host HTTP per selezionare un HttpRoute per l'elaborazione della richiesta. Il nome host è il nome di dominio completo di un host di rete, come definito da RFC 1123, con l'eccezione: - Gli IP non sono consentiti. - Un nome host può essere preceduto da un'etichetta jolly (*.). L'etichetta jolly deve essere visualizzata da sola come prima etichetta.

Il nome host può essere "esatto" Si tratta di un nome di dominio senza il punto di chiusura di un host di rete (ad es. foo.example.com) o di un "caratteri jolly", ovvero un nome di dominio preceduto da una singola etichetta carattere jolly (ad es. *.example.com).

Tieni presente che, in base a RFC1035 e RFC1123, un'etichetta deve essere composta da caratteri alfanumerici in minuscolo o "-" e deve iniziare e terminare con un carattere alfanumerico. Non sono ammessi altri segni di punteggiatura.

Le route associate a un mesh o a un gateway devono avere nomi host univoci. Se tenti di collegare più route con nomi host in conflitto, la configurazione verrà rifiutata.

Ad esempio, sebbene sia accettabile che le route per i nomi host *.foo.bar.com e *.bar.com siano associate allo stesso mesh (o gateway nello stesso ambito), non è possibile associare due route entrambe a *.bar.com o entrambe con bar.com.
meshes[]

string

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

Ogni riferimento 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 è collegata questa HttpRoute, 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 etichetta associati alla risorsa HttpRoute.

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

object (RouteRule)

Obbligatorio. Regole che definiscono le modalità di routing e gestione del traffico. Le regole vengono abbinate in sequenza in base al RouteMatch specificato per la regola.

RouteRule

Specifica come associare il traffico e come indirizzarlo quando viene associato.

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

object (RouteMatch)

Un elenco di corrispondenze definisce le condizioni utilizzate per la corrispondenza della regola alle richieste HTTP in arrivo. Ogni corrispondenza è indipendente, ad esempio viene trovata una corrispondenza con una qualsiasi delle corrispondenze.

Se non viene specificato alcun campo delle corrispondenze, questa regola corrisponderà incondizionatamente al traffico.

Se vuoi configurare una regola predefinita, aggiungi una regola senza corrispondenze specificate alla fine dell'elenco delle regole.
action

object (RouteAction)

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

RouteMatch

RouteMatch definisce le specifiche utilizzate per creare corrispondenze con le richieste. Se sono impostati più tipi di corrispondenza, questo RouteMatch corrisponderà se TUTTI i tipi di corrispondenze corrispondono.

Rappresentazione JSON 
{
  "ignoreCase": boolean,
  "headers": [
    {
      object (HeaderMatch)
    }
  ],
  "queryParameters": [
    {
      object (QueryParameterMatch)
    }
  ],

  // Union field PathMatch can be only one of the following:
  "fullPathMatch": string,
  "prefixMatch": string,
  "regexMatch": string
  // End of list of possible types for union field PathMatch.
}
Campi
ignoreCase

boolean

Specifica se le corrispondenze di prefissoMatch e fullPathMatch sono sensibili alle maiuscole. Il valore predefinito è false.
headers[]

object (HeaderMatch)

Specifica un elenco di intestazioni delle richieste HTTP con cui trovare una corrispondenza. TUTTE le intestazioni fornite devono corrispondere.
queryParameters[]

object (QueryParameterMatch)

Specifica un elenco di parametri di query da confrontare. TUTTI i parametri di ricerca devono corrispondere.

Campo unione PathMatch.

PathMatch può essere solo uno dei seguenti:
fullPathMatch

string

Il valore del percorso della richiesta HTTP deve corrispondere esattamente a questo valore.

Deve essere utilizzato solo uno dei valori fullPathMatch, prefixMatch o regexMatch.
prefixMatch

string

Il valore del percorso della richiesta HTTP deve iniziare con prefissoMatch specificato. Il prefisso prefisso deve iniziare con una barra (/).

Deve essere utilizzato solo uno dei valori fullPathMatch, prefixMatch o regexMatch.
regexMatch

string

Il valore del percorso della richiesta HTTP deve soddisfare l'espressione regolare specificata da regexMatch dopo aver rimosso eventuali parametri di ricerca e l'anchor fornito con l'URL originale. Per la grammatica delle espressioni regolari, consulta https://github.com/google/re2/wiki/Syntax

Deve essere utilizzato solo uno dei valori fullPathMatch, prefixMatch o regexMatch.

HeaderMatch

Specifica come selezionare una regola di route in base alle intestazioni delle richieste HTTP.

Rappresentazione JSON 
{
  "header": string,
  "invertMatch": boolean,

  // Union field MatchType can be only one of the following:
  "exactMatch": string,
  "regexMatch": string,
  "prefixMatch": string,
  "presentMatch": boolean,
  "suffixMatch": string,
  "rangeMatch": {
    object (IntegerRange)
  }
  // End of list of possible types for union field MatchType.
}
Campi
header

string

Il nome dell'intestazione HTTP da abbinare.
invertMatch

boolean

Se specificato, il risultato della corrispondenza verrà invertito prima del controllo. Il valore predefinito è impostato su false.

Campo unione MatchType.

MatchType può essere solo uno dei seguenti:
exactMatch

string

Il valore dell'intestazione deve corrispondere esattamente ai contenuti di exactMatch.
regexMatch

string

Il valore dell'intestazione deve corrispondere all'espressione regolare specificata in regexMatch. Per la grammatica delle espressioni regolari, consulta: https://github.com/google/re2/wiki/Syntax
prefixMatch

string

Il valore dell'intestazione deve iniziare con i contenuti diPrefixMatch.
presentMatch

boolean

Deve esistere un'intestazione con headerName. La corrispondenza avviene indipendentemente dal fatto che l'intestazione abbia un valore o meno.
suffixMatch

string

Il valore dell'intestazione deve terminare con i contenuti di suffixMatch.
rangeMatch

object (IntegerRange)

Se specificato, la regola corrisponderà se il valore dell'intestazione della richiesta rientra nell'intervallo.

IntegerRange

Rappresenta un intervallo di valori interi.

Rappresentazione JSON 
{
  "start": integer,
  "end": integer
}
Campi
start

integer

Inizio dell'intervallo (incluso)
end

integer

Fine dell'intervallo (escluso)

QueryParameterMatch

Specifiche per la corrispondenza a un parametro di query nella richiesta.

Rappresentazione JSON 
{
  "queryParameter": string,

  // Union field MatchType can be only one of the following:
  "exactMatch": string,
  "regexMatch": string,
  "presentMatch": boolean
  // End of list of possible types for union field MatchType.
}
Campi
queryParameter

string

Il nome del parametro di query da trovare.

Campo unione MatchType.

MatchType può essere solo uno dei seguenti:
exactMatch

string

Il valore del parametro query deve corrispondere esattamente ai contenuti di exactMatch.

È necessario impostare solo uno tra corrispondenzaEsatta, corrispondenzaRegex o corrispondenzaPresente.
regexMatch

string

Il valore del parametro di query deve corrispondere all'espressione regolare specificata da regexMatch. Per la grammatica delle espressioni regolari, consulta https://github.com/google/re2/wiki/Syntax

Deve essere impostata solo una corrispondenza esatta, regexMatch o presentMatch.
presentMatch

boolean

Specifica che QueryParameterMatcher crea corrispondenze se la richiesta contiene un parametro di query, indipendentemente dal fatto che il parametro abbia o meno un valore.

È necessario impostare solo uno tra corrispondenzaEsatta, corrispondenzaRegex o corrispondenzaPresente.

RouteAction

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

Rappresentazione JSON 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "redirect": {
    object (Redirect)
  },
  "faultInjectionPolicy": {
    object (FaultInjectionPolicy)
  },
  "requestHeaderModifier": {
    object (HeaderModifier)
  },
  "responseHeaderModifier": {
    object (HeaderModifier)
  },
  "urlRewrite": {
    object (URLRewrite)
  },
  "timeout": string,
  "retryPolicy": {
    object (RetryPolicy)
  },
  "requestMirrorPolicy": {
    object (RequestMirrorPolicy)
  },
  "corsPolicy": {
    object (CorsPolicy)
  },
  "statefulSessionAffinity": {
    object (StatefulSessionAffinityPolicy)
  },
  "directResponse": {
    object (HttpDirectResponse)
  },
  "idleTimeout": string
}
Campi
destinations[]

object (Destination)

La destinazione a cui deve essere inoltrato il traffico.
redirect

object (Redirect)

Se impostato, la richiesta viene indirizzata come configurato da questo campo.
faultInjectionPolicy

object (FaultInjectionPolicy)

La specifica per l'iniezione di errori introdotta nel traffico per testare la resilienza dei client al fallimento del servizio di backend. Nell'ambito dell'iniezione di errori, quando i client inviano richieste a un servizio di backend, è possibile introdurre ritardi in una percentuale di richieste prima di inviarle al servizio di backend. Analogamente, le richieste da parte dei client possono essere interrotte per una percentuale di richieste.

timeout e retryPolicy verranno ignorati dai client configurati con un criterio faultInjectionPolicy
requestHeaderModifier

object (HeaderModifier)

La specifica per la modifica delle intestazioni di una richiesta corrispondente prima dell'invio della richiesta alla destinazione. Se HeaderModifiers sono impostati sia su destination che su RouteAction, verranno uniti. I conflitti tra i due non verranno risolti nella configurazione.
responseHeaderModifier

object (HeaderModifier)

La specifica per la modifica delle intestazioni di una risposta prima di inviare la risposta al client. Se HeaderModifiers sono impostati sia su destination che su RouteAction, verranno uniti. I conflitti tra i due non saranno risolti nella configurazione.
urlRewrite

object (URLRewrite)

La specifica per l'URL di riscrittura prima di inoltrare le richieste alla destinazione.
timeout

string (Duration format)

Specifica il timeout per la route selezionata. Il timeout viene calcolato dal momento in cui la richiesta viene completamente elaborata (ad es. la fine del flusso) fino al completamento dell'elaborazione della risposta. Il timeout include tutti i nuovi tentativi.

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

object (RetryPolicy)

Specifica il criterio per i nuovi tentativi associato a questa route.
requestMirrorPolicy

object (RequestMirrorPolicy)

Specifica il criterio in base al quale le richieste destinate alla destinazione dei percorsi vengono messe in ombra in una destinazione duplicata separata. Il proxy non attenderà che la destinazione shadow risponda prima di restituire la risposta. Prima di inviare il traffico al servizio shadow, l'intestazione host/authority ha come suffisso -shadow.
corsPolicy

object (CorsPolicy)

La specifica per consentire le richieste multiorigine lato client.
statefulSessionAffinity

object (StatefulSessionAffinityPolicy)

Facoltativo. Specifica l'affinità sessione stateful basata su cookie.
directResponse

object (HttpDirectResponse)

Facoltativo. Oggetto della risposta HTTP statica da restituire indipendentemente dalla richiesta.
idleTimeout

string (Duration format)

Facoltativo. Specifica il timeout per inattività per la route selezionata. Per timeout di inattività si intende il periodo in cui non vengono inviati o ricevuti byte nella connessione a monte o a valle. Se non viene configurato, il timeout predefinito per inattività è 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".

Destinazione

Specifiche di una destinazione a cui deve essere indirizzata la richiesta.

Rappresentazione JSON 
{
  "serviceName": string,
  "weight": integer,
  "requestHeaderModifier": {
    object (HeaderModifier)
  },
  "responseHeaderModifier": {
    object (HeaderModifier)
  }
}
Campi
serviceName

string

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

integer

Specifica la proporzione di richieste inoltrate al backend a cui fa riferimento il campo serviceName. Questo valore viene calcolato come segue: - peso/Somma(pesi in questo elenco di destinazioni). Per i valori diversi da zero, potrebbe esserci un'epsilon rispetto alla proporzione esatta definita qui, a seconda della precisione supportata da un'implementazione.

Se viene specificato un solo serviceName e ha un peso maggiore di 0, il 100% del traffico viene inoltrato a quel backend.

Se i pesi vengono specificati per un nome di servizio, devono essere specificati per tutti.

Se i pesi non sono specificati per tutti i servizi, il traffico viene distribuito in proporzioni uguali a tutti.
requestHeaderModifier

object (HeaderModifier)

Facoltativo. La specifica per la modifica delle intestazioni di una richiesta corrispondente prima dell'invio della richiesta alla destinazione. Se HeaderModifiers è impostato sia su Destination sia su RouteAction, verranno uniti. I conflitti tra i due non verranno risolti nella configurazione.
responseHeaderModifier

object (HeaderModifier)

Facoltativo. La specifica per la modifica delle intestazioni di una risposta prima di inviarla nuovamente al client. Se HeaderModifiers sono impostati sia su destination che su RouteAction, verranno uniti. I conflitti tra i due non saranno risolti nella configurazione.

HeaderModifier

La specifica per la modifica dell'intestazione HTTP nella richiesta e nella risposta HTTP.

Rappresentazione JSON 
{
  "set": {
    string: string,
    ...
  },
  "add": {
    string: string,
    ...
  },
  "remove": [
    string
  ]
}
Campi
set

map (key: string, value: string)

Sostituisci completamente le intestazioni con la mappa specificata, dove la chiave è il nome dell'intestazione e il valore è il valore dell'intestazione.

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

map (key: string, value: string)

Aggiungi le intestazioni con la mappa specificata, dove la chiave è il nome dell'intestazione e il valore è il valore dell'intestazione.

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

string

Rimuovi le intestazioni (corrispondenza per i nomi delle intestazioni) specificate nell'elenco.

Reindirizzamento

La specifica per il reindirizzamento del traffico.

Rappresentazione JSON 
{
  "hostRedirect": string,
  "pathRedirect": string,
  "prefixRewrite": string,
  "responseCode": enum (ResponseCode),
  "httpsRedirect": boolean,
  "stripQuery": boolean,
  "portRedirect": integer
}
Campi
hostRedirect

string

L'host che verrà utilizzato nella risposta di reindirizzamento anziché quello fornito nella richiesta.
pathRedirect

string

Il percorso che verrà utilizzato nella risposta di reindirizzamento anziché quello specificato nella richiesta. pathRedirect non può essere specificato insieme a prefixRedirect. Fornisci solo uno o nessuno. Se non viene specificato nessuno dei due, per il reindirizzamento verrà utilizzato il percorso della richiesta originale.
prefixRewrite

string

Indica che durante il reindirizzamento il prefisso (o percorso) corrispondente deve essere scambiato con questo valore. Questa opzione consente di creare gli URL in modo dinamico in base alla richiesta.
responseCode

enum (ResponseCode)

Il codice di stato HTTP da utilizzare per il reindirizzamento.
httpsRedirect

boolean

Se impostato su true, lo schema URL nella richiesta reindirizzata è impostato su https. Se impostato su false, lo schema URL della richiesta reindirizzata rimarrà invariato rispetto a quello della richiesta.

L'impostazione predefinita è false.
stripQuery

boolean

Se impostato su true, qualsiasi parte della query associata dell'URL originale viene rimossa prima del reindirizzamento della richiesta. Se viene impostato su false, la parte relativa alla query dell'URL originale viene mantenuta.

L'impostazione predefinita è false.
portRedirect

integer

La porta che verrà utilizzata nella richiesta reindirizzata al posto di quella fornita nella richiesta.

ResponseCode

Codice di risposta HTTP supportato.

Enum
RESPONSE_CODE_UNSPECIFIED Valore predefinito
MOVED_PERMANENTLY_DEFAULT Corrisponde al codice 301.
FOUND Corrisponde al codice 302.
SEE_OTHER Corrisponde al codice 303.
TEMPORARY_REDIRECT Corrisponde al 307. In questo caso, il metodo di richiesta verrà mantenuto.
PERMANENT_REDIRECT Corrisponde al 308. In questo caso, il metodo di richiesta verrà mantenuto.

FaultInjectionPolicy

La specifica per la fault injection introdotta nel traffico per testare la resilienza dei client all'errore del servizio di destinazione. Nell'ambito della fault injection, quando i client inviano richieste a una destinazione, il proxy client può introdurre ritardi su una percentuale di richieste prima di inviare queste richieste al servizio di destinazione. Analogamente, le richieste possono essere interrotte dal proxy client per una percentuale di richieste.

Rappresentazione JSON 
{
  "delay": {
    object (Delay)
  },
  "abort": {
    object (Abort)
  }
}
Campi
delay

object (Delay)

La specifica per l'inserimento del ritardo nelle richieste del client.
abort

object (Abort)

La specifica per l'interruzione delle richieste del client.

Ritardo

Specifica di come le richieste del client vengono ritardate come parte di una fault injection prima di essere inviate a una destinazione.

Rappresentazione JSON 
{
  "fixedDelay": string,
  "percentage": integer
}
Campi
fixedDelay

string (Duration format)

Specifica un ritardo fisso prima di inoltrare la richiesta.

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

integer

La percentuale di traffico su cui verrà inserito il ritardo.

Il valore deve essere compreso tra [0, 100]

Interrompi

Specifica di come le richieste del client vengono interrotte nell'ambito dell'iniezione di errori prima di essere inviate a una destinazione.

Rappresentazione JSON 
{
  "httpStatus": integer,
  "percentage": integer
}
Campi
httpStatus

integer

Il codice di stato HTTP utilizzato per interrompere la richiesta.

Il valore deve essere compreso tra 200 e 599 compresi.
percentage

integer

La percentuale di traffico che verrà interrotta.

Il valore deve essere compreso tra [0, 100]

URLRewrite

La specifica per la modifica dell'URL della richiesta prima di inoltrarla alla destinazione.

Rappresentazione JSON 
{
  "pathPrefixRewrite": string,
  "hostRewrite": string
}
Campi
pathPrefixRewrite

string

Prima di inoltrare la richiesta alla destinazione selezionata, la parte corrispondente del percorso delle richieste viene sostituita da questo valore.
hostRewrite

string

Prima di inoltrare la richiesta alla destinazione selezionata, l'intestazione dell'host della richiesta viene sostituita da questo valore.

RetryPolicy

Le specifiche per i nuovi tentativi.

Rappresentazione JSON 
{
  "retryConditions": [
    string
  ],
  "numRetries": integer,
  "perTryTimeout": string
}
Campi
retryConditions[]

string

Specifica una o più condizioni in cui si applica questo criterio di ripetizione. I valori validi sono: 5xx: il proxy tenterà un nuovo tentativo se il servizio di destinazione risponde con un codice di risposta 5xx o se non risponde affatto, ad esempio disconnessione, reimpostazione, timeout di lettura, errore di connessione e stream rifiutati.

gateway-error: simile a 5xx, ma valido solo per i codici di risposta 502, 503, 504.

reimpostazione: il proxy tenterà un nuovo tentativo se il servizio di destinazione non risponde (timeout di disconnessione/reimpostazione/lettura)

connect-failure: il proxy riproverà in caso di errori di connessione alla destinazione, ad esempio a causa di timeout di connessione.

retriable-4xx: il proxy eseguirà un nuovo tentativo per i codici di risposta 4xx che lo consentono. Al momento, l'unico errore risolvibile supportato è 409.

refused-stream: il proxy riproverà se la destinazione reimposta lo stream con un codice di errore REFUSED_STREAM. Questo tipo di reimpostazione indica che è sicuro riprovare.
numRetries

integer

Specifica il numero consentito di nuovi tentativi. Questo numero deve essere maggiore di 0. Se non specificato, il valore predefinito è 1.
perTryTimeout

string (Duration format)

Specifica un timeout diverso da zero per ogni tentativo di nuovo tentativo.

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

RequestMirrorPolicy

Specifica il criterio relativo al modo in cui le richieste vengono sottoposte a shadowing su un servizio di destinazione di mirroring separato. Il proxy non attende le risposte dal servizio shadow. Prima di inviare il traffico al servizio shadow, l'intestazione host/authority ha come suffisso -shadow.

Rappresentazione JSON 
{
  "destination": {
    object (Destination)
  },
  "mirrorPercent": number
}
Campi
destination

object (Destination)

La destinazione a cui verranno sottoposte a mirroring le richieste. Il peso della destinazione verrà ignorato.
mirrorPercent

number

Facoltativo. La percentuale di richieste da eseguire il mirroring alla destinazione desiderata.

CorsPolicy

La specifica per consentire le richieste cross-origin lato client.

Rappresentazione JSON 
{
  "allowOrigins": [
    string
  ],
  "allowOriginRegexes": [
    string
  ],
  "allowMethods": [
    string
  ],
  "allowHeaders": [
    string
  ],
  "exposeHeaders": [
    string
  ],
  "maxAge": string,
  "allowCredentials": boolean,
  "disabled": boolean
}
Campi
allowOrigins[]

string

Specifica l'elenco delle origini che potranno consentire le richieste CORS. Un'origine è consentita se corrisponde a un elemento in allowOrigins o a un elemento in allowOriginRegexes.
allowOriginRegexes[]

string

Specifica i pattern di espressioni regolari che corrispondono alle origini consentite. Per la grammatica delle espressioni regolari, consulta https://github.com/google/re2/wiki/Syntax.
allowMethods[]

string

Specifica il contenuto dell'intestazione Access-Control-Allow-Methods.
allowHeaders[]

string

Specifica il contenuto per l'intestazione Access-Control-Allow-Headers.
exposeHeaders[]

string

Specifica il contenuto per l'intestazione Access-Control-Expose-Headers.
maxAge

string

Specifica per quanto tempo il risultato di una richiesta preflight può essere memorizzato nella cache in secondi. Questo si traduce nell'intestazione Access-Control-Max-Age.
allowCredentials

boolean

In risposta a una richiesta preflight, l'impostazione su true indica che la richiesta effettiva può includere le credenziali utente. Questo si traduce nell'intestazione Access-Control-Allow-Credentials.

Il valore predefinito è false.
disabled

boolean

Se true, il criterio CORS è disattivato. Il valore predefinito è false, a indicare che il criterio CORS è attivo.

StatefulSessionAffinityPolicy

La specifica per l'affinità sessione stateful basata sui cookie in cui il piano data fornisce un "cookie di sessione" con il nome "GSSA" che codifica un host di destinazione specifico e ogni richiesta contenente quel cookie verrà indirizzata a quell'host, purché l'host di destinazione rimanga attivo e integro.

La libreria mesh senza proxy gRPC o il proxy sidecar gestirà il cookie della sessione, ma il codice dell'applicazione client è responsabile della copia del cookie da ogni RPC nella sessione a quella successiva.

Rappresentazione JSON 
{
  "cookieTtl": string
}
Campi
cookieTtl

string (Duration format)

Obbligatorio. Il valore TTL del cookie per l'intestazione Set-Cookie generata dal piano dati. La durata del cookie può essere impostata su un valore compreso tra 1 e 86.400 secondi (24 ore) inclusi.

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

HttpDirectResponse

Oggetto di risposta HTTP statica da restituire.

Rappresentazione JSON 
{
  "status": integer,

  // Union field HttpBody can be only one of the following:
  "stringBody": string,
  "bytesBody": string
  // End of list of possible types for union field HttpBody.
}
Campi
status

integer

Obbligatorio. Stato da restituire come parte della risposta HTTP. Deve essere un numero intero positivo.
Campo unione HttpBody. Corpo da restituire come parte della risposta HTTP. HttpBody può essere solo uno dei seguenti:
stringBody

string

Facoltativo. Corpo della risposta come stringa. La lunghezza massima del corpo è di 1024 caratteri.
bytesBody

string (bytes format)

Facoltativo. Corpo della risposta in byte. La dimensione massima del corpo è 4096 miliardi.

Una stringa con codifica base64.

Metodi

create

 Crea un nuovo percorso HTTP in un determinato progetto e posizione.

delete

 Consente di eliminare un singolo HttpRoute.

get

 Recupera i dettagli di un singolo HttpRoute.

getIamPolicy

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

list

 Elenca HttpRoute in un determinato progetto e località.

patch

 Aggiorna i parametri di un singolo HttpRoute.

setIamPolicy

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

testIamPermissions

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