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 for Private Cloud, 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 release cloud specifica è inclusa nella tua versione di Edge for Private Cloud.

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, una 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 per le notifiche, 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 relative ai limiti di invio

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

• Configurare le notifiche degli eventi
• Creare 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 seguenti miglioramenti, 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 Postres 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 nell'interfaccia utente Edge

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

Per saperne di più, 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, vedi 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 ulteriori informazioni, consulta Caricare gli asset.
• Come criptare la password di Cassandra durante la configurazione dei nodi dello stack BaaS. Per ulteriori informazioni, vedi Reimpostare le password di Edge.

Rilascio 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, elaboratori di messaggi, ZooKeeper, Cassandra) e i codici di errore HTTP per varie organizzazioni e ambienti nel tuo deployment. Puoi anche scattare un'istantanea dei dati della dashboard e condividerla con Apigee per risolvere gli incidenti di assistenza.

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

Tuttavia, prima di poter installare e utilizzare la dashboard, devi completare il contratto di valutazione di Apigee, disponibile anche alla 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 dei 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 versione 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 per 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 un JSON non valido. 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 norma Assign Message e nella norma Raise Fault nei documenti di riferimento. (APIRT-1160)

Miglioramenti delle policy da XML a JSON (Cloud 16.08.17)

La policy XML to JSON è stata migliorata con le seguenti funzionalità. Puoi configurare i criteri 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 ulteriori informazioni, consulta XML to JSON policy. (APIRT-1144)

Più caratteri jolly nei percorsi delle risorse del prodotto API (Cloud 16.08.17)

Quando definisci i percorsi delle risorse nel 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 delle risorse 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 maggiori informazioni, vedi Modello oggetto 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 si verifichi il timeout dopo un periodo di tempo specificato (con uno stato di timeout del gateway 504). Il caso d'uso principale è per 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 il timeout a 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 di 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 per il 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 passa 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 per il 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 consente di inviare dati JSON anziché FormParams.
• Quando aggiungi il supporto CORS (condivisione delle risorse tra origini) 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 ComplexType definiti come astratto nel WSDL e riconosce correttamente tutti i tipi di istanza basati sui tipi astratti.

Utilità da 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 https://github.com/apigee/wsdl2apigee.

(EDGEUI-614)

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

Il criterio Operazioni di mapping 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 con notifiche regolabili (interfaccia utente Cloud 16.04.20, monetizzazione Cloud 16.04.13)

Un nuovo piano tariffario di notifica regolabile nella monetizzazione di Edge consente a un fornitore di API di regolare 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 ulteriori informazioni, 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 vengano inviate 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 aggiustabile con piano tariffario per attributo personalizzato (interfaccia utente 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 con 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 ulteriori informazioni, vedi Specificare il piano tariffario con i dettagli degli attributi personalizzati. (DEVRT-2504)

Configura le notifiche in base ai totali delle transazioni combinate 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 maggiori informazioni, 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 di 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ù, vedi Visualizzazione e ri-elaborazione delle notifiche. (DEVRT-2643)

Test Monetization (Cloud 16.05.25 monetization)

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 di 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 personalizzata. 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 gli 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 ulteriori informazioni, vedi http://docs.apigee.com/monetization/content/create-rate-plans#public-versus-private-rate-plans. (DEVRT-2445)

Riassegnazione degli sviluppatori (monetizzazione di Cloud 16.06.08)

La monetizzazione fornisce un insieme di API che puoi utilizzare per riattivare un developer 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 in un intervallo di tempo specificato utilizzando l'API Management. Per maggiori informazioni, consulta la sezione 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)

Norme 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 di 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 la policy 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 è destinato principalmente agli utenti che vogliono verificare 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: