SFTP, FTPS및 FTP 서버 이벤트 - AWS Transfer Family

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

SFTP, FTPS및 FTP 서버 이벤트

다음은 SFTP, FTPS및 FTP 서버 이벤트에 대한 세부 정보 필드입니다.

  • FTP 파일 서버 다운로드 완료

  • FTP 파일 서버 다운로드 실패

  • FTP 파일 서버 업로드 완료

  • FTP 파일 서버 업로드 실패

  • FTPS 파일 서버 다운로드 완료

  • FTPS 파일 서버 다운로드 실패

  • FTPS 파일 서버 업로드 완료

  • FTPS 파일 서버 업로드 실패

  • SFTP 서버 파일 다운로드 완료

  • SFTP 서버 파일 다운로드 실패

  • SFTP 서버 파일 업로드 완료

  • SFTP 서버 파일 업로드 실패

source 및 detail-type 필드는 Transfer Family 이벤트에 대한 특정 값을 포함하므로 아래에 포함되어 있습니다. 모든 이벤트에 포함된 다른 메타데이터 필드의 정의는 Amazon EventBridge 사용 설명서의 이벤트 구조 참조를 참조하세요.

{
  . . .,
  "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",
    "server-id" : "string",
    "username" : "string",
    "session-id" : "string",
    "start-timestamp" : "string"
  }
}
detail-type

이벤트의 유형을 식별합니다.

이 이벤트의 값은 이전에 나열된 SFTP, FTPS또는 FTP 서버 이벤트 이름 중 하나입니다.

source

이벤트를 생성한 서비스를 식별합니다. Transfer Family 이벤트의 경우 이 값은 입니다aws.transfer.

detail

이벤트에 대한 정보가 포함된 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다.

이 이벤트의 경우 데이터에 다음이 포함됩니다.

failure-code

전송이 실패한 이유에 대한 범주입니다. 값: PARTIAL_UPLOAD | PARTIAL_DOWNLOAD | UNKNOWN_ERROR

status-code

전송 성공 여부. 값: COMPLETED | FAILED.

protocol

전송에 사용되는 프로토콜입니다. 값: SFTP | FTPS | FTP

bytes

전송되는 바이트 수입니다.

client-ip

전송과 관련된 클라이언트의 IP 주소

failure-message

실패한 전송의 경우 전송이 실패한 이유에 대한 세부 정보입니다.

end-timestamp

성공적인 전송을 위해 파일 처리가 완료될 때의 타임스탬프입니다.

etag

엔터티 태그(Amazon S3 파일에만 사용됨).

file-path

전송 중인 파일의 경로입니다.

server-id

Transfer Family 서버의 고유 ID입니다.

username

전송을 수행하는 사용자입니다.

session-id

전송 세션의 고유 식별자입니다.

start-timestamp

성공적인 전송을 위해 파일 처리가 시작될 때의 타임스탬프입니다.

예 SFTP 서버 파일 다운로드 실패 예제 이벤트

다음 예제는 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"
    }
}
예 FTP 파일 서버 업로드 완료 예제 이벤트

다음 예제는 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": "/DOC-EXAMPLE-BUCKET/test/1mb_file",
        "server-id": "s-1111aaaa2222bbbb3",
        "username": "test",
        "session-id": "event-ID",
        "start-timestamp": "2024-01-29T16:31:42.462088327Z"
    }
}