

Amazon Fraud Detector tidak lagi terbuka untuk pelanggan baru per 7 November 2025. Untuk kemampuan yang mirip dengan Amazon Fraud Detector, jelajahi Amazon SageMaker AutoGluon,, dan AWS WAF.

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

# Prediksi Batch
<a name="batch-predictions"></a>

Anda dapat menggunakan pekerjaan *prediksi batch* di Amazon Fraud Detector untuk mendapatkan prediksi untuk serangkaian peristiwa yang tidak memerlukan penilaian waktu nyata. Misalnya, Anda dapat membuat pekerjaan prediksi batch untuk melakukan offline proof-of-concept, atau mengevaluasi risiko kejadian secara retrospektif setiap jam, harian, atau mingguan. 

Anda dapat membuat pekerjaan prediksi batch menggunakan [konsol Amazon Fraud Detector](https://console.aws.amazon.com/frauddetector), atau dengan memanggil operasi [CreateBatchPredictionJob](https://docs.aws.amazon.com/frauddetector/latest/api/API_CreateBatchPredictionJob.html)API menggunakan AWS Command Line Interface (AWS CLI) atau salah satu Amazon Fraud Detector. SDKs

**Topics**
+ [Cara kerja prediksi batch](#how-batch-predictions-works)
+ [File input dan output](#input-and-output-files)
+ [Mendapatkan prediksi batch](#getting-batch-predictions)
+ [Bimbingan tentang peran IAM](#guidance-iam-roles)
+ [Dapatkan prediksi penipuan batch menggunakan AWS SDK untuk Python (Boto3)](#get-a-batch-fraud-prediction-using-the-aws-python-sdk)

## Cara kerja prediksi batch
<a name="how-batch-predictions-works"></a>

Operasi `CreateBatchPredictionJob` API menggunakan versi detektor tertentu untuk membuat prediksi berdasarkan data yang disediakan dalam file CSV input yang terletak di bucket Amazon S3. API kemudian mengembalikan file CSV yang dihasilkan ke bucket S3. 

Pekerjaan prediksi Batch menghitung skor model dan hasil prediksi dengan cara yang sama seperti operasi. `GetEventPrediction` Mirip dengan`GetEventPrediction`, untuk membuat pekerjaan prediksi batch, pertama-tama Anda membuat jenis acara, melatih model secara opsional, dan kemudian membuat versi detektor yang mengevaluasi peristiwa dalam pekerjaan batch Anda. 

Harga untuk skor risiko peristiwa yang dievaluasi oleh pekerjaan prediksi batch sama dengan harga untuk skor yang dibuat oleh API. `GetEventPrediction` Untuk detailnya, lihat [harga Amazon Fraud Detector](https://aws.amazon.com/fraud-detector/pricing/). 

Anda hanya dapat menjalankan satu pekerjaan prediksi batch pada satu waktu.

## File input dan output
<a name="input-and-output-files"></a>

 File CSV input harus berisi header yang cocok dengan jenis acara yang dikaitkan dengan versi detektor yang dipilih. Ukuran maksimum file data input adalah 1GB. Jumlah acara akan bervariasi menurut ukuran acara Anda.

Amazon Fraud Detector membuat file keluaran dalam bucket yang sama dengan file input, kecuali Anda menentukan lokasi terpisah untuk data keluaran. File output berisi data asli dari file input dan kolom tambahan berikut: 
+ `MODEL_SCORES`— Merinci skor model untuk acara dari setiap model yang terkait dengan versi detektor yang dipilih.
+ `OUTCOMES`— Merinci hasil acara sebagaimana dievaluasi oleh versi detektor yang dipilih dan aturannya.
+ `STATUS`— Menunjukkan apakah acara berhasil dievaluasi. Jika acara tidak berhasil dievaluasi, kolom ini menunjukkan kode alasan kegagalan.
+ ` RULE_RESULTS`— Daftar semua aturan yang cocok, berdasarkan mode eksekusi aturan. 

## Mendapatkan prediksi batch
<a name="getting-batch-predictions"></a>

Langkah-langkah berikut mengasumsikan bahwa Anda telah membuat jenis peristiwa, melatih model menggunakan jenis peristiwa tersebut (opsional), dan membuat versi detektor untuk jenis peristiwa tersebut. 

**Untuk mendapatkan prediksi batch**

1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon Fraud Detector di [https://console.aws.amazon.com/frauddetector](https://console.aws.amazon.com/frauddetector).

1. Di panel navigasi kiri konsol Amazon Fraud Detector, pilih **Prediksi Batch, lalu pilih Prediksi** **batch baru**.

1. Di **Job name**, tentukan nama untuk pekerjaan prediksi batch Anda. Jika Anda tidak menentukan nama, Amazon Fraud Detector akan menghasilkan nama pekerjaan secara acak.

1. Di **Detektor**, pilih detektor untuk prediksi batch ini.

1. Dalam **versi Detektor**, pilih versi detektor untuk prediksi batch ini. Anda dapat memilih versi detektor dalam status apa pun. Jika detektor Anda memiliki versi detektor dalam `Active` status, versi tersebut dipilih secara otomatis, tetapi Anda juga dapat mengubah pilihan ini jika diperlukan.

1. Dalam **peran IAM**, pilih atau buat peran yang memiliki akses baca dan tulis ke bucket Amazon S3 masukan dan keluaran Anda. Untuk informasi selengkapnya, lihat [Bimbingan tentang peran IAM](#guidance-iam-roles).

   Untuk mendapatkan prediksi batch, peran IAM yang memanggil `CreateBatchPredictionJob` operasi harus memiliki izin baca ke bucket S3 input dan izin tulis ke bucket S3 keluaran Anda. Untuk informasi selengkapnya tentang izin bucket, lihat [contoh kebijakan pengguna](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-policies-s3.html) di Panduan Pengguna *Amazon S3*. 

1. Di **lokasi data input**, tentukan lokasi Amazon S3 dari data input Anda. Jika Anda menginginkan file keluaran dalam bucket S3 yang berbeda, pilih **Pisahkan lokasi data untuk output** dan berikan lokasi Amazon S3 untuk data keluaran Anda. 

1. (Opsional) Buat tag untuk pekerjaan prediksi batch Anda.

1. Pilih **Mulai**.

   Amazon Fraud Detector membuat pekerjaan prediksi batch, dan status pekerjaannya adalah`In progress`. Waktu pemrosesan pekerjaan prediksi batch bervariasi tergantung pada jumlah peristiwa dan konfigurasi versi detektor Anda.

Untuk menghentikan pekerjaan prediksi batch yang sedang berlangsung, buka halaman detail pekerjaan prediksi batch, pilih **Tindakan**, lalu pilih **Hentikan prediksi batch**. Jika Anda menghentikan pekerjaan prediksi batch, Anda tidak akan menerima hasil apa pun untuk pekerjaan itu.

Jika status pekerjaan prediksi batch berubah menjadi`Complete`, Anda dapat mengambil output pekerjaan dari bucket Amazon S3 keluaran yang ditentukan. Nama file output ada dalam format`batch prediction job name_file creation timestamp_output.csv`. Misalnya, file output dari pekerjaan bernama `mybatchjob` adalah`mybatchjob_ 1611170650_output.csv`.

Untuk mencari peristiwa tertentu yang dievaluasi oleh pekerjaan prediksi batch, di panel navigasi kiri konsol Amazon Fraud Detector, pilih **Cari** prediksi sebelumnya.

Untuk menghapus pekerjaan prediksi batch yang telah selesai, buka halaman detail pekerjaan prediksi batch, pilih **Tindakan**, lalu pilih **Hapus prediksi batch**. 

## Bimbingan tentang peran IAM
<a name="guidance-iam-roles"></a>

Untuk mendapatkan prediksi batch, peran IAM yang memanggil [CreateBatchPredictionJob](https://docs.aws.amazon.com/frauddetector/latest/api/API_CreateBatchPredictionJob.html)operasi harus memiliki izin baca ke bucket S3 input dan izin tulis ke bucket S3 keluaran Anda. Untuk informasi selengkapnya tentang izin bucket, lihat contoh kebijakan pengguna di Panduan Pengguna Amazon S3. Di konsol Amazon Fraud Detector, Anda memiliki tiga opsi untuk memilih peran IAM untuk Prediksi Batch:

1. Buat peran saat membuat pekerjaan Prediksi Batch baru.

1. Pilih peran IAM yang sudah ada yang sebelumnya Anda buat di konsol Amazon Fraud Detector. Pastikan untuk menambahkan `S3:PutObject` izin ke peran sebelum Anda melakukan langkah ini. 

1. Masukkan ARN khusus untuk peran IAM yang dibuat sebelumnya.

Jika Anda menerima kesalahan terkait dengan peran IAM Anda, verifikasi hal berikut:

1. Bucket input dan output Amazon S3 Anda berada di wilayah yang sama dengan detektor Anda.

1. Peran IAM yang Anda gunakan memiliki `s3:GetObject` izin untuk bucket input S3 Anda dan `s3:PutObject` izin untuk bucket S3 keluaran Anda. 

1. Peran IAM yang Anda gunakan memiliki kebijakan kepercayaan untuk prinsipal `frauddetector.amazonaws.com` layanan.

## Dapatkan prediksi penipuan batch menggunakan AWS SDK untuk Python (Boto3)
<a name="get-a-batch-fraud-prediction-using-the-aws-python-sdk"></a>

Contoh berikut menunjukkan permintaan sampel untuk [CreateBatchPredictionJob](https://docs.aws.amazon.com/frauddetector/latest/api/API_CreateBatchPredictionJob.html)API. Pekerjaan prediksi batch harus menyertakan sumber daya yang ada berikut: detektor, versi detektor, dan nama jenis peristiwa. Contoh berikut mengasumsikan Anda telah membuat jenis peristiwa`sample_registration`, detektor`sample_detector`, dan versi `1` detektor.

```
import boto3
fraudDetector = boto3.client('frauddetector')

fraudDetector.create_batch_prediction_job (
   jobId = 'sample_batch',
   inputPath = 's3://bucket_name/input_file_name.csv',
   outputPath = 's3://bucket_name/',
   eventTypeName = 'sample_registration',
   detectorName = 'sample_detector',
   detectorVersion = '1',
   iamRoleArn = 'arn:aws:iam::**:role/service-role/AmazonFraudDetector-DataAccessRole-**'
)
```