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" } }