기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
를 사용하여 Transfer Family 이벤트 관리 Amazon EventBridge
Amazon EventBridge 는 이벤트를 사용하여 애플리케이션 구성 요소를 함께 연결하는 서버리스 서비스로, 확장 가능한 이벤트 기반 애플리케이션을 더 쉽게 구축할 수 있습니다. 이벤트 기반 아키텍처는 이벤트를 내보내고 대응하여 함께 작동하는 느슨하게 결합된 소프트웨어 시스템을 구축하는 스타일입니다. 이벤트는 리소스나 환경의 변화를 나타냅니다.
많은 AWS 서비스와 마찬가지로는 이벤트를 Transfer Family 생성하고 EventBridge 기본 이벤트 버스로 전송합니다. 기본 이벤트 버스는 모든 AWS 계정에 자동으로 프로비저닝됩니다. 이벤트 버스는 이벤트를 수신하여 0개 이상의 목적지 또는 대상에 전달하는 라우터입니다. 이벤트가 도착할 때 이벤트를 평가하는 이벤트 버스에 대한 규칙을 지정합니다. 각 규칙은 이벤트가 규칙의 이벤트 패턴과 일치하는지 여부를 확인합니다. 이벤트가 일치하는 경우 이벤트 버스는 이벤트를 하나 이상의 지정된 대상으로 보냅니다.
주제
Transfer Family 이벤트
Transfer Family 는 이벤트를 기본 이벤트 EventBridge 버스로 자동 전송합니다. 각 규칙에 이벤트 패턴과 하나 이상의 대상이 포함된 이벤트 버스에 규칙을 생성할 수 있습니다.
규칙의 이벤트 패턴과 일치하는 이벤트는 최선의 노력 또는 내구성을 기준으로 지정된 대상으로 전달됩니다(일부 이벤트는 순서에 맞지 않게 전달될 수 있음). 이러한 전송 수준은 Amazon EventBridge 이벤트 참조의 AWS 서비스 이벤트에 대한 전송 수준에 설명되어 있습니다.
-
SFTP, FTPS 및 FTP 서버에 대한 서버 수준 이벤트는 최대한 제공됩니다.
-
SFTP 커넥터 이벤트는 내구성을 기반으로 전달됩니다.
-
AS2 이벤트는 내구성을 기반으로 전달됩니다.
다음 이벤트는에서 생성됩니다 Transfer Family. 자세한 내용을 알아보려면 Amazon EventBridge 사용 설명서의 EventBridge 이벤트를 참조하세요.
SFTP, FTPS 및 FTP 서버 이벤트
다음 표에는 이벤트 유형별로 구성된 SFTP, FTPS 및 FTP 서버의 이벤트가 나열되어 있습니다.
파일 업로드 및 다운로드 이벤트
| 이벤트 세부 정보 유형 | 설명 |
|---|---|
|
FTP 프로토콜에 대한 파일이 성공적으로 다운로드되었습니다. |
|
|
FTP 프로토콜에 대한 파일 다운로드 시도가 실패했습니다. |
|
|
FTP 프로토콜에 대한 파일이 성공적으로 업로드되었습니다. |
|
|
FTP 프로토콜에 대한 파일 업로드 시도가 실패했습니다. |
|
|
FTPS 프로토콜에 대한 파일이 성공적으로 다운로드되었습니다. |
|
|
FTPS 프로토콜에 대한 파일 다운로드 시도가 실패했습니다. |
|
|
FTPS 프로토콜에 대한 파일이 성공적으로 업로드되었습니다. |
|
|
FTPS 프로토콜에 대한 파일 업로드 시도가 실패했습니다. |
|
|
SFTP 프로토콜에 대한 파일이 성공적으로 다운로드되었습니다. |
|
|
SFTP 프로토콜에 대한 파일 다운로드 시도가 실패했습니다. |
|
|
SFTP 프로토콜에 대한 파일이 성공적으로 업로드되었습니다. |
|
|
SFTP 프로토콜에 대한 파일 업로드 시도가 실패했습니다. |
기타 파일 작업 이벤트
| 이벤트 세부 정보 유형 | 설명 |
|---|---|
|
FTP 프로토콜에 대한 디렉터리가 성공적으로 생성되었습니다. |
|
|
FTP 프로토콜에 대한 디렉터리 생성 시도가 실패했습니다. |
|
|
FTP 프로토콜에 대한 디렉터리가 성공적으로 삭제되었습니다. |
|
|
FTP 프로토콜에 대한 디렉터리 삭제 시도가 실패했습니다. |
|
|
FTP 프로토콜에 대한 파일이 성공적으로 삭제되었습니다. |
|
|
FTP 프로토콜에 대한 파일 삭제 시도가 실패했습니다. |
|
|
FTP 프로토콜의 파일 이름이 성공적으로 변경되었습니다. |
|
|
FTP 프로토콜에 대한 파일 이름 변경 시도가 실패했습니다. |
|
|
FTPS 프로토콜에 대한 디렉터리가 성공적으로 생성되었습니다. |
|
|
FTPS 프로토콜에 대한 디렉터리 생성 시도가 실패했습니다. |
|
|
FTPS 프로토콜에 대한 디렉터리가 성공적으로 삭제되었습니다. |
|
|
FTPS 프로토콜에 대한 디렉터리 삭제 시도가 실패했습니다. |
|
|
FTPS 프로토콜에 대한 파일이 성공적으로 삭제되었습니다. |
|
|
FTPS 프로토콜에 대한 파일 삭제 시도가 실패했습니다. |
|
|
FTPS 프로토콜의 파일 이름이 성공적으로 변경되었습니다. |
|
|
FTPS 프로토콜에 대한 파일 이름 변경 시도가 실패했습니다. |
|
|
SFTP 프로토콜에 대한 디렉터리가 성공적으로 생성되었습니다. |
|
|
SFTP 프로토콜에 대한 디렉터리 생성 시도가 실패했습니다. |
|
|
SFTP 프로토콜에 대한 디렉터리가 성공적으로 삭제되었습니다. |
|
|
SFTP 프로토콜에 대한 디렉터리 삭제 시도가 실패했습니다. |
|
|
SFTP 프로토콜에 대한 파일이 성공적으로 삭제되었습니다. |
|
|
SFTP 프로토콜에 대한 파일 삭제 시도가 실패했습니다. |
|
|
SFTP 프로토콜의 파일 이름이 성공적으로 변경되었습니다. |
|
|
SFTP 프로토콜에 대한 파일 이름 변경 시도가 실패했습니다. |
SFTP 커넥터 이벤트
참고
이러한 이벤트는 Amazon EventBridge 이벤트 참조의 AWS 서비스 이벤트에 대한 전송 수준에 설명된 대로 내구성 있는 수준으로 EventBridge에 전달됩니다. EventBridge
| 이벤트 세부 정보 유형 | 설명 |
|---|---|
| 커넥터에서 원격 SFTP 서버로의 파일 전송이 성공적으로 완료되었습니다. | |
| 커넥터에서 원격 SFTP 서버로의 파일 전송이 실패했습니다. | |
| 원격 SFTP 서버에서 커넥터로의 파일 전송이 성공적으로 완료되었습니다. | |
| 원격 SFTP 서버에서 커넥터로의 파일 전송이 실패했습니다. | |
| 성공적으로 완료된 호출을 나열하는 시작 파일 디렉터리입니다. | |
| 실패한 시작 파일 디렉터리 목록입니다. | |
| 파일 또는 디렉터리가 원격 서버에서 성공적으로 이동되었거나 이름이 변경되었습니다. | |
| 원격 서버에서 파일 또는 디렉터리를 이동하거나 이름을 바꾸지 못했습니다. | |
| 원격 서버에서 파일 또는 디렉터리가 성공적으로 삭제되었습니다. | |
| 원격 서버에서 파일 또는 디렉터리를 삭제하지 못했습니다. |
AS2 이벤트
참고
이러한 이벤트는 Amazon EventBridge 이벤트 참조의 AWS 서비스 이벤트에 대한 전송 수준에 설명된 대로 내구성 있는 수준으로 EventBridge에 전달됩니다. EventBridge
| 이벤트 세부 정보 유형 | 설명 |
|---|---|
| AS2 메시지의 페이로드를 수신했습니다. | |
| AS2 메시지의 페이로드가 수신되지 않았습니다. | |
| AS2 메시지의 페이로드가 성공적으로 전송되었습니다. | |
| AS2 메시지의 페이로드가 전송되지 않았습니다. | |
| AS2 메시지에 대한 메시지 처리 알림이 수신되었습니다. | |
| AS2 메시지에 대한 메시지 처리 알림이 수신되지 않았습니다. | |
| AS2 메시지에 대한 메시지 처리 알림이 성공적으로 전송되었습니다. | |
| AS2 메시지에 대한 메시지 처리 알림이 전송되지 않았습니다. |
EventBridge 규칙을 사용하여 Transfer Family 이벤트 전송
EventBridge 기본 이벤트 버스가 Transfer Family 이벤트를 대상으로 보내도록 하려면 원하는 이벤트의 데이터와 일치하는 Transfer Family 이벤트 패턴이 포함된 규칙을 생성해야 합니다.
Amazon EventBridge에서 AWS Transfer Family 이벤트를 캡처하려면
-
에 로그인 AWS Management Console 하고 https://console.aws.amazon.com/events/
Amazon EventBridge 콘솔을 엽니다. -
탐색 창에서 규칙을 선택한 다음 규칙 생성을 선택합니다.
-
규칙에 대한 설명 이름을 입력하고 선택적으로 설명을 입력합니다.
-
규칙 유형에서 이벤트 패턴이 있는 규칙을 선택한 후 다음을 선택합니다.
-
이벤트 소스 섹션에서 AWS 이벤트 또는 EventBridge 파트너 이벤트를 선택합니다.
-
생성 방법 섹션에서 패턴 양식 사용을 선택합니다.
-
이벤트 패턴 섹션에서 다음 정보를 제공합니다.
-
이벤트 소스에서 AWS 서비스를 선택합니다.
-
AWS 서비스에서 전송을 선택합니다.
-
이벤트 유형에서 규칙을 트리거할 Transfer Family 이벤트 유형을 선택합니다.
이벤트 유형 선택에 따라 이벤트 유형 사양 1 섹션이 표시될 수 있습니다.
-
이벤트 유형 사양 1 섹션이 표시되면 캡처하려는 특정 이벤트를 선택합니다(또는 모든 이벤트를 선택하여 선택한 이벤트 유형에 대한 모든 이벤트를 캡처).
-
(선택 사항) 이벤트 패턴 편집기를 사용하여 이벤트 세부 정보에 대한 필터를 지정합니다.
-
다음을 선택합니다.
-
-
대상 선택에서 사용할 수 있는 선택 항목 중에서 대상을 선택합니다. 다음 사용 가능한 대상 중에서 선택합니다.
-
AWS 서비스. 인기 있는 옵션은 서버리스 컴퓨팅을 위한 Lambda 함수, 메시지 처리를 위한 Amazon SQS 대기열, 알림을 위한 Amazon SNS 주제, AWS Step Functions 워크플로 오케스트레이션입니다.
-
EventBridge API 대상. 외부의 HTTP 엔드포인트로 이벤트를 보내려면 API 대상을 대상으로 사용할 AWS수 있습니다.
-
EventBridge 이벤트 버스. 동일한 계정 및 리전 또는 다른 계정 또는 리전의 다른 이벤트 버스로 이벤트를 보낼 수 있습니다.
이벤트 버스 규칙 생성에 대한 포괄적인 지침은 Amazon EventBridge 사용 설명서의 Creating rules that react to events를 참조하세요.
대상 선택에 대한 도움말은 Amazon EventBridge 사용 설명서의 대상 선택을 참조하세요.
-
-
대상에 대한 추가 옵션을 구성한 후 다음을 선택합니다.
-
(선택 사항) 규칙에 태그를 추가하고 다음을 선택합니다.
-
검토 및 생성 화면에서 모든 것이 양호한 경우 규칙 생성을 선택합니다.
이벤트에 대한 Transfer Family 이벤트 패턴 생성
가 이벤트를 기본 이벤트 버스로 Transfer Family 전송할 때는 각 규칙에 대해 정의된 이벤트 패턴을 EventBridge 사용하여 이벤트를 규칙의 대상으로 전달해야 하는지 여부를 결정합니다. 이벤트 패턴이 원하는 Transfer Family 이벤트의 데이터와 일치합니다. 각 이벤트 패턴은 다음을 포함하는 JSON 객체입니다.
-
이벤트를 전송하는 서비스를 식별하는
source속성입니다. Transfer Family 이벤트의 경우 소스는 입니다aws.transfer. -
(선택 사항) 일치시킬 이벤트 유형의 배열을 포함하는
detail-type속성입니다. -
(선택 사항) 일치시킬 다른 이벤트 데이터를 포함하는
detail속성입니다.
예를 들어 다음 이벤트 패턴은의 모든 이벤트와 일치합니다. Transfer Family
{ "source": ["aws.transfer"] }
다음 이벤트 패턴 예제는 모든 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"] }
다음 이벤트 패턴 예제는 모든 Transfer Family 실패 이벤트와 일치합니다.
{ "source": ["aws.transfer"], "detail-type": [{"wildcard", "*Failed"}] }
다음 이벤트 패턴 예제는 사용자 사용자 이름에 대한 성공적인 SFTP 다운로드와 일치합니다.
{ "source": ["aws.transfer"], "detail-type": ["SFTP Server File Download Completed"], "detail": { "username": [username] } }
자세한 내용은 EventBridge 사용 설명서의 이벤트 패턴을 참조하세요.
에서 이벤트에 대한 Transfer Family 이벤트 패턴 테스트 EventBridge
EventBridge 샌드박스를 사용하면 규칙을 생성하거나 편집하는 광범위한 프로세스를 완료할 필요 없이 이벤트 패턴을 빠르게 정의하고 테스트할 수 있습니다. 샌드박스를 사용하여 이벤트 패턴을 정의하고 샘플 이벤트를 사용하여 패턴이 원하는 이벤트와 일치하는지 확인할 수 있습니다. EventBridge 샌드박스에서 직접 해당 이벤트 패턴을 사용하여 새 규칙을 생성할 수 있는 옵션을 제공합니다.
자세한 내용은 EventBridge 사용 설명서의 EventBridge 샌드박스를 사용하여 이벤트 패턴 테스트를 참조하세요.
Amazon EventBridge 권한
Transfer Family 에는 이벤트를 전달하는 데 추가 권한이 필요하지 않습니다 Amazon EventBridge.
지정하는 대상에는 특정 권한 또는 구성이 필요할 수 있습니다. 대상에 특정 서비스를 사용하는 방법에 대한 자세한 내용은 Amazon EventBridge 사용 설명서의 Amazon EventBridge 대상을 참조하세요.
추가적인 EventBridge 리소스
를 사용하여 이벤트를 처리하고 관리하는 방법에 대한 자세한 내용은 Amazon EventBridge 사용 설명서의 다음 주제를 참조 EventBridge 하세요.
-
이벤트 버스의 작동 방식에 대한 자세한 내용은 Amazon EventBridge 이벤트 버스를 참조하세요.
-
이벤트 구조에 대해 자세히 알아보려면 이벤트를 참조하세요.
-
가 이벤트를 규칙과 일치 EventBridge 시킬 때 사용할 이벤트 패턴을 구성하는 방법에 대한 자세한 내용은 이벤트 패턴을 참조하세요.
-
EventBridge 에서 처리하는 이벤트를 지정하는 규칙을 생성하는 방법에 대한 자세한 내용은 규칙을 참조하세요.
-
가 일치하는 이벤트를 EventBridge 전송하는 서비스 또는 기타 대상을 지정하는 방법에 대한 자세한 내용은 대상을 참조하세요.