Cette page a été traduite par l'API Cloud Translation.

Créer un proxy d'API

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

Consultez la documentation d'Apigee Edge.

Créez un proxy dans l'UI d'Apigee ou à l'aide de l'API, comme décrit dans les sections suivantes.

Champs principaux du proxy d'API

Suivez ces consignes lorsque vous créez un proxy d'API:

Champ	Description
Nom de proxy d'API	Nom affiché pour votre API. Indiquez des caractères alphanumériques, des tirets (-) ou des traits de soulignement (_). Remarque : Le nom du proxy d'API ne doit pas correspondre à celui d'un proxy d'API de l'organisation pouvant être déployé sur un environnement avec déploiement de proxy activé.
Chemin de base du proxy d'API	Fragment d'URI qui apparaît après l'adresse `http://[host]` ou `https://[host]` du proxy d'API. Apigee utilise l'URI de chemin de base pour faire correspondre et acheminer les messages de requête entrantes vers le proxy d'API approprié. Remarque : Le chemin de base doit être unique. Vous ne pouvez pas déployer deux proxys d'API avec le même chemin de base. Si vous modifiez un proxy d'API déployé et que vous définissez le chemin de base sur la même valeur que le chemin de base d'un autre proxy d'API, Apigee annule automatiquement le déploiement du proxy d'API lorsque vous l'enregistrez. Pour pouvoir redéployer le proxy d'API, vous devez modifier le chemin d'accès de base afin qu'il soit unique. Utiliser des caractères génériques dans les chemins de base Utilisez un ou plusieurs caractères génériques dans les chemins d'accès de base du proxy d'API pour assurer la pérennité de vos proxys d'API. Nous autorisons la spécification d'un seul caractère générique `` entre deux caractères barre oblique `/`: `//`. Par exemple, un chemin de base de `/team//members` permet aux clients d'appeler `https://[host]/team/blue/members` et `https://[host]/team/green/members` sans que vous ayez besoin de créer de proxys d'API pour gérer les nouvelles équipes. Vous pouvez remplacer un nombre illimité de jetons dans le chemin d'accès de base en suivant ce modèle. Les autres modèles, y compris `/`, `/something` ou `/*something`, ne sont pas acceptés.
Description	(Facultatif) Description du proxy d'API.
URL de destination/URL de backend	URL (y compris HTTP ou HTTPS) du service de backend que ce proxy d'API appelle.

Étapes à suivre pour créer un proxy d'API

Pour créer un proxy d'API à l'aide de l'UI ou des API:

Apigee dans la console Cloud

Pour créer un proxy simple dans Apigee dans la console Cloud, procédez comme suit :

Ouvrez l'interface utilisateur d'Apigee dans la console Cloud dans un navigateur.
Remarque : Si la page Bienvenue dans la gestion des API Apigee s'affiche, vous devez provisionner votre organisation Apigee avant de continuer.

Après avoir provisionné Apigee, fermez l'interface utilisateur et rouvrez l'interface utilisateur d'Apigee dans la console Cloud.
Dans le volet de navigation de gauche, cliquez sur Développement du proxy > Proxys d'API.
Dans le volet Proxys d'API, cliquez sur + Créer.
Dans le volet Créer un proxy, sous Modèle de proxy, sélectionnez Proxy inverse (le plus courant).
Sous Détails du proxy, saisissez les informations suivantes :
- Nom du proxy : saisissez un nom pour le proxy, tel que myproxy.
- Chemin de base : défini automatiquement sur la valeur que vous saisissez pour Proxy name. Le chemin de base fait partie de l'URL utilisée pour envoyer des requêtes à votre API. Apigee utilise l'URL pour mettre en correspondance et acheminer les requêtes entrantes vers le proxy d'API approprié.
- Description (facultatif) : saisissez une description de votre nouveau proxy d'API, par exemple "Test Apigee avec un proxy simple".
- Target (Existing API) Target (API existante) : saisissez https://mocktarget.apigee.net. Cela définit l'URL cible qu'Apigee appelle pour une requête adressée au proxy d'API. Le service "mocktarget" est hébergé sur Apigee et renvoie des données simples. Il ne nécessite aucune clé d'API ni jeton d'accès.
- Cliquez sur Suivant.
Déployer (facultatif) :
- Environnements de déploiement : facultatif. Cochez les cases pour sélectionner un ou plusieurs environnements dans lesquels déployer votre proxy. Si vous préférez ne pas déployer le proxy à ce stade, laissez le champ Environnements de déploiement vide. Vous pourrez toujours déployer le proxy ultérieurement.
- Compte de service : facultatif. Associez un compte de service à votre déploiement pour permettre à votre proxy d'accéder aux services Google Cloud, comme indiqué dans le rôle et les autorisations du compte de service.
Cliquez sur Créer.

Apigee crée le proxy et affiche un résumé des détails du proxy dans la vue Récapitulatif du proxy.

Volet récapitulatif myproxy.

Si vous avez choisi de déployer le proxy, la section Déploiements affiche le numéro de Révision, soit 1 lors du premier déploiement. La colonne État affiche les environnements dans lesquels le proxy est déployé avec un indicateur d'état vert.

Apigee classique

Pour créer un proxy d'API simple dans l'interface utilisateur classique d'Apigee :

Connectez-vous à l'UI Apigee.
Dans la vue principale, cliquez sur Proxys d'API.
Dans la liste déroulante Environnement, sélectionnez l'environnement dans lequel vous souhaitez créer un proxy d'API.
L'interface utilisateur hybride affiche la liste des proxys d'API pour cet environnement. Si vous n'avez pas encore créé de proxy, la liste est vide.
Cliquez sur Créer.
L'assistant de création de proxy démarre.
Cliquez sur Inverser le proxy (le plus courant).

La page Informations sur le proxy s'affiche.
Configurez votre proxy avec les paramètres suivants :
- Nom : saisissez getstarted. Si un proxy portant ce nom existe déjà, choisissez-en un autre.
- Base Path (Chemin de base) : laissez cette valeur définie sur /getstarted. Le chemin de base fait partie de l'URL utilisée pour envoyer des requêtes à votre API. Apigee utilise l'URL pour mettre en correspondance et acheminer les requêtes entrantes vers le proxy d'API approprié.
- Description (facultatif) : saisissez une description du nouveau proxy d'API, telle que Get started API proxy.
- Target (Existing API) Target (API existante) : saisissez https://mocktarget.apigee.net. Cela définit l'URL cible qu'Apigee appelle pour une requête adressée au proxy d'API. Le service "mocktarget" est hébergé sur Apigee et renvoie des données simples. Il ne nécessite aucune clé d'API ni jeton d'accès.
Les détails de votre proxy API doivent se présenter comme suit :
Cliquez sur Suivant.
Dans la vue Common policies (Règles courantes), sous Security: Authorization (Sécurité : Autorisation), sélectionnez Pass through (no authorization) (Stratégie directe (sans autorisation).
Cliquez sur Suivant.
Sur la page Summary (Résumé), sélectionnez les environnements de déploiement, si vous le souhaitez, puis cliquez sur Create and deploy (Créer et déployer).

Remarque : Si vous ne sélectionnez pas d'environnement sous Déploiement facultatif, le bouton situé en bas à droite est simplement intitulé Créer.

Remarque : Après avoir déployé une révision de proxy d'API, vous ne pouvez plus la modifier. Pour modifier le proxy d'API, vous devez créer et déployer une nouvelle révision.
Pour cette raison, vous pouvez choisir de créer le proxy d'API sans le déployer dans un environnement. Vous pouvez modifier le proxy d'API et le déployer ultérieurement, comme décrit dans la section Étapes suivantes.

Votre proxy d'API est créé et déployé dans l'environnement sélectionné.
Cliquez sur Edit proxy (Modifier le proxy) pour afficher l'onglet "Overview" (Présentation) dans l'éditeur de proxy.

Modifier la liste des proxys

Dans la liste des proxys d'API, l'état de déploiement du proxy getstarted est vert pour l'environnement test.

Affiche la liste des proxys d'API. L'état du déploiement getstarted est affiché en vert.

API Apigee

Créez un proxy d'API dans votre organisation Apigee en envoyant une requête POST à la ressource suivante :

https://apigee.googleapis.com/v1/organizations/$ORG/apis

Vous devez définir le nom du proxy d'API à l'aide du paramètre de requête name. Limitez les caractères utilisés dans le nom aux éléments suivants : A-Za-z0-9._\-$ %

Vous pouvez éventuellement importer un groupe de configuration de proxy d'API en procédant comme suit :

Définissez le paramètre de requête action sur import
Définissez l'en-tête Content-type sur multipart/form-data
Transmettez le nom du groupe de configuration de proxy d'API sur votre système de fichiers local

L'exemple suivant montre comment créer un proxy d'API en important un groupe de configuration de proxy d'API (helloworld-config.zip) sur votre système de fichiers local à l'aide de l'API.

curl "https://apigee.googleapis.com/v1/organizations/$ORG/apis?name=helloworld&action=import" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: multipart/form-data" \
  -F "file=@helloworld-config.zip"

Où $TOKEN est défini sur votre jeton d'accès OAuth 2.0, comme décrit dans la section Obtenir un jeton d'accès OAuth 2.0. Pour en savoir plus sur les options curl utilisées dans cet exemple, consultez la section Utiliser curl. Pour obtenir une description des variables d'environnement utilisées, consultez la section Définir des variables d'environnement pour les requêtes API Apigee.

Voici un exemple de résultat de réponse :

{
  "basepaths": [
    "/helloworld"
  ],
  "configurationVersion": {
    "majorVersion": 4
  },
  "createdAt": "1559145292799",
  "displayName": "helloworld",
  "entityMetaDataAsProperties": {
    "bundle_type": "zip",
    "subType": "Proxy",
    "lastModifiedAt": "1559145292799",
    "createdAt": "1559145292799"
  },
  "lastModifiedAt": "1559145292799",
  "name": "helloworld",
  "policies": [
    "verify-api-key",
    "remove-query-param-apikey",
    "OAuth-v20-1"
  ],
  "proxies": [
    "default"
  ],
  "proxyEndpoints": [
    "default"
  ],
  "resourceFiles": {},
  "targetEndpoints": [
    "default"
  ],
  "targets": [
    "default"
  ],
  "type": "Application",
  "revision": "1",
  "description": "Hello world"
}

Pour plus d'informations sur la création d'un proxy d'API, consultez la méthode apis.create dans l'API Apigee. Pour afficher toutes les méthodes disponibles pour les proxys d'API, consultez la page Proxys d'API.

Étapes suivantes

Après avoir créé un proxy d'API simple, effectuez l'une des opérations suivantes :

Ajoutez des règles, des sécurités et d'autres fonctionnalités de la plate-forme Apigee, comme décrit dans Comprendre les API et les proxys d'API.
Déployez-le sur votre cluster, comme décrit dans la section Déployer un proxy d'API.