Gerenciando Transfer Family eventos usando Amazon EventBridge - AWS Transfer Family

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Gerenciando Transfer Family eventos usando Amazon EventBridge

Amazon EventBridge é um serviço sem servidor que usa eventos para conectar componentes do aplicativo, o que pode facilitar a criação de aplicativos escaláveis orientados por eventos. A arquitetura orientada a eventos é um estilo de criar sistemas de software fracamente acoplados que funcionam juntos emitindo e respondendo a eventos. Os eventos representam uma mudança em um recurso ou ambiente.

Como acontece com muitos AWS serviços, Transfer Family gera e envia eventos para o barramento de eventos EventBridge padrão. Observe que o barramento de eventos padrão é provisionado automaticamente em todas as AWS contas. Um barramento de eventos é um roteador que recebe eventos e os entrega a zero ou mais destinos, ou alvos. Você especifica regras para o barramento de eventos que avalia os eventos à medida que eles chegam. Cada regra verifica se um evento corresponde ao padrão do evento. Se o evento corresponder, o barramento de eventos enviará o evento para um ou mais destinos especificados.

AWS os serviços enviam eventos para o barramento de eventos EventBridge padrão. Se o evento corresponder ao padrão de evento de uma regra, EventBridge envia o evento para os destinos especificados para essa regra.

Transfer Family eventos

Transfer Family envia eventos automaticamente para o barramento de EventBridge eventos padrão. Você pode criar regras no barramento de eventos em que cada regra inclui um padrão de evento e um ou mais alvos.

Os eventos que correspondem ao padrão de eventos de uma regra são entregues às metas especificadas com o melhor esforço possível ou de forma duradoura (observe que alguns eventos podem ser entregues fora de ordem). Esses níveis de entrega são descritos em Nível de entrega para eventos AWS de serviço na Amazon EventBridge Events Reference.

  • Os eventos em nível de servidor para servidores SFTP, FTPS e FTP são entregues com base no melhor esforço.

  • Os eventos do conector SFTP são fornecidos de forma durável.

  • Os AS2 eventos são realizados de forma duradoura.

Os eventos a seguir são gerados por Transfer Family. Para obter mais informações, consulte Eventos do EventBridge, no Guia do usuário do Amazon EventBridge .

Eventos de servidor SFTP, FTPS e FTP

As tabelas a seguir listam os eventos dos servidores SFTP, FTPS e FTP, organizados por tipo de evento.

Eventos de upload e download de arquivos

Tipo de detalhe de evento Description

Download do arquivo do servidor FTP concluído

Um arquivo foi baixado com sucesso para o protocolo FTP.

Falha no download do arquivo do servidor FTP

Houve falha na tentativa de baixar um arquivo para o protocolo FTP.

Carregamento do arquivo do servidor FTP concluído

Um arquivo foi carregado com sucesso para o protocolo FTP.

Falha no upload do arquivo do servidor FTP

Houve falha na tentativa de carregar um arquivo para o protocolo FTP.

Download do arquivo do servidor FTPS concluído

Um arquivo foi baixado com sucesso para o protocolo FTPS.

Falha no download do arquivo do servidor FTPS

Houve falha na tentativa de baixar um arquivo para o protocolo FTPS.

Carregamento do arquivo do servidor FTPS concluído

Um arquivo foi carregado com sucesso para o protocolo FTPS.

Falha no upload do arquivo do servidor FTPS

Houve falha na tentativa de carregar um arquivo para o protocolo FTPS.

Download do arquivo do servidor SFTP concluído

Um arquivo foi baixado com sucesso para o protocolo SFTP.

Falha no download do arquivo do servidor SFTP

Houve falha na tentativa de baixar um arquivo para o protocolo SFTP.

Carregamento do arquivo do servidor SFTP concluído

Um arquivo foi carregado com sucesso para o protocolo SFTP.

Falha no carregamento do arquivo do servidor SFTP

Houve falha na tentativa de carregar um arquivo para o protocolo SFTP.

Outros eventos de operações de arquivo

Tipo de detalhe de evento Description

Criação do diretório do servidor FTP concluída

Um diretório foi criado com sucesso para o protocolo FTP.

Falha na criação do diretório do servidor FTP

Houve falha na tentativa de criar um diretório para o protocolo FTP.

A exclusão do diretório do servidor FTP foi concluída

Um diretório foi excluído com sucesso para o protocolo FTP.

Falha na exclusão do diretório do servidor FTP

Houve falha na tentativa de excluir um diretório para o protocolo FTP.

A exclusão do arquivo do servidor FTP foi concluída

Um arquivo foi excluído com sucesso para o protocolo FTP.

Falha na exclusão do arquivo do servidor FTP

Houve falha na tentativa de excluir um arquivo para o protocolo FTP.

Renomeação do arquivo do servidor FTP concluída

Um arquivo foi renomeado com sucesso para o protocolo FTP.

Falha na renomeação do arquivo do servidor FTP

Houve falha na tentativa de renomear um arquivo para o protocolo FTP.

Criação do diretório do servidor FTPS concluída

Um diretório foi criado com sucesso para o protocolo FTPS.

Falha na criação do diretório do servidor FTPS

Houve falha na tentativa de criar um diretório para o protocolo FTPS.

Exclusão do diretório do servidor FTPS concluída

Um diretório foi excluído com sucesso para o protocolo FTPS.

Falha na exclusão do diretório do servidor FTPS

Houve falha na tentativa de excluir um diretório para o protocolo FTPS.

A exclusão do arquivo do servidor FTPS foi concluída

Um arquivo foi excluído com sucesso para o protocolo FTPS.

Falha na exclusão do arquivo do servidor FTPS

Houve falha na tentativa de excluir um arquivo para o protocolo FTPS.

Renomeação do arquivo do servidor FTPS concluída

Um arquivo foi renomeado com sucesso para o protocolo FTPS.

Falha na renomeação do arquivo do servidor FTPS

Houve falha na tentativa de renomear um arquivo para o protocolo FTPS.

Criação do diretório do servidor SFTP concluída

Um diretório foi criado com sucesso para o protocolo SFTP.

Falha na criação do diretório do servidor SFTP

Houve falha na tentativa de criar um diretório para o protocolo SFTP.

A exclusão do diretório do servidor SFTP foi concluída

Um diretório foi excluído com sucesso para o protocolo SFTP.

Falha na exclusão do diretório do servidor SFTP

Houve falha na tentativa de excluir um diretório para o protocolo SFTP.

A exclusão do arquivo do servidor SFTP foi concluída

Um arquivo foi excluído com sucesso para o protocolo SFTP.

Falha na exclusão do arquivo do servidor SFTP

Houve falha na tentativa de excluir um arquivo para o protocolo SFTP.

Renomeação do arquivo do servidor SFTP concluída

Um arquivo foi renomeado com sucesso para o protocolo SFTP.

Falha na renomeação do arquivo do servidor SFTP

Houve falha na tentativa de renomear um arquivo para o protocolo SFTP.

Eventos do conector SFTP

nota

Esses eventos são entregues EventBridge em um nível durável, conforme descrito em Nível de entrega para eventos AWS de serviço na Referência de EventBridge Eventos da Amazon.

Tipo de detalhe de evento Description

Envio do arquivo do conector SFTP concluído

A transferência de arquivo de um conector para um servidor SFTP remoto foi concluída com êxito.

Falha no envio do arquivo do conector SFTP

Uma transferência de arquivo de um conector para um servidor SFTP remoto falhou.

Recuperação do arquivo do conector SFTP concluída

Uma transferência de arquivo de um servidor SFTP remoto para um conector foi concluída com êxito.

Falha na recuperação do arquivo do conector SFTP

Uma transferência de arquivo de um servidor SFTP remoto para um conector falhou.

Lista de diretórios de conectores SFTP concluída

Uma chamada de listagem do diretório de arquivos inicial que foi concluída com êxito.

Falha na listagem do diretório do conector SFTP

Uma listagem do diretório do arquivo inicial que falhou.

Movimentação remota do conector SFTP concluída

Os arquivos ou diretórios foram movidos ou renomeados com êxito no servidor remoto.

Falha na movimentação remota do conector SFTP

Não foi possível mover ou renomear arquivos ou diretórios no servidor remoto.

Exclusão remota do conector SFTP concluída

Os arquivos ou diretórios foram excluídos com sucesso no servidor remoto.

Falha na exclusão remota do conector SFTP

Não foi possível excluir arquivos ou diretórios no servidor remoto.

AS2 eventos

nota

Esses eventos são entregues EventBridge em um nível durável, conforme descrito em Nível de entrega para eventos AWS de serviço na Referência de EventBridge Eventos da Amazon.

Tipo de detalhe de evento Description

AS2 Recebimento da carga útil concluído

A carga útil de uma AS2 mensagem foi recebida.

AS2 Falha no recebimento da carga

A carga útil de uma AS2 mensagem não foi recebida.

AS2 Envio de carga útil concluído

A carga útil de uma AS2 mensagem foi enviada com sucesso.

AS2 Falha no envio da carga

Falha no envio da carga útil de uma AS2 mensagem.

AS2 Recebimento MDN concluído

A notificação de descarte de uma AS2 mensagem foi recebida.

AS2 Falha na recepção do MDN

A notificação de descarte de uma AS2 mensagem não foi recebida.

AS2 Envio MDN concluído

A notificação de descarte de uma AS2 mensagem foi enviada com sucesso.

AS2 Falha no envio do MDN

A notificação de descarte de uma AS2 mensagem falhou no envio.

Envio de Transfer Family eventos usando EventBridge regras

Se você quiser que o barramento de eventos EventBridge padrão envie Transfer Family eventos para um destino, você deve criar uma regra que contenha um padrão de evento que corresponda aos dados dos Transfer Family eventos desejados.

Para capturar AWS Transfer Family eventos na Amazon EventBridge
  1. Faça login no Console de gerenciamento da AWS e abra o EventBridge console da Amazon em https://console.aws.amazon.com/events/.

  2. No painel de navegação, escolha Regras e, em seguida, escolha Criar regra.

  3. Insira um nome descritivo para a regra e, opcionalmente, insira uma descrição.

  4. Em Tipo de regra, selecione Regra com um padrão de evento e escolha Avançar.

  5. Na seção Origem do evento, selecione AWS eventos ou eventos de EventBridge parceiros.

  6. Na seção Método de criação, escolha Usar formulário padrão.

  7. Na seção Padrão de eventos, forneça as seguintes informações.

    1. Em Fonte do evento, selecione Serviços da AWS .

    2. Para o AWS serviço, escolha Transferir.

    3. Em Tipo de evento, escolha o tipo de evento Transfer Family que você deseja acionar sua regra.

      Dependendo da seleção do tipo de evento, você pode receber uma seção Especificação 1 do tipo de evento.

    4. Se você ver a seção Especificação do tipo de evento 1, selecione os eventos específicos que deseja capturar (ou selecione Qualquer evento para capturar todos os eventos do tipo de evento selecionado).

    5. (Opcional) Use o editor de padrões de eventos para especificar filtros para detalhes do evento.

    6. Escolha Próximo.

  8. Escolha um alvo entre as opções disponíveis em Selecionar alvos. Escolha entre os seguintes alvos disponíveis.

    • AWS serviço. As opções mais populares são funções Lambda para computação sem servidor, filas do Amazon SQS para processamento de mensagens, tópicos do Amazon SNS para notificações e para orquestrar fluxos de trabalho. AWS Step Functions

    • EventBridge Destino da API. Se você quiser enviar eventos para um endpoint HTTP externo AWS, você pode usar um destino de API como seu destino.

    • EventBridge ônibus de eventos. Você pode enviar eventos para outro ônibus de eventos, na mesma conta e região ou em uma conta ou região diferente.

      Para obter instruções abrangentes sobre a criação de regras de barramento de eventos, consulte Criação de regras que reagem a eventos no Guia EventBridge do usuário da Amazon.

    Para obter ajuda na seleção de um alvo, consulte Selecionar alvos no Guia EventBridge do usuário da Amazon.

  9. Configure todas as opções adicionais para seu alvo e escolha Avançar.

  10. (Opcional) Adicione tags à sua regra e escolha Avançar.

  11. Na tela Revisar e criar, se tudo estiver correto, escolha Criar regra.

Criação de padrões de Transfer Family eventos para eventos

Ao Transfer Family entregar um evento ao barramento de eventos padrão, EventBridge usa o padrão de evento definido para cada regra para determinar se o evento deve ser entregue aos destinos da regra. Um padrão de evento corresponde aos dados nos eventos do Transfer Family desejados. Cada padrão de evento é um objeto JSON que contém o seguinte:

  • Um atributo source que identifica o serviço que envia o evento. Para Transfer Family eventos, a fonte éaws.transfer.

  • (Opcional) Um detail-type atributo que contém uma matriz dos tipos de eventos a serem correspondentes.

  • (Opcional) Um detail atributo contendo quaisquer outros dados de eventos aos quais corresponder.

Por exemplo, o padrão de eventos a seguir corresponde a todos os eventos de Transfer Family:

{ "source": ["aws.transfer"] }

O exemplo de padrão de evento a seguir corresponde a todos os eventos do conector SFTP:

{ "source": ["aws.transfer"], "detail-type": ["SFTP Connector File Send Completed", "SFTP Connector File Retrieve Completed", "SFTP Connector File Retrieve Failed", "SFTP Connector File Send Failed"] }

O exemplo de padrão de evento a seguir corresponde a todos os eventos com falha do Transfer Family:

{ "source": ["aws.transfer"], "detail-type": [{"wildcard", "*Failed"}] }

O exemplo de padrão de evento a seguir corresponde a downloads de SFTP bem-sucedidos para o usuáriousername:

{ "source": ["aws.transfer"], "detail-type": ["SFTP Server File Download Completed"], "detail": { "username": [username] } }

Para obter mais informações sobre como escrever padrões de eventos, consulte Padrões de eventos no Guia do usuário do EventBridge .

Testando padrões de Transfer Family eventos para eventos em EventBridge

Você pode usar o EventBridge Sandbox para definir e testar rapidamente um padrão de evento, sem precisar concluir o processo mais amplo de criação ou edição de uma regra. Usando o Sandbox, você pode definir um padrão de evento e usar um evento de amostra para confirmar se o padrão corresponde aos eventos desejados. EventBridge oferece a opção de criar uma nova regra usando esse padrão de evento diretamente da sandbox.

Para obter mais informações, consulte Testando um padrão de evento usando o EventBridge Sandbox no Guia do EventBridge usuário.

Amazon EventBridge permissões

Transfer Family não exige nenhuma permissão adicional para realizar eventos Amazon EventBridge.

Os alvos que você especificar podem exigir permissões ou configurações específicas. Para obter mais detalhes sobre o uso de serviços específicos para destinos, consulte Destinos do Amazon EventBridge no Guia do usuário do Amazon EventBridge .

Recursos adicionais do EventBridge

Consulte os tópicos a seguir no Guia do Amazon EventBridge usuário para obter mais informações sobre como usar EventBridge para processar e gerenciar eventos.

  • Para obter informações detalhadas sobre como os barramentos de eventos funcionam, consulte Barramento de eventos do Amazon EventBridge.

  • Para obter informações sobre a estrutura de eventos, consulte Eventos

  • Para obter informações sobre a construção de padrões de eventos EventBridge para uso ao comparar eventos com regras, consulte Padrões de eventos.

  • Para obter informações sobre a criação de regras para especificar quais eventos são processados pelo EventBridge , consulte Regras.

  • Para obter informações sobre como especificar quais serviços ou outros destinos EventBridge enviam eventos correspondentes, consulte Metas.