Desenvolver fluxos compartilhados

Esta página se aplica à Apigee e à Apigee híbrida.

Confira a documentação da Apigee Edge.

Combine políticas e recursos em um fluxo compartilhado que você possa consumir a partir de vários proxies de API e até mesmo de outros fluxos compartilhados. Ele é semelhante a um proxy, mas um fluxo compartilhado não tem endpoint. É possível usá-lo somente a partir de um proxy de API ou fluxo compartilhado que esteja na mesma organização do fluxo compartilhado.

Desenvolva seus fluxos compartilhados usando a Apigee no Cloud Code, conforme descrito nas seções a seguir. Consulte também Gerenciar pastas e arquivos em um espaço de trabalho da Apigee.

Antes de começar: familiarize-se com os conceitos descritos nos seguintes tópicos:

• Como criar fluxos compartilhados reutilizáveis
• Como anexar um fluxo compartilhado usando um gancho de fluxo

Criar um fluxo compartilhado

Para criar um fluxo compartilhado usando a Apigee no Cloud Code:

1. Realize uma das seguintes etapas:

   • Posicione o cursor sobre a pasta sharedflows no seu espaço de trabalho local e clique em .

   • Selecione Visualizar > Paleta de Comandos para abrir a paleta de comandos e selecione Cloud Code: criar pacote de fluxo compartilhado da Apigee.

   O assistente "Criar fluxo compartilhado" é aberto.

2. Digite um nome exclusivo para o fluxo compartilhado no prompt e aperte Enter.

Depois de concluir as etapas no assistente, o novo nome do fluxo compartilhado vai aparecer em sharedflows na seção "Apigee". Cada pasta de fluxo compartilhado é estruturada conforme descrito em Estrutura do diretório do pacote de fluxo compartilhado

Fazer upload de um pacote de fluxo compartilhado

Para fazer upload de um pacote de fluxo compartilhado usando a Apigee no Cloud Code:

1. Realize uma das seguintes ações:

   • No seu espaço de trabalho local, posicione o cursor sobre a pasta sharedflows e clique em .

   • Selecione Visualizar > Paleta de comandos para abrir a paleta de comandos e selecione Cloud Code: importar pacote de fluxo compartilhado da Apigee.

2. Acesse o pacote de fluxo compartilhado que será feito upload e clique em Importar fluxo compartilhado. O pacote de fluxo compartilhado precisa ser estruturado conforme descrito em Estrutura do diretório do pacote de fluxo compartilhado.

3. (Opcional) Por padrão, o nome do arquivo ZIP menos a extensão dele é usado para o nome do fluxo compartilhado. Se o nome não for exclusivo, você deverá digitar um nome exclusivo.

A pasta de fluxo compartilhado enviada é adicionada em sharedflows no seu espaço de trabalho do Apigee.

Configurar fluxos compartilhados

Configure fluxos compartilhados conforme descrito nos seguintes tópicos:

• Como criar fluxos compartilhados reutilizáveis
• Adicionar recursos usando políticas
• Gerenciar recursos

Usar fluxos compartilhados

Você pode chamar um fluxo compartilhado usando a política FlowCallout, conforme descrito em Política FlowCallout.

Além disso, ao anexar um fluxo compartilhado a um gancho de fluxo, é possível executá-lo antes de um proxy ou de uma solicitação de destino, ou depois de um proxy ou uma resposta de destino. Veja mais informações em:

• Como anexar um fluxo compartilhado usando um gancho de fluxo (visão geral conceitual)
• Como anexar fluxos compartilhados usando ganchos de fluxo (flowhooks.json) (etapas usando a Apigee no Cloud Code)

Observação: a Apigee não valida as dependências entre fluxos compartilhados e proxies de API no momento da implantação. Por exemplo, se a política FlowCallout em um proxy de API referir-se a um fluxo compartilhado que não existe ou não foi implantado, a implantação do proxy de API ainda será concluída. Quando a Apigee verifica a dependência no ambiente de execução e a validação falha, a Apigee lança um erro de proxy de API com um código de status HTTP 500.