16.08.17 - Note di rilascio di Apigee Edge per il cloud pubblico

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Martedì 30 agosto 2016 abbiamo rilasciato una nuova versione di Apigee Edge per il cloud pubblico.

Nuove funzionalità e aggiornamenti

Di seguito sono riportate le nuove funzionalità e gli aggiornamenti di questa release.

Payload JSON in Assign Message e Raise Fault

Con questo miglioramento, non sono necessarie soluzioni alternative per garantire la corretta formattazione dei messaggi JSON e le variabili possono essere specificate utilizzando le parentesi graffe senza creare JSON non validi. Ad esempio, il seguente inserisce il valore di message.content nel messaggio JSON:

<Payload contentType="application/json">{"message" : "{message.content}"}</Payload>

Se hai utilizzato una soluzione alternativa, il codice continuerà a funzionare così com'è. Puoi anche utilizzare variablePrefix e variableSuffix anziché le parentesi graffe per indicare le variabili.

Consulta l'elemento <Set><Payload> nella documentazione di riferimento delle policy Assign Message e Raise Fault. (APIRT-1160)

Miglioramenti della policy XML to JSON

La policy XML to JSON è stata migliorata con le seguenti funzionalità. Puoi configurare la policy per:

• Trattare alcuni elementi XML come array durante la conversione, che inserisce i valori tra parentesi quadre "[ ]" nel documento JSON.
• Rimuovere o eliminare i livelli della gerarchia dei documenti XML nel documento JSON finale.

Per saperne di più, consulta la policy XML to JSON. (APIRT-1144)

Più caratteri jolly in percorsi delle risorse del prodotto API

Quando definisci i percorsi delle risorse nel prodotto API, puoi includere caratteri jolly in più punti di un percorso di risorsa. Ad esempio, /team/*/invoices/** consente chiamate API con un solo valore dopo /team e qualsiasi percorso di risorsa dopo invoices/. Un URI consentito in una chiamata API sarebbe proxyBasePath/team/finance/invoices/company/a.

Se dopo questa release i percorsi delle risorse del prodotto API esistenti smettono di funzionare come previsto, imposta la seguente proprietà nella tua organizzazione per ripristinare il comportamento precedente: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

Funzioni di crittografia in JavaScript

È disponibile un nuovo set di funzioni JavaScript crypto ad alte prestazioni per creare, recuperare e aggiornare i seguenti oggetti hash: MD5, SHA-1, SHA256, SHA512. L'oggetto crypto consente anche di ottenere la data in vari formati. Per saperne di più, consulta il modello di oggetti JavaScript. (APIRT-2886)

Controllo della versione JAR del callout Java checking

Quando carichi una risorsa JAR Java in un proxy API, viene restituito un codice di stato HTTP 400 (anziché 500) se la versione della risorsa Java non è compatibile con la versione di Java supportata da Edge, elencata in Software supportato e versioni supportate. (MGMT-3420)

Convalida delle risorse del proxy API

Quando hai file di risorse del proxy API (come JAR JavaScript o Java) archiviati nell' ambito dell'ambiente o dell'organizzazione, il framework di convalida non richiede più di includere queste risorse anche a livello di proxy API in un bundle proxy per superare la convalida di importazione. La convalida delle risorse ora avviene in fase di deployment, non in fase di importazione. (MGMT-1430)

Configurare il timeout per i singoli proxy API

Puoi configurare i proxy API in modo che scadano dopo un periodo di tempo specificato (con uno stato di timeout del gateway 504 ). Il caso d'uso principale è per i clienti del cloud privato che hanno proxy API che richiedono più tempo per l'esecuzione. Ad esempio, supponiamo che tu abbia bisogno di proxy specifici che scadano dopo 3 minuti. Puoi utilizzare una nuova api.timeout proprietà nella configurazione di un proxy API. Ecco come farlo con l'esempio di 3 minuti:

1. Innanzitutto, assicurati di configurare il bilanciatore del carico, il router e il processore di messaggi in modo che scadano dopo 3 minuti.
2. Quindi configura i proxy pertinenti in modo che scadano dopo 3 minuti. Specifica il valore in millisecondi. Ad esempio:

   <ProxyEndpoint name="default">
     <HTTPProxyConnection>
       <BasePath>/v1/weather</BasePath>
       <Properties>
         <!-- api.timeout is in milliseconeds -->
         <Property name="api.timeout">180000</Property>
       </Properties>
       ...

3. Tieni presente, tuttavia, che l'aumento dei timeout di sistema potrebbe causare problemi di prestazioni, perché tutti i proxy senza un'impostazione api.timeout utilizzano i nuovi timeout più elevati del bilanciatore del carico, del router e del processore di messaggi. Quindi configura altri proxy API che non richiedono timeout più lunghi per utilizzare timeout inferiori. Ad esempio, il seguente imposta un proxy API in modo che scada dopo 1 minuto:
   <Property name="api.timeout">60000</Property>

I clienti cloud, che non possono modificare i timeout di Edge, possono anche configurare un timeout del proxy API, purché il timeout sia inferiore al timeout standard del processore di messaggi Edge di 57 secondi.

Non puoi inserire il valore con una variabile. Questa proprietà è trattata nel riferimento per le proprietà degli endpoint. (APIRT-1778)

TLS/SSL per la policy di logging dei messaggi

<KeyStore> e <TrustStore> possono essere impostati nella configurazione SSLInfo della policy di logging dei messaggi, consentendo TLS/SSL unidirezionale e bidirezionale con un servizio di logging. Configura SSLInfo nella policy di logging dei messaggi nello stesso modo in cui lo faresti in un TargetEndpoint del proxy. Tuttavia, TLS/SSL di logging dei messaggi supporta solo il protocollo TCP. (APIRT-1858)

Bug corretti

In questa release sono stati corretti i seguenti bug. Questo elenco è destinato principalmente agli utenti che vogliono verificare se i loro ticket di assistenza sono stati risolti. Non è progettato per fornire informazioni dettagliate a tutti gli utenti.