4.16.09 - Note di rilascio di Edge per Private Cloud

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

Lunedì 19 settembre 2016 abbiamo rilasciato una nuova versione di Apigee Edge for Private Cloud.

Dalla precedente release delle funzionalità di Edge per il cloud privato, si sono verificate le seguenti release, che sono incluse in questa release delle funzionalità:

• Cloud: 16.04.13 (UI), 16.04.13 (monetizzazione), 16.04.20 (UI), 16.04.27 (monetizzazione), 16.04.27 (UI), 16.05.04 (UI), 16.05.11 (UI), 16.05.11 (monetizzazione), 16.05.18 (UI), 16.05.25 (monetizzazione), 16.06.08 (monetizzazione), 16.06.15 (UI), 16.06.22 (monetizzazione), 16.06.29 (UI), 16.07.06 (monetizzazione), 16.07.06.02 (monetizzazione), 16.07.13 (UI), 16.07.20.01 (monetizzazione), 16.07.27 (UI), 16.08.17

Consulta la sezione Informazioni sulla numerazione delle release per capire come determinare se una specifica release cloud è inclusa nella tua versione di Edge per il cloud privato.

Panoramica della release

In questa release, l'editor proxy API classico è stato rimosso e sostituito dal nuovo editor proxy, che era disponibile per l'utilizzo insieme all'editor classico. Altri miglioramenti degni di nota includono un comportamento migliorato dei percorsi delle risorse dei prodotti API, una gestione migliorata dei payload JSON definiti nelle norme Assegna messaggio e Genera errore, miglioramenti alle conversioni da XML a JSON, una migliore convalida delle risorse, la possibilità di impostare timeout per singoli proxy API, la generazione aggiornata dei proxy SOAP nella procedura guidata per i proxy API e un oggetto Crypto ad alte prestazioni per JavaScript.

I miglioramenti alla monetizzazione includono nuove funzionalità di notifica con un piano tariffario di notifica, un'API che esegue la migrazione degli sviluppatori alla monetizzazione e la possibilità di rendere pubblici o privati i piani tariffari.

Il resto di questo argomento contiene i dettagli di tutte le nuove funzionalità, gli aggiornamenti e le correzioni di bug contenuti nella release.

Deprecato

Servizi API

Editor proxy classico rimosso (interfaccia utente Cloud 16.04.20)

La nuova versione dell'editor proxy API è ora l'unica versione supportata. La versione classica non è più disponibile e il link "Accedi alla versione classica dell'editor proxy" è stato rimosso. Se utilizzavi la versione classica, i proxy API verranno caricati automaticamente nel nuovo editor. (EDGEUI-498)

Monetizzazione

Le seguenti funzionalità deprecate sono state rimosse e non sono più supportate:

• Impostare i limiti
• Notifiche sui limiti di invio

In alternativa, puoi configurare le notifiche come descritto nelle sezioni seguenti:

• Configurare le notifiche degli eventi
• Crea una notifica di limite per un piano tariffario

(DEVRT-2742)

Nuove funzionalità e aggiornamenti

Di seguito sono riportate le nuove funzionalità e i miglioramenti di questa release. Oltre ai miglioramenti seguenti, questa release contiene anche diversi miglioramenti di usabilità, prestazioni, sicurezza e stabilità.

Per ulteriori dettagli e istruzioni, consulta la documentazione di Edge for Private Cloud.

Cloud privato

Upgrade di PostgreSQL alla versione 9.4

Questa release include un upgrade a Postgres 9.4. Per istruzioni sull'aggiornamento del sistema, vedi Aggiornare Apigee Edge alla versione 4.16.09.

Supporto di GeoMap nella UI di Edge

Le aggregazioni geografiche consentono di raccogliere dati di analisi per le chiamate API in base ad attributi geografici come regione, continente, paese e città. Da questi dati di analisi, puoi visualizzare una GeoMap nella UI Edge che mostra la posizione delle richieste API.

Per ulteriori informazioni, vedi Attivare l'aggregazione geografica e le mappe geografiche.

API BaaS

È stata aggiunta la documentazione su:

• Come configurare API BaaS per l'utilizzo di TLS. Per maggiori informazioni, consulta Configurazione di TLS per API BaaS.
• Come configurare tutti i nodi dello stack API BaaS in modo che utilizzino lo spazio di archiviazione condiviso, in modo che tutti gli asset siano disponibili per tutti i nodi dello stack API BaaS. Per saperne di più, consulta Caricamento degli asset.
• Come criptare la password di Cassandra durante la configurazione dei nodi dello stack BaaS. Per saperne di più, consulta Reimpostare le password di Edge.

Rilascio della versione beta dello strumento e della dashboard di monitoraggio

In questa release è inclusa una versione beta del nuovo strumento di monitoraggio e del nuovo pannello per Edge. Questo strumento ti consente di comprendere lo stato di vari componenti (router, processori di messaggi, ZooKeeper, Cassandra) e i codici di errore HTTP per varie organizzazioni e ambienti nel tuo deployment. Puoi anche fare uno snapshot dei dati della dashboard e condividerlo con Apigee per contribuire a risolvere gli incidenti di assistenza.

La documentazione, incluse le istruzioni di installazione, è inclusa nel documento Edge 4.16.09 alla versione 4.18.01.

Tuttavia, prima di poter installare e utilizzare la dashboard, devi completare il Contratto di valutazione di Apigee, disponibile anche alla pagina Versione 4.18.01, e restituirlo ad Apigee inviandolo via email all'indirizzo orders@apigee.com.

Versione beta dello strumento di raccolta di Analytics

Tutti i clienti di Edge for Private Cloud sono tenuti a inviare ad Apigee statistiche sul traffico proxy API. Apigee consiglia ai clienti di caricare queste informazioni una volta al giorno, possibilmente creando un cron job.

Per facilitare il caricamento di questi dati, Apigee fornisce la release beta dell'utilità a riga di comando apigee-analytics-collector. Questa utilità invia il report sul volume delle chiamate API ad Apigee. Ogni installazione di Edge for Private Cloud può utilizzare questa utilità per recuperare e segnalare i dati sul traffico ad Apigee.

Per saperne di più, consulta Caricamento dei dati di traffico API su Apigee - Release beta.

Servizi API

Payload JSON in Assegna messaggio e Genera errore (Cloud 16.08.17)

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 dei criteri Assign Message e Raise Fault. (APIRT-1160)

Miglioramenti delle policy da XML a JSON (Cloud 16.08.17)

Il criterio XML to JSON è stato migliorato con le seguenti funzionalità. Puoi configurare la policy in modo che:

• Considera alcuni elementi XML come array durante la conversione, inserendo i valori tra parentesi quadre "[ ]" nel documento JSON.
• Rimuovi o elimina i livelli della gerarchia del documento XML nel documento JSON finale.

Per saperne di più, consulta Policy da XML a JSON. (APIRT-1144)

Più caratteri jolly nei percorsi delle risorse del prodotto API (Cloud 16/08/17)

Quando definisci i percorsi delle risorse in un prodotto API, puoi includere caratteri jolly in più posizioni di un percorso della risorsa. Ad esempio, /team/*/invoices/** consente chiamate API con qualsiasi 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 (Cloud 16.08.17)

È disponibile un nuovo insieme di funzioni JavaScript crypto ad alte prestazioni per creare, ottenere 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 Modello a oggetti JavaScript. (APIRT-2886)

Controllo della versione JAR del callout Java (Cloud 16.08.17)

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 proxy API (Cloud 16.08.17)

Quando hai file di risorse 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. La convalida delle risorse ora viene eseguita al momento del deployment, non dell'importazione. (MGMT-1430)

Configurare il timeout per i singoli proxy API (Cloud 16.08.17)

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 riguarda i clienti di Private Cloud che hanno proxy API che richiedono più tempo per l'esecuzione. Ad esempio, supponiamo che tu abbia bisogno di proxy specifici per scadere dopo 3 minuti. Puoi utilizzare una nuova proprietà api.timeout nella configurazione di un proxy API. Ecco come fare 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 il timeout scada 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 bilanciamento del carico, del router e del processore di messaggi. Pertanto, configura altri proxy API che non richiedono timeout più lunghi per utilizzare timeout più brevi. Ad esempio, il seguente imposta il timeout di un proxy API dopo 1 minuto:
   <Property name="api.timeout">60000</Property>

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

Non puoi compilare il valore con una variabile. Questa proprietà è trattata nel riferimento alle proprietà dell'endpoint. (APIRT-1778)

Comportamento del proxy SOAP quando si utilizza la procedura guidata proxy (UI Cloud 16.07.27)

Quando crei un proxy basato su SOAP da un WSDL utilizzando la procedura guidata per i proxy, sono disponibili due opzioni per la creazione del proxy:

• SOAP pass-through, in cui il proxy trasmette semplicemente un payload della richiesta SOAP così com'è.
• Da REST a SOAP a REST, in cui il proxy converte un payload in entrata, ad esempio JSON, in un payload SOAP, quindi riconverte la risposta SOAP nel formato previsto dal chiamante.

Questa release include i seguenti aggiornamenti al comportamento di queste opzioni. Le differenze tra il comportamento precedente e quello nuovo risiedono nelle norme e nelle configurazioni generate automaticamente dalla procedura guidata del proxy.

Pass-Through SOAP

• Tutte le operazioni WSDL vengono ora inviate al percorso di base del proxy "/" anziché alle risorse proxy (ad esempio "/cityforecastbyzip"). I nomi delle operazioni vengono passati al servizio SOAP di destinazione. Questo comportamento corrisponde alla specifica SOAP.

• Il proxy generato non supporta più JSON nella richiesta. Supporta solo XML. Il proxy assicura che le richieste SOAP abbiano una busta, un corpo e uno spazio dei nomi.

Da REST a SOAP a REST

• WSDL 2.0 non è supportato.
• Il nuovo comportamento non è stato testato con WS-Policy.
• Il proxy ti consente di inviare dati JSON anziché FormParams.
• Quando aggiungi il supporto CORS (condivisione delle risorse multiorigine) al proxy utilizzando lo strumento di creazione del proxy, vedrai i seguenti miglioramenti:
  • Intestazione Access-Control-Allow-Headers: oltre alle intestazioni Origin, x-requested-with e Accept, l'intestazione Access-Control-Allow-Headers include anche Content-Type, Accept-Encoding, Accept-Language, Host, Pragma, Referrer, User-Agent e Cache-Control.
  • Intestazione Access-Control-Allow-Methods: oltre a GET, PUT, POST, DELETE, questa intestazione include anche i verbi PATCH e OPTIONS.
• Quando genera un proxy API per un WSDL, Edge legge tutti i ComplexTypes definiti come abstract nel WSDL e riconosce correttamente tutti i tipi di istanza basati sui tipi abstract.

Utilità a riga di comando open source wsdl2apigee

Apigee fornisce anche un'utilità a riga di comando open source per generare proxy API passthrough o rest-to-soap da WSDL. Consulta la pagina https://github.com/apigee/wsdl2apigee.

(EDGEUI-614)

Scadenza/aggiornamento predefinito nel criterio Operazioni mappa di coppie chiave-valore (interfaccia utente Cloud 16.06.15)

Il criterio Operazioni mappa di coppie chiave-valore ti consente di determinare per quanto tempo i valori vengono mantenuti prima di essere aggiornati. L'intervallo di aggiornamento è impostato con l'elemento <ExpiryTimeInSecs>. Se viene eseguita un'operazione GET e l'intervallo di scadenza è stato superato, il valore viene aggiornato e il criterio riceve il valore aggiornato. Quando aggiungi questo criterio a un proxy API, il tempo di scadenza predefinito è ora di 300 secondi. (Il valore predefinito precedente era -1, il che significa che i valori non vengono mai aggiornati.) (EDGEUI-579)

Monetizzazione

Piano tariffario per le notifiche regolabile (interfaccia utente Cloud 16.04.20, monetizzazione Cloud 16.04.13)

Un nuovo piano tariffario regolabile per le notifiche nella monetizzazione Edge consente a un provider di API di modificare il numero target di transazioni per ogni sviluppatore di app. Puoi configurare se e quando inviare le notifiche in base alla percentuale del numero target raggiunto, ad esempio 90%, 100% o 150%. Questa funzionalità è disponibile tramite la UI di gestione, oltre all'API di gestione (che era disponibile in una release precedente). Per saperne di più, vedi Specificare i dettagli del piano di notifiche regolabile. (DEVRT-2375, DEVRT-2370)

Notifiche webhook per piani tariffari di notifica regolabili (monetizzazione Cloud 16.04.27)

Per i piani tariffari con tasso di notifica regolabile, puoi creare webhook che inviano notifiche all'URL che specifichi. Puoi anche controllare le notifiche in modo che si verifichino a intervalli specifici (percentuali) fino al raggiungimento del limite di transazioni. Le notifiche webhook ti offrono un'alternativa flessibile all'utilizzo dei modelli di notifica esistenti. Consulta Configurare le notifiche utilizzando i webhook. (DEVRT-2393, DEVRT-2394)

Notifica regolabile con piano tariffario dell'attributo personalizzato (UI Cloud 16.05.18)

Nella monetizzazione Edge, un nuovo piano tariffario "Notifica regolabile con attributo personalizzato" ti consente di aumentare il conteggio delle transazioni di uno sviluppatore utilizzando il valore di un attributo personalizzato. Con il piano tariffario standard Tasso di notifica regolabile, ogni chiamata API riuscita aggiunge 1 al conteggio delle transazioni di uno sviluppatore. Tuttavia, con il piano tariffario Notifica aggiustabile con attributo personalizzato, il valore dell'attributo personalizzato viene aggiunto al conteggio delle transazioni dello sviluppatore. Ad esempio, se l'attributo personalizzato "small" ha un valore di 0,1 nella risposta, il conteggio delle transazioni viene incrementato di 0,1; oppure se l'attributo personalizzato "addressTotal" ha un valore di 50, il conteggio viene incrementato di 50. Per saperne di più, consulta Specificare il piano tariffario con i dettagli degli attributi personalizzati. (DEVRT-2504)

Configura le notifiche in base ai totali combinati delle transazioni per un'azienda e i suoi sviluppatori (monetizzazione di Cloud 16.06.22)

In genere, i totali delle transazioni vengono monitorati automaticamente per tutti gli sviluppatori di un'azienda quando utilizzano l'app aziendale per accedere alle API. Cosa succede se hai sviluppatori che utilizzano attivamente le proprie app per sviluppatori per accedere alle API e devi monitorare i totali combinati delle transazioni senza interruzioni del traffico? Puoi aggiungere gli sviluppatori a un'azienda e configurare le notifiche da inviare quando vengono raggiunte le soglie basate sui totali combinati delle transazioni per l'azienda e i suoi sviluppatori. Per saperne di più, vedi Configurare le notifiche in base ai totali combinati delle transazioni per un'azienda e i suoi sviluppatori. (DEVRT-2643)

Visualizzare ed elaborare nuovamente le notifiche (monetizzazione Cloud 16.06.08)

Nell'ambito della suite di test per la monetizzazione, puoi visualizzare ed elaborare nuovamente le notifiche inviate in precedenza utilizzando l'API di gestione. Per saperne di più, consulta Visualizzare e rielaborare le notifiche. (DEVRT-2643)

Test di monetizzazione (monetizzazione Cloud 16.05.25)

La monetizzazione fornisce un insieme di API che puoi utilizzare per testare l'esecuzione dei webhook per assicurarti che le notifiche vengano inviate. Per maggiori dettagli, vedi Configurazione delle notifiche di test. (DEVRT-2625)

Migrazione degli sviluppatori alla monetizzazione (monetizzazione Cloud 16.05.11)

È disponibile una nuova API per facilitare la migrazione degli sviluppatori alla monetizzazione. Puoi trasferire l'utilizzo delle transazioni e addebitare le tariffe ricorrenti e di configurazione personalizzate. Inoltre, quando accetti un piano tariffario pubblicato, puoi rinunciare alle tariffe di configurazione nel caso in cui siano già state addebitate. Per maggiori informazioni, consulta la pagina Eseguire la migrazione degli sviluppatori alla monetizzazione. (DEVRT-2446)

Piani tariffari pubblici e privati per il portale per sviluppatori (monetizzazione di Cloud 16.04.27)

Puoi impostare i piani tariffari su "Pubblico" o "Privato". I piani tariffari pubblici vengono visualizzati nel portale per gli sviluppatori, mentre quelli privati no. L'impostazione predefinita per un piano tariffario è Pubblico. Per saperne di più, consulta la pagina http://docs.apigee.com/monetization/content/create-rate-plans#public-versus-private-rate-plans. (DEVRT-2445)

Riassegnazione degli sviluppatori (monetizzazione Cloud 16.06.08)

La monetizzazione fornisce un insieme di API che puoi utilizzare per riattivare uno sviluppatore che era stato sospeso in precedenza. Uno sviluppatore potrebbe essere sospeso se viene raggiunto un limite configurato. Ad esempio, il numero di transazioni ha raggiunto il limite massimo o il saldo di un account prepagato è esaurito. Per informazioni, consulta Riassegnare l'account sviluppatore. (DEVRT-2641)

Visualizzare lo stato delle transazioni (monetizzazione Cloud 16.06.08)

Nell'ambito della suite di test per la monetizzazione, puoi visualizzare lo stato delle transazioni che si sono verificate durante un intervallo di tempo specificato utilizzando l'API Management. Per saperne di più, consulta Visualizzare lo stato delle transazioni. (DEVRT-2640)

Inclusione degli attributi personalizzati dello sviluppatore nei report sulle entrate (monetizzazione di Cloud 16.05.25)

Solo per i report sulle entrate, puoi includere attributi personalizzati nel report, se l'attributo personalizzato è definito per lo sviluppatore. Per saperne di più, consulta Includere attributi personalizzati dello sviluppatore nei report sulle entrate utilizzando l'API. (DEVRT-2447)

Policy di registrazione delle transazioni e coerenza delle risorse del prodotto API (interfaccia utente Cloud 16.05.18)

Se i percorsi delle risorse in una norma di registrazione delle transazioni per la monetizzazione non corrispondono ai percorsi delle risorse definiti nel prodotto API (ad esempio, se modifichi i percorsi delle risorse del prodotto API), l'icona della norma di registrazione delle transazioni nella pagina Prodotti mostra un simbolo di avviso. Quando fai clic sull'icona per visualizzare le norme di registrazione delle transazioni, nella parte superiore della pagina viene visualizzato un avviso. Quando correggi i percorsi delle risorse nella policy di registrazione delle transazioni, gli indicatori di avviso scompaiono. (DEVRT-2240)

Bug corretti

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

Edge for Private Cloud

16.08.17

16.07.27 (UI)

16.07.20.01 (monetizzazione)

Questa release include modifiche minori allo schema del database. Non sono presenti altri aggiornamenti software in questa release.

16.07.13 (UI)

16.07.06.02 (monetizzazione)

16.07.06 (monetizzazione)

16.06.29 (UI)

16/06/22 (monetizzazione)

Nessuno

16.06.15 (UI)

16.06.08 (monetizzazione)

Nessuno

16.05.25 (monetizzazione)

16.05.18 (UI)

16.05.11 (monetizzazione)

16.05.11 (UI)

16.05.04 (UI)

16.04.27 (UI)

16.04.27 (monetizzazione)

Nessuno

16.04.20 (UI)

16.04.13 (monetizzazione)

Nessuno

16.04.13 (UI)

Problemi noti

Questa release presenta i seguenti problemi noti: