Amazon Fraud Detector는 2025년 11월 7일부터 신규 고객에게 더 이상 공개되지 않습니다. Amazon Fraud Detector와 유사한 기능을 알아보려면 Amazon SageMaker, AutoGluon 및를 살펴보세요 AWS WAF.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 배치 예측
<a name="batch-predictions"></a>

Amazon Fraud Detector에서 *배치 예측* 작업을 사용하여 실시간 점수가 필요하지 않은 이벤트 세트에 대한 예측을 가져올 수 있습니다. 예를 들어, 배치 예측 작업을 생성하여 오프라인 proof-of-concept 수행하거나 시간별, 일별 또는 주별로 이벤트 위험을 소급하여 평가할 수 있습니다.

[Amazon Fraud Detector 콘솔](https://console.aws.amazon.com/frauddetector)을 사용하거나 AWS 명령줄 인터페이스(AWS CLI) 또는 Amazon Fraud Detector SDK 중 하나를 사용하여 [CreateBatchPredictionJob](https://docs.aws.amazon.com/frauddetector/latest/api/API_CreateBatchPredictionJob.html) API 작업을 호출하여 배치 예측 작업을 생성할 수 있습니다. SDKs

**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/) 참조하세요.

배치 예측 작업은 한 번에 하나만 실행할 수 있습니다.

## 입력 및 출력 파일
<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 Management Console 하고 [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`. 배치 예측 작업 처리 시간은 이벤트 수와 감지기 버전 구성에 따라 달라집니다.

진행 중인 배치 예측 작업을 중지하려면 배치 예측 작업 세부 정보 페이지로 이동하여 **작업을** 선택한 다음 **배치 예측 중지**를 선택합니다. 배치 예측 작업을 중지하면 작업에 대한 결과가 수신되지 않습니다.

배치 예측 작업의 상태가 로 변경되면 지정된 출력 Amazon S3 버킷에서 작업의 출력을 검색할 `Complete`수 있습니다. 출력 파일의 이름은 형식입니다`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 콘솔에는 배치 예측에 대한 IAM 역할을 선택하는 세 가지 옵션이 있습니다.

1. 새 배치 예측 작업을 생성할 때 역할을 생성합니다.

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