Cloud Endpoints pour OpenAPI

Cloud Endpoints est un système de gestion d'API qui vous aide à sécuriser, surveiller, analyser et définir des quotas sur les API en utilisant la même infrastructure que celle utilisée par Google pour ses propres API. Endpoints assure la gestion des API à l'aide d'Extensible Service Proxy (ESP) et d'Extensible Service Proxy V2 (ESPv2). Pour en savoir plus sur Endpoints, ESP et ESPv2, consultez la page À propos de Endpoints.

Cloud Endpoints est compatible avec la version 2 de la spécification OpenAPI (anciennement "spécification Swagger"), le standard dans l'industrie pour la définition des API REST. Si vous ne connaissez pas la spécification OpenAPI, consultez la section Présentation d'OpenAPI.

Cet ensemble de documentations explique comment utiliser Cloud Endpoints avec OpenAPI. Pour en savoir plus sur les autres options de Cloud Endpoints, consultez la documentation sur Cloud Endpoints.

Pour commencer, nous vous recommandons de consulter la documentation dans l'ordre suivant :

  1. Pour voir les fonctionnalités Cloud Endpoints en action, suivez le guide de démarrage rapide de Cloud Endpoints, qui utilise des scripts pour déployer un exemple d'API dans l'environnement flexible App Engine.

  2. Vous devez maintenant choisir la plate-forme de calcul que vous souhaitez utiliser pour votre API. Pour vous aider à prendre cette décision, consultez la page Choisir une option de calcul et la section Plates-formes de calcul compatibles ci-dessous.

  3. Une fois que vous avez choisi le backend de votre API, suivez le tutoriel de votre plate-forme de calcul préférée.

Plates-formes de calcul compatibles

Endpoints pour OpenAPI repose sur ESP ou ESPv2 pour la gestion des API. ESP et ESPv2 sont des projets Open Source qui vous sont proposés comme suit :

  • Un conteneur dans Google Container Registry.
  • Le code source dans GitHub.
    • Consultez le fichier ESP README pour obtenir plus de détails sur la création d'ESP.
    • Consultez le fichier ESPv2 README pour plus de détails sur la création d'ESPv2.

Vous pouvez exécuter le conteneur ESP sur les éléments suivants :

Vous pouvez exécuter le conteneur ESPv2 sur les éléments suivants :

  • App Engine
  • Cloud Functions
  • Cloud Run
  • Cloud Run for Anthos
  • GKE
  • Compute Engine
  • Kubernetes

Consultez la section À propos de Cloud Endpoints pour plus d'informations.

Dans l'environnement flexible App Engine, ESP est automatiquement déployé lorsque vous ajoutez quelques lignes au fichier app.yaml. Pour plus d'informations, consultez la section Déployer l'API et ESP. ESPv2 n'est pas compatible avec l'environnement flexible App Engine.

Pour l'environnement standard App Engine de génération 1, vous devez utiliser Endpoints Frameworks. Si vous déployez plutôt le conteneur selon l'une des options de calcul ci-dessus, vous pouvez utiliser un proxy pour l'une ou l'autre génération de l'environnement d'exécution standard App Engine.