Questa pagina si applica ad Apigee e Apigee hybrid.
Visualizza la documentazione di Apigee Edge.
Questa sezione fornisce informazioni di riferimento sulle variabili di flusso.
Apigee definisce le seguenti variabili di flusso:
apigee
is
request
apiproduct
loadbalancing
response
apiproxy
message
route
client
messageid
servicecallout
current
mint
system
environment
organization
target
error
proxy
variable
fault
publishmessage
graphql
ratelimit
Ognuna di queste variabili è descritta nelle sezioni seguenti.
apigee
Una variabile helper che fornisce informazioni sulla data e l'ora di esecuzione del criterio.
Nella tabella seguente vengono descritte le proprietà della variabile apigee
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
apigee.metrics.policy.policy_name.timeTaken |
Numero intero | Sola lettura | Il tempo, in nanosecondi, impiegato per l'esecuzione del criterio. | Norme |
apiproduct
Una variabile helper che fornisce informazioni sui prodotti API.
Nella tabella seguente vengono descritte le proprietà della variabile apiproduct
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
apiproduct.operation |
Stringa | Sola lettura |
Nome dell'operazione del prodotto API. Questa variabile ti consente di distinguere tra le impostazioni dei criteri per le quote e le impostazioni delle quote nell'operazione di un prodotto API. Ad esempio, |
Richiesta proxy |
apiproduct.operation.resource |
Stringa | Sola lettura |
Il nome della risorsa dell'operazione abbinata a una richiesta. |
Richiesta proxy |
apiproduct.operation.methods |
Array | Sola lettura |
Un array di metodi HTTP consentiti dall'operazione abbinata. |
Richiesta proxy |
apiproduct.operation.attributes.key_name |
Array | Sola lettura |
Recupera il valore dell'attributo personalizzato che corrisponde a key_name. |
Richiesta proxy |
Per ulteriori informazioni, consulta le seguenti risorse:
apiproxy
Descrive il proxy API.
Nella tabella seguente vengono descritte le proprietà della variabile apiproxy
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
apiproxy.name |
Stringa | Sola lettura | Nome del proxy API. Ad esempio, My Proxy . |
Richiesta proxy |
apiproxy.revision |
Stringa | Sola lettura | Il numero di revisione di un proxy API. Ad esempio, 6 . |
Richiesta proxy |
apiproxy.basepath |
Stringa | Sola lettura | Il percorso di base del deployment (specificato durante il deployment dell'API). | Richiesta proxy |
Per saperne di più sull'utilizzo dei proxy API, consulta la pagina Informazioni su API e proxy API.
client
L'applicazione o il sistema che ha inviato una richiesta al bilanciatore del carico.
Nella tabella seguente vengono descritte le proprietà della variabile client
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
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 dell'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 bilanciatore del carico. Ad esempio, potrebbe trattarsi dell'IP del client originale o dell'IP di un 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). | 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 a ProxyEndpoint. Ad esempio: Wed, 21 Aug 2013 19:16:47 UTC. Questo valore temporale è la rappresentazione in formato stringa della quantità corrispondente del timestamp a 32 bit. Ad esempio, mercoledì 21 agosto 2013 19:16:47 UTC corrisponde al valore del timestamp di 1377112607413. |
Richiesta proxy |
client.received.end.timestamp |
Lungo | Sola lettura |
Il valore del timestamp che specifica quando il proxy ha finito di ricevere la richiesta dal client di origine a ProxyEndpoint. Questo valore è un numero intero a 64 bit (lungo) 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 a ProxyEndpoint. Ad esempio: Wed, 21 Aug 2013 19:16:47 UTC Questo valore temporale è la rappresentazione in formato stringa della quantità corrispondente del timestamp a 32 bit. Ad esempio, mercoledì 21 agosto 2013 19:16:47 UTC corrisponde al valore del timestamp di 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 a ProxyEndpoint. Questo valore è un numero intero a 64 bit (lungo) 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 di inviare la risposta da ProxyEndpoint al client. Ad esempio: mercoledì 21 ago 2013 19:16:47 UTC. Questo valore è una rappresentazione in formato stringa dell'elemento |
PostClientFlow |
client.sent.end.timestamp |
Lungo | Sola lettura | Il valore timestamp che specifica quando ProxyEndpoint ha terminato di restituire la risposta all'app client di origine. Questo valore è un numero intero a 64 bit (lungo) contenente il numero di millisecondi trascorsi dalla mezzanotte, il 1° gennaio 1970 UTC. | PostClientFlow |
client.sent.start.time |
Stringa | Sola lettura | L'ora, espressa in forma di stringa, in cui ProxyEndpoint ha iniziato a restituire la risposta all'app client di origine. Ad esempio, Mer 21 ago 2013 19:16:47 UTC.
Questo valore è una rappresentazione in formato stringa dell'elemento |
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 un numero intero a 64 bit (lungo) contenente il numero di millisecondi trascorsi dalla mezzanotte del 1° gennaio 1970 UTC. | PostClientFlow |
client.ssl.enabled |
Stringa | Sola lettura |
|
Richiesta proxy |
client.state |
Stringa | Sola lettura |
Lo stato nel certificato TLS/SSL presentato dal client. |
Richiesta proxy |
current
Contiene informazioni sul flusso proxy API corrente.
Nella tabella seguente vengono descritte le proprietà della variabile current
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
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 vista Trace dell'interfaccia utente di Apigee.
environment
Un contenitore per la proprietà environment.name
.
Nella tabella seguente vengono descritte le proprietà della variabile environment
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
environment.name |
Stringa | Sola lettura | Nome dell'ambiente in cui è stata eseguita la transazione. | Richiesta proxy |
error
Un oggetto contestuale che rappresenta un messaggio di errore nel flusso di errore.
Nella tabella seguente vengono descritte le proprietà della variabile error
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
error |
message |
Lettura/scrittura | Errore di tipo message , che è un oggetto contestuale nel flusso di errori. |
Errore |
error.content |
Stringa | Lettura/scrittura | Contenuti 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, |
Errore |
error.reason.phrase |
Stringa | Sola lettura |
La frase del motivo associata all'errore. Ad esempio: |
Errore |
error.transport.message |
TransportMessage | Sola lettura |
Qualsiasi errore di tipo |
Errore |
error.state |
Numero intero | Sola lettura |
Stato del flusso in cui si è verificato un errore. |
Errore |
error.header.header_name |
Stringa | Lettura/scrittura |
Ottieni o imposta l'intestazione della risposta. |
Errore |
fault
Fornisce informazioni sull'origine di un errore di runtime, sul motivo e sui dettagli. Apigee imposta queste variabili quando un criterio genera un errore e i valori sono specifici per ciascun criterio. Per capire quando sono impostate le variabili fault
, consulta
Informazioni sugli errori dei criteri.
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
fault.name |
Stringa | Sola lettura | Il nome dell'errore, come descritto nella tabella Errori di runtime inclusa in ogni argomento Riferimento dei criteri. Questa variabile può essere utile nelle condizioni applicate a FaultRules. | Errore |
fault.reason |
Stringa | Sola lettura | Il motivo dell'errore. Ad esempio, quando il criterio OASValidation rileva che una richiesta in entrata non viene convalidata in base alla specifica OpenAPI, imposta questa variabile su una stringa che descrive il nome del criterio, il nome della specifica e i dettagli che descrivono perché la richiesta non viene convalidata in base alla specifica. Gli altri criteri imposteranno questa variabile sui messaggi appropriati per i relativi errori. | Errore |
fault.category |
Stringa | Sola lettura | La categoria. Ad esempio, se l'errore si verifica in un passaggio del criterio, questa variabile potrebbe contenere il valore "Passaggio". Questa variabile può essere utile nelle condizioni applicate a FaultRules. | Errore |
fault.subcategory |
Stringa | Sola lettura | La sottocategoria. Ad esempio, se il criterio OASValidation rileva che una richiesta non viene convalidata in base a una specifica OpenAPI, imposta questa variabile su "OASValidationFailure". Questa variabile può essere utile nelle condizioni applicate a FaultRules. | Errore |
graphql
Ti permette di accedere ai risultati di una query GraphQL in fase di runtime. Per maggiori informazioni, consulta le norme di GraphaQL.
Nella tabella seguente vengono descritte le proprietà della variabile graphql
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | |
---|---|---|---|---|
graphql |
Tipo complesso | SOLA LETTURA/SCRITTURA LETTURA | La query GraphQL principale. | AMBITO |
graphql.fragment |
Tipo complesso | SOLA LETTURA/SCRITTURA LETTURA | Un riferimento al frammento predefinito per questa query. | AMBITO |
graphql.fragment.count |
Numero intero | Sola lettura | Il numero di framenti generati da questa query GraqhQL. | AMBITO |
graphql.fragment.INDEX.selectionSet.INDEX |
TIPO | SOLA LETTURA/SCRITTURA LETTURA | Un riferimento all'insieme di selezione nell'indice specificato. | AMBITO |
graphql.fragment.INDEX.selectionSet.INDEX.name |
Stringa | SOLA LETTURA/SCRITTURA LETTURA | Il nome dell'insieme di selezione nell'indice specificato. | AMBITO |
graphql.fragment.INDEX.selectionSet.count |
Numero intero | Sola lettura | Il numero di insiemi di selezione in questo frammento. | AMBITO |
graphql.fragment.INDEX.selectionSet.name |
Stringa | SOLA LETTURA/SCRITTURA LETTURA | Il nome dell'insieme di selezione predefinita nel frammento. | AMBITO |
graphql.operation |
Tipo complesso | SOLA LETTURA/SCRITTURA LETTURA | Un riferimento all'operazione predefinita della query.
Non puoi impostare le quote a livello di operazione. Impostali invece a livello di ambiente. |
AMBITO |
graphql.operation.name |
Stringa | Sola lettura | Il nome dell'operazione predefinita della query. | AMBITO |
graphql.operation.operationType |
Enumerazione | Sola lettura | Il tipo di operazione predefinita della query che può essere eseguita su questo proxy API. I valori possibili sono query , mutation o all . |
AMBITO |
graphql.operation.selectionSet |
Tipo complesso | La selezione predefinita impostata per l'operazione predefinita della query. | AMBITO | |
graphql.operation.selectionSet.count |
Numero intero | Sola lettura | Il numero di insiemi di selezione nell'operazione predefinita della query. | AMBITO |
graphql.operation.selectionSet.name |
Stringa | Sola lettura | Il nome dell'insieme di selezione predefinito dell'operazione predefinita della query. | AMBITO |
graphql.operation.selectionSet.INDEX |
Numero intero | Sola lettura | Un riferimento all'insieme di selezioni nell'indice specificato nell'elenco di insiemi di selezione. | AMBITO |
graphql.operation.selectionSet.INDEX.name |
Stringa | Sola lettura | Il nome della selezione nell'indice specificato nell'elenco dei set di selezione per questa operazione. | AMBITO |
graphql.operation.selectionSet.INDEX.[selectionSet] |
Tipo complesso | SOLA LETTURA/SCRITTURA LETTURA | Uno o più oggetti aggiuntivi del set di selezione.
È possibile accedere agli insiemi di selezione in modo ricorsivo. Ad esempio, dopo un
| AMBITO |
graphql.operation.selectionSet.INDEX.directive |
Tipo complesso | Un riferimento all'istruzione predefinita nell'insieme di selezione specificato. | AMBITO | |
graphql.operation.selectionSet.INDEX.directive.count |
Tipo complesso | AMBITO | ||
graphql.operation.selectionSet.INDEX.directive.INDEX |
Numero intero | Sola lettura | Un riferimento all'istruzione nell'indice specificato. | AMBITO |
graphql.operation.selectionSet.INDEX.directive.INDEX.argument.INDEX |
Numero intero | Sola lettura | Un riferimento all'argomento nell'indice specificato. | AMBITO |
graphql.operation.selectionSet.INDEX.directive.INDEX.argument.INDEX.name |
Stringa | Il nome dell'argomento nell'indice specificato. | AMBITO | |
graphql.operation.selectionSet.INDEX.directive.INDEX.argument.INDEX.value |
Stringa | Il valore dell'argomento nell'indice specificato. | AMBITO | |
graphql.operation.selectionSet.INDEX.directive.name |
Stringa | AMBITO | ||
graphql.operation.variableDefinitions |
Tipo complesso | Un riferimento a un elenco di definizioni di variabili per l'operazione predefinita della query. | AMBITO | |
graphql.operation.variableDefinitions.count |
Numero intero | Il numero di definizioni di variabili per l'operazione predefinita della query. | AMBITO | |
graphql.operation.variableDefinitions.INDEX |
Numero intero | Un riferimento alla definizione della variabile nell'indice specificato. | AMBITO | |
graphql.operation.variableDefinitions.INDEX.name |
Stringa | Il nome della definizione della variabile nell'indice specificato. | AMBITO | |
graphql.operation.variableDefinitions.INDEX.type |
Il tipo di valore della definizione della variabile nell'indice specificato. | AMBITO |
is
Un contenitore per la proprietà is.error
.
Nella tabella seguente vengono descritte le proprietà della variabile is
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
is.error |
Booleano | Sola lettura |
Flag di errore. |
Richiesta proxy |
loadbalancing
Fornisce informazioni sullo stato del bilanciamento del carico di TargetEndpoint.
Nella tabella seguente vengono descritte le proprietà della variabile loadbalancing
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
loadbalancing.failedservers |
Array di stringhe | Sola lettura |
Elenco di TargetServer non riusciti durante il bilanciamento del carico in TargetEndpoint. |
Risposta target |
loadbalancing.isfallback |
Booleano | Sola lettura |
|
Risposta target |
loadbalancing.targetserver |
Stringa | Sola lettura |
TargetServer richiamato durante il bilanciamento del carico in TargetEndpoint. Da impostare solo se
l'elemento |
Risposta target |
message
Un oggetto contestuale con lo stesso valore di request
nel flusso di richiesta, di response
nel flusso di risposta o di error
nel flusso di errori.
Nella tabella seguente vengono descritte le proprietà della variabile message
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
message |
message |
Lettura/scrittura |
Un oggetto contestuale con lo stesso valore di |
Richiesta proxy |
message.content |
Stringa | Lettura/scrittura |
Contenuto della richiesta, risposta o messaggio di errore. |
Richiesta proxy |
message.formparam.param_name |
Stringa | Lettura/scrittura |
Valore del parametro di modulo specificato. |
Richiesta proxy |
message.formparam.param_name. |
Raccolta | Sola lettura |
Tutti i valori del parametro di modulo specificato nel messaggio. |
Richiesta proxy |
message.formparam.param_name. |
Numero intero | Sola lettura |
Conteggio dei valori dei parametri di 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 di una determinata intestazione trovata nella richiesta. Se l'intestazione contiene una virgola, al momento della lettura riceverai solo il segmento di testo fino alla prima virgola. Ad esempio, se l'intestazione Se vuoi l'intera intestazione come stringa, utilizza una variabile come
|
Richiesta proxy |
message.header.header_name.N |
Stringa | Lettura/scrittura |
Il valore dell'ennesimo valore di intestazione specifico nel messaggio (richiesta o risposta), a seconda dello stato del flusso. Apigee suddivide i valori del testo dell'intestazione con virgole. L'indice inizia da 1 per il valore più a sinistra. Ad esempio, se l'intestazione |
Richiesta proxy |
message.header.header_name. |
Raccolta | Sola lettura |
Tutti i valori del nome dell'intestazione HTTP specificata 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.header.header_name. |
Stringa | Sola lettura |
Tutti i valori di una determinata intestazione del messaggio, sotto forma di singola stringa. Ad esempio, se l'intestazione |
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 del messaggio di richiesta completo nell'URL, esclusi eventuali parametri di ricerca. |
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 il nome di un singolo parametro di query, come
|
Richiesta proxy |
message.queryparam.param_name. |
Raccolta | Sola lettura |
Tutti i valori di un determinato parametro di ricerca nel messaggio, formattati come 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 parametri di ricerca 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 eseguire l'iterazione dei nomi dei parametri di query utilizzando JavaScript, consulta il seguente post della community di Apigee: Come si esegue l'iterazione della raccolta da "request.queryparams.names" in JS? nella community Apigee. |
Richiesta proxy |
message.querystring |
Stringa | Sola lettura |
Una stringa contenente tutti i nomi dei parametri di query e i valori associati alla richiesta inviata a ProxyEndpoint dall'app client. Ad esempio, per la richiesta |
Richiesta proxy |
message.status.code |
Numero intero | Sola lettura |
Codice di stato HTTP del messaggio di risposta della 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 dell'URI completo (seguendo l'URL del dominio), inclusi parametri di ricerca. Ad esempio, per la richiesta |
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 maggiori informazioni sui messaggi, consulta Riferimento alle funzioni del modello di messaggio.
messageid
Un contenitore per l'ID univoco globale della richiesta.
Nella tabella seguente vengono descritte le proprietà della variabile messageid
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
messageid |
Stringa | Sola lettura |
Contiene l'ID univoco globale della richiesta, incluso il nome host del bilanciatore del carico. Questo ID consente il monitoraggio delle richieste ricevute dal bilanciatore del carico dopo l'invio al processore di messaggi. Questo ID viene registrato nei log degli errori di Apigee per correlare |
Richiesta proxy |
mint
Una variabile di supporto che fornisce informazioni sulla monetizzazione.
Nella tabella seguente vengono descritte le proprietà della variabile mint
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
mint.limitscheck.is_request_blocked |
Booleano | Sola lettura |
Flag che specifica se la richiesta API è bloccata. Impostato su Questa variabile di flusso è disponibile se la norma MonetizationLimitsCheck è collegata al proxy API. Consulta Applicazione di limiti di monetizzazione nei proxy API. |
Richiesta proxy |
mint.limitscheck.is_subscription_found |
Booleano | Sola lettura |
Flag che specifica se lo sviluppatore ha un abbonamento attivo al prodotto API. Imposta su Questa variabile di flusso è disponibile se la norma MonetizationLimitsCheck è collegata al proxy API. Consulta Applicazione di limiti di monetizzazione nei proxy API. |
Richiesta proxy |
mint.limitscheck.prepaid_developer_balance |
Numerico | Sola lettura |
Saldo attuale nel portafoglio dell'account prepagato dello sviluppatore associato alla valuta del piano tariffario. |
Richiesta proxy |
mint.limitscheck.prepaid_developer_currency |
Stringa | Sola lettura |
Valuta del saldo disponibile nella variabile |
Richiesta proxy |
mint.limitscheck.purchased_product_name |
Stringa | Sola lettura |
Nome del prodotto API associato. Questa variabile di flusso è disponibile se la norma MonetizationLimitsCheck è collegata al proxy API. Consulta Applicazione di limiti di monetizzazione nei proxy API. |
Richiesta proxy |
mint.limitscheck.status_message |
Stringa | Sola lettura |
Informazioni aggiuntive sull'esecuzione delle norme MonetizationLimitsCheck a scopo di debug. Questa variabile di flusso è disponibile se la norma MonetizationLimitsCheck è collegata al proxy API. Consulta Applicazione di limiti di monetizzazione nei proxy API. |
Richiesta proxy |
mint.mintng_consumption_pricing_rates |
Stringa | Sola lettura |
Tariffe a consumo. Imposta le commissioni quando crei un piano tariffario. |
PostClientFlow |
mint.mintng_consumption_pricing_type |
Stringa | Sola lettura |
Tipo di prezzo a consumo. Ad esempio: Imposta le tariffe basate sul consumo quando crei un piano tariffario. |
PostClientFlow |
mint.mintng_currency |
Stringa | Sola lettura |
Valuta per il calcolo delle entrate. Questa variabile di flusso ha il valore della variabile di monetizzazione |
Criterio Data Capture |
mint.mintng_dev_share |
Numerico | Sola lettura |
Le entrate devono essere condivise con lo sviluppatore. Imposta le entrate da condividere con lo sviluppatore durante la creazione di un piano tariffario. |
PostClientFlow |
mint.mintng_is_apiproduct_monetized |
Booleano | Sola lettura |
Flag che specifica se il prodotto API è attualmente monetizzato (ovvero se è attivo un piano tariffario attivo). Questa variabile di flusso viene aggiunta dal criterio VerificationAPIKey o VerificationAccessToken associato al proxy API. Vedi Aggiungere un criterio di autenticazione. |
Richiesta proxy |
mint.mintng_price |
Numerico | Sola lettura |
Entrate per il calcolo della quota dello sviluppatore. La variabile di flusso ha il valore della variabile di monetizzazione |
Criterio Data Capture e PostClientFlow |
mint.mintng_price_multiplier |
Numerico | Sola lettura |
Fattore (moltiplicatore) per cui viene moltiplicato il costo per transazione. La variabile di flusso ha il valore della variabile di monetizzazione |
Criterio Data Capture e PostClientFlow |
mint.mintng_rate |
Numerico | Sola lettura |
Tariffa addebitata per la chiamata API. Questa variabile di flusso mostra la tariffa basata sul consumo per chiamata API.
Imposta la tariffa basata sul consumo durante la creazione di un piano tariffario.
Se hai configurato la variabile di monetizzazione |
PostClientFlow |
mint.mintng_rate_before_multipliers |
Numerico | Sola lettura |
Tariffa addebitata per la chiamata API senza il calcolo di Se il criterio Data Capture acquisisce la
variabile di monetizzazione |
PostClientFlow |
mint.mintng_rate_plan_id |
Stringa | Sola lettura |
ID del piano tariffario. Questa variabile di flusso viene aggiunta dal criterio VerificationAPIKey o VerificationAccessToken associato al proxy API. Vedi Aggiungere un criterio di autenticazione. |
Richiesta proxy |
mint.mintng_revenue_share_rates |
Stringa | Sola lettura |
Tariffe relative alla quota di condivisione delle entrate. Imposta la percentuale di quota di condivisione delle entrate durante la creazione di un piano tariffario. |
PostClientFlow |
mint.mintng_revenue_share_type |
Stringa | Sola lettura |
Tipo di quota di condivisione delle entrate. Ad esempio: Imposta il tipo di quota di condivisione delle entrate durante la creazione di un piano tariffario. |
PostClientFlow |
mint.mintng_tx_success |
Booleano | Sola lettura |
Specifica se la transazione è monetizzata. Questa variabile di flusso ha il valore della variabile di monetizzazione |
Criterio Data Capture |
mint.prepaid_updated_developer_usage |
Numerico | Sola lettura |
Utilizzo corrente dello sviluppatore prepagato. L'utilizzo viene calcolato in base alla configurazione del piano tariffario e al valore della variabile di monetizzazione perUnitPriceMultiplier. |
PostClientFlow |
mint.rateplan_end_time_ms |
Numerico | Sola lettura |
Tempo di scadenza del piano tariffario in millisecondi dall'epoca. Questa variabile di flusso viene aggiunta dal criterio VerificationAPIKey o VerificationAccessToken associato al proxy API. Vedi Aggiungere un criterio di autenticazione. |
Richiesta proxy |
mint.rateplan_start_time_ms |
Numerico | Sola lettura |
Tempo di attivazione del piano tariffario in millisecondi dall'epoca. Questa variabile di flusso viene aggiunta dal criterio VerificationAPIKey o VerificationAccessToken associato al proxy API. Vedi Aggiungere un criterio di autenticazione. |
Richiesta proxy |
mint.status |
Stringa | Sola lettura |
Stato della chiamata monetizzata. Compilato solo in caso di errore. |
PostClientFlow |
mint.status_code |
Numerico | Sola lettura |
Codice di stato HTTP della chiamata monetizzata. Compilato solo in caso di errore. |
PostClientFlow |
mint.subscription_end_time_ms |
Numerico | Sola lettura |
Tempo di scadenza dell'abbonamento al prodotto API in millisecondi dall'epoca. Questa variabile di flusso è disponibile se la norma MonetizationLimitsCheck è collegata al proxy API. Consulta Applicazione di limiti di monetizzazione nei proxy API. |
Richiesta proxy |
mint.subscription_start_time_ms |
Numerico | Sola lettura |
Tempo di attivazione per l'abbonamento al prodotto API in millisecondi dall'epoca. Questa variabile di flusso è disponibile se la norma MonetizationLimitsCheck è collegata al proxy API. Consulta Applicazione di limiti di monetizzazione nei proxy API. |
Richiesta proxy |
mint.tx_success_result |
Booleano | Sola lettura |
Indica se la monetizzazione è andata a buon fine per la transazione. La variabile
|
PostClientFlow |
Per ulteriori informazioni, consulta le seguenti risorse:
organization
Un contenitore per la proprietà organization.name
.
Nella tabella seguente vengono descritte le proprietà della variabile organization
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
organization.name |
Stringa | Sola lettura |
Nome dell'organizzazione. |
Richiesta proxy |
Per saperne di più sulle organizzazioni, consulta Informazioni sulle organizzazioni.
proxy
La configurazione del proxy API.
Nella tabella seguente vengono descritte le proprietà della variabile proxy
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
proxy.basepath |
Stringa | Sola lettura |
Il valore del percorso di base nella configurazione dell'endpoint del proxy API. Il percorso di base è il frammento URI più a sinistra che segue l'host nell'URL. Gli URI di flusso condizionale seguono il percorso di base. Supponi di avere un endpoint proxy API configurato con un percorso base
Se definisci un percorso di base dinamico nella configurazione del proxy API, ad esempio |
Richiesta proxy |
proxy.client.ip |
Stringa | Sola lettura |
L'indirizzo |
Richiesta proxy |
proxy.name |
Stringa | Sola lettura |
L'attributo del nome configurato per ProxyEndpoint. |
Richiesta proxy |
proxy.pathsuffix |
Stringa | Sola lettura |
Il valore del suffisso del percorso nell'URL che viene inviato dal client e ricevuto a ProxyEndpoint. Il percorso base è il componente del percorso più a sinistra che identifica in modo univoco un proxy API all'interno di un gruppo di ambienti. Supponi di avere un endpoint proxy API configurato con un percorso base
|
Richiesta proxy |
proxy.url |
Stringa | Sola lettura |
Recupera l'URL completo associato alla richiesta di proxy ricevuta da ProxyEndpoint, inclusi eventuali parametri di ricerca presenti. |
Richiesta proxy |
Per saperne di più sull'utilizzo dei proxy API, consulta la pagina Informazioni su API e proxy API.
publishmessage
Compilato quando viene eseguito un criterio publishMessage.
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
publishmessage.message.id | Stringa | Sola lettura | Restituisce il messageId (ID del messaggio pubblicato) dal server Pub/Sub.
Apigee imposta questa variabile di flusso solo se la richiesta di pubblicazione ha esito positivo. |
Richiesta proxy |
ratelimit
Compilato quando viene eseguito un criterio di quota o SpikeArrest.
Nella tabella seguente vengono descritte le proprietà della variabile ratelimit
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
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 in 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 quando scade la quota e quando inizia il nuovo intervallo di quota. Quando il tipo del criterio per le quote è |
PostClientFlow |
ratelimit.policy_name.identifier | Stringa | Sola lettura | Restituisce il riferimento all'identificatore (client) associato al criterio | PostClientFlow |
ratelimit.policy_name.class | Stringa | Sola lettura | Restituisce la classe associata all'ID cliente | PostClientFlow |
ratelimit.policy_name.class.allowed.count | Lungo | Sola lettura | Restituisce il conteggio della quota consentito definito nella classe | PostClientFlow |
ratelimit.policy_name.class.used.count | Lungo | Sola lettura | Restituisce la quota utilizzata all'interno di una classe | PostClientFlow |
ratelimit.policy_name.class.available.count | Lungo | Sola lettura | Restituisce il conteggio della quota disponibile nella classe | PostClientFlow |
ratelimit.policy_name.class.exceed.count | Lungo | Sola lettura | Restituisce il conteggio delle richieste che supera il limite nella classe nell'intervallo di quota attuale | PostClientFlow |
ratelimit.policy_name.class.total.exceed.count | Lungo | Sola lettura | Restituisce il conteggio totale delle richieste che supera il limite nella classe in tutti gli intervalli di quota, pertanto è la somma di class.exceed.count per tutti gli intervalli di quota. |
PostClientFlow |
ratelimit.policy_name.non superato | Booleano | Sola lettura |
Indica se il criterio ha avuto esito negativo (true o false). |
PostClientFlow |
Per ulteriori informazioni, consulta le seguenti risorse:
- Limitazione di frequenza
- Confronto dei criteri di Quota e SpikeArrest
- Criteri per le quote
- Norme di SpikeArrest
request
La richiesta completa, incluso eventuale payload presente.
Per maggiori informazioni sui dati delle richieste, consulta In che modo i dati della richiesta vengono passati al server di backend?
Nella tabella seguente vengono descritte le proprietà della variabile request
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
request |
message |
Sola lettura |
La richiesta completa, incluso eventuale payload presente. |
Richiesta proxy |
request.content |
Stringa | Lettura/scrittura |
Recupera o imposta il payload del messaggio di richiesta. |
Richiesta proxy |
request.formparam.param_name |
Stringa | Lettura/scrittura |
Restituisce o imposta il valore del parametro di modulo specificato nella richiesta inviata dall'applicazione client. |
Richiesta proxy |
request.formparam.param_name. |
Raccolta | Sola lettura |
Tutti i valori di un determinato parametro di modulo nella richiesta, formattati come elenco separato da virgole. Ad esempio, se il payload è
|
Richiesta proxy |
request.formparam.param_name. |
Numero intero | Sola lettura |
Conteggio di tutti i valori per il parametro di modulo specificato associato alla richiesta. |
Richiesta proxy |
request.formparam.param_name.N |
Stringa | Lettura/scrittura |
Il valore dell'Nth specifico parametro di modulo nel messaggio. Ad esempio, se
la stringa del modulo è |
Richiesta proxy |
request.formparams.count |
Numero intero | Sola lettura |
Conteggio di tutti i parametri associati alla richiesta inviata dall'applicazione client. |
Richiesta proxy |
request.formparams.names |
Raccolta | Sola lettura |
Un elenco di tutti i nomi dei parametri associati alla richiesta. |
Richiesta proxy |
request.formstring |
Stringa | Sola lettura |
Il valore Ad esempio, |
Richiesta proxy |
request.grpc.rpc.name |
Stringa | Sola lettura |
Applicabile solo quando si utilizza un server di destinazione gRPC. Il nome RPC. Per informazioni sui proxy gRPC, consulta la pagina relativa alla creazione di proxy API gRPC. |
Richiesta proxy |
request.grpc.service.name |
Stringa | Sola lettura |
Applicabile solo quando si utilizza un server di destinazione gRPC. Il nome del servizio di stato gRPC. Per informazioni sui proxy gRPC, consulta la pagina relativa alla creazione di proxy API gRPC. |
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, al momento della lettura riceverai solo il segmento di testo fino alla prima virgola. Ad esempio, se l'intestazione Se vuoi l'intera intestazione come stringa, utilizza una variabile come
|
Richiesta proxy |
request.header.header_name.N |
Stringa | Lettura/scrittura |
Il valore dell'ennesimo valore di intestazione specifico nella richiesta. Apigee divide i valori del testo dell'intestazione per virgole. L'indice inizia da 1 per il valore più a sinistra. 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.header.header_name. |
Stringa | Sola lettura |
Tutti i valori di una determinata intestazione nella richiesta, sotto forma di singola stringa. Ad esempio, se l'intestazione |
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 della richiesta. |
Richiesta proxy |
request.path |
Stringa | Sola lettura |
Il percorso della risorsa senza proxy (escluso l'host) al servizio di backend, esclusi parametri di ricerca. Ad esempio, se l'URI del servizio di backend è |
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 di query Nth nella richiesta. Ad esempio, se Come esempio di scrittura di più valori per il nome di un singolo parametro di query, come
|
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 di ricerca nella richiesta. |
Richiesta proxy |
request.queryparams.names |
Raccolta | Sola lettura |
I nomi di tutti i parametri di ricerca nella richiesta. Per eseguire l'iterazione dei nomi dei parametri di query utilizzando JavaScript, consulta Come si esegue l'iterazione della raccolta da "request.queryparams.names" in JS? nella community Apigee. |
Richiesta proxy |
request.querystring |
Stringa | Sola lettura |
L'elenco completo dei parametri di ricerca nella richiesta inviata dall'app client. Ad esempio, se la richiesta è |
Richiesta proxy |
request.transportid |
Stringa | Sola lettura |
ID contestuale della richiesta come tipo TransportMessage. |
Richiesta proxy |
request.transport.message |
Transport-Message | Sola lettura |
Richiesta di tipo TransportMessage contestuale. |
Richiesta proxy |
request.uri |
Stringa | Sola lettura |
In un proxy API, il proxy
Rimanda a
Nella richiesta, Nella risposta, La differenza è che la richiesta originale è arrivata nel proxy, che a sua volta invia 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
E il proxy chiama:
che aggiunge
|
Richiesta proxy (diversa 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 escluso il numero di porta (se specificato). Ad esempio, se effettui una chiamata a un proxy di esempio
|
Risposta target |
request.verb |
Stringa | Sola lettura |
Il verbo HTTP utilizzato per la richiesta. Ad esempio, |
Richiesta proxy |
request.version |
Stringa | Sola lettura |
La versione HTTP della richiesta. Ad esempio, |
Richiesta proxy |
response
La risposta completa, incluso eventuale payload presente.
Nella tabella seguente vengono descritte le proprietà della variabile response
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
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.header.header_name |
Stringa | Lettura/scrittura |
Restituisce o imposta il valore di un'intestazione HTTP specificata nella risposta. Se il testo dell'intestazione include una virgola, Apigee deduce più valori. In questo caso, Ad esempio, se l'intestazione Se vuoi l'intera intestazione come stringa, utilizza una variabile come
|
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. |
Stringa | Sola lettura |
Tutti i valori di una determinata intestazione nella risposta, sotto forma di singola stringa. Ad esempio, se l'intestazione |
Risposta target |
response.header.header_name.N |
Stringa | Lettura/scrittura |
Il valore dell'ennesimo valore di intestazione specifico nella risposta. Apigee divide i valori del testo dell'intestazione per virgole. L'indice inizia da 1 per il valore più a sinistra. 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 del 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 eseguire l'override del
codice di stato della risposta, archiviato 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.
Nella tabella seguente vengono descritte le proprietà della variabile route
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
route.name |
Stringa | Sola lettura |
Il nome dell'elemento |
Richiesta target |
route.target |
Stringa | Sola lettura |
Il nome dell'endpoint Target che è stato eseguito. Ad esempio, |
Richiesta target |
servicecallout
Descrive il TargetEndpoint per un criterio Callout di servizio.
Nella tabella seguente vengono descritte le proprietà della variabile servicecallout
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
servicecallout.policy_name.expectedcn |
Stringa | Lettura/scrittura |
Il nome comune previsto del TargetEndpoint come indicato in un criterio Callout di servizio. Questo è significativo solo quando TargetEndpoint si riferisce a un endpoint TLS/SSL. |
Richiesta proxy |
servicecallout.policy_name.target.url |
Stringa | Lettura/scrittura |
L'URL TargetEndpoint per un determinato criterio di callout di servizio. |
Richiesta proxy |
servicecallout.requesturi |
Stringa | Lettura/scrittura |
L'URI TargetEndpoint per un criterio ServiceCallout. L'URI è l'URL TargetEndpoint senza il protocollo e la specifica di dominio. |
Richiesta proxy |
system
Specifica l'indirizzo IP del sistema e i dettagli relativi al proxy.
Nella tabella seguente vengono descritte le proprietà della variabile system
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
system.interface.interface_name |
Stringa | Sola lettura |
Indirizzo IP del sistema. |
Richiesta proxy |
system.pod.name |
Stringa | Sola lettura |
Il nome del pod su 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, Wed, 21 Aug 2013 19:16:47 GMT. Questo valore è la rappresentazione in formato stringa del valore corrispondente di
|
Richiesta proxy |
system.time.year |
Numero intero | Sola lettura |
La parte dell'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 mese di |
Richiesta proxy |
system.time.dayofweek |
Numero intero | Sola lettura |
La parte relativa al 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 |
Il numero intero a 64 bit (lungo) che rappresenta il tempo in cui la variabile è stata letta. Il valore è il numero di millisecondi trascorsi dalla mezzanotte del 1° gennaio 1970 UTC. Ad esempio,
|
Richiesta proxy |
system.uuid |
Stringa | Sola lettura |
L'UUID del processore di messaggi che gestisce il proxy. |
Richiesta proxy |
target
Descrive il target della richiesta.
Nella tabella seguente vengono descritte le proprietà della variabile target
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
target.basepath |
Stringa | Sola lettura |
Il percorso della risorsa (escluso il dominio) al servizio di destinazione, esclusi i parametri di query, che viene definito nel TargetEndpoint del proxy. Ad esempio, supponiamo che un proxy API chiami il seguente target:
In questo esempio, Se il target fosse questo:
Il valore |
Richiesta target |
target.copy.pathsuffix |
Booleano | Lettura/scrittura |
Quando |
Richiesta target |
target.copy.queryparams |
Booleano | Lettura/scrittura |
Quando |
Richiesta 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 fa riferimento a un endpoint TLS/SSL. |
Richiesta 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 è 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 viene raggiunto il messaggio da targetendpoint. |
Richiesta 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 dal target. Ad esempio, Wed, 21 Aug 2013 19:16:47 UTC. Questo valore temporale è la rappresentazione in formato stringa della quantità corrispondente del timestamp a 32 bit. Ad esempio, mercoledì 21 agosto 2013 alle 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, |
Risposta target |
target.received.start.time |
Stringa | Sola lettura |
L'ora, espressa in forma stringa, in cui TargetEndpoint ha iniziato a ricevere la risposta dalla destinazione. Ad esempio, Wed, 21 Aug 2013 19:16:47 UTC. Questo valore temporale è la rappresentazione in formato stringa della quantità corrispondente del timestamp a 32 bit. Ad esempio, mercoledì 21 agosto 2013 19:16:47 UTC corrisponde al valore del timestamp di 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, |
Risposta target |
target.scheme |
Stringa | Sola lettura |
Inizia l'ambito: risposta target Restituisce http o https in base al messaggio di richiesta. |
Richiesta 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, Wed, 21 Aug 2013 19:16:47 UTC. Questo valore temporale è la rappresentazione in formato stringa della quantità corrispondente del timestamp a 32 bit. Ad esempio, mercoledì 21 agosto 2013 19:16:47 UTC corrisponde al valore del timestamp di 1377112607413. |
Richiesta 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 (lungo) contenente il numero di millisecondi trascorsi dalla mezzanotte del 1° gennaio 1970 UTC. |
Richiesta target |
target.sent.start.time |
Stringa | Sola lettura |
L'ora, espressa in forma di stringa, in cui il proxy ha iniziato a inviare la richiesta all'URL specificato in TargetEndpoint. Ad esempio, Wed, 21 Aug 2013 19:16:47 UTC. Questo valore temporale è la rappresentazione in formato stringa della quantità corrispondente del timestamp a 32 bit. Ad esempio, mercoledì 21 agosto 2013 19:16:47 UTC corrisponde al valore del timestamp di 1377112607413. |
Richiesta 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, |
Richiesta 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 nell'URL di destinazione dinamico (se
|
Richiesta target |
variable
Un contenitore per la proprietà variable.expectedcn
.
Nella tabella seguente vengono descritte le proprietà della variabile variable
:
Proprietà | Tipo | Lettura/scrittura | Descrizione | L'ambito inizia |
---|---|---|---|---|
variable.expectedcn |
Stringa | Lettura/scrittura |
Variabile esposta per il nome comune se in esecuzione su TLS/SSL. |
Richiesta proxy |
Per maggiori informazioni sull'uso di TLS, vedi Opzioni per la configurazione di TLS.