Étape 3 : Appeler un proxy d'API

Cette page s'applique à Apigee et à Apigee hybrid.

Consultez la documentation d' Apigee Edge.

Au cours de cette étape, vous allez tester le proxy d'API que vous venez de créer et de déployer.

Apigee dans la console Cloud

  1. Dans la console Google Cloud , accédez à la page Apigee> Gestion> Environnements.

    Accéder à la page Environnements

  2. Assurez-vous que le même projet Google Cloud dans lequel vous avez créé le proxy d'API est sélectionné dans le menu déroulant en haut de la page.
  3. Sélectionnez l'onglet Groupes d'environnements.
  4. Dans le tableau, recherchez la ligne correspondant au groupe d'environnements contenant l'environnement dans lequel myproxy est déployé. Le nom d'hôte s'affiche dans la colonne Noms d'hôte de cette ligne. Par exemple : mydomain.com.
  5. Appelez le proxy d'API. La façon dont vous appelez le proxy dépend de la configuration de votre instance Apigee pour l'accès au réseau externe ou interne. Si vous ne savez pas comment votre instance Apigee est configurée, contactez votre administrateur Apigee.
    • Accès externe : si votre instance Apigee est configurée pour l'accès externe, appelez le proxy comme suit : 
      curl https://YOUR_ENV_GROUP_HOSTNAME/myproxy

      Où YOUR_ENV_GROUP_HOSTNAME est le nom d'hôte que vous avez obtenu à l'étape précédente.

      Exemple :

      curl https://mydomain.com/myproxy

      Voici un autre exemple, où le service DNS wildcard nip.io est utilisé pour l'hôte :

      curl https://198.51.100.251.nip.io/myproxy
    • Accès interne : si votre instance Apigee est configurée pour l'accès au réseau interne, vous devez effectuer quelques étapes supplémentaires pour accéder à l'équilibreur de charge interne et à son adresse IP. Pour en savoir plus, consultez Appeler un proxy avec un accès interne uniquement.
  6. Un appel réussi au proxy renvoie le résultat suivant :

    Hello, Guest!

Interface utilisateur classique d'Apigee

  1. Ouvrez l'interface utilisateur Apigee dans un navigateur.
  2. Assurez-vous que le même projet Google Cloud dans lequel vous avez créé le proxy d'API est sélectionné dans le menu déroulant en haut de la page.
  3. Dans l'interface utilisateur de la console Cloud, sélectionnez Administrateur > Environnements > Groupes.
  4. Cliquez sur Afficher dans la console Google Cloud .
  5. Sélectionnez l'onglet Groupes d'environnements.
  6. Dans le tableau, recherchez la ligne correspondant au groupe d'environnements contenant l'environnement dans lequel myproxy est déployé. Le nom d'hôte s'affiche dans la colonne Noms d'hôte de cette ligne. Exemple : mydomain.com.
  7. Appelez le proxy d'API. La façon dont vous appelez le proxy dépend de la configuration de votre instance Apigee pour l'accès au réseau externe ou interne. Si vous ne savez pas comment votre instance Apigee est configurée, contactez votre administrateur Apigee.
    • Accès externe : si votre instance Apigee est configurée pour l'accès externe, appelez le proxy comme suit : 
      curl https://YOUR_ENV_GROUP_HOSTNAME/myproxy

      Où YOUR_ENV_GROUP_HOSTNAME est le nom d'hôte que vous avez obtenu à l'étape précédente.

      Exemple :

      curl https://mydomain.com/myproxy

      Voici un autre exemple, où le service DNS wildcard nip.io est utilisé pour l'hôte :

      curl https://198.51.100.251.nip.io/myproxy
    • Accès interne : si votre instance Apigee est configurée pour l'accès au réseau interne, vous devez effectuer quelques étapes supplémentaires pour accéder à l'équilibreur de charge interne et à son adresse IP. Pour en savoir plus, consultez Appeler un proxy avec un accès interne uniquement.
  8. Un appel réussi au proxy renvoie le résultat suivant :

    Hello, Guest!

Si une erreur s'affiche, vérifiez les points suivants :

  • Si vous rencontrez une erreur de délai avant expiration (inhabituel), essayez d'annuler le déploiement et de redéployer le nouveau proxy d'API.
  • Si l'hôte ne peut pas être résolu, par exemple si vous recevez une erreur 404, vérifiez que vous utilisez le nom d'hôte et le nom de proxy corrects.
  • Assurez-vous que le nom d'hôte du groupe d'environnements est configuré avec l'équilibreur de charge cloud. Consultez la section Déterminer si l'équilibreur de charge cloud est configuré pour un nom d'hôte.
  • Si vous rencontrez une erreur TLS/SSL, telle qu'une erreur de handshake SSL, contactez votre fournisseur DNS pour vous assurer que l'enregistrement DNS A du nom d'hôte est correctement configuré. Assurez-vous que l'enregistrement possède l'adresse IP de l'équilibreur de charge qui a été créé lors du provisionnement d'Apigee. Si vous ne savez pas quelle adresse IP vous devez utiliser, consultez la section Déterminer si l'équilibreur de charge cloud est configuré pour un nom d'hôte.
  • Si vous rencontrez une erreur de certificat TLS/SSL, il est possible que le certificat SSL associé à l'équilibreur de charge ne dispose pas du nom d'hôte approprié et qu'il soit donc refusé. Le certificat a été créé lors du processus de provisionnement. La procédure de dépannage de la section Déterminer si l'équilibreur de charge cloud est configuré pour un nom d'hôte vous montre comment localiser et inspecter le certificat.
  • Si vous ne parvenez pas à résoudre le problème, contactez la personne qui a provisionné Apigee pour obtenir de l'aide.

À l'étape suivante, vous allez modifier le point de terminaison cible du proxy d'API.

1 2 3 (ÉTAPE SUIVANTE) Étape 4 : Modifiez le point de terminaison cible 5