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

Estás viendo la documentación de Apigee Edge.
Ve a la Documentación de Apigee X. información

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 funciones de nube privada, los siguientes lanzamientos tienen se produjeron y están incluidos en este Lanzamiento de la función:

• Nube: 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 versión. numeración para entender cómo puedes saber si una versión específica de la nube incluida en tu versión de Edge para la nube privada.

Resumen de la versión

En esta versión, se quitó el editor de proxy de API clásico y se reemplazó por el nuevo proxy que estaba disponible para usarse junto con el editor clásico. Otras mejoras notables Incluye un comportamiento mejorado de las rutas de acceso de los recursos del producto de API y un manejo mejorado de las cargas útiles de JSON. definidas en las políticas de asignación de mensajes y aumento de errores, mejoras en las conversiones de XML a JSON, validación de recursos mejorada, la capacidad de establecer tiempos de espera en proxies de API individuales, actualización la generación de proxies de SOAP en el asistente de proxy de API y un objeto Crypto de alto rendimiento para JavaScript:

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

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

Obsoleto

Servicios de APIs

Se quitó el editor de proxy clásico (IU de Cloud 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 el vínculo "Acceder a la versión clásica del Editor de proxy" ha sido o quitarse. Si utilizabas la versión clásica, los proxies de tu 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:

• Establece límites
• Enviando notificaciones de límites

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

• Configurar evento notificaciones
• Crea un notificación sobre el límite de un plan de tarifas

(DEVRT-2742)

Nuevas funciones y actualizaciones

A continuación, se detallan las nuevas funciones y mejoras de esta versión. Además de los siguientes mejoras, esta versión también contiene diversas funciones de usabilidad, rendimiento, seguridad y estabilidad. mejoras.

Para obtener más instrucciones y detalles, consulta la documentación sobre el perímetro de 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 el sistema, consulta Actualiza Apigee Edge 4.16.09.

Compatibilidad con GeoMap en la IU de Edge

Las agregaciones geográficas te permiten recopilar datos de estadísticas para llamadas a la API según la ubicación atributos como región, continente, país y ciudad. A partir de estos datos de estadísticas, puedes ver un GeoMap 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 Mapas geográficos.

BaaS de API

Se agregó documentación sobre lo siguiente:

• Cómo configurar las BaaS de las APIs para usar TLS Si deseas obtener más información, consulta Configura TLS para BaaS de API.
• Cómo configurar todos los nodos de la pila de BaaS de APIs para usar el almacenamiento compartido de modo que todos los recursos se disponible para todos los nodos de la pila de BaaS de APIs. Para obtener más información, consulta Cómo subir recursos.
• Cómo encriptar la contraseña de Cassandra cuando se configuran nodos de pila BaaS Para ver más consulta Restablece Edge Contraseñas

Lanzamiento en versión beta de la herramienta de supervisión y el panel

En esta versión, se incluye una versión beta de la nueva herramienta de supervisión y el panel de Edge para Edge. Permite comprender el estado de varios componentes (enrutadores, procesadores de mensajes, ZooKeeper, Cassandra), así como códigos de error HTTP para varias organizaciones y entornos de tu de Google Workspace. También pueden tomar una instantánea de los datos de su panel y compartirlos con Apigee para ayudar y resolver los incidentes de asistencia.

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

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

Lanzamiento en versión beta de la herramienta de recopilador de estadísticas

Todos los clientes de Edge para la nube privada deben enviar estadísticas de Apigee sobre la API el tráfico del proxy. Apigee recomienda que los clientes suban esa información una vez al día, posiblemente mediante crear un trabajo cron.

Para ayudar en la carga de estos datos, Apigee proporciona la versión beta de la línea de comandos de apigee-analytics-collector o de terceros. Esta utilidad envía el informe del volumen de llamadas a la API a Apigee. Todas las ventajas de la La instalación de nube privada puede usar esta utilidad para recuperar datos de tráfico e informarlos a Apigee

Para obtener más información, consulta Subir la API Datos de tráfico a Apigee: lanzamiento beta.

Servicios de APIs

Cargas útiles de JSON en Asignar mensaje y generar errores (Cloud 16.08.17)

Con esta mejora, no se necesitan soluciones alternativas para garantizar el formato adecuado de los mensajes JSON. Las variables se pueden especificar con llaves sin crear un JSON no válido. Por ejemplo, el siguiente 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 las variables

Consulta <Set><Payload> de la política de Asignar mensajes Política de aumento de errores documentos de referencia. (APIRT-1160)

Mejoras en las políticas de XML a JSON (Cloud 16.08.17)

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

• Trata algunos elementos XML como arrays durante la conversión, lo que coloca los valores en cuadrados. 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 XML en la política de JSON. (APIRT-1144)

Varios comodines en las rutas de acceso de los recursos del producto de API (Cloud 16.08.17)

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

Si después de este lanzamiento las rutas existentes de los recursos del producto de API dejan de funcionar como se esperaba, configura la siguiente propiedad de tu organización para volver a la configuración anterior comportamiento: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

Funciones criptográficas en JavaScript (Cloud 16.08.17)

Está disponible un nuevo conjunto de funciones crypto de alto rendimiento de JavaScript para crear, obtener y actualizar lo siguiente tiene objetos: 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 Modelo de objetos de JavaScript. (APIRT-2886)

Verificación de versión de JAR de texto destacado de Java (Cloud 16.08.17)

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

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

Cuando tiene archivos de recursos del proxy de API (como archivos JAR de JavaScript o Java) almacenados en el alcance del entorno o la organización, el framework de validación ya no requiere que también incluir esos recursos en el 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 ocurre en el momento de la implementación, no en el 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 se agote el tiempo de espera después de un tiempo específico (con un tiempo de espera de puerta de enlace 504 estado). El caso de uso principal es para los clientes de la Nube privada que tienen proxies de API que toman más tiempo de ejecución. Por ejemplo, supongamos que necesitas proxies específicos para que el tiempo de espera sea de 3 minutos. Puedes Usa una nueva propiedad api.timeout en la configuración de un proxy de API. Aquí te indicamos cómo hacerlo lo harías con el ejemplo de 3 minutos:

1. 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 un aumento de los tiempos de espera del sistema podría provocar problemas de rendimiento todos los proxies sin un parámetro de configuración de api.timeout usan el nuevo balanceador de cargas más alto del router y del procesador de mensajes. Así que configura otros proxies de API que no requieran tiempos de espera más largos para usar tiempos de espera más bajos. Por ejemplo, lo siguiente configura un proxy de API para que se agote el tiempo de espera 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 un tiempo de espera de proxy de API. siempre y cuando el tiempo de espera sea menor que el tiempo de espera estándar del procesador de mensajes Edge de 57 segundos.

No puedes propagar el valor con una variable. Esta propiedad está cubierta en las Propiedades de extremos referencia. (APIRT-1778)

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

Al crear un proxy basado en SOAP desde un WSDL a través del asistente de proxy, existen dos opciones para creación de proxy:

• SOAP de transferencia, en el que el proxy simplemente pasa por una solicitud de SOAP de la carga útil tal como está.
• REST a SOAP a REST, donde el proxy convierte una carga útil entrante, como JSON a una carga útil de SOAP, luego vuelve a convertir la respuesta de SOAP al formato que el emisor espera.

En esta versión, se incluyen las siguientes actualizaciones del comportamiento de estas opciones. Diferencias entre el comportamiento anterior y el nuevo están en las políticas y configuraciones que se generada por el asistente del proxy.

SOAP de transferencia

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

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

REST a SOAP a REST

• No se admite WSDL 2.0.
• El comportamiento nuevo no se probó con la política WS.
• El proxy te permite PUBLICAR datos JSON en lugar de FormParams.
• Cuando agregas compatibilidad con el CORS (uso compartido de recursos entre dominios) al proxy verás las siguientes mejoras:
  • Access-Control-Allow-Headers: Además de los encabezados Origin, x-requested-with y Accept; el El encabezado Access-Control-Allow-Headers también incluye Content-Type, Accept-Encoding, Accept-Language, Host, Pragma, Referrer, User-Agent y Cache-Control:
  • Access-Control-Allow-Methods: Además de GET, PUT, POST y DELETE. Este encabezado también incluye el elemento Verbos PATCH y OPTIONS.
• Al generar un proxy de API para un WSDL, Edge lee cualquier ComplexTypes que se define como en el WSDL y reconoce correctamente cualquier tipo de instancia que se base en la de tipos de datos.

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 transferencias o con los proxies de las APIs de REST-to-soap de los WSDL. Consulta https://github.com/apigee/wsdl2apigee.

(EDGEUI-614)

Configuración predeterminada de vencimiento o actualización de la política de operaciones del mapa de pares clave-valor (IU de Cloud 16.06.15)

La política de operaciones del mapa de pares clave-valor permite determinar durante cuánto tiempo se conservan los valores que se está actualizando. 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 se actualiza la política valor. Cuando agregas esta política a un proxy de API, el tiempo de vencimiento predeterminado ahora es de 300 segundos. (El el valor predeterminado anterior era -1, lo que significa que los valores nunca se actualizan). (EDGEUI-579)

Monetización

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

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

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

Para los planes de tarifa de notificación ajustable, puedes crear webhooks que envíen notificaciones a la la URL que especifiques. También puedes controlar las notificaciones para que se produzcan en intervalos específicos (porcentajes). hasta alcanzar el límite de transacciones. Las notificaciones de webhook te ofrecen una alternativa al uso de las plantillas de notificación existentes. Consulta Configurar notificaciones con webhooks. (DEVRT-2393 y DEVRT-2394)

Notificación ajustable con plan de tarifas de atributos personalizados (IU de Cloud 16/05/18)

En la monetización de Edge, existe una nueva “Notificación ajustable con atributo personalizado” el plan de tarifas te permite agregar al recuento de transacciones de un desarrollador con el valor de un atributo personalizado Con la API de Con el plan de tarifa de notificaciones ajustable, cada llamada exitosa a la API agrega 1 a la transacción de un desarrollador recuento. Sin embargo, con la notificación ajustable con plan de tarifas de atributos personalizados, el valor del el atributo personalizado se agrega al recuento de transacciones del desarrollador. Por ejemplo, si el atributo personalizado “pequeño” tiene un valor de 0.1 en la respuesta, el recuento de transacciones se incrementa en 0.1; o si atributo personalizado "addressTotal" tiene un valor de 50, el recuento se incrementa en 50. Para ver más consulta Especifica el plan de tarifas con detalles de atributos personalizados (DEVRT-2504)

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

Normalmente, los totales de las transacciones se rastrean automáticamente para todos los desarrolladores en una empresa cuando los desarrolladores usan la app de la empresa para acceder a las APIs. ¿Qué sucede si hay desarrolladores que activamente usan sus propias apps de desarrollador para acceder a APIs, y necesitas hacer un seguimiento de sus transacciones combinadas totales sin interrupciones en el tráfico? Puedes agregar desarrolladores a una empresa y configurar notificaciones que se enviarán cuando se alcancen umbrales basados en transacciones combinadas totales para la empresa y sus desarrolladores. Para obtener más información, consulta Establece notificaciones en función de totales combinados de transacciones para una empresa y sus desarrolladores. (DEVRT-2643)

Ver y volver a procesar notificaciones (monetización de Cloud 16.06.08)

Como parte del paquete de pruebas de monetización, puedes ver y volver a procesar notificaciones anteriormente. enviados con la API de administración. Para obtener más información, consulta Visualizar y volver a procesar las notificaciones. (DEVRT-2643)

Prueba de monetización (monetización de Cloud 16.05.25)

La monetización ofrece un conjunto de APIs que puedes usar para probar la ejecución de webhooks para asegurarte de que se envíen las notificaciones. Para obtener más información, consulta Cómo probar la configuración de notificaciones. (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 las transacciones y cobrar una configuración personalizada y tarifas recurrentes. 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 a los desarrolladores monetización. (DEVRT-2446)

Planes de tarifas públicas y privadas para el portal para desarrolladores (monetización de Cloud 16/04/27)

Puedes establecer los planes de tarifas como “Públicos” o "Privado". Los planes de tarifas públicos aparecen en el desarrollador portal; Los planes de tarifas privadas no lo hacen. 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)

Anular la suspensión de los desarrolladores (monetización de Cloud 16.06.08)

La monetización ofrece un conjunto de APIs que puedes usar para anular la suspensión de un desarrollador que suspendidos previamente. Se podría suspender a un desarrollador si se alcanza un límite configurado. Para Por ejemplo, la cantidad de transacciones alcanzó su límite máximo o un saldo de cuenta prepagado se haya agotado. Para obtener más información, consulta Cómo anular la suspensión de los desarrolladores. (DEVRT-2641)

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

Como parte del paquete de pruebas de monetización, puedes ver el estado de las transacciones que tienen ocurrieron durante un intervalo de tiempo específico con la API de Management. Para obtener más información, consulta Cómo ver el estado de transacciones. (DEVRT-2640)

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

Solo en los informes de ingresos, puedes incluir atributos personalizados en el informe, si los se define para el desarrollador. Para obtener más información, consulta Incluye contenido personalizado en los informes de ingresos con la API. (DEVRT-2447)

Coherencia de los recursos del producto de la API y la política de registro de transacciones (IU de Cloud 16.05.18)

Si las rutas de acceso a los recursos en una Política de Registro de Transacciones de monetización no coinciden con los recursos definidas en su producto de API (por ejemplo, si cambias las rutas de acceso de los recursos del producto de la API), el El ícono de la Política de registro de transacciones en la página Productos muestra un símbolo de advertencia. Al hacer clic en el ícono para ver la Política de Registro de Transacciones, aparecerá una advertencia en la parte superior de la página. Cuando corregir las rutas de acceso a los recursos en la política de registro de transacciones, desaparecen 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 lanzamiento.

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: