Ajout d'une fonction dans le service des fonctions pour OCI comme élément dorsal du service de passerelle d'API

Pour créer une fonction sans serveur dans le service des fonctions pour OCI qui peut être appelée à partir d'une passerelle d'API, suivez les instructions de la documentation sur le service des fonctions pour OCI pour effectuer les opérations suivantes :

• Vérifiez que vous avez terminé les étapes préalables pour utiliser le service des fonctions pour OCI, comme décrit sous Préparation pour le service des fonctions.
• Créez et déployez la fonction dans un compartiment auquel l'accès a été accordé aux passerelles d'API, tel qu'il décrit sous Création et déploiement de fonctions.

Pour ajouter un élément dorsal de fonction du service des fonctions pour OCI à une spécification de déploiement d'API à l'aide de la console :

1. Créez ou mettez à jour un déploiement d'API à l'aide de la console, sélectionnez l'option À partir de zéro et entrez les détails dans la page Informations de base.

   Pour plus d'informations, voir Déploiement d'une API sur une passerelle d'API en créant un déploiement d'API et Mise à jour d'une passerelle d'API.

2. Dans la page Authentification, spécifiez les options d'authentification.

   Pour plus d'informations sur les options d'authentification, voir Ajout de l'authentification et de l'autorisation aux déploiements d'API.

3. Dans la page Routes, créez une route et spécifiez les données suivantes :

   • Chemin : Chemin des appels d'API utilisant les méthodes indiquées au service dorsal. Notez que le chemin de routage que vous spécifiez :

     • Est relatif au préfixe du chemin du déploiement (voir Déploiement d'une API sur une passerelle d'API en créant un déploiement d'API).
     • Doit être précédé d'une barre oblique (/) et peut être simplement cette seule barre oblique.
     • Peut contenir plusieurs barres obliques (à condition qu'elles ne soient pas adjacentes) et peut se terminer par une barre oblique.
     • Peut inclure des caractères alphanumériques en majuscules et en minuscules.
     • peut inclure les caractères spéciaux $ - _ . + ! * ' ( ) , % ; : @ & =
     • Peut inclure des paramètres et des caractères génériques (voir Ajout de paramètres de chemin et de caractères génériques aux chemins de routage).
   • Méthodes : Une ou plusieurs méthodes acceptées par le service dorsal. Par exemple, GET, PUT.

   • Ajouter un seul serveur dorsal ou Ajouter plusieurs serveurs dorsaux : Indique si toutes les demandes doivent être acheminées vers le même serveur dorsal ou si elles doivent être acheminées vers différents serveurs dorsaux en fonction de la variable de contexte et des règles que vous entrez.

     Ces instructions supposent que vous voulez utiliser un seul élément dorsal. Sélectionnez donc Ajouter un seul élément dorsal. Sinon, si vous voulez utiliser des éléments dorsaux différents, sélectionnez Ajouter plusieurs éléments dorsaux et suivez les instructions sous Utilisation de la console pour ajouter une sélection d'élément dorsal dynamique à une spécification de déploiement d'API.

   • Type dorsal : Type du service dorsal comme Oracle Functions.
   • Application dans <compartiment-nom> : Nom de l'application du service des fonctions pour OCI qui contient la fonction. Vous pouvez sélectionner une application dans un compartiment différent.
   • Nom de la fonction : Nom de la fonction du service des fonctions pour OCI.

   Dans cet exemple, la route définit une simple fonction sans serveur Hello World dans le service des fonctions pour OCI en tant qu'élément dorsal unique.

   Champ :	Entrez :
   Chemin :	/hello
   Méthodes :	GET
   Type de service dorsal :	Oracle Functions
   Application dans <compartment-name> :	acmeapp
   Nom de la fonction :	acme-func

4. (Facultatif) Sélectionnez Autre route pour entrer les détails des routes supplémentaires.
5. Sélectionnez Suivant pour vérifier les détails que vous avez entrés pour le déploiement d'API.
6. Sélectionnez Créer ou enregistrer les modifications pour créer ou mettre à jour le déploiement d'API.

7. (Facultatif) Vérifiez que l'API a été déployée avec succès en l'appelant (voir Appel d'une API déployée sur une passerelle d'API).

   Si la fonction sans serveur accepte les paramètres, incluez-les dans l'appel à l'API. Par exemple :

   curl -k -X GET https://lak...sjd.apigateway.us-phoenix-1.oci.customer-oci.com/marketing/hello/ -d "name=john"

Pour ajouter un élément dorsal de fonction du service des fonctions pour OCI à une spécification de déploiement d'API dans un fichier JSON :

1. Dans votre éditeur JSON préféré, créez la spécification de déploiement d'API dans un fichier JSON au format suivant :

   {
     "requestPolicies": {},
     "routes": [
       {
         "path": "<api-route-path>",
         "methods": ["<method-list>"],
         "backend": {
           "type": "ORACLE_FUNCTIONS_BACKEND",
           "functionId": "<identifier>"
         },
         "requestPolicies": {}
       }
     ]
   }

   où :

   • "requestPolicies" spécifie des politiques facultatives pour contrôler le comportement d'un déploiement d'API. Si vous voulez appliquer des politiques à toutes les routes d'une spécification de déploiement d'API, placez les politiques en dehors de la section routes. Si vous voulez appliquer les politiques uniquement à une route particulière, placez les politiques dans la section routes. Voir Ajout de politiques de demande et de réponse aux spécifications de déploiement d'API.

   • <api-route-path> spécifie un chemin pour les appels d'API utilisant les méthodes indiquées au service dorsal. Notez que le chemin de routage que vous spécifiez :

     • Est relatif au préfixe du chemin du déploiement (voir Déploiement d'une API sur une passerelle d'API en créant un déploiement d'API).
     • Doit être précédé d'une barre oblique (/) et peut être simplement cette seule barre oblique.
     • Peut contenir plusieurs barres obliques (à condition qu'elles ne soient pas adjacentes) et peut se terminer par une barre oblique.
     • Peut inclure des caractères alphanumériques en majuscules et en minuscules.
     • peut inclure les caractères spéciaux $ - _ . + ! * ' ( ) , % ; : @ & =
     • Peut inclure des paramètres et des caractères génériques (voir Ajout de paramètres de chemin et de caractères génériques aux chemins de routage).
   • <method-list> spécifie une ou plusieurs méthodes acceptées par le service dorsal, séparées par des virgules. Par exemple, "GET, PUT".
   • <identifier> spécifie l'OCID de la fonction à utiliser comme service dorsal. Par exemple, "functionId": "ocid1.fnfunc.oc1.phx.aaaaaaaaab______xmq".

   Par exemple, la spécification de déploiement d'API de base suivante définit une simple fonction sans serveur Hello World du service des fonctions pour OCI en tant qu'élément dorsal unique :

   {
     "routes": [
       {
         "path": "/hello",
         "methods": ["GET"],
         "backend": {
           "type": "ORACLE_FUNCTIONS_BACKEND",
           "functionId": "ocid1.fnfunc.oc1.phx.aaaaaaaaab______xmq"
         }
       }
     ]
   }

2. Enregistrez le fichier JSON contenant la spécification de déploiement d'API.

3. Utilisez comme suit la spécification de déploiement d'API lorsque vous créez ou mettez à jour un déploiement d'API :

   • En spécifiant le fichier JSON dans la console lorsque vous sélectionnez l'option Charger une API existante.
   • En spécifiant le fichier JSON dans une demande à l'API REST du service Passerelle d'API.

   Pour plus d'informations,voir Déploiement d'une API sur une passerelle d'API en créant un déploiement d'API.

4. (Facultatif) Vérifiez que l'API a été déployée et que la fonction sans serveur du service des fonctions pour OCI peut être appelée avec succès en appelant l'API (voir Appel d'une API déployée sur une passerelle d'API).

   Si la fonction sans serveur accepte les paramètres, incluez-les dans l'appel à l'API. Par exemple :

   curl -k -X GET https://lak...sjd.apigateway.us-phoenix-1.oci.customer-oci.com/marketing/hello/ -d "name=john"