Déployer des API Cloud Endpoints sur API Gateway

Cloud Endpoints est un système de gestion d'API qui vous aide à sécuriser, surveiller, analyser et définir des quotas sur vos API. Endpoints utilise Extensible Service Proxy (ESP) ou Extensible Service Proxy V2 bêta (ESPv2 bêta) pour héberger vos API.

Lorsque vous utilisez Endpoints, vous disposez de trois options pour définir votre API :

Développer des API avec API Gateway

API Gateway est compatible avec les API décrites à l'aide de la spécification OpenAPI, version 2.0. Vous pouvez donc déployer vos spécifications OpenAPI à partir d'Endpoints sur API Gateway.

Déployer des spécifications OpenAPI Endpoints sur API Gateway

API Gateway est compatible avec le même format et les mêmes options de définition de spécification OpenAPI que Cloud Endpoints pour OpenAPI. Cela signifie que vous pouvez utiliser les mêmes définitions de sécurité, de quota et d'autres éléments de vos spécifications OpenAPI Endpoints pour définir une API dans API Gateway.

La seule différence entre Endpoints et API Gateway réside dans la façon dont ils traitent la propriété host dans la définition de spécification OpenAPI :

  • Dans Endpoints, définissez la propriété host sur la partie nom d'hôte de l'URL créée lorsque vous avez déployé ESP, qui est le service utilisé pour héberger votre API Endpoints.
  • Dans API Gateway, omettez host ou définissez-le sur le nom DNS de l'API déployée. Les fournisseurs d'API le définissent souvent sur le nom DNS lorsqu'ils partagent la spécification OpenAPI avec leurs consommateurs d'API. Toutefois, API Gateway n'applique pas la valeur de la propriété host.

Par exemple, voici une partie d'une spécification OpenAPI utilisée par Endpoints pour définir une API afin d'accéder à un service de backend déployé sur des fonctions Cloud Run:

swagger: '2.0'
info:
  title: Cloud Endpoints + GCF
  description: Sample API on Cloud Endpoints with a Google Cloud Functions backend
  version: 1.0.0
host: ESP_HOST
schemes:
  - https
produces:
  - application/json
paths:
  /hello:
  ...

Pour Cloud Endpoints :

  1. Déployez ESP, qui crée l'URL que vous utiliserez ensuite pour accéder aux API déployées sur ESP. Exemple :

    https://gateway-12345-uc.a.run.app

  2. Modifiez la spécification OpenAPI pour définir la propriété host sur le nom de domaine de l'URL de l'ESP. Exemple :

    host: gateway-12345-uc.a.run.app

  3. Déployez la spécification OpenAPI sur ESP.

  4. Accédez à votre API à l'aide de l'URL de l'ESP. Dans la spécification OpenAPI précédente, l'élément paths est défini sur /hello. Vous pouvez donc accéder à cette API à l'aide de l'URL suivante:

    https://gateway-12345-uc.a.run.app/hello

Comme vous pouvez le constater, pour Endpoints, vous devez d'abord déployer ESP pour pouvoir définir la valeur de la propriété host.

Pour utiliser cette définition d'API afin de créer une configuration d'API pour API Gateway, vous pouvez supprimer complètement la propriété host ou la laisser dans le fichier. API Gateway n'applique pas la valeur de la propriété host.

L'URL de la passerelle déployée, et donc de l'URL que vos clients utilisent pour accéder à votre API, est définie lorsque vous créez la passerelle, au format suivant :

https://GATEWAY_ID-HASH.REGION_CODE.gateway.dev

où GATEWAY_ID est le nom de la passerelle, HASH est le code de hachage unique généré lors du déploiement de l'API et REGION_CODE est le code de la régionGoogle Cloud où vous avez déployé la passerelle.

Une fois que vous avez déployé une API sur une instance de passerelle, l'URL que vous utilisez pour accéder à /hello est la suivante :

https://my-gateway-a12bcd345e67f89g0h.uc.gateway.dev/hello

Pour en savoir plus sur le déploiement d'API, consultez la section Modèle de déploiement de la passerelle API.

Pour en savoir plus sur la création de la spécification OpenAPI pour votre définition d'API, consultez la page Présentation d'OpenAPI.

Étape suivante