4.16.09 - Note di rilascio di Edge per Private Cloud

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X. Informazioni

Lunedì 19 settembre 2016 abbiamo rilasciato una nuova versione di Apigee Edge per il cloud privato.

Dalla precedente release delle funzionalità Edge per il cloud privato, le seguenti release hanno si sono verificati e sono inclusi in questa versione:

• Cloud: 16.04.13 (UI), 16.04.13 (monetizzazione), 16.04.20 (UI), 27.04.16. (monetizzazione), 16.04.27 (UI), 4/16/05 (UI), 16.05.11 (UI), 16.05.11 (monetizzazione), 16.05.18 (UI), 16/05/25 (monetizzazione), 16.06.08 (monetizzazione), 16/16/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

Vedi Informazioni sulla release numerazione per capire come capire se una specifica release cloud è incluso 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 proxy un editor disponibile per l'uso insieme alla versione classica. Altri miglioramenti degni di nota includono un comportamento migliorato dei percorsi delle risorse dei prodotti API, una migliore gestione dei payload JSON definiti in Attribution Message and Raise Fault criteri, miglioramenti alle conversioni XML-to-JSON, convalida delle risorse migliorata, possibilità di impostare timeout su singoli proxy API, aggiornamento generazione di proxy SOAP nella procedura guidata del proxy API e un oggetto Crypto ad alte prestazioni 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 possibilità di rendere pubblici i piani tariffari privato.

La parte restante di questo argomento contiene dettagli su tutte le nuove funzionalità, gli aggiornamenti e le correzioni di bug contenuti nella release.

Deprecato

Servizi API

Editor proxy classico rimosso (UI Cloud 16.04.20)

La nuova versione dell'Editor proxy API è ora l'unica 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 in il nuovo editor. (EDGEUI-498)

Monetizzazione

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

• Impostare i limiti
• Invio di notifiche sui limiti

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

• Configura evento notifiche
• Crea un notifica sui limiti per un piano tariffario

(DEVRT-2742)

Nuove funzionalità e aggiornamenti

Di seguito sono riportate le nuove funzioni e i miglioramenti di questa release. Oltre a quanto segue miglioramenti, questa release contiene inoltre diverse caratteristiche di usabilità, prestazioni, sicurezza e miglioramenti.

Per ulteriori dettagli e istruzioni, consulta la documentazione di Edge per il cloud privato.

Cloud privato

Upgrade dei post alla versione 9.4

Questa release include un upgrade a Postgres 9.4. Per istruzioni su come aggiornare l'impianto, vedi Aggiornare Apigee Edge 4.16.09.

Supporto delle mappe geografiche nella UI di Edge

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

Per ulteriori informazioni, consulta Attivazione dell'aggregazione geografica e Mappe geografiche.

API BaaS

È stata aggiunta la documentazione relativa a:

• Come configurare l'API BaaS per l'utilizzo di TLS. Per ulteriori informazioni, consulta Configurazione di TLS per BaaS API.
• Come configurare tutti i nodi dello stack BaaS dell'API per utilizzare lo spazio di archiviazione condiviso in modo che tutti gli asset siano disponibile per tutti i nodi dello stack BaaS delle API. Per ulteriori informazioni, consulta la sezione Caricamento degli asset.
• Come criptare la password Cassandra durante la configurazione dei nodi dello stack BaaS. Per ulteriori informazioni informazioni, consulta la sezione Reimpostazione di Edge Password.

Versione beta dello strumento e della dashboard di monitoraggio

Questa release include una versione beta del nuovo strumento di monitoraggio e della dashboard per Edge. Questo strumento consente di comprendere l'integrità di vari componenti (router, processori di messaggi, ZooKeeper, Cassandra), nonché i codici di errore HTTP per i vari ambienti e organizzazioni e deployment continuo. Puoi anche creare uno snapshot dei dati della tua dashboard e condividerlo con Apigee per aiutarti gli incidenti di assistenza.

La documentazione, comprese le istruzioni di installazione, è inclusa nella documentazione di Edge 4.16.09 alla Versione 4.18.01.

Tuttavia, prima di poter installare e utilizzare la dashboard, devi completare la valutazione Apigee disponibile anche nella versione 4.18.01, per poi restituirlo ad Apigee inviandolo via email all'indirizzo orders@apigee.com.

Versione beta dello strumento di raccolta Analytics

Tutti i clienti di Edge per il cloud privato sono tenuti a inviare ad Apigee le statistiche sull'API il traffico proxy. Apigee consiglia ai clienti di caricare queste informazioni una volta al giorno, probabilmente la creazione di un cron job.

Per facilitare il caricamento di questi dati, Apigee fornisce la versione beta della riga di comando apigee-analytics-collector utilità. Questa utilità invia il report sul volume di chiamate API ad Apigee. Ogni vantaggio per L'installazione del cloud privato può utilizzare questa utilità per recuperare e segnalare i dati sul traffico a Apigee.

Per ulteriori informazioni, consulta la sezione Upload API Dati sul traffico verso Apigee (versione beta).

Servizi API

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

Con questo miglioramento, non sono necessarie soluzioni alternative per garantire la corretta formattazione dei messaggi JSON. possono essere specificate utilizzando parentesi graffe senza creare un file JSON non valido. Ad esempio, 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 tuo codice continuerà a funzionare così com'è. Puoi anche utilizzare variabili Prefisso e variabileSuffix anziché parentesi graffe per indicare le variabili.

Consulta la sezione <Set><Payload> nel criterio Assign Message Policy e Aumenta il criterio di errore documenti di riferimento. (APIRT-1160)

Miglioramenti dei criteri da XML a JSON (Cloud 16.08.17)

Il criterio da XML a JSON è stato migliorato con le funzionalità seguenti. Puoi configurare le norme per:

• Tratta alcuni elementi XML come array durante la conversione, in modo che i valori siano quadrati parentesi quadra "[ ]" nel documento JSON.
• Elimina o elimina i livelli della gerarchia dei documenti XML nel documento JSON finale.

Per ulteriori informazioni, consulta i file XML al criterio JSON. APIRT-1144

Caratteri jolly multipli nei percorsi di risorse del prodotto API (Cloud 16.08.17)

Quando si definiscono i percorsi delle risorse in un prodotto API, è possibile includere caratteri jolly in più punti di un del percorso delle risorse. Ad esempio, /team/*/invoices/** consente le chiamate API con qualsiasi un valore dopo /team ed eventuali percorsi delle risorse dopo il giorno invoices/. Un URI consentito su una chiamata API proxyBasePath/team/finance/invoices/company/a.

Se dopo questa release i percorsi delle risorse del prodotto API esistenti smetteranno di funzionare come previsto, imposta la seguente proprietà nell'organizzazione per ripristinare la precedente comportamento: 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 la creazione, il recupero e l'aggiornamento di quanto segue include oggetti: MD5, SHA-1, SHA256, SHA512. L'oggetto crypto ti consente inoltre di ottenere data in vari formati. Per ulteriori informazioni, consulta la sezione Modello a oggetti JavaScript. (APIRT-2886)

Controllo della versione JAR del callout Java (Cloud 16.08.17)

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

Convalida risorse proxy API (Cloud 16.08.17)

Se i file di risorse del proxy API (come JavaScript o JAR) sono archiviati nel a livello di ambiente o organizzazione, il framework di convalida non richiede più Includere queste risorse a livello di proxy API in un bundle proxy affinché l'importazione superi la convalida. La convalida delle risorse viene ora eseguita al momento del deployment, non in fase di importazione. (MGMT-1430)

Configura il timeout per singoli proxy API (Cloud 16.08.17)

Puoi configurare i proxy API in modo che scadano dopo un determinato periodo di tempo (con un timeout del gateway 504) . Il caso d'uso principale è per i clienti del cloud privato che dispongono di proxy API che prendono più a lungo da eseguire. Ad esempio, supponiamo che tu abbia bisogno di proxy specifici per scadere dopo 3 minuti. Puoi utilizza una nuova proprietà api.timeout nella configurazione di un proxy API. Ecco come: nel seguente esempio:

1. Innanzitutto, assicurati di configurare il bilanciatore del carico, il router e il processore di messaggi in modo che scada il tempo dopo 3 minuti.
2. Dopodiché 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 del sistema potrebbe causare problemi di prestazioni, tutti i proxy senza un'impostazione api.timeout usano il nuovo bilanciatore del carico più alto, del router e del processore di messaggi. Configura quindi altri proxy API che non richiedono più lunghi per utilizzare timeout inferiori. Ad esempio, quanto segue imposta un proxy API per il timeout dopo 1 minuto:
   <Property name="api.timeout">60000</Property>

I clienti Cloud, che non possono modificare i timeout per Edge, possono anche configurare un timeout del proxy API, purché il timeout sia più breve del timeout standard del processore di messaggi Edge di 57 secondi.

Non puoi completare il valore con una variabile. Questa proprietà è trattata nella sezione Proprietà endpoint riferimento. (APIRT-1778)

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

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

• SOAP pass-through, in cui il proxy passa semplicemente attraverso una richiesta SOAP il payload così com'è.
• REST to SOAP to REST, dove il proxy converte un payload in entrata come JSON in un payload SOAP, quindi converte la risposta SOAP nel formato del chiamante si aspetta.

Questa release include i seguenti aggiornamenti relativi al comportamento di queste opzioni. Le differenze tra il vecchio e il nuovo comportamento sono i criteri e le configurazioni che vengono generate dalla procedura guidata del proxy.

SOAP passthrough

• Tutte le operazioni WSDL vengono ora inviate al percorso base proxy "/" che tramite proxy per le risorse (ad esempio "/cityforecastbyzip"). I nomi delle operazioni vengono trasmessi alla SOAP di destinazione completamente gestito di Google Cloud. Questo comportamento corrisponde alla specifica SOAP.

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

Da REST a SOAP e 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 il proxy noterai i seguenti miglioramenti:
  • Intestazione Access-Control-Allow-Headers: oltre a Origin, x-requested-with e Accept, il valore 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 campi Verbi PATCH e OPTIONS.
• Quando genera un proxy API per un WSDL, Edge legge tutti i ComplexTypes definiti come in WSDL e riconosce correttamente tutti i tipi di istanza basati sull'astratto di testo.

Utility a riga di comando open source wsdl2apigee

Apigee offre anche un'utilità a riga di comando open source per generare proxy API REST-to-Sapone da WSDL. Vedi https://github.com/apigee/wsdl2apigee.

(EDGEUI-614)

Scadenza/aggiornamento predefinito nel criterio Key Value Map Operations (UI Cloud 16.06.15)

Il criterio delle operazioni di mappatura dei valori chiave consente di determinare per quanto tempo i valori rimangono persistenti prima di in fase di aggiornamento. L'intervallo di aggiornamento è impostato con l'elemento <ExpiryTimeInSecs>. Se viene eseguita un'operazione GET l'intervallo di scadenza è stato superato, il valore viene aggiornato e il criterio ottiene valore. Quando aggiungi questo criterio a un proxy API, la scadenza predefinita è ora di 300 secondi. (La il valore predefinito precedente era -1, il che significa che i valori non vengono mai aggiornati.) (EDGEUI-579)

Monetizzazione

Piano del tasso di notifica regolabile (UI Cloud 16.04.20, monetizzazione Cloud 16.04.13)

Un nuovo piano tariffario regolabile nella monetizzazione perimetrale consente a un provider API numero di transazioni target per ogni sviluppatore di app. Puoi configurare se e quando le notifiche vengono inviati in base alla percentuale del numero target raggiunto, ad esempio 90%, 100% o il 150%. Questa funzionalità è disponibile tramite l'interfaccia utente di gestione e l'API di gestione (disponibile in una release precedente). Per ulteriori informazioni, consulta la sezione Specificare dettagli del piano di notifica regolabili. (DEVRT-2375, DEVRT-2370)

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

Per i piani tariffari regolabili, puoi creare webhook che inviano notifiche al all'URL specificato. Puoi anche controllare le notifiche in modo che vengano inviate a intervalli specifici (percentuali) fino al raggiungimento del limite di transazioni. Le notifiche webhook offrono un approccio flessibile un'alternativa all'utilizzo dei modelli di notifica esistenti. Vedi Configurare le notifiche con webhook. (DEVRT-2393, DEVRT-2394)

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

Nella monetizzazione Edge, viene visualizzata una nuova "Notifica regolabile con attributo personalizzato" piano tariffario ti consente aggiungere al conteggio delle transazioni di uno sviluppatore utilizzando il valore di un attributo personalizzato. Con lo standard Piano di tasso di notifica regolabile: ogni chiamata API andata a buon fine aggiunge 1 alla transazione di uno sviluppatore conteggio. Con il piano tariffario Notifica regolabile con attributo personalizzato, invece, il valore attributo personalizzato viene aggiunto al conteggio delle transazioni dello sviluppatore. Ad esempio, se l'attributo personalizzato "piccolo" ha un valore di 0,1 nella risposta, il conteggio delle transazioni viene incrementato di 0,1; o se attributo personalizzato "addressTotal" ha un valore pari a 50, il conteggio viene incrementato di 50. Per ulteriori informazioni informazioni, consulta la sezione Specificare il piano tariffario con dettagli degli attributi personalizzati. (DEVRT-2504)

Configurare le notifiche in base ai totali delle transazioni combinate per una società e i suoi sviluppatori (Monetizzazione Cloud 16.06.22)

Di solito, i totali delle transazioni vengono monitorati automaticamente per tutti gli sviluppatori di un'azienda quando gli sviluppatori usano l'app aziendale per accedere alle API. E se ci fossero sviluppatori che stanno attivamente che usano le proprie app sviluppatore per accedere alle API, e tu devi monitorare la sua transazione combinata totali senza interruzioni nel traffico? Puoi aggiungere gli sviluppatori a un'azienda e configurare notifiche da inviare al raggiungimento delle soglie basate su transazioni combinate totali per l'azienda e i suoi sviluppatori. Per ulteriori informazioni, vedi Impostare Impostare le notifiche in base ai totali delle transazioni combinate di una società e dei suoi sviluppatori. (DEVRT-2643)

Visualizzare e rielaborare le notifiche (monetizzazione Cloud 16.06.08)

Nell'ambito della Test Suite per la monetizzazione, puoi visualizzare e rielaborare le notifiche in precedenza inviate utilizzando l'API di gestione. Per ulteriori informazioni, consulta la sezione Visualizzazione e notifiche di rielaborazione. (DEVRT-2643)

Test di monetizzazione (monetizzazione Cloud 16.05.25)

La monetizzazione fornisce un set di API che puoi utilizzare per testare l'esecuzione di webhook assicurarsi 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 configurazione personalizzata e tariffe ricorrenti. Inoltre, quando accetti un piano tariffario pubblicato, puoi rinunciare alle commissioni di configurazione nel caso in cui siano già stati addebitati. Per ulteriori informazioni, leggi l'articolo Eseguire la migrazione degli sviluppatori a monetizzazione. (DEVRT-2446)

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

Puoi impostare i piani tariffari come "Pubblico" o "Privato". I piani tariffari pubblici vengono visualizzati nello sviluppatore portal; mentre i piani tariffari privati non lo fanno. L'impostazione predefinita di un piano tariffario è Pubblico. Per ulteriori informazioni, consulta http://docs.apigee.com/monetization/content/create-rate-plans#public-versus-private-rate-plans. (DEVRT-2445)

Annullamento della sospensione degli sviluppatori (monetizzazione Cloud 16.06.08)

La monetizzazione fornisce una serie di API che puoi utilizzare per annullare la sospensione di uno sviluppatore che era sospeso in precedenza. Uno sviluppatore potrebbe essere sospeso se viene raggiunto un limite configurato. Per Ad esempio, è stato raggiunto il limite massimo del numero di transazioni o il saldo dell'account è prepagato esaurite. Per informazioni, vedi Annullare la sospensione degli sviluppatori. (DEVRT-2641)

Visualizzare lo stato delle transazioni (monetizzazione Cloud 16.06.08)

Come parte della Test Suite per la monetizzazione, puoi visualizzare lo stato delle transazioni che si sono verificate durante un intervallo di tempo specificato utilizzando l'API di gestione. Per ulteriori informazioni, consulta la sezione Visualizzazione dello stato transazioni. (DEVRT-2640)

Inclusione degli attributi personalizzati degli sviluppatori nei report Entrate (monetizzazione Cloud 16.05.25)

Solo per i report Entrate, puoi includere attributi personalizzati nel report, se l'impostazione personalizzata viene definito per lo sviluppatore. Per ulteriori informazioni, leggi l'articolo Inclusione di personalizzazione degli sviluppatori nei report sulle entrate usando l'API. (DEVRT-2447)

Criterio di registrazione delle transazioni e coerenza delle risorse del prodotto API (UI Cloud 16.05.18)

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

Bug corretti

In questa release sono stati corretti i bug riportati di seguito. Questo elenco è destinato principalmente agli utenti che vogliono visualizzare se i ticket di assistenza sono stati risolti. Non è pensata per fornire informazioni dettagliate per tutti gli utenti.

Edge per cloud privato

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 .

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: