4.16.09: Notas de la versión de Edge para la nube privada

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X. info

El lunes 19 de septiembre de 2016, lanzamos una nueva versión de Apigee Edge para la Nube privada.

Desde la versión anterior de Edge para la nube privada, se lanzaron las siguientes versiones, que se incluyen en esta versión de funciones:

• Cloud: 16.04.13 (IU), 16.04.13 (monetización), 16.04.20 (IU), 16.04.27 (monetización), 16.04.27 (IU), 16.05.04 (IU), 16.05.11 (IU), 16.05.11 (monetización), 16.05.18 (IU), 16.05.25 (monetización), 16.06.08 (monetización), 16.06.15 (IU), 16.06.22 (monetización), 16.06.29 (IU), 16.07.06 (monetización), 16.07.06.02 (monetización), 16.07.13 (IU), 16.07.20.01 (monetización), 16.07.27 (IU), 16.08.17

Consulta Acerca de la numeración de versiones para comprender cómo puedes determinar si una versión específica de la nube se incluye en tu versión de Edge para Private Cloud.

Resumen de la versión

En esta versión, se quitó el editor de proxies de API clásico y se reemplazó por el nuevo editor de proxies que estaba disponible para usar junto con el editor clásico. Otras mejoras destacadas incluyen el comportamiento mejorado de las rutas de recursos de productos de API, el manejo mejorado de cargas útiles JSON definidas en las políticas de Assign Message y Raise Fault, mejoras en las conversiones de XML a JSON, la validación de recursos mejorada, la capacidad de establecer tiempos de espera en proxies de API individuales, la generación actualizada de proxies de SOAP en el asistente de proxies de API y un objeto Crypto de alto rendimiento para JavaScript.

Las mejoras en la monetización incluyen nuevas funciones de notificación con un plan de tarifas de notificación, una API que migra a los desarrolladores a la monetización y la capacidad de hacer que los planes de tarifas sean públicos o privados.

El resto de este tema contiene detalles sobre todas las funciones nuevas, las actualizaciones y las correcciones de errores que se incluyen en la versión.

Obsoleto

Servicios de APIs

Se quitó el Editor de proxies clásico (IU de Cloud del 16/04/20)

La nueva versión del Editor de proxy de API ahora es la única versión compatible. La versión clásica ya no está disponible y se quitó el vínculo a "Acceder a la versión clásica del Editor de proxy". Si usabas la versión clásica, tus proxies de API se cargarán automáticamente en el nuevo editor. (EDGEUI-498)

Monetización

Se quitaron las siguientes funciones obsoletas y ya no se admiten:

• Cómo establecer límites
• Notificaciones de límite de envío

Como alternativa, puedes configurar notificaciones, como se describe en las siguientes secciones:

• Configura las notificaciones de eventos
• Crea una notificación de límite para un plan de tarifas

(DEVRT-2742)

Nuevas funciones y actualizaciones

A continuación, se indican las nuevas funciones y mejoras de esta versión. Además de las siguientes mejoras, esta versión también incluye varias mejoras de usabilidad, rendimiento, seguridad y estabilidad.

Para obtener más detalles e instrucciones, consulta la documentación de Edge para la nube privada.

Nube privada

Actualización de Postres a la versión 9.4

Esta versión incluye una actualización a Postgres 9.4. Para obtener instrucciones sobre cómo actualizar tu sistema, consulta Actualiza Apigee Edge a la versión 4.16.09.

Compatibilidad con GeoMap en la IU de Edge

Las agregaciones geográficas te permiten recopilar datos de análisis para las llamadas a la API en función de atributos geográficos, como región, continente, país y ciudad. A partir de estos datos de análisis, puedes ver un mapa geográfico en la IU de Edge que muestra la ubicación de las solicitudes a la API.

Para obtener más información, consulta Cómo habilitar la Agregación geográfica y los Mapas geográficos.

API de BaaS

Se agregó documentación sobre los siguientes temas:

• Cómo configurar API BaaS para usar TLS Para obtener más información, consulta Configura TLS para API BaaS.
• Cómo configurar todos los nodos de la pila de BaaS de la API para que usen almacenamiento compartido, de modo que todos los recursos estén disponibles para todos los nodos de la pila de BaaS de la API Para obtener más información, consulta Cómo subir recursos.
• Cómo encriptar la contraseña de Cassandra cuando se configuran los nodos de la pila de BaaS Para obtener más información, consulta Cómo restablecer contraseñas de Edge.

Lanzamiento de la versión beta del panel y la herramienta de supervisión

En esta versión, se incluye una versión beta de la nueva herramienta y el panel de supervisión para Edge. Esta herramienta te permite comprender el estado de varios componentes (routers, procesadores de mensajes, ZooKeeper y Cassandra), así como los códigos de error HTTP para varias organizaciones y entornos en tu implementación. También puedes tomar una instantánea de los datos de tu panel y compartirla con Apigee para ayudar a resolver incidentes de asistencia.

La documentación, incluidas las instrucciones de instalación, se incluye con la documentación de Edge 4.16.09 en la versión 4.18.01.

Sin embargo, antes de instalar y usar el panel, debes completar el Acuerdo de Evaluación de Apigee, que también está disponible en la versión 4.18.01, y enviarlo a Apigee por correo electrónico a orders@apigee.com.

Lanzamiento de la versión beta de la herramienta de recopilación de Analytics

Todos los clientes de Edge para Private Cloud deben enviar a Apigee estadísticas sobre el tráfico de los proxies de API. Apigee recomienda que los clientes suban esa información una vez al día, posiblemente creando un trabajo cron.

Para ayudarte a subir estos datos, Apigee proporciona la versión beta de la utilidad de línea de comandos apigee-analytics-collector. Esta utilidad envía el informe de volumen de llamadas a la API a Apigee. Cada instalación de Edge para la nube privada puede usar esta utilidad para recuperar y registrar datos de tráfico en Apigee.

Para obtener más información, consulta Cómo subir datos de tráfico de la API a Apigee: versión beta.

Servicios de APIs

Cargas útiles de JSON en Assign Message y Raise Fault (Cloud 16.08.17)

Con esta mejora, no se necesitan soluciones alternativas para garantizar el formato correcto de los mensajes JSON, y las variables se pueden especificar con llaves sin crear un JSON no válido. Por ejemplo, el siguiente código inserta el valor de message.content en el mensaje JSON:

<Payload contentType="application/json">{"Message: " : "{message.content}"}</Payload>

Si usaste una solución alternativa, tu código seguirá funcionando como está. También puedes usar variablePrefix y variableSuffix en lugar de llaves para indicar variables.

Consulta el elemento <Set><Payload> en los documentos de referencia de la política AssignMessage y la política Raise Fault. (APIRT-1160)

Mejoras en la política de XML a JSON (Cloud 16.08.17)

La política de XML a JSON se mejoró con las siguientes capacidades. Puedes configurar la política para que haga lo siguiente:

• Trata algunos elementos XML como arrays durante la conversión, lo que coloca los valores entre corchetes "[ ]" en el documento JSON.
• Quita o elimina niveles de la jerarquía del documento XML en el documento JSON final.

Para obtener más información, consulta Política de XML a JSON. (APIRT-1144)

Comodines múltiples en las rutas de recursos de productos de API (Cloud 16.08.17)

Cuando defines rutas de recursos en el producto de API, puedes incluir comodines en varios lugares de una ruta de recursos. Por ejemplo, /team/*/invoices/** permite llamadas a la API con cualquier valor después de /team y cualquier ruta de recursos después de invoices/. Un URI permitido en una llamada a la API sería proxyBasePath/team/finance/invoices/company/a.

Si, después de esta versión, las rutas de recursos de tu producto de API existente dejan de funcionar como se espera, establece la siguiente propiedad en tu organización para revertir al comportamiento anterior: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

Funciones de criptografía en JavaScript (Cloud 16.08.17)

Hay disponible un nuevo conjunto de funciones crypto de JavaScript de alto rendimiento para crear, obtener y actualizar los siguientes objetos hash: MD5, SHA-1, SHA256 y SHA512. El objeto crypto también te permite obtener la fecha en varios formatos. Para obtener más información, consulta el modelo de objetos de JavaScript. (APIRT-2886)

Verificación de la versión del JAR de Java Callout (Cloud 16.08.17)

Cuando se sube un recurso JAR de Java a un proxy de API, se devuelve un código de estado HTTP 400 (en lugar de un 500) si la versión del recurso de Java no es compatible con la versión de Java admitida por Edge, que se indica en Software y versiones compatibles. (MGMT-3420)

Validación de recursos del proxy de API (Cloud 16.08.17)

Cuando tienes archivos de recursos del proxy de API (como archivos JAR de JavaScript o Java) almacenados en el alcance del entorno o de la organización, el framework de validación ya no requiere que también incluyas esos recursos a nivel del proxy de API en un paquete de proxy para que la importación pase la validación. La validación de recursos ahora se realiza en el momento de la implementación, no en el momento de la importación. (MGMT-1430)

Configura el tiempo de espera para proxies de API individuales (Cloud 16.08.17)

Puedes configurar los proxies de API para que agoten el tiempo de espera después de un tiempo especificado (con un estado de tiempo de espera de puerta de enlace 504). El caso de uso principal es para los clientes de Private Cloud que tienen proxies de API que tardan más en ejecutarse. Por ejemplo, supongamos que necesitas proxies específicos para agotar el tiempo de espera en 3 minutos. Puedes usar una nueva propiedad api.timeout en la configuración de un proxy de API. A continuación, te mostramos cómo hacerlo con el ejemplo de 3 minutos:

1. Primero, asegúrate de configurar el balanceador de cargas, el router y el procesador de mensajes para que se agote el tiempo de espera después de 3 minutos.
2. Luego, configura los proxies relevantes para que se agote el tiempo de espera en 3 minutos. Especifica el valor en milisegundos. Por ejemplo:

   <ProxyEndpoint name="default">
     <HTTPProxyConnection>
       <BasePath>/v1/weather</BasePath>
       <Properties>
         <!-- api.timeout is in milliseconeds -->
         <Property name="api.timeout">180000</Property>
       </Properties>
       ...

3. Sin embargo, ten en cuenta que aumentar los tiempos de espera del sistema puede generar problemas de rendimiento, ya que todos los proxies sin una configuración de api.timeout usan los tiempos de espera del balanceador de cargas, el router y el procesador de mensajes nuevos. Por lo tanto, configura otros proxies de API que no requieran tiempos de espera más largos para usar tiempos de espera más bajos. Por ejemplo, el siguiente comando establece un proxy de API para que el tiempo de espera se agote después de 1 minuto:
   <Property name="api.timeout">60000</Property>

Los clientes de Cloud, que no pueden modificar los tiempos de espera de Edge, también pueden configurar el tiempo de espera del proxy de API, siempre que el tiempo de espera sea menor que el tiempo de espera estándar del procesador de mensajes de Edge de 57 segundos.

No puedes propagar el valor con una variable. Esta propiedad se describe en la Referencia de propiedades de extremos. (APIRT-1778)

Comportamiento del proxy de SOAP cuando se usa el asistente de proxy (IU de Cloud 16.07.27)

Cuando creas un proxy basado en SOAP a partir de un WSDL con el asistente de proxy, existen dos opciones para la creación del proxy:

• SOAP de transferencia, en el que el proxy simplemente transfiere una carga útil de solicitud SOAP tal como está.
• De REST a SOAP y de SOAP a REST, en la que el proxy convierte una carga útil entrante, como JSON, en una carga útil de SOAP y, luego, convierte la respuesta de SOAP al formato que espera el llamador.

En esta versión, se incluyen las siguientes actualizaciones sobre el comportamiento de estas opciones. Las diferencias entre el comportamiento anterior y el nuevo se encuentran en las políticas y configuraciones que genera automáticamente el asistente de proxy.

SOAP de transferencia

• Todas las operaciones de WSDL ahora se envían a la ruta base del proxy "/" en lugar de a los recursos del proxy (como "/cityforecastbyzip"). Los nombres de las operaciones se pasan al servicio SOAP de destino. Este comportamiento coincide con la especificación de SOAP.

• El proxy generado ya no admite JSON en la solicitud. Solo admite XML. El proxy garantiza que las solicitudes SOAP tengan un sobre, un cuerpo y un espacio de nombres.

De REST a SOAP y de SOAP a REST

• No se admite WSDL 2.0.
• El nuevo comportamiento no se probó con WS-Policy.
• El proxy te permite enviar datos JSON con POST en lugar de FormParams.
• Cuando agregues compatibilidad con CORS (uso compartido de recursos entre dominios) al proxy con el compilador de proxy, verás las siguientes mejoras:
  • Encabezado Access-Control-Allow-Headers: Además de los encabezados Origin, x-requested-with y Accept, el encabezado Access-Control-Allow-Headers también incluye Content-Type, Accept-Encoding, Accept-Language, Host, Pragma, Referrer, User-Agent y Cache-Control.
  • Encabezado Access-Control-Allow-Methods: Además de GET, PUT, POST y DELETE, este encabezado también incluye los verbos PATCH y OPTIONS.
• Cuando se genera un proxy de API para un WSDL, Edge lee cualquier ComplexType que se defina como abstracto en el WSDL y reconoce correctamente cualquier tipo de instancia que se base en los tipos abstractos.

Utilidad de línea de comandos de código abierto wsdl2apigee

Apigee también proporciona una utilidad de línea de comandos de código abierto para generar proxies de API de transferencia o de REST a SOAP a partir de WSDL. Consulta https://github.com/apigee/wsdl2apigee.

(EDGEUI-614)

Vencimiento o actualización predeterminados en la política de operaciones de mapa de clave-valor (IU de Cloud 16.06.15)

La política de operaciones de mapa de clave-valor te permite determinar cuánto tiempo se conservan los valores antes de que se actualicen. El intervalo de actualización se establece con el elemento <ExpiryTimeInSecs>. Si se ejecuta una operación GET y se superó el intervalo de vencimiento, se actualiza el valor y la política obtiene el valor actualizado. Cuando agregas esta política a un proxy de API, el tiempo de vencimiento predeterminado ahora es de 300 segundos. (El valor predeterminado anterior era -1, lo que significa que los valores nunca se actualizan). (EDGEUI-579)

Monetización

Plan de tarifas de notificaciones ajustable (IU de Cloud 16.04.20, monetización de Cloud 16.04.13)

Un nuevo plan de tarifas de notificaciones ajustable en la monetización de Edge permite que un proveedor de APIs ajuste la cantidad objetivo de transacciones para cada desarrollador de apps. Puedes configurar si se envían notificaciones y cuándo se envían en función del porcentaje del número objetivo que se alcanzó, como el 90%, el 100% o el 150%. Esta función está disponible a través de la IU de administración, además de la API de administración (que estaba disponible en una versión anterior). Para obtener más información, consulta Cómo especificar detalles del plan de notificaciones ajustable. (DEVRT-2375, DEVRT-2370)

Notificaciones de webhook para planes de tarifas de notificación ajustables (monetización de Cloud 16.04.27)

En el caso de los planes de tarifas de notificación ajustables, puedes crear webhooks que envíen notificaciones a la URL que especifiques. También puedes controlar las notificaciones para que se produzcan en intervalos específicos (porcentajes) hasta que se alcance el límite de transacciones. Las notificaciones de webhook te brindan una alternativa flexible al uso de las plantillas de notificación existentes. Consulta Cómo configurar notificaciones con webhooks. (DEVRT-2393, DEVRT-2394)

Plan de tarifas de notificación ajustable con atributo personalizado (IU de Cloud 16.05.18)

En la monetización perimetral, un nuevo plan de tarifas "Notificación ajustable con atributo personalizado" te permite agregar al recuento de transacciones de un desarrollador el valor de un atributo personalizado. Con el plan de tarifas estándar de notificaciones ajustables, cada llamada a la API exitosa agrega 1 al recuento de transacciones de un desarrollador. Sin embargo, con el plan de tarifas de Notificación ajustable con atributo personalizado, el valor del atributo personalizado se agrega al recuento de transacciones del desarrollador. Por ejemplo, si el atributo personalizado "small" tiene un valor de 0.1 en la respuesta, el recuento de transacciones se incrementa en 0.1; o bien, si el atributo personalizado "addressTotal" tiene un valor de 50, el recuento se incrementa en 50. Para obtener más información, consulta Cómo especificar el plan de tarifas con detalles de atributos personalizados. (DEVRT-2504)

Configura notificaciones basadas en los totales combinados de transacciones de una empresa y sus desarrolladores (Monetización de Cloud 16.06.22)

Por lo general, los totales de las transacciones se registran automáticamente para todos los desarrolladores de una empresa cuando estos usan la app de la empresa para acceder a las APIs. ¿Qué sucede si tienes desarrolladores que usan activamente sus propias apps para desarrolladores para acceder a las APIs y necesitas hacer un seguimiento de sus totales de transacciones combinadas sin interrupciones en el tráfico? Puedes agregar a los desarrolladores a una empresa y configurar notificaciones para que se envíen cuando se alcancen los umbrales basados en los totales combinados de transacciones de la empresa y sus desarrolladores. Para obtener más información, consulta Cómo configurar notificaciones basadas en los totales de transacciones combinados de una empresa y sus desarrolladores. (DEVRT-2643)

Visualiza y vuelve a procesar notificaciones (monetización de Cloud 16.06.08)

Como parte del conjunto de pruebas de monetización, puedes ver y volver a procesar las notificaciones que se enviaron anteriormente con la API de Management. Para obtener más información, consulta Cómo ver y volver a procesar notificaciones. (DEVRT-2643)

Test Monetization (monetización de Cloud del 25/05/16)

La monetización proporciona un conjunto de APIs que puedes usar para probar la ejecución de webhooks y asegurarte de que se envíen las notificaciones. Para obtener más información, consulta Configuración de notificaciones de prueba. (DEVRT-2625)

Migración de desarrolladores a la monetización (monetización de Cloud 16.05.11)

Hay una nueva API disponible para facilitar la migración de los desarrolladores a la monetización. Puedes transferir el uso de transacciones y cobrar tarifas recurrentes y de configuración personalizadas. Además, cuando aceptas un plan de tarifas publicado, puedes renunciar a las tarifas de configuración en caso de que ya se hayan cobrado. Para obtener más información, consulta Migra desarrolladores a la monetización. (DEVRT-2446)

Planes de tarifas públicos y privados para el portal para desarrolladores (monetización de Cloud 16.04.27)

Puedes configurar los planes de tarifas como “Públicos” o “Privados”. Los planes de tarifas públicos aparecen en el portal para desarrolladores, pero los planes de tarifas privados no. El valor predeterminado de un plan de tarifas es Público. Para obtener más información, consulta http://docs.apigee.com/monetization/content/create-rate-plans#public-versus-private-rate-plans. (DEVRT-2445)

Cómo reactivar a los desarrolladores (monetización de Cloud 16.06.08)

La monetización proporciona un conjunto de APIs que puedes usar para anular la suspensión de un desarrollador que se suspendió anteriormente. Es posible que se suspenda a un desarrollador si se alcanza un límite configurado. Por ejemplo, la cantidad de transacciones alcanzó su límite máximo o se agotó el saldo de una cuenta prepagada. Para obtener más información, consulta Cómo reactivar a los desarrolladores. (DEVRT-2641)

Consulta el estado de las transacciones (monetización de Cloud 16.06.08)

Como parte del conjunto de pruebas de monetización, puedes ver el estado de las transacciones que se produjeron durante un período especificado con la API de administración. Para obtener más información, consulta Cómo ver el estado de las transacciones. (DEVRT-2640)

Se incluyen atributos personalizados del desarrollador en los informes de ingresos (monetización de Cloud del 25/05/2016)

Solo para los informes de ingresos, puedes incluir atributos personalizados en el informe si el atributo personalizado está definido para el desarrollador. Para obtener más información, consulta Cómo incluir atributos personalizados del desarrollador en los informes de ingresos con la API. (DEVRT-2447)

Política de grabación de transacciones y coherencia de recursos del producto de API (IU de Cloud del 16/05/18)

Si las rutas de recursos de una política de registro de transacciones de monetización no coinciden con las rutas de recursos definidas en su producto de API (por ejemplo, si cambias las rutas de recursos del producto de API), el ícono de la política de registro de transacciones en la página Productos mostrará un símbolo de advertencia. Cuando haces clic en el ícono para ver la Política de Grabación de Transacciones, aparece una advertencia en la parte superior de la página. Cuando corrijas las rutas de acceso de los recursos en la Política de grabación de transacciones, desaparecerán los indicadores de advertencia. (DEVRT-2240)

Fallas corregidas

En esta versión, se corrigieron los siguientes errores. Esta lista está dirigida principalmente a usuarios que verifican si sus tickets de asistencia se corrigieron. No está diseñada para proporcionar información detallada a todos los usuarios.

Edge para la nube privada

16.08.17

16.07.27 (IU)

16.07.20.01 (monetización)

Esta versión incluye cambios menores en el esquema de la base de datos. No hay otras actualizaciones de software en esta versión.

16.07.13 (IU)

16.07.06.02 (monetización)

16.07.06 (monetización)

16.06.29 (IU)

16/06/22 (monetización)

Ninguno

16.06.15 (IU)

16.06.08 (monetización)

Ninguno

16.05.25 (monetización)

16/05/18 (IU)

16.05.11 (monetización)

16.05.11 (IU)

16.05.04 (IU)

16.04.27 (IU)

16.04.27 (monetización)

Ninguno

16.04.20 (IU)

16.04.13 (monetización)

Ninguno

16.04.13 (IU)

Problemas conocidos

Esta versión tiene los siguientes problemas conocidos: