SFTP、FTPS 和 FTP 服务器事件 - Amazon Transfer Family
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

SFTP、FTPS 和 FTP 服务器事件

以下是 SFTP、FTPS 和 FTP 服务器事件的详细信息字段:

  • FTP 文件服务器下载已完成

  • FTP 文件服务器下载失败

  • FTP 文件服务器上传已完成

  • FTP 文件服务器上传失败

  • FTPS 文件服务器下载已完成

  • FTPS 文件服务器下载失败

  • FTPS 文件服务器上传已完成

  • FTPS 文件服务器上传失败

  • SFTP 服务器文件下载已完成

  • SFTP 服务器文件下载失败

  • SFTP 服务器文件上传已完成

  • SFTP 服务器文件上传失败

下面包含sourcedetail-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" } }