Comece a usar os conetores

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

Veja a documentação do Apigee Edge.

Este tutorial mostra como usar a integração de aplicações e os conetores para criar uma integração de exemplo que aciona a publicação de uma mensagem do Cloud Pub/Sub. O tutorial pressupõe que tem conhecimentos práticos da Application Integration.

Neste exemplo, chamar um ponto final da API aciona a publicação de uma mensagem num tópico do Cloud Pub/Sub. Os passos abaixo descrevem como configurar o acionador da API e a associação do Pub/Sub necessários para executar uma integração bem-sucedida.

Antes de começar

Antes de começar este tutorial, confirme as suas credenciais de início de sessão do Google Cloud e os detalhes da organização. Estas informações são necessárias para aceder à IU dos conetores. São necessárias as suas credenciais do Apigee para aceder à tarefa de conectores no criador do Application Integration. Os passos previamente necessários adicionais são descritos abaixo:

• Antes de criar uma associação pela primeira vez, conclua os seguintes passos:

  Nota: estes passos só são necessários se estiver a ativar os suplementos de integração de aplicações e conectores pela primeira vez para utilização com o Apigee.
  1. Crie uma nova instância do Apigee. As novas instâncias do Apigee podem ser aprovisionadas com a IU de aprovisionamento.

     Para ver a lista de regiões que suportam conetores, consulte o artigo Regiões de conetores suportadas.

  2. Confirme se as funcionalidades de integração de aplicações e conectores estão incluídas na sua subscrição do Apigee.
  3. Ative as funcionalidades de integração de aplicações e conectores através do seguinte comando:

     curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H \
     "content-type:application/json" \
     "https://apigee.googleapis.com/v1/organizations/PROJECT_ID:setAddons" -XPOST \
     -d '{"addonsConfig": {"integrationConfig": {"enabled": true}, "connectorsPlatformConfig": {"enabled": true}}}'

     Aviso: quando executa um comando de suplemento, este substitui todos os suplementos existentes. Por conseguinte, se tiver suplementos existentes, inclua-os no comando de suplemento. Caso contrário, o comando para ativar a integração de aplicações e os conectores desativa todos os outros suplementos na sua organização existente. Além disso, se um suplemento estiver desativado, o Apigee elimina todas as configurações do suplemento (funcionalidade). Por exemplo, se desativar o suplemento Integrations, todas as integrações são eliminadas.
  4. Se não tiver uma conta de serviço, crie uma.

     Uma conta de serviço é um tipo especial de Conta Google destinada a representar um utilizador não humano que precisa de autenticação e autorização para aceder a dados nas APIs Google. Se não tiver uma conta de serviço, tem de criar uma. Para mais informações, consulte Criar uma conta de serviço.

Ative os serviços necessários

Os conetores requerem que ative os seguintes serviços Google:

Nome	Título
apigee.googleapis.com	API Apigee
secretmanager.googleapis.com	API Secret Manager
connectors.googleapis.com	API Connectors

Se estes serviços não tiverem sido ativados anteriormente para o seu projeto, é-lhe pedido que os ative quando criar a associação na página Criar associação.

Para saber como ativar serviços, consulte o artigo Ativar serviços.

O que se segue?

• Saiba como criar e usar uma ligação do Pub/Sub na sua integração.
• Consulte a lista de conetores suportados.
• Saiba como criar e gerir associações.