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á.
# Gerenciamento Transfer Family eventos usando Amazon EventBridge
Amazon EventBridge é um serviço sem servidor que usa eventos para conectar os componentes do aplicativo, o que pode facilitar a criação de aplicativos escaláveis orientados por eventos. Event-driven arquitetura é um estilo de construção de 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 coincidir, o barramento de eventos envia o evento para um ou mais alvos específicos.
**Topics**
+ [Transfer Family eventos](#supported-events)
+ [Enviando Transfer Family eventos usando EventBridge regras](#eventbridge-using-events-rules)
+ [Amazon EventBridge permissões](#eventbridge-permissions)
+ [Adicional EventBridge recursos](#eventbridge-additonal-resources)
+ [Transfer Family referência detalhada de eventos](events-detail-reference.md)
## Transfer Family eventos
Transfer Family envia eventos automaticamente para o barramento de EventBridge eventos padrão. Você pode criar regras no barramento de eventos, onde 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 aos alvos especificados da * melhor maneira 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 ](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) na * Amazon EventBridge Events Reference*.
+ Server-level eventos para servidores SFTP, FTPS e FTP são entregues com base no melhor esforço possível.
+ Os eventos do conector SFTP são fornecidos de forma durável.
+ Os eventos AS2 são realizados de forma durável.
Os eventos a seguir são gerados por Transfer Family. Para obter mais informações, consulte [Eventos do EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html), no *Guia do usuário do Amazon EventBridge *.
### Eventos do servidor SFTP, FTPS e FTP
As tabelas a seguir listam os eventos para 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 ](events-detail-reference.md#event-detail-server-events) | Um arquivo foi baixado com sucesso para o protocolo FTP. |
| [Falha no download do arquivo do servidor FTP ](events-detail-reference.md#event-detail-server-events) | Uma tentativa de baixar um arquivo falhou para o protocolo FTP. |
| [Carregamento do arquivo do servidor FTP concluído ](events-detail-reference.md#event-detail-server-events) | Um arquivo foi carregado com sucesso para o protocolo FTP. |
| [Falha no carregamento do arquivo do servidor FTP ](events-detail-reference.md#event-detail-server-events) | Uma tentativa de fazer upload de um arquivo falhou para o protocolo FTP. |
| [Download do arquivo do servidor FTPS concluído ](events-detail-reference.md#event-detail-server-events) | Um arquivo foi baixado com sucesso para o protocolo FTPS. |
| [Falha no download do arquivo do servidor FTPS ](events-detail-reference.md#event-detail-server-events) | Uma tentativa de baixar um arquivo falhou para o protocolo FTPS. |
| [Carregamento do arquivo do servidor FTPS concluído ](events-detail-reference.md#event-detail-server-events) | Um arquivo foi carregado com sucesso para o protocolo FTPS. |
| [Falha no carregamento do arquivo do servidor FTPS ](events-detail-reference.md#event-detail-server-events) | Uma tentativa de fazer upload de um arquivo falhou para o protocolo FTPS. |
| [Download do arquivo do servidor SFTP concluído ](events-detail-reference.md#event-detail-server-events) | Um arquivo foi baixado com sucesso para o protocolo SFTP. |
| [Falha no download do arquivo do servidor SFTP ](events-detail-reference.md#event-detail-server-events) | Uma tentativa de baixar um arquivo falhou para o protocolo SFTP. |
| [Carregamento do arquivo do servidor SFTP concluído ](events-detail-reference.md#event-detail-server-events) | Um arquivo foi carregado com sucesso para o protocolo SFTP. |
| [Falha no carregamento do arquivo do servidor SFTP ](events-detail-reference.md#event-detail-server-events) | Falha na tentativa de fazer upload de um arquivo para o protocolo SFTP. |
**Outros eventos de operações de arquivos **
| Tipo de detalhe de evento | Description |
| --- | --- |
| [Criação do diretório do servidor FTP concluída ](events-detail-reference.md#event-detail-server-events) | Um diretório foi criado com sucesso para o protocolo FTP. |
| [Falha na criação do diretório do servidor FTP ](events-detail-reference.md#event-detail-server-events) | Uma tentativa de criar um diretório falhou para o protocolo FTP. |
| [Concluída a exclusão do diretório do servidor FTP ](events-detail-reference.md#event-detail-server-events) | Um diretório foi excluído com sucesso para o protocolo FTP. |
| [Falha na exclusão do diretório do servidor FTP ](events-detail-reference.md#event-detail-server-events) | Uma tentativa de excluir um diretório falhou para o protocolo FTP. |
| [Exclusão do arquivo do servidor FTP concluída ](events-detail-reference.md#event-detail-server-events) | Um arquivo foi excluído com sucesso para o protocolo FTP. |
| [Falha na exclusão do arquivo do servidor FTP ](events-detail-reference.md#event-detail-server-events) | Uma tentativa de excluir um arquivo falhou para o protocolo FTP. |
| [Renomeação do arquivo do servidor FTP concluída ](events-detail-reference.md#event-detail-server-events) | Um arquivo foi renomeado com sucesso para o protocolo FTP. |
| [Falha na renomeação do arquivo do servidor FTP ](events-detail-reference.md#event-detail-server-events) | Uma tentativa de renomear um arquivo falhou para o protocolo FTP. |
| [Criação do diretório do servidor FTPS concluída ](events-detail-reference.md#event-detail-server-events) | Um diretório foi criado com sucesso para o protocolo FTPS. |
| [Falha na criação do diretório do servidor FTPS ](events-detail-reference.md#event-detail-server-events) | Uma tentativa de criar um diretório falhou para o protocolo FTPS. |
| [Concluída a exclusão do diretório do servidor FTPS ](events-detail-reference.md#event-detail-server-events) | Um diretório foi excluído com sucesso para o protocolo FTPS. |
| [Falha na exclusão do diretório do servidor FTPS ](events-detail-reference.md#event-detail-server-events) | Uma tentativa de excluir um diretório falhou para o protocolo FTPS. |
| [Exclusão do arquivo do servidor FTPS concluída ](events-detail-reference.md#event-detail-server-events) | Um arquivo foi excluído com sucesso para o protocolo FTPS. |
| [Falha na exclusão do arquivo do servidor FTPS ](events-detail-reference.md#event-detail-server-events) | Uma tentativa de excluir um arquivo falhou para o protocolo FTPS. |
| [Renomeação do arquivo do servidor FTPS concluída ](events-detail-reference.md#event-detail-server-events) | Um arquivo foi renomeado com sucesso para o protocolo FTPS. |
| [Falha na renomeação do arquivo do servidor FTPS ](events-detail-reference.md#event-detail-server-events) | Uma tentativa de renomear um arquivo falhou para o protocolo FTPS. |
| [Criação do diretório do servidor SFTP concluída ](events-detail-reference.md#event-detail-server-events) | Um diretório foi criado com sucesso para o protocolo SFTP. |
| [Falha na criação do diretório do servidor SFTP ](events-detail-reference.md#event-detail-server-events) | Uma tentativa de criar um diretório falhou para o protocolo SFTP. |
| [Concluída a exclusão do diretório do servidor SFTP ](events-detail-reference.md#event-detail-server-events) | Um diretório foi excluído com êxito para o protocolo SFTP. |
| [Falha na exclusão do diretório do servidor SFTP ](events-detail-reference.md#event-detail-server-events) | Uma tentativa de excluir um diretório falhou para o protocolo SFTP. |
| [Exclusão do arquivo do servidor SFTP concluída ](events-detail-reference.md#event-detail-server-events) | Um arquivo foi excluído com sucesso para o protocolo SFTP. |
| [Falha na exclusão do arquivo do servidor SFTP ](events-detail-reference.md#event-detail-server-events) | Uma tentativa de excluir um arquivo falhou para o protocolo SFTP. |
| [Renomeação do arquivo do servidor SFTP concluída ](events-detail-reference.md#event-detail-server-events) | Um arquivo foi renomeado com sucesso para o protocolo SFTP. |
| [Falha na renomeação do arquivo do servidor SFTP ](events-detail-reference.md#event-detail-server-events) | Uma tentativa de renomear um arquivo falhou 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 ](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) na * Amazon EventBridge Events Reference*.
| Tipo de detalhe de evento | Description |
| --- | --- |
| [Envio do arquivo do conector SFTP concluído ](events-detail-reference.md#event-detail-sftp-connector-events) | A transferência de arquivos de um conector para um servidor SFTP remoto foi concluída com êxito. |
| [Falha no envio do arquivo do conector SFTP ](events-detail-reference.md#event-detail-sftp-connector-events) | A transferência de arquivos de um conector para um servidor SFTP remoto falhou. |
| [Recuperação do arquivo do conector SFTP concluída ](events-detail-reference.md#event-detail-sftp-connector-events) | A transferência de arquivos de um servidor SFTP remoto para um conector foi concluída com êxito. |
| [Falha na recuperação do arquivo do conector SFTP ](events-detail-reference.md#event-detail-sftp-connector-events) | A transferência de arquivos de um servidor SFTP remoto para um conector falhou. |
| [Lista de diretórios de conectores SFTP concluída ](events-detail-reference.md#event-detail-sftp-connector-events) | Uma chamada inicial de listagem de diretórios de arquivos que foi concluída com êxito. |
| [Falha na listagem do diretório de conectores SFTP ](events-detail-reference.md#event-detail-sftp-connector-events) | Uma listagem de diretórios de arquivos iniciais que falhou. |
| [Transferência remota do conector SFTP concluída ](events-detail-reference.md#event-detail-sftp-connector-events) | Arquivos ou diretórios foram movidos ou renomeados com sucesso no servidor remoto. |
| [Falha na movimentação remota do conector SFTP ](events-detail-reference.md#event-detail-sftp-connector-events) | Não foi possível mover ou renomear arquivos ou diretórios no servidor remoto. |
| [Exclusão remota do conector SFTP concluída ](events-detail-reference.md#event-detail-sftp-connector-events) | Arquivos ou diretórios foram excluídos com sucesso no servidor remoto. |
| [Falha na exclusão remota do conector SFTP ](events-detail-reference.md#event-detail-sftp-connector-events) | Não foi possível excluir arquivos ou diretórios no servidor remoto. |
### Eventos AS2
**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 ](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) na * Amazon EventBridge Events Reference*.
| Tipo de detalhe de evento | Description |
| --- | --- |
| [Recebimento da carga útil AS2 concluído ](events-detail-reference.md#event-detail-as2-server-events) | A carga útil de uma mensagem AS2 foi recebida. |
| [Falha na recepção do payload AS2 ](events-detail-reference.md#event-detail-as2-server-events) | A carga útil de uma mensagem AS2 não foi recebida. |
| [Envio da carga útil AS2 concluído ](events-detail-reference.md#event-detail-as2-server-events) | A carga útil de uma mensagem AS2 foi enviada com sucesso. |
| [Falha no envio do payload AS2 ](events-detail-reference.md#event-detail-as2-server-events) | A carga útil de uma mensagem AS2 falhou ao ser enviada. |
| [Recebimento do AS2 MDN concluído ](events-detail-reference.md#event-detail-as2-server-events) | A notificação de disposição da mensagem para uma mensagem AS2 foi recebida. |
| [Falha na recepção do AS2 MDN ](events-detail-reference.md#event-detail-as2-server-events) | A notificação de disposição da mensagem para uma mensagem AS2 não foi recebida. |
| [Envio AS2 MDN concluído ](events-detail-reference.md#event-detail-as2-server-events) | A notificação de disposição da mensagem para uma mensagem AS2 foi enviada com sucesso. |
| [Falha no envio do AS2 MDN ](events-detail-reference.md#event-detail-as2-server-events) | A notificação de disposição da mensagem para uma mensagem AS2 falhou ao ser enviada. |
## Enviando 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 nos 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/](https://console.aws.amazon.com/events/).
1. No painel de navegação, escolha ** Regras ** e escolha ** Criar regra**.
1. Insira um nome descritivo para a regra e, opcionalmente, insira uma descrição.
1. **Em Tipo de regra**, selecione ** Regra com um padrão de evento ** e escolha ** Avançar**.
1. Na ** seção Fonte do ** evento, selecione **AWS eventos ou eventos de EventBridge parceiros**.
1. Na ** seção Método de ** criação, escolha ** Usar formulário padrão**.
1. Na ** seção Padrão de ** eventos, forneça as seguintes informações.
1. Em **Fonte do evento**, selecione **Serviços da AWS **.
1. Para o **AWS serviço**, escolha ** Transferir**.
1. **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 de Especificação de tipo de ** evento 1.
1. 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).
1. (Opcional) Use o ** editor de padrões de ** eventos para especificar filtros para detalhes do evento.
1. Escolha **Próximo**.
1. Escolha um alvo dentre as opções disponíveis em ** Selecionar alvos**. Escolha entre os seguintes alvos disponíveis.
+ **AWS serviço**. As opções populares são funções do 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 fora de AWS, você pode usar um destino de API como seu destino.
+ **EventBridge ônibus de eventos**. Você pode enviar eventos para outro barramento 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 ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) no Guia EventBridge do usuário da * Amazon*.
Para obter ajuda na seleção de um alvo, consulte [ Selecionar destinos ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html#eb-create-rule-target) no Guia EventBridge do usuário * da Amazon*.
1. Configure todas as opções adicionais para seu alvo e escolha ** Avançar**.
1. (Opcional) Adicione tags à sua regra e escolha ** Avançar**.
1. Na ** tela ** Revisar e criar, se tudo estiver correto, escolha ** Criar regra**.
### Criação de padrões de eventos para Transfer Family eventos
Ao Transfer Family entregar um evento ao barramento de eventos padrão, EventBridge usa o padrão de eventos definido para cada regra para determinar se o evento deve ser entregue aos alvos 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 combinados.
+ (Opcional) Um `detail` atributo contendo quaisquer outros dados de eventos aos quais corresponder.
Por exemplo, o padrão de evento 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 da Transfer Family:
```
{
"source": ["aws.transfer"],
"detail-type": [{"wildcard", "*Failed"}]
}
```
O exemplo de padrão de evento a seguir corresponde aos downloads de SFTP bem-sucedidos para o usuário{{username}}:
```
{
"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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) no *Guia do usuário do EventBridge *.
### Testando padrões de eventos para Transfer Family 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 ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-pattern-sandbox.html) no Guia * do *EventBridge usuário.
## Amazon EventBridge permissões
Transfer Family não exige nenhuma permissão adicional para entregar eventos Amazon EventBridge a.
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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html) no *Guia do usuário do Amazon EventBridge *.
## Adicional EventBridge recursos
Consulte os tópicos a seguir no Guia do [*Amazon EventBridge usuário *](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html).
+ Para obter informações sobre a estrutura de eventos, consulte [Eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)
+ Para obter informações sobre a construção de padrões de eventos EventBridge para usar ao comparar eventos com regras, consulte Padrões [ de ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) eventos.
+ Para obter informações sobre a criação de regras para especificar quais eventos são processados pelo EventBridge , consulte [Regras](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html).
+ Para obter informações sobre como especificar quais serviços ou outros destinos EventBridge enviam eventos correspondentes, consulte [ Destinos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html).