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

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

SFTP 连接器事件

以下是 SFTP 连接器事件的详细信息字段:

  • SFTP 连接器文件发送已完成

  • SFTP 连接器文件发送失败

  • SFTP 连接器文件检索已完成

  • 检索 SFTP 连接器文件失败

下面包含sourcedetail-type字段,因为它们包含 Transfer Family 事件的特定值。有关所有事件中包含的其他元数据字段的定义,请参阅Amazon EventBridge 用户指南中的事件结构参考

{ . . ., "detail-type": "string", "source": "aws.transfer", . . ., "detail": { "operation" : "string", "connector-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" "bytes" : "number", "local-file-location" : { "domain" : "string", "bucket" : "string", "key" : "string" }, } }
detail-type

标识事件的类型。

对于此事件,该值是先前列出的 SFTP 连接器事件名称之一。

source

标识生成事件的服务。对于 Transfer Family 事件,此值为aws.transfer

detail

包含关于事件信息的 JSON 对象。生成事件的服务决定了该字段的内容。

对于此事件,数据包括以下内容:

operation

StartFileTransfer请求是发送文件还是检索文件。价值观:SEND|RETRIEVE

connector-id

正在使用的 SFTP 连接器的唯一标识符。

transfer-id

传输事件(StartFileTransfer请求)的唯一标识符。

file-transfer-id

正在传输的文件的唯一标识符。

url

合作伙伴的 AS2 或 SFTP 端点的 URL。

file-path

正在发送或检索的位置和文件。

status-code

传输是否成功。价值观:FAILED | COMPLETED

failure-code

对于失败的传输,则为转移失败的原因代码。

failure-message

对于失败的传输,提供传输失败原因的详细信息。

start-timestamp

对于成功传输,指文件处理开始时间的时间戳。

end-timestamp

对于成功传输,指文件处理完成的时间戳。

local-directory-path

对于RETRIEVE请求,指存放检索到文件的位置。

remote-directory-path

对于SEND请求,指将文件放在合作伙伴的 SFTP 服务器上的文件目录。这是用户传递给StartFileTransfer请求RemoteDirectoryPath的的值。您可以在合作伙伴的 SFTP 服务器上指定默认目录。如果是,则此字段为空。

bytes

正在传输的字节数。对于失败的传输,该值为 0。

local-file-location

此参数包含 Amazon 存储文件位置的详细信息。

domain

正在使用的存储空间。目前,唯一的值是S3

bucket

Amazon S3 中对象的容器。

key

在 Amazon S3 中为对象分配的名称。

例 SFTP 连接器文件发送失败示例事件

以下示例显示了尝试向远程 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": "/DOC-EXAMPLE-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": "DOC-EXAMPLE-BUCKET", "key": "testfile.txt" } } }
例 SFTP 连接器文件检索已完成示例事件

以下示例显示了一个事件,其中 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": "/DOC-EXAMPLE-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": "DOC-EXAMPLE-BUCKET", "key": "testfile.txt" } } }