SFTPacara konektor - AWS Transfer Family

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

SFTPacara konektor

Berikut ini adalah bidang detail untuk acara SFTP konektor:

  • SFTPKirim File Konektor Selesai

  • SFTPKirim File Konektor Gagal

  • SFTPPengambilan File Konektor Selesai

  • SFTPPengambilan File Konektor Gagal

detail-typeBidang source dan disertakan di bawah ini karena mengandung nilai khusus untuk Transfer Family acara. Untuk definisi bidang metadata lain yang disertakan dalam semua peristiwa, lihat Referensi struktur acara di Amazon EventBridge Panduan Pengguna.

{
  . . .,
  "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

Mengidentifikasi jenis acara.

Untuk acara ini, nilainya adalah salah satu nama acara SFTP konektor yang tercantum sebelumnya.

source

Mengidentifikasi layanan yang menghasilkan peristiwa. Untuk Transfer Family acara, nilai ini adalahaws.transfer.

detail

JSONObjek yang berisi informasi tentang acara tersebut. Layanan yang menghasilkan acara menentukan konten bidang ini.

Untuk acara ini, data meliputi yang berikut:

operation

Apakah StartFileTransfer permintaan mengirim atau mengambil file. Nilai:SEND|RETRIEVE.

connector-id

Pengidentifikasi unik untuk SFTP konektor yang digunakan.

transfer-id

Pengenal unik untuk acara transfer (StartFileTransferpermintaan).

file-transfer-id

Pengidentifikasi unik untuk file yang ditransfer.

url

URLDari pasangan AS2 atau SFTP titik akhir.

file-path

Lokasi dan file yang sedang dikirim atau diambil.

status-code

Apakah transfer berhasil. Nilai:FAILED | COMPLETED.

failure-code

Untuk transfer yang gagal, kode alasan mengapa transfer gagal.

failure-message

Untuk transfer yang gagal, detail mengapa transfer gagal.

start-timestamp

Untuk transfer yang berhasil, stempel waktu saat pemrosesan file dimulai.

end-timestamp

Untuk transfer yang berhasil, stempel waktu saat pemrosesan file selesai.

local-directory-path

Untuk RETRIEVE permintaan, lokasi untuk menempatkan file yang diambil.

remote-directory-path

Untuk SEND permintaan, direktori file di mana untuk menempatkan file di SFTP server mitra. Ini adalah nilai untuk RemoteDirectoryPath yang diteruskan pengguna ke StartFileTransfer permintaan. Anda dapat menentukan direktori default di SFTP server mitra. Jika demikian, bidang ini kosong.

bytes

Jumlah byte yang ditransfer. Nilainya adalah 0 untuk transfer yang gagal.

local-file-location

Parameter ini berisi rincian lokasi file AWS penyimpanan.

domain

Penyimpanan yang digunakan. Saat ini, satu-satunya nilai adalahS3.

bucket

Wadah untuk objek di Amazon S3.

key

Nama yang ditetapkan untuk objek di Amazon S3.

contoh SFTPKonektor File Kirim contoh peristiwa gagal

Contoh berikut menunjukkan peristiwa di mana SFTP konektor gagal saat mencoba mengirim file ke SFTP server jauh.

{
    "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"
        }
    }
}
contoh SFTPPengambilan File Konektor Contoh acara yang lengkap

Contoh berikut menunjukkan peristiwa di mana SFTP konektor berhasil mengambil file yang dikirim dari SFTP server jauh.

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