Estás viendo la documentación de Apigee Edge.
Ir a la documentación de
Apigee X. info
El martes 2 de junio de 2015, lanzamos una nueva versión en la nube de Apigee Edge.
Si tienes preguntas, comunícate con el equipo de asistencia de Apigee Edge.
Para obtener una lista de todas las notas de la versión de Apigee Edge, consulta las Notas de la versión de Apigee.
Nuevas funciones y mejoras
A continuación, se indican las nuevas funciones y mejoras de esta versión.
Disponibilidad general de SmartDocs
SmartDocs pasará de la versión beta a la disponibilidad general. Las actualizaciones y las funciones nuevas incluyen lo siguiente:
- Se agregó compatibilidad con Swagger 2.0, incluida la importación por archivo o URL, y con objetos de seguridad con nombres personalizados.
- Se realizaron mejoras en el diseño visual de las plantillas que generan SmartDocs.
- Mejoras en la usabilidad y el flujo de trabajo en el portal para desarrolladores, disponibles a través del menú Content > SmartDocs en Drupal.
- Lo que se conocía como autenticación con "token personalizado" ahora se denomina "clave de API".
- Son objetos de "seguridad" de autenticación definidos a nivel de la revisión.
- Es la configuración de la autenticación del cliente a nivel de la plantilla. Las revisiones nuevas ya no restablecen las credenciales de cliente de SmartDocs preconfiguradas.
Para obtener más información sobre las funciones, consulta esta entrada de blog.
Para obtener documentación sobre SmartDocs, consulta Cómo usar SmartDocs para documentar APIs.
Nueva versión beta del editor de proxy de API
Hay disponible una nueva versión beta del editor de proxies de API. Para acceder, haz clic en el vínculo "Accede a la versión beta" cuando edites un proxy de API existente. Puedes alternar entre los editores "clásico" y "beta".
Nueva política de OAuthV2
La nueva política DeleteOAuthV2Info te permite borrar códigos de autorización y tokens de acceso. Para obtener más información, consulta la política de Delete OAuthV2 Info.
Nuevas entidades en la política de Access Entity
La política de Access Entity proporciona acceso a las siguientes entidades nuevas: consumerkey-scopes, authorizationcode, requesttoken y verifier. Para obtener más información, consulta la política de AccessEntity.
Mostrar los certificados SSL que están cerca de vencer
En la página Certificados SSL de la IU de administración (Administrador > Certificados SSL), se indica cuándo vencerán los certificados SSL en un plazo de 10, 15, 30 o 90 días, según la selección que realices en el nuevo campo desplegable de vencimiento.
Nombre de la app para desarrolladores que se muestra en la IU de administración
Las apps para desarrolladores en Edge tienen un nombre interno que no cambia y un nombre visible que puedes cambiar. En la página de una app para desarrolladores en la IU de administración (Publicar > Apps para desarrolladores > nombre de la app), se muestra el "Nombre" interno de la app junto con el "Nombre visible", lo que facilita la identificación visual de las apps por sus nombres internos para la solución de problemas y la administración de APIs.
Se quitará la versión clásica de los informes personalizados de la IU de administración
La versión clásica opcional de los informes de estadísticas personalizados ya no está disponible en la IU de administración.
Proceso de actualización de SmartDocs
Si ya usaste SmartDocs durante el período beta, las nuevas funciones y capacidades de la versión de disponibilidad general requieren que actualices SmartDocs en tu portal para desarrolladores.
Las páginas de SmartDocs que ya se publicaron en tu portal para desarrolladores seguirán funcionando, pero debes seguir el proceso de actualización antes de editar o publicar cualquier cambio en las páginas existentes o nuevas.
Ten en cuenta que, si bien puedes renderizar y publicar SmartDocs dentro de tu portal para desarrolladores, los SmartDocs se generan a partir del modelo de API que reside en los servicios de administración de APIs de Edge de Apigee. Todos los cambios que realices en un modelo de API en Edge serán los mismos en todos tus entornos de Pantheon (de manera similar a cómo existen los desarrolladores en los entornos de Pantheon).
Cómo actualizar de la versión beta de SmartDocs a la disponibilidad general
- Actualiza y prueba la versión 15.05.27 en tus entornos de desarrollo o prueba en Pantheon.
- Crea un modelo nuevo para reemplazar cualquier modelo de API existente que hayas estado usando.
- Si importaste documentos de Swagger o WADL, vuelve a importarlos en una revisión nueva.
- Si mantuviste tu modelo de API a través del módulo de SmartDocs, expórtalo como JSON de SmartDocs y, luego, impórtalo a tu nuevo modelo con un archivo adjunto.
- Establece las propiedades de seguridad de la revisión de tu modelo. En la página Content > SmartDocs > model, selecciona Security Settings.
- Haz clic en Configuración en la columna Operaciones para verificar cualquier autenticación preconfigurada en la página de configuración del modelo (Contenido > SmartDocs).
- Actualiza las plantillas personalizadas para que usen la versión 6 de los recursos CSS y JS, y realiza los cambios necesarios para reflejar los nombres de los objetos nuevos, como authSchemes y apiSchema. Para obtener información sobre cómo actualizar las plantillas de SmartDocs, consulta Cómo usar SmartDocs para documentar APIs.
- Vuelve a renderizar y publicar la revisión del modelo.
- Después de validar la nueva documentación, actualiza tu portal de producción a la versión del 27/05/15.
Si eres cliente empresarial de Edge y tienes preguntas o inquietudes sobre el proceso de actualización, envía un correo electrónico a marsh@apigee.com y cnovak@apigee.com. De lo contrario, usa la Comunidad de Apigee para obtener la mejor respuesta.
Fallas corregidas
En esta versión, se corrigieron los siguientes errores.
| ID del problema | Description |
|---|---|
| TBD-72 | Problema con la política de registro de mensajes |
| MGMT-2124 | Los permisos del rol del cliente se restablecen cuando se guardan los permisos en la IU |
| MGMT-2048 | El usuario con un rol personalizado que limita los permisos de implementación a un entorno puede realizar implementaciones en otros |
| MGMT-2041 | Se quitó el elemento FaultRules de la plantilla de adjuntos predeterminada El elemento FaultRules, que no se usa en las políticas ni en los pasos del proxy de API, ya no se agrega automáticamente cuando creas proxies de API o agregas políticas. |
| MGMT-2034 | La recuperación de WSDL devuelve un error: "Error de recuperación de WSDL: Error al procesar WSDL". |
| MGMT-1812 | Se agregó la validación de TargetEndpoint durante la importación Al igual que con ProxyEndpoint, se validará que TargetEndpoint tenga el esquema y las expresiones adecuados que se usan en las condiciones durante la importación del proxy de API. |
| MGMT-1345 | La importación de WSDL con varios espacios de nombres genera un paso de compilación de SOAP incorrecto |
| MGMT-800 | La creación de un recurso con el nombre "default" genera una IU dañada |
| MGMT-602 | Vista de desarrollo del proxy de API: Agregar una política de Response Cache cuando el extremo no tiene PreFlow/PostFlow causa un error |
| MGMT-460 | El cambio de nombre de la política genera un comportamiento defectuoso y una política duplicada que no se puede quitar |
| DEVRT-1565 | Intervalos de 15 minutos para los CARGOS |
| AXAPP-1728 | Ignora las variables de monetización en Analytics |
| AXAPP-1690 | "Error de API no válido" en informes personalizados |
| AXAPP-1533 | El mapa geográfico de Analytics arroja el error Invalid API Call |
| APIRT-52 | Informes personalizados: El código de estado de respuesta de muchas APIs es nulo |