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.
Tópicos
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 |
|---|---|
|
Um arquivo foi baixado com sucesso para o protocolo FTP. |
|
|
Houve falha na tentativa de baixar um arquivo para o protocolo FTP. |
|
|
Um arquivo foi carregado com sucesso para o protocolo FTP. |
|
|
Houve falha na tentativa de carregar um arquivo para o protocolo FTP. |
|
|
Um arquivo foi baixado com sucesso para o protocolo FTPS. |
|
|
Houve falha na tentativa de baixar um arquivo para o protocolo FTPS. |
|
|
Um arquivo foi carregado com sucesso para o protocolo FTPS. |
|
|
Houve falha na tentativa de carregar um arquivo para o protocolo FTPS. |
|
|
Um arquivo foi baixado com sucesso para o protocolo SFTP. |
|
|
Houve falha na tentativa de baixar um arquivo para o protocolo SFTP. |
|
|
Um arquivo foi carregado com sucesso para o protocolo 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 |
|---|---|
|
Um diretório foi criado com sucesso para o protocolo FTP. |
|
|
Houve falha na tentativa de criar um diretório para o protocolo FTP. |
|
|
Um diretório foi excluído com sucesso para o protocolo FTP. |
|
|
Houve falha na tentativa de excluir um diretório para o protocolo FTP. |
|
|
Um arquivo foi excluído com sucesso para o protocolo FTP. |
|
|
Houve falha na tentativa de excluir um arquivo para o protocolo FTP. |
|
|
Um arquivo foi renomeado com sucesso para o protocolo FTP. |
|
|
Houve falha na tentativa de renomear um arquivo para o protocolo FTP. |
|
|
Um diretório foi criado com sucesso para o protocolo FTPS. |
|
|
Houve falha na tentativa de criar um diretório para o protocolo FTPS. |
|
|
Um diretório foi excluído com sucesso para o protocolo FTPS. |
|
|
Houve falha na tentativa de excluir um diretório para o protocolo FTPS. |
|
|
Um arquivo foi excluído com sucesso para o protocolo FTPS. |
|
|
Houve falha na tentativa de excluir um arquivo para o protocolo FTPS. |
|
|
Um arquivo foi renomeado com sucesso para o protocolo FTPS. |
|
|
Houve falha na tentativa de renomear um arquivo para o protocolo FTPS. |
|
|
Um diretório foi criado com sucesso para o protocolo SFTP. |
|
|
Houve falha na tentativa de criar um diretório para o protocolo SFTP. |
|
|
Um diretório foi excluído com sucesso para o protocolo SFTP. |
|
|
Houve falha na tentativa de excluir um diretório para o protocolo SFTP. |
|
|
Um arquivo foi excluído com sucesso para o protocolo SFTP. |
|
|
Houve falha na tentativa de excluir um arquivo para o protocolo SFTP. |
|
|
Um arquivo foi renomeado com sucesso para o protocolo 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 |
|---|---|
| A transferência de arquivo de um conector para um servidor SFTP remoto foi concluída com êxito. | |
| Uma transferência de arquivo de um conector para um servidor SFTP remoto falhou. | |
| Uma transferência de arquivo de um servidor SFTP remoto para um conector foi concluída com êxito. | |
| Uma transferência de arquivo de um servidor SFTP remoto para um conector falhou. | |
| Uma chamada de listagem do diretório de arquivos inicial que foi concluída com êxito. | |
| Uma listagem do diretório do arquivo inicial que falhou. | |
| Os arquivos ou diretórios foram movidos ou renomeados com êxito no servidor remoto. | |
| Não foi possível mover ou renomear arquivos ou diretórios no servidor remoto. | |
| Os arquivos ou diretórios foram excluídos com sucesso no servidor remoto. | |
| 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 |
|---|---|
| A carga útil de uma AS2 mensagem foi recebida. | |
| A carga útil de uma AS2 mensagem não foi recebida. | |
| A carga útil de uma AS2 mensagem foi enviada com sucesso. | |
| Falha no envio da carga útil de uma AS2 mensagem. | |
| A notificação de descarte de uma AS2 mensagem foi recebida. | |
| A notificação de descarte de uma AS2 mensagem não foi recebida. | |
| A notificação de descarte de uma AS2 mensagem foi enviada com sucesso. | |
| 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
-
Faça login no Console de gerenciamento da AWS e abra o EventBridge console da Amazon em https://console.aws.amazon.com/events/
. -
No painel de navegação, escolha Regras e, em seguida, escolha Criar regra.
-
Insira um nome descritivo para a regra e, opcionalmente, insira uma descrição.
-
Em Tipo de regra, selecione Regra com um padrão de evento e escolha Avançar.
-
Na seção Origem do evento, selecione AWS eventos ou eventos de EventBridge parceiros.
-
Na seção Método de criação, escolha Usar formulário padrão.
-
Na seção Padrão de eventos, forneça as seguintes informações.
-
Em Fonte do evento, selecione Serviços da AWS .
-
Para o AWS serviço, escolha Transferir.
-
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.
-
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).
-
(Opcional) Use o editor de padrões de eventos para especificar filtros para detalhes do evento.
-
Escolha Próximo.
-
-
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.
-
-
Configure todas as opções adicionais para seu alvo e escolha Avançar.
-
(Opcional) Adicione tags à sua regra e escolha Avançar.
-
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
sourceque identifica o serviço que envia o evento. Para Transfer Family eventos, a fonte éaws.transfer. -
(Opcional) Um
detail-typeatributo que contém uma matriz dos tipos de eventos a serem correspondentes. -
(Opcional) Um
detailatributo 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.