기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Transfer Family 이벤트 세부 정보 참조
<a name="events-detail-reference"></a>

 AWS 서비스의 모든 이벤트에는 이벤트에 대한 메타데이터가 포함된 공통 필드 세트가 있습니다. 이러한 메타데이터에는 이벤트의 소스인 AWS 서비스, 이벤트가 생성된 시간, 이벤트가 발생한 계정 및 리전 등이 포함될 수 있습니다. 이러한 일반 필드에 대한 정의는 **Amazon EventBridge 사용 설명서의 [이벤트 구조 참조](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)를 참조하세요.

또한 각 이벤트에는 해당 특정 이벤트와 관련된 데이터를 포함하는 `detail` 필드가 있습니다. 다음 참조에서는 다양한 Transfer Family 이벤트에 대한 세부 정보 필드를 정의합니다.

 EventBridge 를 사용하여 Transfer Family 이벤트를 선택하고 관리할 때는 다음 사항을 고려하세요.
+ 의 모든 이벤트에 대한 `source` 필드는 로 Transfer Family 설정됩니다`aws.transfer`.
+ `detail-type` 필드는 이벤트 유형을 지정합니다.

  예를 들어 `FTP Server File Download Completed`입니다.
+ `detail` 필드는 해당 특정 이벤트와 관련된 데이터를 포함합니다.

 Transfer Family 이벤트와 일치하는 규칙을 활성화하는 이벤트 패턴을 구성하는 방법에 대한 자세한 내용은 **Amazon EventBridge 사용 안내서의 [이벤트 패턴](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)을 참조하세요.

이벤트 및에서 이벤트를 EventBridge 처리하는 방법에 대한 자세한 내용은 *Amazon EventBridge 사용 설명서*의 [Amazon EventBridge 이벤트를](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) 참조하세요.

**Topics**
+ [SFTP, FTPS 및 FTP 서버 이벤트](#event-detail-server-events)
+ [SFTP 커넥터 이벤트](#event-detail-sftp-connector-events)
+ [AS2 이벤트](#event-detail-as2-server-events)

## SFTP, FTPS 및 FTP 서버 이벤트
<a name="event-detail-server-events"></a>

다음은 SFTP, FTPS 및 FTP 서버 이벤트에 대한 세부 정보 필드입니다.
+ FTP 서버 디렉터리 생성 완료
+ FTP 서버 디렉터리 생성 실패
+ FTP 서버 디렉터리 삭제 완료
+ FTP 서버 디렉터리 삭제 실패
+ FTP 서버 파일 삭제 완료
+ FTP 서버 파일 삭제 실패
+ FTP 서버 파일 다운로드 완료
+ FTP 서버 파일 다운로드 실패
+ FTP 서버 파일 이름 변경 완료
+ FTP 서버 파일 이름 변경 실패
+ FTP 서버 파일 업로드 완료
+ FTP 서버 파일 업로드 실패
+ FTPS 서버 디렉터리 생성 완료
+ FTPS 서버 디렉터리 생성 실패
+ FTPS 서버 디렉터리 삭제 완료
+ FTPS 서버 디렉터리 삭제 실패
+ FTPS 서버 파일 삭제 완료
+ FTPS 서버 파일 삭제 실패
+ FTPS 서버 파일 다운로드 완료
+ FTPS 서버 파일 다운로드 실패
+ FTPS 서버 파일 이름 변경 완료
+ FTPS 서버 파일 이름 변경 실패
+ FTPS 서버 파일 업로드 완료
+ FTPS 서버 파일 업로드 실패
+ SFTP 서버 디렉터리 생성 완료
+ SFTP 서버 디렉터리 생성 실패
+ SFTP 서버 디렉터리 삭제 완료
+ SFTP 서버 디렉터리 삭제 실패
+ SFTP 서버 파일 삭제 완료
+ SFTP 서버 파일 삭제 실패
+ SFTP 서버 파일 다운로드 완료
+ SFTP 서버 파일 다운로드 실패
+ SFTP 서버 파일 이름 변경 완료
+ SFTP 서버 파일 이름 변경 실패
+ SFTP 서버 파일 업로드 완료
+ SFTP 서버 파일 업로드 실패

`source` 및 `detail-type` 필드는 Transfer Family 이벤트에 대한 특정 값을 포함하므로 아래에 포함되어 있습니다. 모든 이벤트에 포함된 다른 메타데이터 필드의 정의는 *Amazon EventBridge 사용 설명서*의 [이벤트 구조 참조](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)를 참조하세요.

```
{
  . . .,
  "detail-type": "string",
  "source": "aws.transfer",
  . . .,
  "detail": {
    "failure-code" : "string",
    "status-code" : "string",
    "protocol" : "string",
    "bytes" : "number",
    "client-ip" : "string",
    "failure-message" : "string",
    "end-timestamp" : "string",
    "etag" : "string",
    "file-path" : "string",
    "original-file-path" : "string",
    "renamed-file-path" : "string",
    "directory-path" : "string",
    "server-id" : "string",
    "username" : "string",
    "session-id" : "string",
    "start-timestamp" : "string"
  }
}
```

`detail-type`  <a name="event-detail-server-events-detail-type"></a>
이벤트의 유형을 식별합니다.  
이 이벤트의 경우 값은 이전에 나열된 SFTP, FTPS 또는 FTP 서버 이벤트 이름 중 하나입니다.

`source`  <a name="event-detail-server-events-source"></a>
이벤트를 생성한 서비스를 식별합니다. Transfer Family 이벤트의 경우이 값은 입니다`aws.transfer`.

`detail`  <a name="sftp-server-detail"></a>
이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다.  
이 이벤트의 경우 데이터에는 다음이 포함됩니다.    
`failure-code`  <a name="sftp-server-failure-code"></a>
전송이 실패한 이유에 대한 범주입니다. 값: `PARTIAL_UPLOAD | PARTIAL_DOWNLOAD | UNKNOWN_ERROR`  
`status-code`  <a name="sftp-server-status-code"></a>
전송 성공 여부입니다. 값: `COMPLETED | FAILED`.  
`protocol`  <a name="sftp-server-protocol"></a>
전송에 사용되는 프로토콜입니다. 값: `SFTP | FTPS | FTP`  
`bytes`  <a name="sftp-server-bytes"></a>
전송되는 바이트 수입니다.  
`client-ip`  <a name="sftp-server-client-ip"></a>
전송과 관련된 클라이언트의 IP 주소  
`failure-message`  <a name="sftp-server-failure-message"></a>
전송이 실패한 경우 전송이 실패한 이유에 대한 세부 정보입니다.  
`end-timestamp`  <a name="sftp-server-end-timestamp"></a>
전송에 성공하려면 파일 처리가 완료된 시점의 타임스탬프입니다.  
`etag`  <a name="sftp-server-etag"></a>
개체 태그(Amazon S3 파일에만 사용됨).  
`file-path`  <a name="sftp-server-file-path"></a>
전송, 삭제 또는 달리 운영되는 파일의 경로입니다.  
`original-file-path`  <a name="sftp-server-original-file-path"></a>
파일 이름 바꾸기 이벤트의 경우 이름을 바꾸기 전에 파일의 원래 경로입니다.  
`renamed-file-path`  <a name="sftp-server-renamed-file-path"></a>
파일 이름 변경 이벤트의 경우 이름 변경 후 파일의 새 경로입니다.  
`directory-path`  <a name="sftp-server-directory-path"></a>
디렉터리 생성 및 삭제 이벤트의 경우 디렉터리의 경로입니다.  
`server-id`  <a name="sftp-server-server-id"></a>
Transfer Family 서버의 고유 ID입니다.  
`username`  <a name="sftp-server-username"></a>
전송을 수행하는 사용자입니다.  
`session-id`  <a name="sftp-server-session-id"></a>
전송 세션의 고유 식별자입니다.  
`start-timestamp`  <a name="sftp-server-start-timestamp"></a>
전송에 성공하려면 파일 처리가 시작되는 시점의 타임스탬프입니다.

**Example SFTP 서버 파일 다운로드 실패 예제 이벤트**  <a name="event-detail-server-events.example"></a>
다음 예제는 SFTP 서버에서 다운로드가 실패한 이벤트를 보여줍니다(사용 중인 스토리지Amazon EFS ).  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server File Download Failed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2024-01-29T17:20:27Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "failure-code": "PARTIAL_DOWNLOAD",
        "status-code": "FAILED",
        "protocol": "SFTP",
        "bytes": 4100,
        "client-ip": "IP-address",
        "failure-message": "File was partially downloaded.",
        "end-timestamp": "2024-01-29T17:20:27.749749117Z",
        "file-path": "/fs-1234abcd5678efghi/user0/test-file",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2024-01-29T17:20:16.706282454Z"
    }
}
```

**Example FTP 서버 파일 업로드 완료됨 예제 이벤트**  <a name="event-detail-server-events.example"></a>
다음 예제는 FTP 서버에서 업로드가 성공적으로 완료된 이벤트를 보여줍니다(사용 중인 스토리지Amazon S3 ).  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "FTP Server File Upload Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2024-01-29T16:31:43Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1111aaaa2222bbbb3"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "FTP",
        "bytes": 1048576,
        "client-ip": "10.0.0.141",
        "end-timestamp": "2024-01-29T16:31:43.311866408Z",
        "etag": "b6d81b360a5672d80c27430f39153e2c",
        "file-path": "/amzn-s3-demo-bucket/test/1mb_file",
        "server-id": "s-1111aaaa2222bbbb3",
        "username": "test",
        "session-id": "event-ID",
        "start-timestamp": "2024-01-29T16:31:42.462088327Z"
    }
}
```

**Example SFTP 서버 파일 삭제 완료됨 예제 이벤트**  <a name="event-detail-server-events.example"></a>
다음 예제는 SFTP 서버에서 파일이 성공적으로 삭제된 이벤트를 보여줍니다.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server File Delete Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2025-05-15T14:30:27Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "SFTP",
        "client-ip": "IP-address",
        "end-timestamp": "2025-05-15T14:30:27.749749117Z",
        "file-path": "/fs-1234abcd5678efghi/user0/test-file-to-delete.txt",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2025-05-15T14:30:26.706282454Z"
    }
}
```

**Example SFTP 서버 파일 이름 바꾸기 완료된 예제 이벤트**  <a name="event-detail-server-events.example"></a>
다음 예제는 SFTP 서버에서 파일 이름이 성공적으로 변경된 이벤트를 보여줍니다.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server File Rename Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2025-05-15T15:45:12Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "SFTP",
        "client-ip": "IP-address",
        "end-timestamp": "2025-05-15T15:45:12.749749117Z",
        "original-file-path": "/fs-1234abcd5678efghi/user0/old-filename.txt",
        "renamed-file-path": "/fs-1234abcd5678efghi/user0/new-filename.txt",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2025-05-15T15:45:11.706282454Z"
    }
}
```

**Example SFTP 서버 디렉터리 완료된 예제 이벤트 생성**  <a name="event-detail-server-events.example"></a>
다음 예제는 SFTP 서버에서 디렉터리가 성공적으로 생성된 이벤트를 보여줍니다.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server Directory Create Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2025-05-15T16:20:05Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "SFTP",
        "client-ip": "IP-address",
        "end-timestamp": "2025-05-15T16:20:05.749749117Z",
        "directory-path": "/fs-1234abcd5678efghi/user0/new-directory",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2025-05-15T16:20:04.706282454Z"
    }
}
```

## SFTP 커넥터 이벤트
<a name="event-detail-sftp-connector-events"></a>

**참고**  
이러한 이벤트는 Amazon EventBridge 이벤트 참조의 [AWS 서비스 이벤트에 대한 전송 수준에 설명된 대로 내구성 있는 수준으로](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) EventBridge에 전달됩니다. * EventBridge *

다음은 SFTP 커넥터 이벤트에 대한 세부 정보 필드입니다.
+ SFTP 커넥터 파일 전송 완료
+ SFTP 커넥터 파일 전송 실패
+ SFTP 커넥터 파일 검색 완료
+ SFTP 커넥터 파일 검색 실패
+ SFTP 커넥터 디렉터리 목록 작성 완료
+ SFTP 커넥터 디렉터리 나열 실패
+ SFTP 커넥터 원격 이동 완료
+ SFTP 커넥터 원격 이동 실패
+ SFTP 커넥터 원격 삭제 완료
+ SFTP 커넥터 원격 삭제 실패

`source` 및 `detail-type` 필드는 Transfer Family 이벤트에 대한 특정 값을 포함하므로 아래에 포함되어 있습니다. 모든 이벤트에 포함된 다른 메타데이터 필드의 정의는 *Amazon EventBridge 사용 설명서*의 [이벤트 구조 참조](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)를 참조하세요.

```
{
  . . .,
  "detail-type": "string",
  "source": "aws.transfer",
  . . .,
  "detail": {
    "operation" : "string",
    "max-items" : "number",
    "connector-id" : "string",
    "output-directory-path" : "string",
    "listing-id" : "string",
    "transfer-id" : "string",
    "file-transfer-id" : "string",
    "url" : "string",
    "file-path" : "string",
    "status-code" : "string",
    "failure-code" : "string",
    "failure-message" : "string",
    "start-timestamp" : "string",
    "end-timestamp" : "string",
    "local-directory-path" : "string",
    "remote-directory-path" : "string"
    "item-count" : "number"
    "truncated" : "boolean"
    "bytes" : "number",
    "egress-type" : "string",
    "vpc-lattice-resource-configuration-arn" : "string",
    "vpc-lattice-port-number" : "number",
    "local-file-location" : {
      "domain" : "string",
      "bucket" : "string",
      "key" : "string"
    },
    "output-file-location" : {
      "domain" : "string",
      "bucket" : "string",
      "key" : "string"
    }
  }
}
```

`detail-type`  <a name="event-detail-sftp-connector-events-detail-type"></a>
이벤트의 유형을 식별합니다.  
이 이벤트의 경우 값은 이전에 나열된 SFTP 커넥터 이벤트 이름 중 하나입니다.

`source`  <a name="event-detail-sftp-connector-events-source"></a>
이벤트를 생성한 서비스를 식별합니다. Transfer Family 이벤트의 경우이 값은 입니다`aws.transfer`.

`detail`  <a name="sftp-connector-detail"></a>
이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스는이 필드의 내용을 결정합니다.  
이 이벤트의 경우 데이터에는 다음이 포함됩니다.    
`max-items`  <a name="sftp-connector-max-items"></a>
반환할 최대 디렉터리/파일 이름 수입니다.  
`operation`  <a name="sftp-connector-operation"></a>
`StartFileTransfer` 요청이 파일을 보내는지 아니면 가져오는지 여부입니다. 값: `SEND|RETRIEVE`.  
`connector-id`  <a name="sftp-connector-connector-id"></a>
사용 중인 SFTP 커넥터의 고유 식별자입니다.  
`output-directory-path`  <a name="sftp-connector-output-directory-path"></a>
파일/디렉터리 목록의 결과를 저장할 Amazon S3의 경로(버킷 및 접두사)입니다.  
`listing-id`  <a name="sftp-connector-listing-id"></a>
`StartDirectoryListing` API 작업의 고유 식별자입니다. 이 식별자를 사용하여 CloudWatch 로그를 확인하여 요청 나열 상태를 확인할 수 있습니다.  
`transfer-id`  <a name="sftp-connector-transfer-id"></a>
전송 이벤트(`StartFileTransfer`요청)의 고유 식별자입니다.  
`file-transfer-id`  <a name="sftp-connector-file-transfer-id"></a>
전송 중인 파일의 고유 식별자입니다.  
`url`  <a name="sftp-connector-url"></a>
파트너의 AS2 또는 SFTP 엔드포인트의 URL입니다.  
`file-path`  <a name="sftp-connector-file-path"></a>
전송 또는 검색되는 위치 및 파일입니다.  
`status-code`  <a name="sftp-connector-status-code"></a>
전송 성공 여부입니다. 값: `FAILED | COMPLETED`.  
`failure-code`  <a name="sftp-connector-failure-code"></a>
전송이 실패한 경우 전송이 실패한 이유 코드입니다.  
`failure-message`  <a name="sftp-connector-failure-message"></a>
전송이 실패한 경우 전송이 실패한 이유에 대한 세부 정보입니다.  
`start-timestamp`  <a name="sftp-connector-start-timestamp"></a>
성공적인 전송을 위해 파일 처리가 시작되는 시점의 타임스탬프입니다.  
`end-timestamp`  <a name="sftp-connector-end-timestamp"></a>
전송에 성공하려면 파일 처리가 완료될 때의 타임스탬프입니다.  
`local-directory-path`  <a name="sftp-connector-local-directory-path"></a>
`RETRIEVE` 요청의 경우 검색된 파일을 배치할 위치입니다.  
`remote-directory-path`  <a name="sftp-connector-remote-directory-path"></a>
`SEND` 요청의 경우 파트너의 SFTP 서버에 파일을 배치할 파일 디렉터리입니다. 사용자가 `StartFileTransfer` 요청에 전달`RemoteDirectoryPath`한의 값입니다. 파트너의 SFTP 서버에서 기본 디렉터리를 지정할 수 있습니다. 그렇다면이 필드는 비어 있습니다.  
`item-count`  <a name="sftp-connector-item-count"></a>
목록 요청에 대해 반환된 항목(디렉터리 및 파일) 수입니다.  
`truncated`  <a name="sftp-connector-truncated"></a>
목록 출력에 원격 디렉터리에 포함된 모든 항목이 포함되어 있는지 여부입니다.  
`bytes`  <a name="sftp-connector-bytes"></a>
전송 중인 바이트 수입니다. 전송 실패의 경우 값은 0입니다.  
`egress-type`  <a name="sftp-connector-egress-type"></a>
커넥터의 송신 구성 유형입니다. 값: `SERVICE_MANAGED` 또는 `VPC_LATTICE`.  
`vpc-lattice-resource-configuration-arn`  <a name="sftp-connector-vpc-lattice-resource-configuration-arn"></a>
대상 SFTP 서버 위치를 정의하는 VPC\$1LATTICE 리소스 구성의 ARN입니다. 서비스 관리형 커넥터의 경우이 필드는 null입니다.  
`vpc-lattice-port-number`  <a name="sftp-connector-vpc-lattice-port-number"></a>
VPC\$1LATTICE를 통해 SFTP 서버에 연결하기 위한 포트 번호입니다.  
`local-file-location`  <a name="sftp-connector-local-file-location"></a>
이 파라미터에는 AWS 스토리지 파일의 위치에 대한 세부 정보가 포함되어 있습니다.    
`domain`  <a name="sftp-connector-domain"></a>
사용 중인 스토리지입니다. 현재 유일한 값은 입니다`S3`.  
`bucket`  <a name="sftp-connector-bucket"></a>
Amazon S3의 객체에 대한 컨테이너입니다.  
`key`  <a name="sftp-connector-key"></a>
Amazon S3의 객체에 할당된 이름입니다.  
`output-file-location`  <a name="sftp-connector-output-file-location"></a>
이 파라미터에는 디렉터리 목록의 결과를 스토리지에 저장할 위치의 세부 정보가 포함되어 있습니다 AWS .    
`domain`  <a name="sftp-connector-output-domain"></a>
사용 중인 스토리지입니다. 현재 유일한 값은 입니다`S3`.  
`bucket`  <a name="sftp-connector-output-bucket"></a>
Amazon S3의 객체에 대한 컨테이너입니다.  
`key`  <a name="sftp-connector-output-key"></a>
Amazon S3의 객체에 할당된 이름입니다.

**Example SFTP 커넥터 파일 전송 실패 예제 이벤트**  <a name="event-detail-sftp-connector-events.example"></a>
다음 예제는 원격 SFTP 서버로 파일을 전송하려고 시도하는 동안 SFTP 커넥터가 실패한 이벤트를 보여줍니다.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Connector File Send Failed",
    "source": "aws.transfer",
    "account": "123456789012",
    "time": "2024-01-24T19:30:45Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:123456789012:connector/c-f1111aaaa2222bbbb3"
    ],
    "detail": {
        "operation": "SEND",
        "connector-id": "c-f1111aaaa2222bbbb3",
        "transfer-id": "transfer-ID",
        "file-transfer-id": "file-transfer-ID",
        "url": "sftp://s-21a23456789012a.server.transfer.us-east-1.amazonaws.com",
        "file-path": "/amzn-s3-demo-bucket/testfile.txt",
        "status-code": "FAILED",
        "failure-code": "CONNECTION_ERROR",
        "failure-message": "Unknown Host",
        "remote-directory-path": "",
        "bytes": 0,
        "start-timestamp": "2024-01-24T18:29:33.658729Z",
        "end-timestamp": "2024-01-24T18:29:33.993196Z",
        "local-file-location": {
            "domain": "S3",
            "bucket": "amzn-s3-demo-bucket",
            "key": "testfile.txt"
        }
    }
}
```

**Example SFTP 커넥터 파일 검색 완료된 예제 이벤트**  <a name="event-detail-sftp-connector-events.example"></a>
다음 예제는 SFTP 커넥터가 원격 SFTP 서버에서 전송된 파일을 성공적으로 검색한 이벤트를 보여줍니다.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Connector File Retrieve Completed",
    "source": "aws.transfer",
    "account": "123456789012",
    "time": "2024-01-24T18:28:08Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:123456789012:connector/c-f1111aaaa2222bbbb3"
    ],
    "detail": {
        "operation": "RETRIEVE",
        "connector-id": "c-fc68000012345aa18",
        "transfer-id": "file-transfer-ID",
        "file-transfer-id": "file-transfer-ID",
        "url": "sftp://s-21a23456789012a.server.transfer.us-east-1.amazonaws.com",
        "file-path": "testfile.txt",
        "status-code": "COMPLETED",
        "local-directory-path": "/amzn-s3-demo-bucket",
        "bytes": 63533,
        "start-timestamp": "2024-01-24T18:28:07.632388Z",
        "end-timestamp": "2024-01-24T18:28:07.774898Z",
        "local-file-location": {
            "domain": "S3",
            "bucket": "amzn-s3-demo-bucket",
            "key": "testfile.txt"
        }
    }
}
```

**Example SFTP 커넥터 디렉터리 목록 완료됨 예제 이벤트**  <a name="event-detail-sftp-connector-events.example"></a>
다음 예제는 시작 디렉터리 목록 호출이 원격 SFTP 서버에서 목록 파일을 검색한 이벤트를 보여줍니다.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Connector Directory Listing Completed",
    "source": "aws.transfer",
    "account": "123456789012",
    "time": "2024-01-24T18:28:08Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:123456789012:connector/c-f1111aaaa2222bbbb3"
    ],
    "detail": {
        "max-items": 10000,
        "connector-id": "c-fc68000012345aa18",
        "output-directory-path": "/amzn-s3-demo-bucket/example/file-listing-output",
        "listing-id": "123456-23aa-7980-abc1-1a2b3c4d5e",
        "url": "sftp://s-21a23456789012a.server.transfer.us-east-1.amazonaws.com",        
        "status-code": "COMPLETED",
        "remote-directory-path": "/home",
        "item-count": 10000,
        "truncated": true,
        "start-timestamp": "2024-01-24T18:28:07.632388Z",
        "end-timestamp": "2024-01-24T18:28:07.774898Z",
        "output-file-location": {
            "domain": "S3",
            "bucket": "amzn-s3-demo-bucket",
            "key": "c-fc1ab90fd0d047e7a-70987273-49nn-4006-bab1-1a7290cc412ba.json"
        }
    }
}
```

## AS2 이벤트
<a name="event-detail-as2-server-events"></a>

**참고**  
이러한 이벤트는 Amazon EventBridge 이벤트 참조의 [AWS 서비스 이벤트에 대한 전송 수준에 설명된 대로 내구성 있는 수준으로](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) EventBridge에 전달됩니다. * EventBridge *

다음은 AS2 이벤트에 대한 세부 정보 필드입니다.
+ AS2 페이로드 수신 완료
+ AS2 페이로드 수신 실패
+ AS2 페이로드 전송 완료
+ AS2 페이로드 전송 실패
+ AS2 MDN 수신 완료
+ AS2 MDN 수신 실패
+ AS2 MDN 전송 완료
+ AS2 MDN 전송 실패

`source` 및 `detail-type` 필드는 Transfer Family 이벤트에 대한 특정 값을 포함하므로 아래에 포함되어 있습니다. 모든 이벤트에 포함된 다른 메타데이터 필드의 정의는 *Amazon EventBridge 사용 설명서*의 [이벤트 구조 참조](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)를 참조하세요.

```
{
   . . .,
  "detail-type": "string",
  "source": "aws.transfer",
  . . .,
  "detail": {    
    "s3-attributes" : {
      "file-bucket" : "string",
      "file-key" : "string",
      "json-bucket" : "string",
      "json-key" : "string", 
      "mdn-bucket" : "string",
      "mdn-key" : "string"
      }
    "mdn-subject" : "string",
    "mdn-message-id" : "string",
    "disposition" : "string",
    "bytes" : "number",
    "as2-from" : "string",
    "as2-message-id" : "string",
    "as2-to" : "string",
    "connector-id" : "string",
    "client-ip" : "string",
    "agreement-id" : "string",
    "server-id" : "string",
    "requester-file-name" : "string",
    "message-subject" : "string",
    "start-timestamp" : "string",
    "end-timestamp" : "string",
    "status-code" : "string",
    "failure-code" : "string",
    "failure-message" : "string",
    "transfer-id" : "string"
  }
}
```

`detail-type`  <a name="event-detail-as2-server-events-detail-type"></a>
이벤트의 유형을 식별합니다.  
이 이벤트의 경우 값은 이전에 나열된 AS2 이벤트 중 하나입니다.

`source`  <a name="event-detail-as2-server-events-source"></a>
이벤트를 생성한 서비스를 식별합니다. Transfer Family 이벤트의 경우이 값은 입니다`aws.transfer`.

`detail`  <a name="as2-server-detail"></a>
이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다.    
`s3-attributes`  <a name="as2-server-s3-attributes"></a>
전송 중인 파일의 Amazon S3 버킷과 키를 식별합니다. MDN 이벤트의 경우 MDN 파일의 버킷과 키도 식별합니다.    
`file-bucket`  <a name="as2-server-s3-file-bucket"></a>
Amazon S3의 객체에 대한 컨테이너입니다.  
`file-key`  <a name="as2-server-s3-file-key"></a>
Amazon S3의 객체에 할당된 이름입니다.  
`json-bucket`  <a name="as2-server-s3-json-bucket"></a>
COMPLETED 또는 FAILED 전송의 경우 JSON 파일의 컨테이너입니다.  
`json-key`  <a name="as2-server-s3-json-key"></a>
COMPLETED 또는 FAILED 전송의 경우 Amazon S3의 JSON 파일에 할당된 이름입니다.  
`mdn-bucket`  <a name="as2-server-s3-mdn-bucket"></a>
MDN 이벤트의 경우 MDN 파일의 컨테이너입니다.  
`mdn-key`  <a name="as2-server-s3-mdn-key"></a>
MDN 이벤트의 경우 Amazon S3의 MDN 파일에 할당된 이름입니다.  
`mdn-subject`  <a name="as2-server-mdn-subject"></a>
MDN 이벤트의 경우 메시지 처리에 대한 텍스트 설명입니다.  
`mdn-message-id`  <a name="as2-server-mdn-message-id"></a>
MDN 이벤트의 경우 MDN 메시지의 고유 ID입니다.  
`disposition`  <a name="as2-server-disposition"></a>
MDN 이벤트의 경우 처리의 범주입니다.  
`bytes`  <a name="as2-server-bytes"></a>
메시지의 바이트 수입니다.  
`as2-from`  <a name="as2-server-as2-from"></a>
메시지를 보내는 AS2 거래 파트너입니다.  
`as2-message-id`  <a name="as2-server-as2-message-id"></a>
전송 중인 AS2 메시지의 고유 식별자입니다.  
`as2-to`  <a name="as2-server-as2-to"></a>
메시지를 수신하는 AS2 거래 파트너입니다.  
`connector-id`  <a name="as2-server-connector-id"></a>
Transfer Family 서버에서 거래 파트너로 전송되는 AS2 메시지의 경우 사용 중인 AS2 커넥터의 고유 식별자입니다.  
`client-ip`  <a name="as2-server-client-ip"></a>
서버 이벤트(거래 파트너에서 Transfer Family 서버로 전송)의 경우 전송과 관련된 클라이언트의 IP 주소입니다.  
`agreement-id`  <a name="as2-server-agreement-id"></a>
서버 이벤트의 경우 AS2 계약의 고유 식별자입니다.  
`server-id`  <a name="as2-server-server-id"></a>
서버 이벤트의 경우 Transfer Family 서버의 고유 ID만 해당됩니다.  
`requester-file-name`  <a name="as2-server-requester-file-name"></a>
페이로드 이벤트의 경우 전송 중에 수신된 파일의 원래 이름입니다.  
`message-subject`  <a name="as2-server-message-subject"></a>
메시지 제목에 대한 텍스트 설명입니다.  
`start-timestamp`  <a name="as2-server-start-timestamp"></a>
성공적인 전송을 위해 파일 처리가 시작되는 시점의 타임스탬프입니다.  
`end-timestamp`  <a name="as2-server-end-timestamp"></a>
전송에 성공하려면 파일 처리가 완료될 때의 타임스탬프입니다.  
`status-code`  <a name="as2-server-status-code"></a>
AS2 메시지 전송 프로세스의 상태에 해당하는 코드입니다. 유효한 값: `COMPLETED | FAILED | PROCESSING`.  
`failure-code`  <a name="as2-server-failure-code"></a>
전송이 실패한 경우 전송이 실패한 이유의 범주입니다.  
`failure-message`  <a name="as2-server-failure-message"></a>
전송이 실패한 경우 전송이 실패한 이유에 대한 세부 정보입니다.  
`transfer-id`  <a name="as2-server-transfer-id"></a>
전송 이벤트의 고유 식별자입니다.

**Example AS2 페이로드 수신 완료된 예제 이벤트**  <a name="event-detail-as2-server-events.example"></a>

```
{
    "version": "0",
     "id": "event-ID",
    "detail-type": "AS2 Payload Receive Completed",
    "source": "aws.transfer",
    "account": "076722215406",
    "time": "2024-02-07T06:47:05Z",
    "region": "us-east-1",
    "resources": ["arn:aws:transfer:us-east-1:076722215406:connector/c-1111aaaa2222bbbb3"],
    "detail": {
        "s3-attributes": {
            "file-key": "/inbound/processed/testAs2Message.dat",
            "file-bucket": "amzn-s3-demo-bucket"
        },
        "client-ip": "client-IP-address",
        "requester-file-name": "testAs2MessageVerifyFile.dat",
        "end-timestamp": "2024-02-07T06:47:06.040031Z",
        "as2-from": "as2-from-ID",
        "as2-message-id": "as2-message-ID",
        "message-subject": "Message from AS2 tests",
        "start-timestamp": "2024-02-07T06:47:05.410Z",
        "status-code": "PROCESSING",
        "bytes": 63,
        "as2-to": "as2-to-ID",
        "agreement-id": "a-1111aaaa2222bbbb3",
        "server-id": "s-1234abcd5678efghi"
    }
}
```

**Example AS2 MDN 수신 실패 예제 이벤트**  <a name="event-detail-as2-server-events.example"></a>

```
{
  "version": "0",
  "id": "event-ID",
  "detail-type": "AS2 MDN Receive Failed",
  "source": "aws.transfer",
  "account": "889901007463",
  "time": "2024-02-06T22:05:09Z",
  "region": "us-east-1",
  "resources": ["arn:aws:transfer:us-east-1:076722215406:server/s-1111aaaa2222bbbb3"],
  "detail": {      
      "mdn-subject": "Your Requested MDN Response re: Test run from Id 123456789abcde to partner ijklmnop987654",
      "s3-attributes": {
          "json-bucket": "amzn-s3-demo-bucket1",
          "file-key": "/as2Integ/TestOutboundWrongCert.dat",
          "file-bucket": "amzn-s3-demo-bucket2",
          "json-key": "/as2Integ/failed/TestOutboundWrongCert.dat.json"
      },
      "mdn-message-id": "MDN-message-ID",
      "end-timestamp": "2024-02-06T22:05:09.479878Z",
      "as2-from": "PartnerA",
      "as2-message-id": "as2-message-ID",
      "connector-id": "c-1234abcd5678efghj",
      "message-subject": "Test run from Id 123456789abcde to partner ijklmnop987654",
      "start-timestamp": "2024-02-06T22:05:03Z",
      "failure-code": "VERIFICATION_FAILED_NO_MATCHING_KEY_FOUND",
      "status-code": "FAILED",
      "as2-to": "MyCompany",
      "failure-message": "No public certificate matching message signature could be found in profile: p-1234abcd5678efghj",
      "transfer-id": "transfer-ID"
  }
}
```