Extensão do Google Cloud Functions

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.info

Versão 2.0.0

Invoque as funções do Cloud implantadas no seu projeto na nuvem do Google Cloud.

No momento, essa extensão oferece suporte à invocação de funções de acionador HTTP.

Pré-requisitos

Este conteúdo fornece uma referência para configurar e usar essa extensão. Antes de usar a extensão de um proxy de API usando a política ExtensionCallout, você precisa:

1. Ativar a API Cloud Functions.

2. Definir e implantar funções no Cloud Functions para seu projeto na nuvem do Google Cloud.

3. Conceder acesso do usuário pelo IAM para o nível de acesso desejado para a função. Por exemplo, você pode limitar o acesso à função apenas à conta de serviço usada para configurar a extensão.

4. Use o console do GCP para gerar uma chave para a conta de serviço.

5. Use o conteúdo do arquivo JSON de chave resultante ao adicionar e configurar a extensão usando a referência de configuração.

Sobre o Cloud Functions

Com o Google Cloud Functions, é possível criar e implantar funções no Google Cloud e invocá-las de outro código. Para uma introdução ao Cloud Functions, teste um dos guias de início rápido.

Amostras

O exemplo a seguir ilustra como invocar funções no Cloud Functions usando a política ExtensionCallout.

/**
 * 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!

Ações

invocar

Invoca uma função do Cloud.

No momento, essa extensão oferece suporte à invocação de funções de acionador 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>

Parâmetros de solicitação

Resposta

O valor da resposta da função especificada, se houver.

Propriedades de resposta

Nenhum.

Referência de configuração

Use o seguinte ao configurar e implantar essa extensão para uso em proxies de API. Para conferir as etapas de configuração de uma extensão usando o console do Apigee, consulte Como adicionar e configurar uma extensão.

Propriedades comuns de extensão

As propriedades a seguir estão presentes para cada extensão.

Propriedades deste pacote de extensão

Especifique valores para as seguintes propriedades de configuração específicas dessa extensão.