Enregistrer automatiquement des proxys Apigee

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

Vous pouvez enregistrer directement dans le hub d'API, en un seul clic, les proxys déployés qui sont présents dans vos projets d'environnement d'exécution Apigee et Apigee hybrid.

Figure 1. Enregistrement automatique des API à partir d'Apigee et d'Apigee hybrid

Les proxys seront enregistrés en tant que ressources d'API dans le hub d'API. Pour enregistrer les proxys, vous devez associer votre projet d'exécution au hub d'API. Lorsque vous associez un projet, le hub d'API enregistre les informations suivantes pour chaque définition de proxy :

• Nom
• Révision
• Détails de l'environnement et du déploiement
• Type d'instance Apigee (Apigee X ou Apigee hybrid)

Le hub d'API exécute régulièrement (une fois toutes les six heures) un programmeur, qui se connecte à votre projet Apigee et obtient les dernières définitions de proxy. Pour les projets nouvellement associés, le programmeur obtient toutes les définitions de proxy, puis les enregistre dans le hub d'API. Pour les projets existants, le programmeur ne reçoit que les modifications apportées aux définitions de proxy, puis met à jour les informations du proxy dans le hub d'API.

Remarque : Pour un projet nouvellement associé, pour que le hub d'API enregistre toutes les définitions de proxy, vous devez attendre la prochaine exécution du programmeur.

Associer un projet d'exécution

Pour associer un projet d'exécution Apigee au hub d'API, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page API Hub > Paramètres > Associations de projets.

2. Cliquez sur Associer un projet d'exécution. Le volet Sélectionner une ressource s'affiche.
3. Cliquez sur le projet Google Cloud dans lequel Apigee est installé. S'il n'y a pas d'erreur, le projet est associé au hub d'API et figure sur la page Associations de projets. Toutefois, le processus réel d'enregistrement des proxys démarrera après la prochaine exécution du programmeur.

Remarque : Si vous avez provisionné le hub d'API dans un projet comportant des proxys Apigee, ces proxys sont automatiquement enregistrés dans le hub d'API dans les heures suivant le provisionnement de ce dernier. Par exemple, si vous provisionnez le hub d'API dans la région test-project-1 et que ce projet dispose de proxys Apigee, le projet test-project-1 est automatiquement associé en tant que projet d'exécution et les proxys dans test-project-1 sont enregistrés dans le hub d'API.

Dissocier un projet d'exécution

Si vous dissociez un projet d'exécution, le hub d'API supprime toutes les API enregistrées pour ce projet. Procédez comme suit pour dissocier un projet d'exécution Apigee du hub d'API :

1. Dans la console Google Cloud, accédez à la page Hub d'API > Paramètres > Associations de projets.

2. Cliquez sur le bouton Dissocier le projet que vous souhaitez dissocier.

Remarque : Même si toutes les API du projet dissocié sont supprimées du hub d'API, les attributs créés pour ces API ne sont pas supprimés, et apparaîtront toujours dans le hub d'API.

Remarques

Tenez compte des points suivants lorsque vous essayez d'enregistrer automatiquement des API :

• Tous les points de terminaison importés depuis Apigee reçoivent un préfixe https:// par défaut.
• Les proxys qui ne sont déployés dans aucun environnement ne sont pas extraits depuis le projet.
• L'extraction ne concerne que les proxys déployés dans un environnement. L'environnement doit également faire partie d'un groupe d'environnements.
• Le hub d'API n'est pas compatible avec VPC Service Controls. Par conséquent, si vous avez activé VPC Service Controls pour votre projet d'exécution Apigee, le hub d'API ne peut pas accéder au projet.
• Si l'API Apigee n'est pas activée pour un projet d'exécution, le hub d'API ne peut pas accéder au projet.