4.16.09 - Notes de version d'Edge for Private Cloud

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X. En savoir plus

Le lundi 19 septembre 2016, nous avons lancé une nouvelle version d'Apigee Edge pour Private Cloud.

Depuis la version précédente de Edge for Private Cloud, les versions suivantes ont s'est produite et sont incluses dans cette version de fonctionnalité:

• Cloud: 16.04.13 (UI), 16.04.13 (monétisation), 16.04.20 (UI), 16.04.27 (monétisation), 16.04.27 (UI), 16.05.04 (UI), 16.05.11 (UI), 16.05.11 (monétisation), 16.05.18 (UI), 16.05.25 (monétisation), 16.06.08 (monétisation), 16.06.15 (UI), 16.06.22 (monétisation), 16.06.29 (UI), 16.07.06 (monétisation), 16.07.06.02 (monétisation), 16.07.13 (UI), 16.07.20.01 (monétisation), 16.07.27 (UI), 16.08.17

Reportez-vous à la section À propos de la version la numérotation pour comprendre comment déterminer si une version spécifique du cloud inclus dans votre version d'Edge pour Private Cloud.

Présentation de la version

Dans cette version, l'éditeur de proxy d'API classique a été supprimé et remplacé par le nouveau proxy disponible en complément de l'éditeur classique. Autres améliorations notables incluent un comportement amélioré des chemins de ressources des produits d'API, ainsi qu'une meilleure gestion des charges utiles JSON. définies dans les règles d'attribution de messages et de génération de problèmes, les améliorations apportées aux conversions XML vers JSON, une meilleure validation des ressources, la possibilité de définir des délais avant expiration sur des mandataires d'API individuels, génération de proxys SOAP dans l'assistant de proxy d'API et un objet Crypto hautes performances pour JavaScript.

Les améliorations de la monétisation incluent de nouvelles fonctionnalités de notification avec un plan de fréquence de notification, un API qui migre les développeurs vers la monétisation et la possibilité de rendre les plans tarifaires publics ou privé.

La suite de cette rubrique contient des informations détaillées sur toutes les nouvelles fonctionnalités, mises à jour et corrections de bugs. dans l'album.

Obsolète

Services d'API

Éditeur de proxy classique supprimé (UI Cloud 16.04.20)

La nouvelle version de l'éditeur de proxy d'API est désormais la seule version compatible. Version classique n'est plus disponible, et le lien « Accéder à la version classique de l'éditeur de proxy » a été supprimés. Si vous utilisiez la version classique, vos proxys d'API seront automatiquement chargés dans le nouvel éditeur. (EDGEUI-498)

Monétisation

Les fonctionnalités obsolètes suivantes ont été supprimées et ne sont plus prises en charge:

• Définir des limites
• Envoyer des notifications de limite

Vous pouvez également configurer des notifications, comme décrit dans les sections suivantes:

• Configurer un événement notifications
• Créez un notification de limite pour un plan tarifaire

(DEVRT-2742).

Nouvelles fonctionnalités et mises à jour

Vous trouverez ci-dessous les nouvelles fonctionnalités et améliorations de cette version. En plus des éléments suivants, Cette version inclut également de multiples fonctionnalités en termes de facilité d'utilisation, de performances, de sécurité et de stabilité améliorations.

Pour plus d'informations et d'instructions, consultez la documentation Edge pour Private Cloud.

Cloud privé

Mise à niveau vers la version 9.4

Cette version inclut une mise à niveau vers Postgres 9.4. Pour obtenir des instructions sur la mise à jour de votre système, voir Mettre à jour Apigee Edge pour 4.16.09.

Prise en charge de GeoMap dans l'interface utilisateur Edge

Les agrégations géographiques vous permettent de collecter des données d'analyse pour les appels d'API en fonction de attributs tels que la région, le continent, le pays et la ville. Ces données d'analyse vous permettent GeoMap dans l'interface utilisateur Edge qui affiche l'emplacement des requêtes API.

Pour en savoir plus, consultez la page Activer l'agrégation géographique et Geo Maps

API BaaS

Ajout de la documentation sur:

• Configurer une API BaaS pour utiliser TLS Pour en savoir plus, consultez la page Configurer TLS pour l'API BaaS.
• Comment configurer tous les nœuds d'une pile BaaS d'API afin qu'ils utilisent le stockage partagé afin que tous les éléments soient pour tous les nœuds de la pile BaaS d'API. Pour en savoir plus, consultez Importer des éléments.
• Comment chiffrer le mot de passe Cassandra lors de la configuration des nœuds de la pile BaaS Pour plus d'informations, consultez la section Réinitialisation du périphérique Mots de passe.

Version bêta de l'outil de surveillance et du tableau de bord

Cette version comprend une version bêta du nouvel outil de surveillance et du nouveau tableau de bord pour Edge. Cet outil vous permet de comprendre l'état de divers composants (routeurs, processeurs de messages, ZooKeeper et Cassandra), ainsi que des codes d'erreur HTTP pour les divers environnements et organisations de votre le déploiement. Vous pouvez également prendre un instantané des données de votre tableau de bord et le partager avec Apigee pour pour résoudre les incidents d'assistance.

La documentation, y compris les instructions d'installation, est incluse dans le document Edge 4.16.09 à la version 4.18.01.

Toutefois, avant de pouvoir installer et utiliser le tableau de bord, vous devez terminer l'évaluation Apigee Contrat, également disponible à l'adresse Version 4.18.01, que vous renvoyez à Apigee d'ici le en l'envoyant par e-mail à orders@apigee.com.

Version bêta du collecteur Analytics

Tous les clients Edge for Private Cloud doivent envoyer à Apigee des statistiques sur les API le trafic proxy. Apigee recommande aux clients d'importer ces informations une fois par jour, créer une tâche Cron.

Pour vous aider à importer ces données, Apigee fournit la version bêta de la ligne de commande apigee-analytics-collector. utilitaire. Cet utilitaire renvoie le rapport sur le volume des appels d'API à Apigee. Chaque périphérie pour L'installation d'un cloud privé peut se servir de cet utilitaire pour récupérer et transmettre les données de trafic Apigee.

Pour en savoir plus, consultez la page Importer l'API Trafic de données vers Apigee (version bêta).

Services d'API

Charges utiles JSON dans "Attribuer un message" et "Générer Fault" (Cloud 16.08.17)

Avec cette amélioration, aucune solution de secours n'est nécessaire pour garantir un formatage correct des messages JSON. peuvent être spécifiées à l'aide d'accolades sans créer de fichier JSON non valide. Par exemple, La commande suivante insère la valeur de message.content dans le message JSON:

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

Si vous avez utilisé une solution de contournement, votre code continuera de fonctionner en l'état. Vous pouvez également utiliser variablePrefix et variableSuffix au lieu d'accolades pour indiquer des variables.

Voir le <Set><Payload> dans la règle Attribuer un message et Règle Lever la défaillance des documents de référence. (APIRT-1160)

Améliorations apportées aux règles XML vers JSON (Cloud 16.08.17)

La règle XML vers JSON a été améliorée avec les fonctionnalités suivantes. Vous pouvez configurer la règle pour:

• Traiter certains éléments XML comme des tableaux lors de la conversion (les valeurs seront alors carrées) crochets '[ ]' dans le document JSON.
• Supprimez ou supprimez des niveaux de la hiérarchie des documents XML dans le document JSON final.

Pour en savoir plus, consultez la page XML à la stratégie JSON. (APIRT-1144)

Caractères génériques multiples dans les chemins de ressource du produit d'API (Cloud 16.08.17)

Lorsque vous définissez des chemins d'accès aux ressources dans le produit API, vous pouvez inclure des caractères génériques à plusieurs endroits dans un chemin d'accès à la ressource. Par exemple, /team/*/invoices/** autorise les appels d'API avec n'importe quelle Une valeur après /team et tous les chemins d'accès aux ressources après le invoices/. Un URI autorisé dans un appel d'API être proxyBasePath/team/finance/invoices/company/a.

Si, après cette version, les chemins d'accès aux ressources de votre produit d'API existants cessent de fonctionner comme prévu, définissez la propriété suivante de votre organisation pour revenir à la version précédente comportement: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

Fonctions de chiffrement en JavaScript (Cloud 16.08.17)

Un nouvel ensemble de fonctions JavaScript crypto hautes performances est disponible pour créer, obtenir et mettre à jour les objets suivants: MD5, SHA-1, SHA256, SHA512. L'objet crypto vous permet également d'obtenir dans divers formats. Pour en savoir plus, consultez la page Modèle d'objet JavaScript. (APIRT-2886)

Vérification de la version JAR des accroches Java (Cloud 16.08.17)

Lors de l'importation d'une ressource JAR Java vers un proxy d'API, un code d'état HTTP 400 est renvoyé. (au lieu d'un 500) si la version de la ressource Java est incompatible avec la version de Java, répertoriée dans la section Logiciels et versions compatibles. (MGMT-3420)

Validation des ressources de proxy d'API (Cloud 16.08.17)

Lorsque des fichiers de ressources de proxy d'API (tels que des fichiers JAR JavaScript ou Java) sont stockés dans la d'environnement ou d'organisation, le framework de validation ne vous oblige plus inclure ces ressources au niveau du proxy de l'API dans un bundle de proxy pour que l'importation réussisse la validation. La validation des ressources s'effectue désormais au moment du déploiement, et non au moment de l'importation. (MGMT-1430)

Configurer le délai avant expiration pour les proxys d'API individuels (Cloud 16.08.17)

Vous pouvez configurer les proxys d'API pour qu'ils expirent après un délai spécifié (avec un délai avant expiration de la passerelle 504) état actuel). Le cas d'utilisation principal concerne les clients de cloud privé qui disposent de proxys d'API plus de temps à exécuter. Par exemple, supposons que vous ayez besoin de proxys spécifiques pour qu'ils expirent au bout de trois minutes. Vous pouvez utilisez une nouvelle propriété api.timeout dans la configuration d'un proxy d'API. Voici comment procéder : dans l'exemple de 3 minutes:

1. Assurez-vous d'abord de configurer l'équilibreur de charge, le routeur et le processeur de messages pour qu'ils expirent au bout de 3 minutes.
2. Configurez ensuite les proxys appropriés pour qu'ils expirent au bout de trois minutes. Spécifiez la valeur dans millisecondes. Exemple :

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

3. Notez toutefois que l'augmentation des délais d'expiration du système peut entraîner des problèmes de performances, car Tous les proxys sans paramètre api.timeout utilisent le nouvel équilibreur de charge plus élevé, les délais avant expiration du routeur et du processeur de messages. Configurez donc d'autres proxys d'API qui n'ont pas besoin des délais plus longs pour utiliser des délais plus bas. Par exemple, ce qui suit définit un proxy d'API pour qu'il expire après 1 minute:
   <Property name="api.timeout">60000</Property>

Les clients Cloud, qui ne peuvent pas modifier les délais avant expiration Edge, peuvent également configurer un délai avant expiration de proxy API, tant que le délai avant expiration est inférieur au délai d'expiration standard du processeur de messages Edge de 57 secondes.

Vous ne pouvez pas renseigner la valeur avec une variable. Cette propriété est traitée dans les propriétés du point de terminaison référence. (APIRT-1778).

Comportement du proxy SOAP lors de l'utilisation de l'assistant de proxy (interface utilisateur Cloud 16.07.27)

Lors de la création d'un proxy SOAP à partir d'un WSDL à l'aide de l'assistant de proxy, il existe deux options pour Création du proxy:

• Transmission via le protocole SOAP, où le proxy transmet simplement une demande SOAP en l'état.
• De REST à SOS en REST, où le proxy convertit une charge utile entrante telle que en une charge utile SOAP, puis reconvertit la réponse SOAP au format utilisé par l'appelant s'attend.

Cette version inclut les mises à jour suivantes concernant le comportement de ces options. Les différences entre l'ancien et le nouveau comportement se trouvent dans les règles et configurations qui sont automatiquement généré par l'assistant du proxy.

Transmission via le protocole SOAP

• Toutes les opérations WSDL sont maintenant envoyées au chemin de base du proxy "/" plutôt que vers des ressources proxy (par exemple, "/cityforecastbyzip"). Les noms d'opération sont transmis à l'API Google Cloud. Ce comportement correspond à la spécification SOAP.

• Le proxy généré n'accepte plus le format JSON dans la requête. Elle n'accepte que le format XML. Le proxy garantit que les demandes SOAP comportent une enveloppe, un corps et un espace de noms.

De REST à SoPQ, puis à REST

• WSDL 2.0 n'est pas pris en charge.
• Le nouveau comportement n'a pas été testé avec WS-Policy.
• Le proxy vous permet d'envoyer des données JSON via POST au lieu de FormParams.
• Lorsque vous ajoutez la compatibilité CORS (Cross-Origin Resource Sharing) au proxy à l'aide du proxy vous bénéficiez des améliorations suivantes: <ph type="x-smartling-placeholder">
  </ph>
  • En-tête Access-Control-Allow-Headers: en plus de les en-têtes Origin, x-requested-with et Accept, L'en-tête Access-Control-Allow-Headers inclut également Content-Type, Accept-Encoding, Accept-Language, Host, Pragma, Referrer, User-Agent et Cache-Control
  • En-tête Access-Control-Allow-Methods: en plus de GET, PUT, POST, DELETE, cet en-tête inclut également Verbes PATCH et OPTIONS.
• Lors de la génération d'un proxy d'API pour un WSDL, Edge lit tous les ComplexTypes définis comme dans le fichier WSDL et reconnaît correctement tous les types d'instances basés sur le schéma de données.

Utilitaire de ligne de commande Open Source wsdl2apigee

Apigee fournit également un utilitaire de ligne de commande Open Source pour générer proxys d'API REST-to-Savon à partir de WSDL. Consultez https://github.com/apigee/wsdl2apigee.

(EDGEUI-614)

Expiration/Actualisation par défaut dans la règle Opérations sur les cartes de valeurs clés (UI Cloud 16.06.15)

La règle Opérations de mappage de valeurs clés vous permet de déterminer la durée de persistance des valeurs en cours d'actualisation. L'intervalle d'actualisation est défini avec l'élément <ExpiryTimeInSecs>. Si une opération GET est exécutée et l'intervalle d'expiration a été dépassé, la valeur est actualisée et la règle est mise à jour . Lorsque vous ajoutez cette règle à un proxy d'API, le délai d'expiration par défaut est maintenant de 300 secondes. (Le la valeur par défaut précédente était -1, ce qui signifie que les valeurs ne sont jamais actualisées). (EDGEUI-579)

Monétisation

Plan de fréquence de notification ajustable (UI Cloud 16.04.20, monétisation Cloud 16.04.13)

Un nouveau plan de fréquence de notification ajustable dans la monétisation Edge permet à un fournisseur d'API d'ajuster le Nombre cible de transactions pour chaque développeur d'applications Vous pouvez configurer si et quand recevoir des notifications sont envoyés en fonction du pourcentage du nombre cible qui a été atteint (par exemple, 90%, 100 % ou 150%. Cette fonctionnalité est disponible via l'interface utilisateur de gestion, en plus de l'API de gestion. (qui était disponible dans une version précédente). Pour plus d'informations, consultez la section Spécifier les détails du plan de notification ajustable. (DEVRT-2375, DEVRT-2370)

Notifications webhook pour les forfaits avec taux de notification ajustables (Cloud 16.04.27 monétisation)

Pour les plans de fréquence de notifications ajustables, vous pouvez créer des webhooks qui envoient des notifications au URL que vous spécifiez. Vous pouvez également contrôler l'envoi des notifications à des intervalles spécifiques (pourcentages). jusqu'à ce que la limite de transaction soit atteinte. Les notifications Webhook vous offrent un moyen alternative aux modèles de notification existants. Consultez la section Configurer les notifications avec webhooks. (DEVRT-2393, DEVRT-2394).

Notification ajustable avec un plan tarifaire d'attribut personnalisé (UI Cloud 16.05.18)

Dans la monétisation Edge, une nouvelle "Notification ajustable avec un attribut personnalisé" vous permet à ajouter au nombre de transactions d'un développeur à l'aide de la valeur d'un attribut personnalisé. La norme Plan de taux de notification ajustable : chaque appel d'API réussi ajoute 1 à la transaction d'un développeur nombre. Mais avec le plan tarifaire "Adjustable Notification with Custom Attribute" (Modèle de notification à attribut personnalisé), est ajouté au nombre de transactions du développeur. Par exemple, si l'attribut personnalisé "petite taille" a une valeur de 0,1 dans la réponse, le nombre de transactions est incrémenté de 0,1 ; ou si attribut personnalisé "addressTotal" a la valeur 50, le nombre est incrémenté de 50. Pour plus consultez la section Spécifier un plan tarifaire avec les détails d'attributs personnalisés. (DEVRT-2504).

Configurer des notifications en fonction des totaux de transactions combinés pour une entreprise et ses développeurs (Monétisation Cloud 16.06.22)

En règle générale, le total des transactions est suivi automatiquement pour tous les développeurs d'une entreprise les développeurs utilisent l'application de l'entreprise pour accéder aux API. Et si certains de vos développeurs sont actifs utilisent leurs propres applications de développement pour accéder aux API, et vous devez suivre leurs transactions combinées. sans interruption du trafic ? Vous pouvez ajouter les développeurs à une entreprise et configurer notifications à envoyer lorsque des seuils basés sur le nombre de transactions combinées sont atteints pour l'entreprise et ses développeurs. Pour en savoir plus, consultez la section Définir des notifications en fonction du total des transactions d'une entreprise et de ses développeurs. (DEVRT-2643).

Afficher et traiter à nouveau les notifications (monétisation Cloud 16.06.08)

Avec la suite de tests de monétisation, vous pouvez consulter et traiter à nouveau les notifications envoyé à l'aide de l'API de gestion. Pour en savoir plus, consultez la section Affichage et notifications de retraitement. (DEVRT-2643).

Tester la monétisation (monétisation Cloud 16.05.25)

La monétisation fournit un ensemble d'API que vous pouvez utiliser pour tester l'exécution de webhooks pour s'assurer que les notifications sont envoyées. Pour en savoir plus, consultez Tester la configuration des notifications. (DEVRT-2625).

Migrer les développeurs vers la monétisation (monétisation Cloud 16.05.11)

Une nouvelle API est disponible pour faciliter la migration des développeurs vers la monétisation. Vous pouvez transférer l'utilisation des transactions et facturer une configuration personnalisée et des frais récurrents. De plus, lorsque accepter un plan tarifaire publié, vous pouvez renoncer aux frais de configuration s'ils ont déjà été facturés. Pour en savoir plus, consultez Migrer les développeurs vers monétisation. (DEVRT-2446).

Plans tarifaires publics et privés pour le portail des développeurs (monétisation Cloud 16.04.27)

Vous pouvez définir les plans tarifaires comme "Publics" ou "Privé". Les forfaits publics s'affichent dans le développeur portal; Ce n'est pas le cas des forfaits privés. Par défaut, un plan tarifaire est défini sur "Public". Pour plus d'informations, voir http://docs.apigee.com/monetization/content/create-rate-plans#public-versus-private-rate-plans. (DEVRT-2445).

Annuler la suspension des développeurs (monétisation Cloud 16.06.08)

La monétisation fournit un ensemble d'API que vous pouvez utiliser pour réactiver un compte de développeur précédemment suspendues. Un développeur peut être suspendu si une limite configurée est atteinte. Pour Exemple : le nombre de transactions a atteint la limite maximale ou un solde prépayé de compte est épuisé. Pour en savoir plus, consultez la section Réactiver les comptes de développeurs. (DEVRT-2641).

Afficher l'état des transactions (monétisation Cloud 16.06.08)

La suite de tests de monétisation vous permet de consulter l'état des transactions ayant généré se sont produites au cours d'une période spécifiée à l'aide de l'API de gestion. Pour plus d'informations, consultez la section Affichage de l'état les transactions. (DEVRT-2640).

Inclure des attributs personnalisés pour les développeurs dans les rapports sur les revenus (monétisation Cloud 16.05.25)

Pour les rapports sur les revenus uniquement, vous pouvez inclure des attributs personnalisés dans le rapport, si les attributs est défini pour le développeur. Pour en savoir plus, consultez l'article Inclure les mots clés personnalisés dans les rapports sur les revenus à l'aide de l'API. (DEVRT-2447).

Règle d'enregistrement des transactions et cohérence des ressources du produit d'API (UI Cloud 16.05.18)

Si les chemins d'accès aux ressources dans une règle d'enregistrement des transactions de monétisation ne correspondent pas aux ressources les chemins d'accès définis dans son produit API (par exemple, si vous modifiez les chemins d'accès aux ressources du produit API), le L'icône des règles d'enregistrement des transactions sur la page "Produits" affiche un symbole d'avertissement. Lorsque vous cliquez sur le bouton pour afficher la règle d'enregistrement des transactions, un avertissement s'affiche en haut de la page. Lorsque vous corriger les chemins d'accès aux ressources dans la règle d'enregistrement des transactions, les indicateurs d'avertissement disparaissent. (DEVRT-2240).

Bugs résolus

Les bugs suivants sont résolus dans cette version. Cette liste s'adresse principalement aux utilisateurs qui veulent vérifier si leurs demandes d'assistance ont été corrigées. Elle n'est pas conçue pour fournir des informations détaillées à tous les utilisateurs.

Edge pour Private Cloud

16.08.17

UI

Monétisation

Cette version inclut des modifications mineures du schéma de base de données. Il n'y a pas d'autres mises à jour logicielles dans cette de sortie.

UI

Monétisation

Monétisation

UI

Monétisation

Aucun

UI

Monétisation

Aucun

Monétisation

UI

Monétisation

UI

UI

UI

Monétisation

Aucun

UI

Monétisation

Aucun

UI

Problèmes connus

Cette version présente les problèmes connus suivants: