Stai visualizzando la documentazione di Apigee Edge.
Consulta la
documentazione di Apigee X. info
Questa sezione fornisce informazioni di riferimento sulle variabili di flusso.
Apigee Edge definisce le seguenti variabili di flusso:
apigeeloadbalancingrouteapiproxymessagerouterapplicationmessageidservicecalloutclientorganizationsystemcurrentproxytargetenvironmentratelimitvariableerrorrequestvirtualhostisresponse
Ognuna di queste variabili è descritta nelle sezioni seguenti.
apigee
Una variabile helper che fornisce informazioni sul tempo di esecuzione del criterio.
La tabella seguente descrive le proprietà della variabile apigee:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
apigee.metrics.policy.policy_name.timeTaken |
Numero intero | Sola lettura | Il tempo, in nanosecondi, impiegato per l'esecuzione del criterio. | Norme |
apiproxy
Descrive il proxy API.
La tabella seguente descrive le proprietà della variabile apiproxy:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
apiproxy.name |
Stringa | Sola lettura | Nome del proxy API. Ad esempio, "Il mio proxy". | Richiesta proxy |
apiproxy.revision |
Stringa | Sola lettura | Il numero di revisione di un proxy API. Ad esempio, "6". | Richiesta proxy |
Per saperne di più sull'utilizzo dei proxy API, consulta Informazioni sulle API e sui proxy API.
application
Un contenitore per la proprietà application.basepath.
La tabella seguente descrive le proprietà della variabile application:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
application.basepath |
Stringa | Sola lettura | Il percorso di base del deployment (specificato durante il deployment dell'API). | Richiesta proxy |
client
L'applicazione o il sistema che ha inviato una richiesta al router Edge.
La tabella seguente descrive le proprietà della variabile client:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
client.cn |
Stringa | Sola lettura |
Il nome comune specificato nel certificato TLS/SSL presentato dall'app client. |
Richiesta proxy |
client.country |
Stringa | Sola lettura |
Il paese nel certificato TLS/SSL presentato dall'app client. |
Richiesta proxy |
client.email.address |
Stringa | Sola lettura |
L'indirizzo email nel certificato TLS/SSL presentato dall'app client. |
Richiesta proxy |
client.host |
Stringa | Sola lettura |
L'IP host HTTP associato alla richiesta ricevuta da ProxyEndpoint. |
Richiesta proxy |
client.ip |
Stringa | Sola lettura |
L'indirizzo IP del client o del sistema che invia il messaggio al router Edge. Ad esempio, potrebbe trattarsi dell'IP client originale o di un IP del bilanciatore del carico. |
Richiesta proxy |
client.locality |
Stringa | Sola lettura |
La località (città) nel certificato TLS/SSL presentato dal client. |
Richiesta proxy |
client.organization |
Stringa | Sola lettura | L'organizzazione nel certificato TLS/SSL presentato dal client. (Non necessariamente equivalente all'organizzazione su Apigee Edge.) | Richiesta proxy |
client.organization.unit |
Stringa | Sola lettura |
L'unità organizzativa nel certificato TLS/SSL presentato dal client. |
Richiesta proxy |
client.port |
Numero intero | Sola lettura |
La porta HTTP associata alla richiesta del client di origine a ProxyEndpoint. |
Richiesta proxy |
client.received.end.time |
Stringa | Sola lettura |
L'ora, espressa in formato stringa, in cui il proxy ha terminato di ricevere la richiesta dal client di origine in ProxyEndpoint. Ad esempio: mercoledì 21 agosto 2013 19:16:47 UTC. Questo valore temporale è la rappresentazione in formato stringa della quantità di timestamp a 32 bit corrispondente. Ad esempio, "Wed, 21 Aug 2013 19:16:47 UTC" corrisponde al valore del timestamp 1377112607413. |
Richiesta proxy |
client.received.end.timestamp |
Lungo | Sola lettura |
Il valore del timestamp che specifica quando il proxy ha terminato di ricevere la richiesta dal client di origine in ProxyEndpoint. Questo valore è un numero intero (long) a 64 bit contenente il numero di millisecondi trascorsi dalla mezzanotte del 1° gennaio 1970 UTC. |
Richiesta proxy |
client.received.start.time |
Stringa | Sola lettura |
L'ora, espressa in formato stringa, in cui il proxy ha iniziato a ricevere la richiesta dal client di origine in ProxyEndpoint. Ad esempio: mercoledì 21 agosto 2013 19:16:47 UTC Questo valore temporale è la rappresentazione in formato stringa della quantità di timestamp a 32 bit corrispondente. Ad esempio, "Wed, 21 Aug 2013 19:16:47 UTC" corrisponde al valore del timestamp 1377112607413. |
Richiesta proxy |
client.received.start.timestamp |
Lungo | Sola lettura |
Il valore del timestamp che specifica quando il proxy ha iniziato a ricevere la richiesta dal client di origine in ProxyEndpoint. Questo valore è un numero intero (long) a 64 bit contenente il numero di millisecondi trascorsi dalla mezzanotte del 1° gennaio 1970 UTC. |
Richiesta proxy |
client.scheme |
Stringa | Sola lettura |
Restituisce http o https a seconda del trasporto utilizzato dall'app client per inviare il messaggio di richiesta. |
Richiesta proxy |
client.sent.end.time |
Stringa | Sola lettura |
L'ora, espressa in formato stringa, in cui il proxy ha terminato l'invio della risposta da ProxyEndpoint al client. Ad esempio: "Wed, 21 Aug 2013 19:16:47 UTC". Questo valore è una rappresentazione di stringa del |
PostClientFlow |
client.sent.end.timestamp |
Lungo | Sola lettura | Il valore del timestamp che specifica quando ProxyEndpoint ha terminato di restituire la risposta all'app client di origine. Questo valore è un numero intero a 64 bit (long) contenente il numero di millisecondi trascorsi dalla mezzanotte del 1° gennaio 1970 UTC. | PostClientFlow |
client.sent.start.time |
Stringa | Sola lettura | L'ora, espressa in formato stringa, in cui ProxyEndpoint ha iniziato a restituire la
risposta all'app client di origine. Ad esempio, "Wed, 21 Aug 2013 19:16:47 UTC".
Questo valore è una rappresentazione di stringa del |
PostClientFlow |
client.sent.start.timestamp |
Lungo | Sola lettura | Quando il proxy ha iniziato a inviare la risposta al client da ProxyEndpoint. Questo valore è espresso come numero intero a 64 bit (long) contenente il numero di millisecondi trascorsi dalla mezzanotte del 1° gennaio 1970 UTC. | PostClientFlow |
client.ssl.enabled |
Stringa | Sola lettura |
"true" se ProxyEndpoint è configurato per TLS/SSL; altrimenti "false". |
Richiesta proxy |
client.state |
Stringa | Sola lettura |
Lo stato nel certificato TLS/SSL presentato dal client. |
Richiesta proxy |
current
Contiene informazioni sul flusso del proxy API corrente.
La tabella seguente descrive le proprietà della variabile current:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
current.flow.name |
Stringa | Sola lettura | Il nome del flusso attualmente in esecuzione (ad esempio "PreFlow", "PostFlow" o il nome di un flusso condizionale). | Richiesta proxy |
current.flow.description |
Stringa | Sola lettura | La descrizione del flusso attualmente in esecuzione. Corrisponde al valore
dell'elemento <Description> nella configurazione XML del flusso. |
Richiesta proxy |
Puoi visualizzare queste proprietà nella visualizzazione Traccia dell'interfaccia utente Edge. Tuttavia, queste proprietà non sono visibili per impostazione predefinita nella visualizzazione Trace dell'interfaccia utente classica.
environment
Un contenitore per la proprietà environment.name.
La tabella seguente descrive le proprietà della variabile environment:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
environment.name |
Stringa | Sola lettura | Il nome dell'ambiente in cui è stata eseguita la transazione. | Richiesta proxy |
error
Un oggetto contestuale che rappresenta un messaggio di errore nel flusso di errori.
La tabella seguente descrive le proprietà della variabile error:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
error |
message |
Lettura/scrittura | Errore di tipo message, che è un oggetto contestuale nel flusso di errori. |
Errore |
error.content |
Stringa | Lettura/scrittura | Contenuto dell'errore. | Errore |
error.message |
Stringa | Sola lettura |
Messaggio associato a un errore, il cui valore è disponibile solo prima dell'esecuzione del flusso di errori. |
Errore |
error.status.code |
Numero intero | Sola lettura |
Il codice di stato HTTP associato all'errore. Ad esempio, "400". |
Errore |
error.reason.phrase |
Stringa | Sola lettura |
La frase di motivo associata all'errore. Ad esempio: "Richiesta errata". |
Errore |
error.transport.message |
TransportMessage | Sola lettura |
Qualsiasi errore di tipo TransportMessage. |
Errore |
error.state |
Numero intero | Sola lettura |
Stato nel flusso in cui si è verificato un errore. |
Errore |
error.header.header_name |
Stringa | Lettura/scrittura |
Recupera o imposta l'intestazione della risposta. |
Errore |
fault
Una variabile di flusso impostata su un codice di errore di runtime quando un criterio genera un errore. I valori dei codici di errore sono specifici per ogni norma.
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
fault.fault_name |
Stringa | Sola lettura | fault_name è il nome dell'errore, come descritto nella tabella Errori di runtime inclusa in ogni argomento di riferimento alle norme. | Errore |
is
Un contenitore per la proprietà is.error.
La tabella seguente descrive le proprietà della variabile is:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
is.error |
Booleano | Sola lettura |
Flag di errore. |
Richiesta proxy |
loadbalancing
Fornisce informazioni sullo stato del bilanciamento del carico di TargetEndpoint.
La tabella seguente descrive le proprietà della variabile loadbalancing:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
loadbalancing.failedservers |
Array di stringhe | Sola lettura |
Elenco dei TargetServer non riusciti durante il bilanciamento del carico in TargetEndpoint. |
Risposta target |
loadbalancing.isfallback |
Booleano | Sola lettura |
"true" se il fallback è abilitato per TargetServer richiamato durante il bilanciamento del carico in TargetEndpoint. |
Risposta target |
loadbalancing.targetserver |
Stringa | Sola lettura |
TargetServer richiamato durante il bilanciamento del carico in TargetEndpoint. Imposta solo se l'elemento
|
Risposta target |
message
Un oggetto contestuale, con lo stesso valore di request nel flusso di richiesta
o di response nel flusso di risposta o di error nel flusso di errore.
La tabella seguente descrive le proprietà della variabile message:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
message |
message |
Lettura/scrittura |
Un oggetto contestuale, con lo stesso valore di |
Richiesta proxy |
message.content |
Stringa | Lettura/scrittura |
Contenuto della richiesta, della risposta o del messaggio di errore. |
Richiesta proxy |
message.formparam.param_name |
Stringa | Lettura/scrittura |
Valore del parametro del modulo specificato. |
Richiesta proxy |
message.formparam.param_name. |
Raccolta | Sola lettura |
Tutti i valori del parametro del modulo specificato nel messaggio. |
Richiesta proxy |
message.formparam.param_name. |
Numero intero | Sola lettura |
Conteggio dei valori dei parametri del modulo specificati nel messaggio./p> |
Richiesta proxy |
message.formparams.count |
Numero intero | Sola lettura |
Conteggio di tutti i parametri del modulo nel messaggio. |
Richiesta proxy |
message.formparams.names |
Raccolta | Sola lettura |
Valore di tutti i parametri del modulo nel messaggio. |
Richiesta proxy |
message.formstring |
Stringa | Sola lettura |
Valore della stringa del modulo nel messaggio. |
Richiesta proxy |
message.header.header_name |
Stringa | Lettura/scrittura |
Recupera o imposta il valore dell'intestazione HTTP specificata nel messaggio. Se l'intestazione
contiene una virgola, durante la lettura riceverai solo il segmento di testo fino alla prima
virgola. Se vuoi l'intera intestazione, utilizza il modulo
|
Richiesta proxy |
message.header.header_name.N |
Stringa | Lettura/scrittura |
Il valore dell'intestazione particolare Nth nel messaggio, richiesta o risposta, a seconda dello stato del flusso. Apigee Edge divide i valori del testo dell'intestazione in base alle virgole. Tieni presente che l'indice il cui valore viene utilizzato per N è basato su 1, non su 0. Ad esempio: se l'intestazione |
Richiesta proxy |
message.header.header_name. |
Raccolta | Sola lettura |
Tutti i valori del nome dell'intestazione HTTP specificato nel messaggio. |
Richiesta proxy |
message.header.header_name. |
Numero intero | Sola lettura |
Conteggio dei valori del nome dell'intestazione HTTP specificato nel messaggio. |
Richiesta proxy |
message.headers.count |
Numero intero | Sola lettura |
Conteggio di tutte le intestazioni HTTP nel messaggio. |
Richiesta proxy |
message.headers.names |
Raccolta | Sola lettura |
Valore di tutte le intestazioni HTTP nel messaggio |
Richiesta proxy |
message.path |
Stringa | Lettura/scrittura |
Il percorso completo del messaggio di richiesta nell'URL, esclusi i parametri di query. |
Richiesta proxy |
message.queryparam.param_name |
Stringa | Sola lettura |
Restituisce il parametro di query del messaggio specificato. |
Richiesta proxy |
message.queryparam.param_name.N |
Stringa | Lettura/scrittura |
Il valore del parametro di query Nth nel messaggio. Ad esempio, se
Come esempio di scrittura di più valori per un singolo nome di parametro di query, ad esempio "type=siteid:1&type=language:us-en&type=currency:USD", imposta quanto segue:
|
Richiesta proxy |
message.queryparam.param_name. |
Raccolta | Sola lettura |
Tutti i valori di un determinato parametro di query nel messaggio, formattati come un elenco separato da virgole. Ad esempio, se la stringa di query è |
Richiesta proxy |
message.queryparam.param_name. |
Numero intero | Sola lettura |
Il conteggio totale di un parametro di query specificato associato alla richiesta inviata a ProxyEndpoint dall'app client. |
Richiesta proxy |
message.queryparams.count |
Numero intero | Sola lettura |
Il conteggio totale di tutti i parametri di query associati alla richiesta inviata a ProxyEndpoint dall'app client. |
Richiesta proxy |
message.queryparams.names |
Raccolta | Sola lettura |
Un elenco di tutti i nomi dei parametri di query associati alla richiesta inviata a ProxyEndpoint dall'app client. Per scorrere i nomi dei parametri di query utilizzando JavaScript, consulta il seguente post della community Apigee: How do you iterate Collection from "request.queryparams.names" in JS? nella community di Apigee. |
Richiesta proxy |
message.querystring |
Stringa | Sola lettura |
Una stringa contenente tutti i nomi e i valori dei parametri di query associati alla richiesta inviata a ProxyEndpoint dall'app client. Ad esempio, per la richiesta "http://api.apifactory.com/inventors?name=nick&surname=danger",
il valore di |
Richiesta proxy |
message.reason.phrase |
Stringa | Sola lettura |
ReasonPhrase del messaggio di risposta dalla destinazione. |
Risposta target |
message.status.code |
Numero intero | Sola lettura |
Codice di stato HTTP del messaggio di risposta dalla destinazione. |
Risposta target |
message.transport.message |
TransportMessage | Sola lettura |
Messaggio di tipo TransportMessage, che è un oggetto contestuale. |
Richiesta proxy |
message.uri |
Stringa | Sola lettura |
Il percorso URI completo (dopo l'URL del dominio), inclusi i parametri di query. Ad esempio, per la richiesta "http://api.apifactory.com/inventors?name=nikola&surname=tesla", questa variabile restituisce "inventors?name=nikola&surname=tesla". |
Richiesta proxy |
message.verb |
Stringa | Sola lettura |
Il verbo HTTP ( |
Richiesta proxy |
message.version |
Stringa | Lettura/scrittura |
La versione HTTP associata alla richiesta inviata a ProxyEndpoint dall'applicazione client. |
Richiesta proxy |
Per ulteriori informazioni sui messaggi, consulta Riferimento per le funzioni dei modelli di messaggio.
messageid
Un contenitore per l'ID univoco a livello globale della richiesta.
La tabella seguente descrive le proprietà della variabile messageid:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
messageid |
Stringa | Sola lettura |
Contiene l'ID univoco globale per la richiesta, che include il nome host del router. Questo ID consente di monitorare le richieste ricevute dal router dopo l'invio al processore di messaggi. Questo ID viene registrato nei log degli errori di Edge per correlare |
Richiesta proxy |
organization
Un contenitore per la proprietà organization.name.
La tabella seguente descrive le proprietà della variabile organization:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
organization.name |
Stringa | Sola lettura |
Nome dell'organizzazione. |
Richiesta proxy |
Per ulteriori informazioni sulle organizzazioni, consulta la sezione Informazioni sulle organizzazioni.
proxy
La configurazione del proxy API.
La tabella seguente descrive le proprietà della variabile proxy:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
proxy.basepath |
Stringa | Sola lettura |
Il valore del percorso di base nella configurazione del proxy API. Il percorso di base è il frammento di URI che segue l'host nell'URL. Gli URI di flusso condizionale seguono il percorso di base. Nell'URL "http://myorg-test.apigee.net/v2/weatherapi/forecastrss?w=12797282":
L'unico modo per saperlo è esaminare la definizione del proxy API o controllare il valore della variabile proxy.basepath. Il suffisso del percorso proxy segue il percorso di base ("/forecastrss"), insieme a eventuali parametri di ricerca. Se definisci un percorso di base dinamico nella configurazione del proxy API, ad esempio "/v2/*/weatherapi", questa variabile viene impostata sul percorso dinamico ("/v2/*/weatherapi"), anche se il percorso di base viene risolto in un valore statico, ad esempio "/v2/foo/weatherapi". |
Richiesta proxy |
proxy.client.ip |
Stringa | Sola lettura |
L'indirizzo |
Richiesta proxy |
proxy.name |
Stringa | Sola lettura |
L'attributo name configurato per ProxyEndpoint. |
Richiesta proxy |
proxy.pathsuffix |
Stringa | Sola lettura |
Il valore del suffisso del percorso di base del proxy API inviato dal client e ricevuto in ProxyEndpoint. Il percorso di base è definito come il componente del percorso che identifica in modo univoco il proxy API. L'URL pubblico di un proxy API è composto dal nome della tua organizzazione, dall'ambiente in cui viene eseguito il deployment del proxy, dal percorso di base, dal suffisso del percorso di base e da eventuali parametri di ricerca. Ad esempio, in una richiesta a |
Richiesta proxy |
proxy.url |
Stringa | Sola lettura |
Recupera l'URL completo associato alla richiesta proxy ricevuta da ProxyEndpoint,
inclusi eventuali parametri di query presenti.
L'host dell'URL sarà sempre Per un esempio di creazione di un URL |
Richiesta proxy |
Per saperne di più sull'utilizzo dei proxy API, consulta Informazioni sulle API e sui proxy API.
ratelimit
Viene compilato quando viene eseguita una policy Quota o SpikeArrest.
La tabella seguente descrive le proprietà della variabile ratelimit:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
| ratelimit.policy_name.allowed.count | Lungo | Sola lettura | Restituisce il conteggio della quota consentita. | PostClientFlow |
| ratelimit.policy_name.used.count | Lungo | Sola lettura | Restituisce la quota corrente utilizzata all'interno di un intervallo di quota. | PostClientFlow |
| ratelimit.policy_name.available.count | Lungo | Sola lettura | Restituisce il conteggio della quota disponibile nell'intervallo di quota. | PostClientFlow |
| ratelimit.policy_name.exceed.count | Lungo | Sola lettura | Restituisce 1 dopo il superamento della quota. | PostClientFlow |
| ratelimit.policy_name.total.exceed.count | Lungo | Sola lettura | Restituisce 1 dopo il superamento della quota. | PostClientFlow |
| ratelimit.policy_name.expiry.time | Lungo | Sola lettura |
Restituisce l'ora UTC (in millisecondi), che determina la scadenza della quota e l'inizio del nuovo intervallo di quota. Quando il tipo di criterio Quota è |
PostClientFlow |
| ratelimit.policy_name.identifier | Stringa | Sola lettura | Restituisce il riferimento all'identificatore (client) allegato alle norme | PostClientFlow |
| ratelimit.policy_name.class.allowed.count | Lungo | Sola lettura | Restituisce il conteggio della quota consentita definita nella classe | PostClientFlow |
| ratelimit.policy_name.class.used.count | Lungo | Sola lettura | Restituisce la quota utilizzata all'interno di un corso | PostClientFlow |
| ratelimit.policy_name.class.available.count | Lungo | Sola lettura | Restituisce il conteggio delle quote disponibili nella classe | PostClientFlow |
| ratelimit.policy_name.class.exceed.count | Lungo | Sola lettura | Restituisce il conteggio delle richieste che superano il limite nella classe nell'intervallo di quota corrente | PostClientFlow |
| ratelimit.policy_name.class.total.exceed.count | Lungo | Sola lettura | Restituisce il conteggio totale delle richieste che superano il limite nella classe in tutti gli intervalli di quota, quindi è la somma di class.exceed.count per tutti gli intervalli di quota. |
PostClientFlow |
| ratelimit.policy_name.failed | Booleano | Sola lettura |
Indica se il criterio non è stato rispettato (true o false). |
PostClientFlow |
Per ulteriori informazioni, consulta le seguenti risorse:
- Limitazione di frequenza
- Confronto tra i criteri Quota e SpikeArrest
- Criteri per le quote
- Norme SpikeArrest
request
La richiesta completa, incluso l'eventuale payload presente.
Per saperne di più sui dati delle richieste, vedi Come vengono passati i dati delle richieste al server di backend?
La tabella seguente descrive le proprietà della variabile request:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
request |
message |
Sola lettura |
La richiesta completa, incluso l'eventuale payload presente. |
Richiesta proxy |
request.content |
Stringa | Lettura/scrittura |
Ottiene o imposta il payload del messaggio di richiesta. |
Richiesta proxy |
request.formparam.param_name |
Stringa | Lettura/scrittura |
Ottiene o imposta il valore del parametro del modulo specificato nella richiesta inviata dall'applicazione client. |
Richiesta proxy |
request.formparam.param_name. |
Raccolta | Sola lettura |
Tutti i valori di un determinato parametro del modulo nella richiesta, formattati come elenco separato da virgole. Ad esempio, se il payload è
"a=hello&x=greeting&a=world", il valore di
|
Richiesta proxy |
request.formparam.param_name. |
Numero intero | Sola lettura |
Conteggio di tutti i valori per il parametro del modulo specificato associato alla richiesta. |
Richiesta proxy |
request.formparam.param_name.N |
Stringa | Lettura/scrittura |
Il valore dell'N-esimo parametro del modulo specifico nel messaggio. Ad esempio, se
la stringa del modulo è "a=hello&a=world", il valore restituito di
|
Richiesta proxy |
request.formparams.count |
Numero intero | Sola lettura |
Conteggio di tutti i parametri del modulo associati alla richiesta inviata dall'applicazione client. |
Richiesta proxy |
request.formparams.names |
Raccolta | Sola lettura |
Un elenco di tutti i nomi dei parametri del modulo associati alla richiesta. |
Richiesta proxy |
request.formstring |
Stringa | Sola lettura |
Il Ad esempio, "name=test&type=first&group=A". |
Richiesta proxy |
request.header.header_name |
Stringa | Lettura/scrittura |
Recupera o imposta il valore di una determinata intestazione trovata nella richiesta. Se l'intestazione contiene una virgola, durante la lettura riceverai solo il segmento di testo fino alla prima virgola. Se vuoi l'intera intestazione, utilizza il modulo
|
Richiesta proxy |
request.header.header_name.N |
Stringa | Lettura/scrittura |
Il valore dell'ennesimo valore di intestazione specifico nella richiesta. Apigee Edge divide i valori di testo dell'intestazione in base alle virgole. Tieni presente che l'indice il cui valore viene utilizzato per N è basato su 1, non su 0. Ad esempio, se l'intestazione |
Richiesta proxy |
request.header.header_name. |
Raccolta | Sola lettura |
Tutti i valori di una determinata intestazione nella richiesta. |
Richiesta proxy |
request.header.header_name. |
Numero intero | Sola lettura |
Conteggio di tutti i valori di una determinata intestazione nella richiesta. |
Richiesta proxy |
request.headers.count |
Numero intero | Sola lettura |
Conteggio di tutte le intestazioni nella richiesta. |
Richiesta proxy |
request.headers.names |
Raccolta | Sola lettura |
Nomi di tutte le intestazioni nella richiesta. |
Richiesta proxy |
request.path |
Stringa | Sola lettura |
Il percorso della risorsa senza proxy (senza includere l'host) al servizio di backend, esclusi i parametri di ricerca. Ad esempio, se l'URI del servizio di backend è
"https://example.com/rest/api/latest", il valore di
|
Richiesta proxy |
request.queryparam.param_name |
Stringa | Lettura/scrittura |
Il valore di un determinato parametro di query trovato nella richiesta. |
Richiesta proxy |
request.queryparam.param_name.N |
Stringa | Lettura/scrittura |
Il valore del parametro query Nth nella richiesta. Ad esempio, se Come esempio di scrittura di più valori per un singolo nome di parametro di query, ad esempio "type=siteid:1&type=language:us-en&type=currency:USD", imposta quanto segue:
|
Richiesta proxy |
request.queryparam.param_name. |
Raccolta | Sola lettura |
Tutti i valori di un determinato parametro di query nella richiesta, formattati come elenco separato da virgole. Ad esempio, se |
Richiesta proxy |
request.queryparam.param_name. |
Numero intero | Sola lettura |
Il conteggio di tutti i valori di un determinato parametro di query nella richiesta. |
Richiesta proxy |
request.queryparams.count |
Numero intero | Sola lettura |
Il conteggio di tutti i parametri della query nella richiesta. |
Richiesta proxy |
request.queryparams.names |
Raccolta | Sola lettura |
I nomi di tutti i parametri di query nella richiesta. Per scorrere i nomi dei parametri di query utilizzando JavaScript, consulta How do you iterate Collection from "request.queryparams.names" in JS? nella community Apigee. |
Richiesta proxy |
request.querystring |
Stringa | Sola lettura |
L'elenco completo dei parametri di query nella richiesta inviata dall'app client. Ad esempio, se la richiesta è "http://host.com/123?name=first&surname=second&place=address", questa variabile restituisce "name=first&surname=second&place=address". |
Richiesta proxy |
request.transportid |
Stringa | Sola lettura |
ID della richiesta di tipo TransportMessage, che è un oggetto contestuale. |
Richiesta proxy |
request.transport.message |
Transport-Message | Sola lettura |
Richiesta di tipo TransportMessage, che è un oggetto contestuale. |
Richiesta proxy |
request.uri |
Stringa | Sola lettura |
In un proxy API, il proxy
Punti per
Nella richiesta, Nella risposta, La differenza è dovuta al fatto che la richiesta originale è arrivata al proxy, ma poi il proxy effettua un'altra richiesta al servizio di destinazione. Supponiamo che venga effettuata la seguente chiamata al nostro proxy di esempio, che ha un percorso di base "/my-mock-proxy":
E le chiamate proxy:
che aggiunge "/user?user=Dude" all'URL.
|
Richiesta proxy (differisce nella risposta) |
request.url |
Stringa | Sola lettura |
L'URL completo della richiesta inviata all'endpoint di destinazione, inclusi i parametri della stringa di query, ma non il numero di porta (se specificato). Ad esempio, se effettui una chiamata a un proxy di esempio "http://my_org-test.apigee.net/my-mock-proxy/user?user=Dude" e l'endpoint di destinazione è "http://example.com:8080", il valore è:
|
Risposta target |
request.verb |
Stringa | Sola lettura |
Il verbo HTTP utilizzato per la richiesta. Ad esempio, "GET", "PUT" e "DELETE". |
Richiesta proxy |
request.version |
Stringa | Sola lettura |
La versione HTTP della richiesta. Ad esempio, "1.1". |
Richiesta proxy |
response
La risposta completa, incluso l'eventuale payload presente.
La tabella seguente descrive le proprietà della variabile response:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
response |
message |
Lettura/scrittura |
Messaggio di risposta completo restituito dalla destinazione. |
Risposta target |
response.content |
Stringa | Lettura/scrittura |
Contenuto del payload del messaggio di risposta restituito dalla destinazione. |
Risposta target |
response.formparam.param_name |
Stringa | Lettura/scrittura |
Il valore di un parametro del modulo nella risposta. |
Risposta target |
response.formparam.param_name. |
Numero intero | Sola lettura |
Conteggio di tutti i valori del parametro del modulo specificato nella risposta. |
Risposta target |
response.formparams.count |
Numero intero | Sola lettura |
Conteggio di tutti i parametri del modulo nella risposta. |
Risposta target |
response.formparams.names |
Raccolta | Sola lettura |
I nomi di tutti i parametri del modulo nella risposta. |
Risposta target |
response.header.header_name |
Stringa | Lettura/scrittura |
Ottiene o imposta il valore di un'intestazione HTTP specificata nella risposta. Se il testo dell'intestazione include una virgola, Apigee Edge deduce più valori. In questo caso,
Per leggere l'intera intestazione, utilizza il modulo |
Risposta target |
response.header.header_name. |
Raccolta | Sola lettura |
Tutti i valori di un'intestazione HTTP specificata nella risposta. |
Risposta target |
response.header.header_name. |
Numero intero | Sola lettura |
Conteggio di tutti i valori dell'intestazione HTTP specificata nella risposta. |
Risposta target |
response.header.header_name.N |
Stringa | Lettura/scrittura |
Il valore dell'ennesimo valore di intestazione specifico nella risposta. Apigee Edge divide i valori di testo dell'intestazione in base alle virgole. Tieni presente che l'indice il cui valore viene utilizzato per N è basato su 1, non su 0. Ad esempio, se l'intestazione |
Risposta target |
response.headers.count |
Numero intero | Sola lettura |
Conteggio di tutte le intestazioni nella risposta. |
Risposta target |
response.headers.names |
Raccolta | Sola lettura |
I nomi di tutte le intestazioni nella risposta. |
Risposta target |
response.reason.phrase |
Stringa | Lettura/scrittura |
La frase che indica il motivo della risposta per una determinata richiesta. |
Risposta target |
response.status.code |
Numero intero | Lettura/scrittura |
Il codice di risposta restituito per una richiesta. Puoi utilizzare questa variabile per ignorare il codice di stato della risposta, che è memorizzato in |
Risposta target |
response.transport.message |
Stringa | Sola lettura |
Risposta di tipo TransportMessage, che è un oggetto contestuale. |
Risposta target |
route
Specifica i nomi di <RouteRule> e TargetEndpoint.
La tabella seguente descrive le proprietà della variabile route:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
route.name |
Stringa | Sola lettura |
Il nome di |
Richiesta del target |
route.target |
Stringa | Sola lettura |
Il nome di TargetEndpoint che è stato eseguito. Ad esempio, "default". |
Richiesta del target |
router
Un contenitore per la proprietà router.uuid, che è stata ritirata.
La tabella seguente descrive le proprietà della variabile router:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
router.uuid |
Stringa | Sola lettura |
Deprecato e restituisce null. (In precedenza, l'UUID del router che gestisce il proxy). |
Richiesta proxy |
servicecallout
Descrive TargetEndpoint per un criterio ServiceCallout.
La tabella seguente descrive le proprietà della variabile servicecallout:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
servicecallout.policy_name.expectedcn |
Stringa | Lettura/scrittura |
Il nome comune previsto di TargetEndpoint a cui si fa riferimento in un criterio ServiceCallout. Questo è significativo solo quando TargetEndpoint fa riferimento a un endpoint TLS/SSL. |
Richiesta proxy |
servicecallout.policy_name.target.url |
Stringa | Lettura/scrittura |
L'URL TargetEndpoint per un determinato criterio ServiceCallout. |
Richiesta proxy |
servicecallout.requesturi |
Stringa | Lettura/scrittura |
L'URI TargetEndpoint per un criterio ServiceCallout. L'URI è l'URL TargetEndpoint senza la specifica di protocollo e dominio. |
Richiesta proxy |
system
Specifica l'indirizzo IP del sistema, nonché i dettagli sul proxy.
La tabella seguente descrive le proprietà della variabile system:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
system.interface.interface_name |
Stringa | Sola lettura |
L'indirizzo IP del sistema. |
Richiesta proxy |
system.pod.name |
Stringa | Sola lettura |
Il nome del pod in cui è in esecuzione il proxy. |
Richiesta proxy |
system.region.name |
Stringa | Sola lettura |
Il nome della regione del data center in cui è in esecuzione il proxy. |
Richiesta proxy |
system.time |
Stringa | Sola lettura |
L'ora in cui è stata letta questa variabile. Ad esempio, "Mer, 21 ago 2013 19:16:47 UTC". Questo valore è la rappresentazione in formato stringa del valore corrispondente di
|
Richiesta proxy |
system.time.year |
Numero intero | Sola lettura |
La parte relativa all'anno di |
Richiesta proxy |
system.time.month |
Numero intero | Sola lettura |
La parte del mese di |
Richiesta proxy |
system.time.day |
Numero intero | Sola lettura |
La parte del giorno del mese di |
Richiesta proxy |
system.time.dayofweek |
Numero intero | Sola lettura |
La parte del giorno della settimana di |
Richiesta proxy |
system.time.hour |
Numero intero | Sola lettura |
La parte relativa all'ora di |
Richiesta proxy |
system.time.minute |
Numero intero | Sola lettura |
La parte dei minuti di |
Richiesta proxy |
system.time.second |
Numero intero | Sola lettura |
La seconda parte di |
Richiesta proxy |
system.time.millisecond |
Numero intero | Sola lettura |
La parte in millisecondi di |
Richiesta proxy |
system.time.zone |
Stringa | Sola lettura |
Fuso orario del sistema. |
Richiesta proxy |
system.timestamp |
Lungo | Sola lettura |
L'intero (long) a 64 bit che rappresenta l'ora in cui è stata letta questa variabile. Il valore è il numero di millisecondi trascorsi dalla mezzanotte del 1° gennaio 1970 UTC. Ad esempio, "1534783015000". |
Richiesta proxy |
system.uuid |
Stringa | Sola lettura |
L'UUID del processore di messaggi che gestisce il proxy. |
Richiesta proxy |
target
Descrive la destinazione della richiesta.
La tabella seguente descrive le proprietà della variabile target:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
target.basepath |
Stringa | Sola lettura |
Il percorso della risorsa (senza includere il dominio) al servizio di destinazione, esclusi i parametri di query, definito in TargetEndpoint del proxy. Ad esempio, supponiamo che un proxy API chiami la seguente destinazione:
In questo esempio, Se il target fosse questo:
|
Richiesta del target |
target.copy.pathsuffix |
Booleano | Lettura/scrittura |
Se "true", la richiesta inoltrata da ProxyEndpoint a TargetEndpoint conserva il suffisso del percorso (il frammento del percorso URI che segue l'URI definito nel percorso base di ProxyEndpoint). |
Richiesta del target |
target.copy.queryparams |
Booleano | Lettura/scrittura |
Se "true", la richiesta inoltrata da ProxyEndpoint a TargetEndpoint conserva i parametri di query. |
Richiesta del target |
target.country |
Stringa | Sola lettura |
Paese del certificato TLS/SSL presentato dal server di destinazione |
Risposta target |
target.cn |
Stringa | Sola lettura |
Il nome comune di TargetEndpoint. Questo è significativo solo quando TargetEndpoint si riferisce a un endpoint TLS/SSL. |
Richiesta del target |
target.email.address |
Stringa | Sola lettura |
Indirizzo email del certificato TLS/SSL presentato dal server di destinazione |
Risposta target |
target.expectedcn |
Stringa | Lettura/scrittura |
Il nome comune previsto di TargetEndpoint. Questo valore è significativo solo quando TargetEndpoint fa riferimento a un endpoint TLS/SSL. |
Richiesta proxy |
target.host |
Stringa | Sola lettura |
Il nome di dominio del servizio di destinazione che restituisce la risposta al proxy API. |
Risposta target |
target.ip |
Stringa | Sola lettura |
L'indirizzo IP del servizio di destinazione che restituisce la risposta al proxy API. |
Risposta target |
target.locality |
Stringa | Sola lettura |
Località (città) del certificato TLS/SSL presentato dal server di destinazione |
Risposta target |
target.name |
Stringa | Sola lettura |
Destinazione a cui il messaggio arriva da targetendpoint. |
Richiesta del target |
target.organization |
Stringa | Sola lettura |
Organizzazione del certificato TLS/SSL presentato dal server di destinazione. |
Risposta target |
target.organization.unit |
Stringa | Sola lettura |
Unità organizzativa del certificato TLS/SSL presentato dal server di destinazione. |
Risposta target |
target.port |
Numero intero | Sola lettura |
Il numero di porta del servizio di destinazione che restituisce la risposta al proxy API. |
Risposta target |
target.received.end.time |
Stringa | Sola lettura |
L'ora, espressa in formato stringa, in cui TargetEndpoint ha terminato di ricevere la risposta dalla destinazione. Ad esempio, "Mer, 21 ago 2013 19:16:47 UTC". Questo valore temporale è la rappresentazione in formato stringa della quantità di timestamp a 32 bit corrispondente. Ad esempio, "Wed, 21 Aug 2013 19:16:47 UTC" corrisponde al valore del timestamp "1377112607413". |
Risposta target |
target.received.end. |
Lungo | Sola lettura |
Il valore del timestamp che specifica quando TargetEndpoint ha terminato di ricevere la risposta dalla destinazione. Ad esempio, "1534783015000". Questo valore è un numero intero (long) a 64 bit che specifica il numero di millisecondi trascorsi dalla mezzanotte del 1° gennaio 1970 UTC. |
Risposta target |
target.received.start.time |
Stringa | Sola lettura |
L'ora, espressa in formato stringa, in cui TargetEndpoint ha iniziato a ricevere la risposta dalla destinazione. Ad esempio, "Mer, 21 ago 2013 19:16:47 UTC". Questo valore temporale è la rappresentazione in formato stringa della quantità di timestamp a 32 bit corrispondente. Ad esempio, "Wed, 21 Aug 2013 19:16:47 UTC" corrisponde al valore del timestamp "1377112607413". |
Risposta target |
target.received.start. |
Lungo | Sola lettura |
Il valore del timestamp che specifica quando TargetEndpoint ha iniziato a ricevere la risposta dalla destinazione. Ad esempio, "1534783015000". Questo valore è un numero intero (long) a 64 bit che specifica il numero di millisecondi trascorsi dalla mezzanotte del 1° gennaio 1970 UTC. |
Risposta target |
target.scheme |
Stringa | Sola lettura |
Scope begins: Target response Restituisce http o https a seconda del messaggio di richiesta. |
Richiesta del target |
target.sent.end.time |
Stringa | Sola lettura |
L'ora, espressa in formato stringa, in cui il proxy ha smesso di inviare la richiesta all'URL specificato in TargetEndpoint. Ad esempio, "Mer, 21 ago 2013 19:16:47 UTC". Questo valore temporale è la rappresentazione in formato stringa della quantità di timestamp a 32 bit corrispondente. Ad esempio, "Wed, 21 Aug 2013 19:16:47 UTC" corrisponde al valore del timestamp "1377112607413". |
Richiesta del target |
target.sent.end.timestamp |
Lungo | Sola lettura |
Il valore del timestamp che specifica quando il proxy ha terminato l'invio della richiesta all'URL specificato in TargetEndpoint. Ad esempio, "1377112607413". Questo valore è un numero intero a 64 bit (long) contenente il numero di millisecondi trascorsi dalla mezzanotte del 1° gennaio 1970 UTC. |
Richiesta del target |
target.sent.start.time |
Stringa | Sola lettura |
L'ora, espressa in formato stringa, in cui il proxy ha iniziato a inviare la richiesta all'URL specificato in TargetEndpoint. Ad esempio, "Mer, 21 ago 2013 19:16:47 UTC". Questo valore temporale è la rappresentazione in formato stringa della quantità di timestamp a 32 bit corrispondente. Ad esempio, "Wed, 21 Aug 2013 19:16:47 UTC" corrisponde al valore del timestamp "1377112607413". |
Richiesta del target |
target.sent.start.timestamp |
Lungo | Sola lettura |
Il valore del timestamp che specifica quando il proxy ha iniziato a inviare la richiesta all'URL specificato in TargetEndpoint. Ad esempio, "1534783015000". Questo valore è un numero intero a 64 bit (long) che specifica il numero di millisecondi trascorsi dalla mezzanotte del 1° gennaio 1970 UTC. |
Richiesta del target |
target.ssl.enabled |
Booleano | Sola lettura |
Indica se TargetEndpoint è in esecuzione su TLS/SSL. |
Richiesta proxy |
target.state |
Stringa | Sola lettura |
Stato del certificato TLS/SSL presentato dal server di destinazione. |
Risposta target |
target.url |
Stringa | Lettura/scrittura |
L'URL configurato nel file XML TargetEndpoint o l'URL di destinazione dinamico (se
|
Richiesta del target |
variable
Un contenitore per la proprietà variable.expectedcn.
La tabella seguente descrive le proprietà della variabile variable:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
variable.expectedcn |
Stringa | Lettura/scrittura |
Variabile esposta per il nome comune se viene eseguita su TLS/SSL. |
Richiesta proxy |
Per saperne di più sull'utilizzo di TLS, consulta la Introduzione a TLS/SSL.
virtualhost
Specifica i dettagli sull'host virtuale.
La tabella seguente descrive le proprietà della variabile virtualhost:
| Proprietà | Tipo | Lettura/scrittura | Descrizione | Inizio dell'ambito |
|---|---|---|---|---|
virtualhost.aliases.values |
Array di stringhe | Sola lettura |
Alias host dell'host virtuale raggiunto durante una determinata richiesta. |
Richiesta proxy |
virtualhost.name |
Stringa | Sola lettura |
Nome dell'host virtuale che gestisce la richiesta del client di origine. |
Richiesta proxy |
virtualhost.ssl.enabled |
Booleano | Sola lettura |
Restituisce "true" se TLS/SSL è abilitato nella configurazione dell'host virtuale. |
Richiesta proxy |
Per ulteriori informazioni sull'utilizzo degli host virtuali, vedi Configurazione degli host virtuali.
