Estensione di Google Cloud Functions

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Versione 2.0.2

Richiama le funzioni Cloud Functions di cui è stato eseguito il deployment tramite il tuo progetto Google Cloud.

Al momento, questa estensione supporta la chiamata di funzioni di trigger HTTP.

Prerequisiti

Questi contenuti forniscono un riferimento per la configurazione e l'utilizzo di questa estensione. Prima di utilizzare l'estensione da un proxy API utilizzando il criterio ExtensionCallout, devi:

1. Abilita l'API Cloud Functions.

2. Definisci ed esegui il deployment delle funzioni in Cloud Functions per il tuo progetto Google Cloud.

3. Concedi l'accesso utente tramite IAM per il livello di accesso che vuoi per la funzione. Ad esempio, puoi limitare l'accesso alla funzione solo al service account che utilizzi per configurare l'estensione.

4. Utilizza la console GCP per generare una chiave per il service account.

5. Utilizza i contenuti del file JSON della chiave risultante quando aggiungi e configuri l'estensione utilizzando il riferimento alla configurazione.

Informazioni su Cloud Functions

Con Google Cloud Functions, puoi creare ed eseguire il deployment di funzioni su Google Cloud, quindi richiamarle da altro codice. Per un'introduzione a Cloud Functions, prova una delle guide rapide.

Esempi

L'esempio seguente mostra come richiamare le funzioni in Cloud Functions utilizzando il ExtensionCallout policy.

/**
 * Responds to any HTTP request.
 *
 * @param {!express:Request} req HTTP request context.
 * @param {!express:Response} res HTTP response context.
 */
exports.helloWorld = (req, res) => {
  let message = req.query.message || req.body.message || 'Hello World!';
  res.status(200).send(message);
};

<Action>invoke</Action>
<Input><![CDATA[
  {
    "region" : "us-central1",
    "projectId" : "my-project",
    "functionName" : "hello-world",
    "method" : "POST",
    "payload" : { "message" : "Hello yourself!" }
  }
]]></Input>
<Output parsed="false">function.response</Output>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Get-Function-Response">
    <DisplayName>Get Function Response</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{function.response}</Payload>
    </Set>
</AssignMessage>

Hello yourself!

Azioni

richiamare

Richiama una funzione Cloud.

Al momento, questa estensione supporta la chiamata di funzioni di trigger HTTP.

<Action>invoke</Action>
<Input><![CDATA[
  {
    "region" : "deployment-region",
    "projectId" : "project-id",
    "functionName" : "function-name",
    "method" : "http-method",
    "payload" : { json-payload }
  }
]]></Input>
<Output>function.response</Output>

<Action>invoke</Action>
<Input><![CDATA[
  {
    "region" : "us-central1",
    "projectId" : "my-project",
    "functionName" : "hello-world",
    "method" : "POST",
    "payload" : { "message" : "Hello yourself!" }
  }
]]></Input>
<Output>function.response</Output>

Parametri di richiesta

Risposta

Il valore di risposta della funzione specificata, se presente.

Proprietà della risposta

Nessuno.

Riferimento alla configurazione

Utilizza quanto segue quando configuri ed esegui il deployment di questa estensione per l'utilizzo nei proxy API. Per i passaggi per configurare un'estensione utilizzando la console Apigee, vedi Aggiunta e configurazione di un'estensione.

Proprietà comuni delle estensioni

Per ogni estensione sono presenti le seguenti proprietà.

Proprietà di questo pacchetto di estensioni

Specifica i valori per le seguenti proprietà di configurazione specifiche di questa estensione.