Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Martedì 2 giugno 2015 abbiamo rilasciato una nuova versione cloud di Apigee Edge.
Se hai domande, rivolgiti all'assistenza clienti Apigee.
Per un elenco di tutte le note di rilascio di Apigee Edge, consulta le note di rilascio di Apigee.
Nuove funzionalità e miglioramenti
Di seguito sono riportate le nuove funzionalità e i miglioramenti di questa release.
Disponibilità generale di SmartDocumenti
SmartDocumenti sta passando dalla versione beta alla disponibilità generale. Gli aggiornamenti e le nuove funzionalità includono:
- Supporto per Swagger 2.0, inclusa l'importazione per file o URL, incluso il supporto per oggetti di sicurezza con nomi personalizzati.
- Miglioramenti del design visivo nei modelli che generano SmartDocumenti.
- Miglioramenti a livello di usabilità e del flusso di lavoro nel Portale per gli sviluppatori, disponibili tramite il menu Contenuti > SmartDocumenti in Drupal.
- L'autenticazione nota come "token personalizzato" ora si chiama "Chiave API".
- Oggetti di "sicurezza" di autenticazione definiti a livello di revisione.
- Configurazione dell'autenticazione client a livello di modello. Le nuove revisioni non reimpostano più le credenziali client SmartDocumenti preconfigurate.
Per ulteriori descrizioni delle funzionalità, consulta questo post del blog.
Per la documentazione di SmartDocuments, vedi Utilizzare SmartDocs per documentare le API.
Nuovo editor proxy API (beta)
È disponibile una nuova versione beta dell'editor proxy API. Per accedere, fai clic sul link "Accedi alla versione beta" quando modifichi un proxy API esistente. Puoi passare dagli editor "classici" a quelli "beta" e viceversa.
Nuovo criterio OAuthV2
Il nuovo criterio DeleteOAuthV2Info consente di eliminare i codici di autorizzazione e i token di accesso. Per maggiori informazioni, consulta la sezione Eliminare i criteri relativi alle informazioni OAuthV2.
Nuove entità nel criterio delle entità di accesso
Il criterio dell'entità di accesso consente di accedere alle seguenti nuove entità: ambito consumerkey, codice di autorizzazione, token di richiesta e verificatore. Per ulteriori informazioni, consulta la pagina relativa ai criteri relativi alle entità di accesso.
Visualizzazione dei certificati SSL prossimi alla scadenza
La pagina Certificati SSL nell'interfaccia utente di gestione (Amministratore > Certificati SSL) indica quando i certificati SSL scadono entro 10, 15, 30 o 90 giorni, a seconda della selezione nel campo del nuovo menu a discesa della scadenza.
Nome dell'app dello sviluppatore visualizzato nell'interfaccia utente di gestione
Le app per sviluppatori in Edge hanno un nome interno che non cambia e un nome visualizzato modificabile. Nella pagina App sviluppatore nell'interfaccia utente di gestione (Pubblica > App sviluppatore > Nome app), viene mostrato il "Nome" interno dell'app insieme al "Nome visualizzato", in modo da poter identificare più facilmente le app in base ai loro nomi interni per la risoluzione dei problemi e la gestione delle API.
Rimozione della versione classica dei report personalizzati dall'interfaccia utente di gestione
La versione classica facoltativa dei report di analisi personalizzati non è più disponibile nella UI di gestione.
Processo di upgrade di SmartDocumenti
Se hai già utilizzato SmartDocumenti durante il periodo beta, le nuove funzionalità e caratteristiche nella versione di disponibilità generale richiedono l'upgrade di SmartDocumenti nel tuo portale per gli sviluppatori.
Tutte le pagine SmartDocumenti già pubblicate nel tuo portale per gli sviluppatori continueranno a funzionare, ma devi seguire la procedura di aggiornamento prima di modificare o pubblicare eventuali modifiche a pagine nuove o esistenti.
Tieni presente che anche se puoi eseguire il rendering e la pubblicazione di SmartDocumenti all'interno del tuo portale per gli sviluppatori, gli SmartDocuments vengono generati dal modello API che si trova all'interno dei servizi di gestione delle API Edge di Apigee. Le modifiche apportate a un modello API in Edge saranno le stesse in tutti gli ambienti Pantheon (in modo simile a come esistono gli sviluppatori negli ambienti Pantheon).
Per eseguire l'upgrade dalla versione beta di SmartDocumenti alla disponibilità generale
- Aggiorna e testa la release 15.05.27 nei tuoi ambienti dev o test su Pantheon.
- Crea un nuovo modello per sostituire l'eventuale modello API esistente che utilizzi.
- Se stai importando documenti Swagger o WADL, importali di nuovo in una nuova revisione.
- Se stai gestendo il tuo modello API tramite il modulo SmartDocumenti, esportalo in formato JSON SmartDocuments e importalo nel nuovo modello utilizzando un file allegato.
- Imposta le proprietà di sicurezza della revisione del modello. Nella pagina Contenuti > SmartDocumenti > modello, seleziona Impostazioni di sicurezza.
- Controlla un'eventuale autenticazione preconfigurata nella pagina delle impostazioni del modello (Contenuti > SmartDocuments) facendo clic su Impostazioni nella colonna Operazioni.
- Aggiorna gli eventuali modelli personalizzati per utilizzare la versione 6 degli asset CSS e JS e apporta modifiche in base ai nuovi nomi degli oggetti, ad esempio authSchemes e apiSchema. Per informazioni sull'aggiornamento dei modelli SmartDocumenti, vedi Utilizzare SmartDocs per documentare le API.
- Esegui nuovamente il rendering e pubblica la revisione del modello.
- Dopo aver convalidato la nuova documentazione, aggiorna il portale di produzione alla release del 15/05/27.
Se sei un cliente Edge Enterprise e hai domande o dubbi sul processo di upgrade, invia un'email a marsh@apigee.com e cnovak@apigee.com. Altrimenti, utilizza la community Apigee per ricevere la risposta migliore.
Bug corretti
In questa release sono stati corretti i bug indicati di seguito.
| ID problema | Descrizione |
|---|---|
| TBD-72 | Problema relativo ai criteri di logging dei messaggi |
| MGMT-2124 | Le autorizzazioni del ruolo cliente vengono reimpostate al momento del salvataggio delle autorizzazioni nella UI |
| MGMT-2048 | L'utente con un ruolo personalizzato che limita le autorizzazioni per il deployment a un ambiente può eseguire il deployment in altri |
| MGMT-2041 | Rimuovi l'elemento FaultRules dal modello di allegato predefinito L'elemento FaultRules, che non viene utilizzato nei criteri o nei passaggi del proxy API, non viene più aggiunto automaticamente quando crei proxy API o aggiungi criteri. |
| MGMT-2034 | Errore di recupero di WSDL: "Errore WSDL di recupero: errore durante l'elaborazione di WSDL." |
| MGMT-1812 | Aggiungi la convalida TargetEndpoint durante l'importazione Analogamente a ProxyEndpoint, TargetEndpoint verrà convalidato per verificare lo schema e le espressioni appropriati utilizzati nelle condizioni durante l'importazione del proxy API. |
| MGMT-1345 | L'importazione di WSDL con più spazi dei nomi genera un passaggio SOAP di creazione errato |
| MGMT-800 | La creazione di una risorsa con il nome "default" causa un errore nell'interfaccia utente |
| MGMT-602 | Vista Sviluppo proxy API: aggiungi un criterio della cache di risposta quando l'endpoint non presenta un errore PreFlow/PostFlow |
| MGMT-460 | La ridenominazione del criterio comporta comportamenti scorretti, criterio duplicato che non può essere rimosso |
| DEVRT-1565 | Intervalli di 15 minuti per CHARGES |
| AXAPP-1728 | Ignorare le variabili di monetizzazione in Analytics |
| AXAPP-1690 | "Errore API non valido" nei report personalizzati |
| AXAPP-1533 | La mappa geografica di Analytics genera un errore di chiamata API non valida |
| APIRT-52 | Report personalizzati: il codice di stato della risposta per molte API è nullo |