Primeiros passos com os conectores

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

Confira a documentação da Apigee Edge.

Neste tutorial, mostramos como usar a integração e os conectores da Apigee para criar uma integração de amostra que aciona a publicação de uma mensagem do Cloud Pub/Sub. Para seguir o tutorial, é necessário ter um conhecimento prático sobre a Integração com a Apigee.

Neste exemplo, chamar um endpoint da API aciona a publicação de uma mensagem em um tópico do Cloud Pub/Sub. As etapas abaixo descrevem como configurar o acionador da API e a conexão do Pub/Sub necessárias para executar uma integração bem-sucedida.

Antes de começar

Antes de começar este tutorial, confirme as credenciais de login e os detalhes da organização do Google Cloud. Essas informações são necessárias para acessar a IU do Connectors. Suas credenciais da Apigee são necessárias para acessar a tarefa "Conectores" no designer de integração da Apigee. As etapas de pré-requisito adicionais são descritas abaixo:

• Antes de criar uma conexão pela primeira vez, conclua as etapas a seguir:

  Observação: essas etapas serão necessárias apenas se você estiver ativando os complementos de integração e conectores da Apigee pela primeira vez para uso com a Apigee.
  1. Crie uma nova instância da Apigee. Novas instâncias da Apigee podem ser provisionadas com a IU de provisionamento.

     Para ver a lista de regiões compatíveis, consulte Regiões de conectores compatíveis.

  2. Confirme se os recursos de integração e conectores da Apigee têm direito à assinatura da Apigee.
  3. Ative os recursos de integração e conectores da Apigee usando o 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 você executa um comando de complemento, todos os complementos atuais são substituídos. Portanto, se você tiver complementos, inclua-os no comando de complementos. Caso contrário, o comando para ativar a integração e os conectores da Apigee desativará todos os outros complementos na organização. Se um complemento estiver desativado, a Apigee excluirá todas as configurações dele. Por exemplo, se você desativar o complemento, todas as integrações serão excluídas.
  4. Se você não tiver uma conta de serviço, crie uma.

     Uma conta de serviço é um tipo especial de Conta do Google destinada a representar um usuário não humano que precisa ser autenticado e autorizado a acessar dados nas APIs do Google. Se você não tiver uma conta de serviço, será necessário criar uma. Para mais informações, consulte Como criar uma conta de serviço.

Ativar serviços obrigatórios

Os conectores exigem que você ative os seguintes serviços do Google:

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

Se esses serviços não foram ativados para seu projeto anteriormente, será solicitado que você os ative ao criar a conexão na página "Criar conexão".

Para entender como ativar os serviços, consulte Como ativar serviços.

A seguir

• Saiba como criar e usar uma conexão do Pub/Sub na integração.
• Consulte a lista de conectores compatíveis.
• Saiba como criar e gerenciar conexões.