Amazon Fraud Detector は、2025 年 11 月 7 日をもって新規顧客に公開されなくなりました。Amazon Fraud Detector と同様の機能については、Amazon SageMaker、AutoGluon、および を参照してください AWS WAF。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# バッチ予測
<a name="batch-predictions"></a>

Amazon Fraud Detector の*バッチ予測*ジョブを使用して、リアルタイムのスコアリングを必要としない一連のイベントの予測を取得できます。例えば、バッチ予測ジョブを作成して、オフラインの概念実証を実行したり、イベントのリスクを時間単位、日単位、週単位で遡及的に評価したりできます。

[Amazon Fraud Detector コンソール](https://console.aws.amazon.com/frauddetector)を使用するか、コマンドラインインターフェイス (AWS CLI) または Amazon Fraud Detector SDKs のいずれかを使用して [CreateBatchPredictionJob](https://docs.aws.amazon.com/frauddetector/latest/api/API_CreateBatchPredictionJob.html) API AWS オペレーションを呼び出すことで、バッチ予測ジョブを作成できます。

**Topics**
+ [バッチ予測の仕組み](#how-batch-predictions-works)
+ [入力および出力ファイル](#input-and-output-files)
+ [バッチ予測の取得](#getting-batch-predictions)
+ [IAM ロールに関するガイダンス](#guidance-iam-roles)
+ [を使用してバッチ不正予測を取得する AWS SDK for Python (Boto3)](#get-a-batch-fraud-prediction-using-the-aws-python-sdk)

## バッチ予測の仕組み
<a name="how-batch-predictions-works"></a>

-`CreateBatchPredictionJob`API オペレーションでは、指定されたディテクタバージョンを使用して、Amazon S3 バケットにある入力 CSV ファイルで指定されたデータに基づいて予測を行います。次に API は、結果の CSV ファイルを S3 バケットに返します。

バッチ予測ジョブは、`GetEventPrediction` オペレーションと同じようにモデルのスコアと予測結果を計算します。`GetEventPrediction` と同様に、バッチ予測ジョブを作成するには、まずイベントタイプを作成し、オプションでモデルをトレーニングしてから、バッチジョブのイベントを評価するディテクタバージョンを作成します。

バッチ予測ジョブによって評価されるイベントリスクスコアの料金は、`GetEventPrediction` API で作成されたスコアの料金と同じです。詳細については、「[Amazon Fraud Detector の料金](https://aws.amazon.com/fraud-detector/pricing/)」を参照してください。

バッチ予測ジョブは、一度に 1 回のみ実行することができます。

## 入力および出力ファイル
<a name="input-and-output-files"></a>

 入力 CSV ファイルには、選択したディテクターバージョンに関連付けられているイベントタイプに一致するヘッダーが含まれている必要があります。入力データファイルの最大サイズは 1GB です。イベントの数は、イベントのサイズによって異なります。

Amazon Fraud Detector は、出力データ用に別の場所を指定しない限り、入力ファイルと同じバケットに出力ファイルを作成します。出力ファイルには、入力ファイルの元のデータと、次の追加列が含まれます。
+ `MODEL_SCORES` — 選択したディテクターバージョンに関連付けられている各モデルのイベントのモデルスコアの詳細を示します。
+ `OUTCOMES` — 選択したディテクターバージョンとそのルールによって評価されたイベントの結果の詳細を示します。
+ `STATUS` — イベントが正常に評価されたかどうかを示します。イベントが正常に評価されなかった場合、この列には失敗の理由コードが表示されます。
+ ` RULE_RESULTS` — ルール実行モードに基づく、一致したすべてのルールのリスト。

## バッチ予測の取得
<a name="getting-batch-predictions"></a>

次の手順では、既にイベントタイプを作成し、そのイベントタイプを使用してモデルをトレーニングし (オプション)、そのイベントタイプのディテクターバージョンを作成していることを前提としています。

**バッチ予測を取得するには**

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/frauddetector](https://console.aws.amazon.com/frauddetector) で Amazon Fraud Detector コンソールを開きます。

1. Amazon Fraud Detector コンソールの左側のナビゲーションペインで、[**バッチ予測**] を選択してから、[**新しいバッチ予測**] をクリックします。

1. [**ジョブ名**] で、バッチ予測ジョブの名前を指定します。名前を指定しない場合、Amazon Fraud Detector はジョブ名をランダムに生成します。

1. [**ディテクター**] で、このバッチ予測のディテクターを選択します。

1. [**ディテクターバージョン**] で、このバッチ予測のディテクターバージョンを選択します。どのステータスのディテクターバージョンも選択できます。お使いのディテクターに `Active` ステータスのディテクターバージョンがある場合、そのバージョンが自動的に選択されますが、必要に応じてこの選択を変更することもできます。

1. [**IAM ロール**] で、入力および出力の Amazon S3 バケットに対する読み取りおよび書き込みアクセス権限を持つロールを選択または作成します。詳細については「[IAM ロールに関するガイダンス](#guidance-iam-roles)」を参照してください。

   バッチ予測を取得するには、 `CreateBatchPredictionJob`オペレーションを呼び出す IAM ロールに、入力 S3 バケットへの読み取りアクセス許可と、出力 S3 バケットへの書き込みアクセス許可が必要です。バケットのアクセス権限の詳細については、*Amazon S3 ユーザーガイド*の「[ユーザーポリシーの例](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-policies-s3.html)」を参照してください。

1. [**入力データの場所**] で、入力データの Amazon S3 の場所を指定します。出力ファイルを別の S3 バケットに含める場合は、[**出力用の個別のデータの場所**] を選択し、出力データの Amazon S3 の場所を指定します。

1. (オプション) バッチ予測ジョブのタグを作成します。

1. **[開始]** を選択します。

   Amazon Fraud Detector はバッチ予測ジョブを作成し、ジョブのステータスは [`In progress`] になります。Batch 予測ジョブの処理時間は、イベントの数とディテクターのバージョンの設定によって異なります。

進行中のバッチ予測ジョブを停止するには、バッチ予測ジョブの詳細ページに移動し、[**アクション**] を選択してから、[**バッチ予測の停止**] をクリックします。バッチ予測ジョブを停止すると、ジョブの結果が表示されません。

バッチ予測ジョブのステータスが [`Complete`] に変わると、指定した出力 Amazon S3 バケットからジョブの出力を取得できます。出力ファイルの名前は `batch prediction job name_file creation timestamp_output.csv` という形式になります。例えば、`mybatchjob` という名前のジョブの出力ファイルは、`mybatchjob_ 1611170650_output.csv` です。

バッチ予測ジョブによって評価された特定のイベントを検索するには、Amazon Fraud Detector コンソールの左側のナビゲーションペインで、[**過去の予測の検索**] を選択します。

完了したバッチ予測ジョブを削除するには、バッチ予測ジョブの詳細ページに移動し、[**アクション**] を選択してから、[**バッチ予測の削除**] をクリックします。

## IAM ロールに関するガイダンス
<a name="guidance-iam-roles"></a>

バッチ予測を取得するには、[CreateBatchPredictionJob](https://docs.aws.amazon.com/frauddetector/latest/api/API_CreateBatchPredictionJob.html) オペレーションを呼び出す IAM ロールに、入力 S3 バケットへの読み取りアクセス許可と、出力 S3 バケットへの書き込みアクセス許可が必要です。バケットのアクセス許可の詳細については、Amazon S3 ユーザーガイドの「ユーザーポリシーの例」を参照してください。Amazon Fraud Detector コンソールでは、以下のように、Batch 予測の IAM ロールを選択するためのオプションが 3 つあります。

1. 新しいBatch 予測ジョブを作成するときに、ロールを作成します。

1. Amazon Fraud Detector コンソールで以前に作成した既存の IAM ロールを選択します。この手順を実行する前に、必ずロールに `S3:PutObject` アクセス許可を追加してください。

1. 以前に作成した IAM ロールのカスタム ARN を入力します。

IAM ロールに関連するエラーが表示された場合は、以下を確認します。

1. Amazon S3 入出力バケットは、ディテクターと同じリージョンにあります。

1. 使用している IAM ロールには、入力 S3 バケット用の `s3:GetObject` アクセス許可と出力 S3 バケット用の `s3:PutObject` アクセス許可があること。

1. 使用している IAM ロールには、サービスプリンシパル `frauddetector.amazonaws.com` の信頼ポリシーがあること。

## を使用してバッチ不正予測を取得する AWS SDK for Python (Boto3)
<a name="get-a-batch-fraud-prediction-using-the-aws-python-sdk"></a>

次の例は、[CreateBatchPredictionJob](https://docs.aws.amazon.com/frauddetector/latest/api/API_CreateBatchPredictionJob.html) API のリクエストの例を示しています。バッチ予測ジョブには、ディテクター、ディテクターバージョン、およびイベントタイプ名の既存のリソースを含める必要があります。次の例では、イベントタイプ `sample_registration`、ディテクター `sample_detector`、およびディテクターバージョン `1` を作成したとします。

```
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-**'
)
```