Desenvolver fluxos partilhados

Esta página aplica-se ao Apigee e ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

Combine políticas e recursos num fluxo partilhado que pode consumir a partir de vários proxies de API e até de outros fluxos partilhados. Embora seja semelhante a um proxy, um fluxo partilhado não tem um ponto final. Só pode ser usado a partir de um proxy de API ou de um fluxo partilhado que esteja na mesma organização que o próprio fluxo partilhado.

Desenvolva os seus fluxos partilhados através do Apigee no Cloud Code, conforme descrito nas secções seguintes. Consulte também o artigo Gerir pastas e ficheiros num espaço de trabalho do Apigee.

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

• Criar fluxos partilhados reutilizáveis
• Anexar um fluxo partilhado através de um gancho de fluxo

Criar um fluxo partilhado

Para criar um fluxo partilhado através do Apigee no Cloud Code:

1. Realize um dos seguintes passos:

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

   • Selecione Ver > Paleta de comandos para abrir a paleta de comandos e selecione Cloud Code: Create Apigee shared flow bundle.

   O assistente de fluxo de criação de partilhas é aberto.

2. Introduza um nome exclusivo para o fluxo partilhado no comando e prima Enter.

Depois de concluir os passos no assistente, o nome do novo fluxo partilhado é apresentado em sharedflows na secção do Apigee. Cada pasta de fluxo partilhado está estruturada conforme descrito em Estrutura do diretório do conjunto de fluxos partilhados

Carregar um pacote de fluxos partilhado

Para carregar um pacote de fluxo partilhado através do Apigee no Cloud Code:

1. Realize uma das seguintes ações:

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

   • Selecione Ver > Paleta de comandos para abrir a paleta de comandos e selecione Cloud Code: Importar pacote de fluxo partilhado do Apigee.

2. Navegue para o pacote de fluxo partilhado que quer carregar e clique em Importar fluxo partilhado. O pacote de fluxo partilhado tem de estar estruturado conforme descrito em Estrutura do diretório do pacote de fluxo partilhado.

3. (Opcional) Por predefinição, o nome do ficheiro ZIP menos a respetiva extensão é usado para o nome do fluxo partilhado. Se este nome não for exclusivo, é-lhe pedido que introduza um nome exclusivo.

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

Configurar fluxos partilhados

Configure fluxos partilhados conforme descrito nos seguintes tópicos:

• Criar fluxos partilhados reutilizáveis
• Adicionar funcionalidades através de políticas
• Gerir recursos

Usar fluxos partilhados

Pode chamar um fluxo partilhado através da política FlowCallout, conforme descrito na política FlowCallout.

Além disso, ao anexar um fluxo partilhado a um ponto de união de fluxo, pode executar o fluxo partilhado antes de um pedido de proxy ou de destino, ou após uma resposta de proxy ou de destino. Para mais informações, consulte:

• Anexar um fluxo partilhado através de um ponto de ligação do fluxo (vista geral conceptual)
• Anexar fluxos partilhados através de hooks de fluxo (flowhooks.json) (passos que usam o Apigee no Cloud Code)

Nota: o Apigee não valida as dependências entre fluxos partilhados e proxies de API no momento da implementação. Por exemplo, se a política FlowCallout num proxy de API fizer referência a um fluxo partilhado que não existe ou não está implementado, a implementação do proxy de API continua a ter êxito. Quando o Apigee verifica a dependência no tempo de execução e a validação falha, o Apigee gera um erro de proxy de API com um 500 código de estado HTTP.