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.
Endpoints est compatible avec la version 2 de la spécification OpenAPI (précédemment connue sous le nom de spécification Swagger), le standard du secteur pour la définition des API REST. Si vous ne connaissez pas la spécification OpenAPI, reportez-vous à la section Présentation d'OpenAPI.
Cet ensemble de documentations explique comment utiliser Endpoints avec OpenAPI. Pour plus d'informations sur les autres options d'Endpoints, consultez l'ensemble des documents Endpoints.
Pour commencer, nous vous recommandons de consulter la documentation dans l'ordre suivant :
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.
Vous devez maintenant choisir quelle plate-forme de calcul vous souhaitez utiliser pour votre API. Pour vous aider dans cette décision, vous pouvez consulter la page Choisir une option de calcul et la section Plates-formes de calcul compatibles ci-dessous.
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 Artifact Registry.
- Consultez les notes de version ESP pour obtenir l'image Docker ESP actuelle.
- Consultez les notes de version ESPv2 pour obtenir l'image Docker ESPv2 actuelle.
- 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 :
- Environnement flexible App Engine
- Compute Engine
- Kubernetes, y compris Google Kubernetes Engine
- Un ordinateur Linux ou macOS ou une autre plate-forme
Vous pouvez exécuter le conteneur ESPv2 sur les éléments suivants :
- App Engine
- Fonctions Cloud Run
- Cloud Run
- Knative serving
- 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.