Amazon Fraud Detector 2019-11-15
- Client: Aws\FraudDetector\FraudDetectorClient
- Service ID: frauddetector
- Version: 2019-11-15
This page describes the parameters and results for the operations of the Amazon Fraud Detector (2019-11-15), and shows how to use the Aws\FraudDetector\FraudDetectorClient object to call the described operations. This documentation is specific to the 2019-11-15 API version of the service.
Operation Summary
Each of the following operations can be created from a client using
$client->getCommand('CommandName'), where "CommandName" is the
name of one of the following operations. Note: a command is a value that
encapsulates an operation and the parameters used to create an HTTP request.
You can also create and send a command immediately using the magic methods
available on a client object: $client->commandName(/* parameters */).
You can send the command asynchronously (returning a promise) by appending the
word "Async" to the operation name: $client->commandNameAsync(/* parameters */).
- BatchCreateVariable ( array $params = [] )
Creates a batch of variables.
- BatchGetVariable ( array $params = [] )
Gets a batch of variables.
- CreateDetectorVersion ( array $params = [] )
Creates a detector version.
- CreateModel ( array $params = [] )
Creates a model using the specified model type.
- CreateModelVersion ( array $params = [] )
Creates a version of the model using the specified model type and model id.
- CreateRule ( array $params = [] )
Creates a rule for use with the specified detector.
- CreateVariable ( array $params = [] )
Creates a variable.
- DeleteDetector ( array $params = [] )
Deletes the detector.
- DeleteDetectorVersion ( array $params = [] )
Deletes the detector version.
- DeleteEvent ( array $params = [] )
Deletes the specified event.
- DeleteRule ( array $params = [] )
Deletes the rule.
- DescribeDetector ( array $params = [] )
Gets all versions for a specified detector.
- DescribeModelVersions ( array $params = [] )
Gets all of the model versions for the specified model type or for the specified model type and model ID.
- GetDetectorVersion ( array $params = [] )
Gets a particular detector version.
- GetDetectors ( array $params = [] )
Gets all detectors or a single detector if a detectorId is specified.
- GetEntityTypes ( array $params = [] )
Gets all entity types or a specific entity type if a name is specified.
- GetEventPrediction ( array $params = [] )
Evaluates an event against a detector version.
- GetEventTypes ( array $params = [] )
Gets all event types or a specific event type if name is provided.
- GetExternalModels ( array $params = [] )
Gets the details for one or more Amazon SageMaker models that have been imported into the service.
- GetKMSEncryptionKey ( array $params = [] )
Gets the encryption key if a Key Management Service (KMS) customer master key (CMK) has been specified to be used to encrypt content in Amazon Fraud Detector.
- GetLabels ( array $params = [] )
Gets all labels or a specific label if name is provided.
- GetModelVersion ( array $params = [] )
Gets the details of the specified model version.
- GetModels ( array $params = [] )
Gets one or more models.
- GetOutcomes ( array $params = [] )
Gets one or more outcomes.
- GetRules ( array $params = [] )
Get all rules for a detector (paginated) if ruleId and ruleVersion are not specified.
- GetVariables ( array $params = [] )
Gets all of the variables or the specific variable.
- ListTagsForResource ( array $params = [] )
Lists all tags associated with the resource.
- PutDetector ( array $params = [] )
Creates or updates a detector.
- PutEntityType ( array $params = [] )
Creates or updates an entity type.
- PutEventType ( array $params = [] )
Creates or updates an event type.
- PutExternalModel ( array $params = [] )
Creates or updates an Amazon SageMaker model endpoint.
- PutKMSEncryptionKey ( array $params = [] )
Specifies the Key Management Service (KMS) customer master key (CMK) to be used to encrypt content in Amazon Fraud Detector.
- PutLabel ( array $params = [] )
Creates or updates label.
- PutOutcome ( array $params = [] )
Creates or updates an outcome.
- TagResource ( array $params = [] )
Assigns tags to a resource.
- UntagResource ( array $params = [] )
Removes tags from a resource.
- UpdateDetectorVersion ( array $params = [] )
Updates a detector version.
- UpdateDetectorVersionMetadata ( array $params = [] )
Updates the detector version's description.
- UpdateDetectorVersionStatus ( array $params = [] )
Updates the detector version’s status.
- UpdateModel ( array $params = [] )
Updates a model.
- UpdateModelVersion ( array $params = [] )
Updates a model version.
- UpdateModelVersionStatus ( array $params = [] )
Updates the status of a model version.
- UpdateRuleMetadata ( array $params = [] )
Updates a rule's metadata.
- UpdateRuleVersion ( array $params = [] )
Updates a rule version resulting in a new rule version.
- UpdateVariable ( array $params = [] )
Updates a variable.
Paginators
Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:
Operations
BatchCreateVariable
$result = $client->batchCreateVariable([/* ... */]); $promise = $client->batchCreateVariableAsync([/* ... */]);
Creates a batch of variables.
Parameter Syntax
$result = $client->batchCreateVariable([
'tags' => [
[
'key' => '<string>', // REQUIRED
'value' => '<string>', // REQUIRED
],
// ...
],
'variableEntries' => [ // REQUIRED
[
'dataSource' => '<string>',
'dataType' => '<string>',
'defaultValue' => '<string>',
'description' => '<string>',
'name' => '<string>',
'variableType' => '<string>',
],
// ...
],
]);
Parameter Details
Members
- tags
-
- Type: Array of Tag structures
A collection of key and value pairs.
- variableEntries
-
- Required: Yes
- Type: Array of VariableEntry structures
The list of variables for the batch create variable request.
Result Syntax
[
'errors' => [
[
'code' => <integer>,
'message' => '<string>',
'name' => '<string>',
],
// ...
],
]
Result Details
Members
- errors
-
- Type: Array of BatchCreateVariableError structures
Provides the errors for the
BatchCreateVariablerequest.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
BatchGetVariable
$result = $client->batchGetVariable([/* ... */]); $promise = $client->batchGetVariableAsync([/* ... */]);
Gets a batch of variables.
Parameter Syntax
$result = $client->batchGetVariable([
'names' => ['<string>', ...], // REQUIRED
]);
Parameter Details
Result Syntax
[
'errors' => [
[
'code' => <integer>,
'message' => '<string>',
'name' => '<string>',
],
// ...
],
'variables' => [
[
'arn' => '<string>',
'createdTime' => '<string>',
'dataSource' => 'EVENT|MODEL_SCORE|EXTERNAL_MODEL_SCORE',
'dataType' => 'STRING|INTEGER|FLOAT|BOOLEAN',
'defaultValue' => '<string>',
'description' => '<string>',
'lastUpdatedTime' => '<string>',
'name' => '<string>',
'variableType' => '<string>',
],
// ...
],
]
Result Details
Members
- errors
-
- Type: Array of BatchGetVariableError structures
The errors from the request.
- variables
-
- Type: Array of Variable structures
The returned variables.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
CreateDetectorVersion
$result = $client->createDetectorVersion([/* ... */]); $promise = $client->createDetectorVersionAsync([/* ... */]);
Creates a detector version. The detector version starts in a DRAFT status.
Parameter Syntax
$result = $client->createDetectorVersion([
'description' => '<string>',
'detectorId' => '<string>', // REQUIRED
'externalModelEndpoints' => ['<string>', ...],
'modelVersions' => [
[
'arn' => '<string>',
'modelId' => '<string>', // REQUIRED
'modelType' => 'ONLINE_FRAUD_INSIGHTS', // REQUIRED
'modelVersionNumber' => '<string>', // REQUIRED
],
// ...
],
'ruleExecutionMode' => 'ALL_MATCHED|FIRST_MATCHED',
'rules' => [ // REQUIRED
[
'detectorId' => '<string>', // REQUIRED
'ruleId' => '<string>', // REQUIRED
'ruleVersion' => '<string>', // REQUIRED
],
// ...
],
'tags' => [
[
'key' => '<string>', // REQUIRED
'value' => '<string>', // REQUIRED
],
// ...
],
]);
Parameter Details
Members
- description
-
- Type: string
The description of the detector version.
- detectorId
-
- Required: Yes
- Type: string
The ID of the detector under which you want to create a new version.
- externalModelEndpoints
-
- Type: Array of strings
The Amazon Sagemaker model endpoints to include in the detector version.
- modelVersions
-
- Type: Array of ModelVersion structures
The model versions to include in the detector version.
- ruleExecutionMode
-
- Type: string
The rule execution mode for the rules included in the detector version.
You can define and edit the rule mode at the detector version level, when it is in draft status.
If you specify
FIRST_MATCHED, Amazon Fraud Detector evaluates rules sequentially, first to last, stopping at the first matched rule. Amazon Fraud dectector then provides the outcomes for that single rule.If you specifiy
ALL_MATCHED, Amazon Fraud Detector evaluates all rules and returns the outcomes for all matched rules.The default behavior is
FIRST_MATCHED. - rules
-
- Required: Yes
- Type: Array of Rule structures
The rules to include in the detector version.
- tags
-
- Type: Array of Tag structures
A collection of key and value pairs.
Result Syntax
[
'detectorId' => '<string>',
'detectorVersionId' => '<string>',
'status' => 'DRAFT|ACTIVE|INACTIVE',
]
Result Details
Members
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
CreateModel
$result = $client->createModel([/* ... */]); $promise = $client->createModelAsync([/* ... */]);
Creates a model using the specified model type.
Parameter Syntax
$result = $client->createModel([
'description' => '<string>',
'eventTypeName' => '<string>', // REQUIRED
'modelId' => '<string>', // REQUIRED
'modelType' => 'ONLINE_FRAUD_INSIGHTS', // REQUIRED
'tags' => [
[
'key' => '<string>', // REQUIRED
'value' => '<string>', // REQUIRED
],
// ...
],
]);
Parameter Details
Members
- description
-
- Type: string
The model description.
- eventTypeName
-
- Required: Yes
- Type: string
The name of the event type.
- modelId
-
- Required: Yes
- Type: string
The model ID.
- modelType
-
- Required: Yes
- Type: string
The model type.
- tags
-
- Type: Array of Tag structures
A collection of key and value pairs.
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating an internal server error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
CreateModelVersion
$result = $client->createModelVersion([/* ... */]); $promise = $client->createModelVersionAsync([/* ... */]);
Creates a version of the model using the specified model type and model id.
Parameter Syntax
$result = $client->createModelVersion([
'externalEventsDetail' => [
'dataAccessRoleArn' => '<string>', // REQUIRED
'dataLocation' => '<string>', // REQUIRED
],
'modelId' => '<string>', // REQUIRED
'modelType' => 'ONLINE_FRAUD_INSIGHTS', // REQUIRED
'tags' => [
[
'key' => '<string>', // REQUIRED
'value' => '<string>', // REQUIRED
],
// ...
],
'trainingDataSchema' => [ // REQUIRED
'labelSchema' => [ // REQUIRED
'labelMapper' => [ // REQUIRED
'<string>' => ['<string>', ...],
// ...
],
],
'modelVariables' => ['<string>', ...], // REQUIRED
],
'trainingDataSource' => 'EXTERNAL_EVENTS', // REQUIRED
]);
Parameter Details
Members
- externalEventsDetail
-
- Type: ExternalEventsDetail structure
Details for the external events data used for model version training. Required if
trainingDataSourceisEXTERNAL_EVENTS. - modelId
-
- Required: Yes
- Type: string
The model ID.
- modelType
-
- Required: Yes
- Type: string
The model type.
- tags
-
- Type: Array of Tag structures
A collection of key and value pairs.
- trainingDataSchema
-
- Required: Yes
- Type: TrainingDataSchema structure
The training data schema.
- trainingDataSource
-
- Required: Yes
- Type: string
The training data source location in Amazon S3.
Result Syntax
[
'modelId' => '<string>',
'modelType' => 'ONLINE_FRAUD_INSIGHTS',
'modelVersionNumber' => '<string>',
'status' => '<string>',
]
Result Details
Members
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account. -
An exception indicating an internal server error.
CreateRule
$result = $client->createRule([/* ... */]); $promise = $client->createRuleAsync([/* ... */]);
Creates a rule for use with the specified detector.
Parameter Syntax
$result = $client->createRule([
'description' => '<string>',
'detectorId' => '<string>', // REQUIRED
'expression' => '<string>', // REQUIRED
'language' => 'DETECTORPL', // REQUIRED
'outcomes' => ['<string>', ...], // REQUIRED
'ruleId' => '<string>', // REQUIRED
'tags' => [
[
'key' => '<string>', // REQUIRED
'value' => '<string>', // REQUIRED
],
// ...
],
]);
Parameter Details
Members
- description
-
- Type: string
The rule description.
- detectorId
-
- Required: Yes
- Type: string
The detector ID for the rule's parent detector.
- expression
-
- Required: Yes
- Type: string
The rule expression.
- language
-
- Required: Yes
- Type: string
The language of the rule.
- outcomes
-
- Required: Yes
- Type: Array of strings
The outcome or outcomes returned when the rule expression matches.
- ruleId
-
- Required: Yes
- Type: string
The rule ID.
- tags
-
- Type: Array of Tag structures
A collection of key and value pairs.
Result Syntax
[
'rule' => [
'detectorId' => '<string>',
'ruleId' => '<string>',
'ruleVersion' => '<string>',
],
]
Result Details
Members
- rule
-
- Type: Rule structure
The created rule.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
CreateVariable
$result = $client->createVariable([/* ... */]); $promise = $client->createVariableAsync([/* ... */]);
Creates a variable.
Parameter Syntax
$result = $client->createVariable([
'dataSource' => 'EVENT|MODEL_SCORE|EXTERNAL_MODEL_SCORE', // REQUIRED
'dataType' => 'STRING|INTEGER|FLOAT|BOOLEAN', // REQUIRED
'defaultValue' => '<string>', // REQUIRED
'description' => '<string>',
'name' => '<string>', // REQUIRED
'tags' => [
[
'key' => '<string>', // REQUIRED
'value' => '<string>', // REQUIRED
],
// ...
],
'variableType' => '<string>',
]);
Parameter Details
Members
- dataSource
-
- Required: Yes
- Type: string
The source of the data.
- dataType
-
- Required: Yes
- Type: string
The data type.
- defaultValue
-
- Required: Yes
- Type: string
The default value for the variable when no value is received.
- description
-
- Type: string
The description.
- name
-
- Required: Yes
- Type: string
The name of the variable.
- tags
-
- Type: Array of Tag structures
A collection of key and value pairs.
- variableType
-
- Type: string
The variable type. For more information see Variable types.
Valid Values:
AUTH_CODE | AVS | BILLING_ADDRESS_L1 | BILLING_ADDRESS_L2 | BILLING_CITY | BILLING_COUNTRY | BILLING_NAME | BILLING_PHONE | BILLING_STATE | BILLING_ZIP | CARD_BIN | CATEGORICAL | CURRENCY_CODE | EMAIL_ADDRESS | FINGERPRINT | FRAUD_LABEL | FREE_FORM_TEXT | IP_ADDRESS | NUMERIC | ORDER_ID | PAYMENT_TYPE | PHONE_NUMBER | PRICE | PRODUCT_CATEGORY | SHIPPING_ADDRESS_L1 | SHIPPING_ADDRESS_L2 | SHIPPING_CITY | SHIPPING_COUNTRY | SHIPPING_NAME | SHIPPING_PHONE | SHIPPING_STATE | SHIPPING_ZIP | USERAGENT
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
DeleteDetector
$result = $client->deleteDetector([/* ... */]); $promise = $client->deleteDetectorAsync([/* ... */]);
Deletes the detector. Before deleting a detector, you must first delete all detector versions and rule versions associated with the detector.
Parameter Syntax
$result = $client->deleteDetector([
'detectorId' => '<string>', // REQUIRED
]);
Parameter Details
Result Syntax
[]
Result Details
Errors
-
An exception indicating there was a conflict during a delete operation. The following delete operations can cause a conflict exception:
-
DeleteDetector: A conflict exception will occur if the detector has associated
RulesorDetectorVersions. You can only delete a detector if it has noRulesorDetectorVersions. -
DeleteDetectorVersion: A conflict exception will occur if the
DetectorVersionstatus isACTIVE. -
DeleteRule: A conflict exception will occur if the
RuleVersionis in use by an associatedACTIVEorINACTIVE DetectorVersion.
-
-
An exception indicating a specified value is not allowed.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
DeleteDetectorVersion
$result = $client->deleteDetectorVersion([/* ... */]); $promise = $client->deleteDetectorVersionAsync([/* ... */]);
Deletes the detector version. You cannot delete detector versions that are in ACTIVE status.
Parameter Syntax
$result = $client->deleteDetectorVersion([
'detectorId' => '<string>', // REQUIRED
'detectorVersionId' => '<string>', // REQUIRED
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating there was a conflict during a delete operation. The following delete operations can cause a conflict exception:
-
DeleteDetector: A conflict exception will occur if the detector has associated
RulesorDetectorVersions. You can only delete a detector if it has noRulesorDetectorVersions. -
DeleteDetectorVersion: A conflict exception will occur if the
DetectorVersionstatus isACTIVE. -
DeleteRule: A conflict exception will occur if the
RuleVersionis in use by an associatedACTIVEorINACTIVE DetectorVersion.
-
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
DeleteEvent
$result = $client->deleteEvent([/* ... */]); $promise = $client->deleteEventAsync([/* ... */]);
Deletes the specified event.
Parameter Syntax
$result = $client->deleteEvent([
'eventId' => '<string>', // REQUIRED
'eventTypeName' => '<string>', // REQUIRED
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
DeleteRule
$result = $client->deleteRule([/* ... */]); $promise = $client->deleteRuleAsync([/* ... */]);
Deletes the rule. You cannot delete a rule if it is used by an ACTIVE or INACTIVE detector version.
Parameter Syntax
$result = $client->deleteRule([
'rule' => [ // REQUIRED
'detectorId' => '<string>', // REQUIRED
'ruleId' => '<string>', // REQUIRED
'ruleVersion' => '<string>', // REQUIRED
],
]);
Parameter Details
Members
- rule
-
- Required: Yes
- Type: Rule structure
A rule.
Result Syntax
[]
Result Details
Errors
-
An exception indicating there was a conflict during a delete operation. The following delete operations can cause a conflict exception:
-
DeleteDetector: A conflict exception will occur if the detector has associated
RulesorDetectorVersions. You can only delete a detector if it has noRulesorDetectorVersions. -
DeleteDetectorVersion: A conflict exception will occur if the
DetectorVersionstatus isACTIVE. -
DeleteRule: A conflict exception will occur if the
RuleVersionis in use by an associatedACTIVEorINACTIVE DetectorVersion.
-
-
An exception indicating a specified value is not allowed.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
DescribeDetector
$result = $client->describeDetector([/* ... */]); $promise = $client->describeDetectorAsync([/* ... */]);
Gets all versions for a specified detector.
Parameter Syntax
$result = $client->describeDetector([
'detectorId' => '<string>', // REQUIRED
'maxResults' => <integer>,
'nextToken' => '<string>',
]);
Parameter Details
Members
Result Syntax
[
'arn' => '<string>',
'detectorId' => '<string>',
'detectorVersionSummaries' => [
[
'description' => '<string>',
'detectorVersionId' => '<string>',
'lastUpdatedTime' => '<string>',
'status' => 'DRAFT|ACTIVE|INACTIVE',
],
// ...
],
'nextToken' => '<string>',
]
Result Details
Members
- arn
-
- Type: string
The detector ARN.
- detectorId
-
- Type: string
The detector ID.
- detectorVersionSummaries
-
- Type: Array of DetectorVersionSummary structures
The status and description for each detector version.
- nextToken
-
- Type: string
The next token to be used for subsequent requests.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
DescribeModelVersions
$result = $client->describeModelVersions([/* ... */]); $promise = $client->describeModelVersionsAsync([/* ... */]);
Gets all of the model versions for the specified model type or for the specified model type and model ID. You can also get details for a single, specified model version.
Parameter Syntax
$result = $client->describeModelVersions([
'maxResults' => <integer>,
'modelId' => '<string>',
'modelType' => 'ONLINE_FRAUD_INSIGHTS',
'modelVersionNumber' => '<string>',
'nextToken' => '<string>',
]);
Parameter Details
Members
Result Syntax
[
'modelVersionDetails' => [
[
'arn' => '<string>',
'createdTime' => '<string>',
'externalEventsDetail' => [
'dataAccessRoleArn' => '<string>',
'dataLocation' => '<string>',
],
'lastUpdatedTime' => '<string>',
'modelId' => '<string>',
'modelType' => 'ONLINE_FRAUD_INSIGHTS',
'modelVersionNumber' => '<string>',
'status' => '<string>',
'trainingDataSchema' => [
'labelSchema' => [
'labelMapper' => [
'<string>' => ['<string>', ...],
// ...
],
],
'modelVariables' => ['<string>', ...],
],
'trainingDataSource' => 'EXTERNAL_EVENTS',
'trainingResult' => [
'dataValidationMetrics' => [
'fieldLevelMessages' => [
[
'content' => '<string>',
'fieldName' => '<string>',
'identifier' => '<string>',
'title' => '<string>',
'type' => '<string>',
],
// ...
],
'fileLevelMessages' => [
[
'content' => '<string>',
'title' => '<string>',
'type' => '<string>',
],
// ...
],
],
'trainingMetrics' => [
'auc' => <float>,
'metricDataPoints' => [
[
'fpr' => <float>,
'precision' => <float>,
'threshold' => <float>,
'tpr' => <float>,
],
// ...
],
],
],
],
// ...
],
'nextToken' => '<string>',
]
Result Details
Members
- modelVersionDetails
-
- Type: Array of ModelVersionDetail structures
The model version details.
- nextToken
-
- Type: string
The next token.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
GetDetectorVersion
$result = $client->getDetectorVersion([/* ... */]); $promise = $client->getDetectorVersionAsync([/* ... */]);
Gets a particular detector version.
Parameter Syntax
$result = $client->getDetectorVersion([
'detectorId' => '<string>', // REQUIRED
'detectorVersionId' => '<string>', // REQUIRED
]);
Parameter Details
Members
Result Syntax
[
'arn' => '<string>',
'createdTime' => '<string>',
'description' => '<string>',
'detectorId' => '<string>',
'detectorVersionId' => '<string>',
'externalModelEndpoints' => ['<string>', ...],
'lastUpdatedTime' => '<string>',
'modelVersions' => [
[
'arn' => '<string>',
'modelId' => '<string>',
'modelType' => 'ONLINE_FRAUD_INSIGHTS',
'modelVersionNumber' => '<string>',
],
// ...
],
'ruleExecutionMode' => 'ALL_MATCHED|FIRST_MATCHED',
'rules' => [
[
'detectorId' => '<string>',
'ruleId' => '<string>',
'ruleVersion' => '<string>',
],
// ...
],
'status' => 'DRAFT|ACTIVE|INACTIVE',
]
Result Details
Members
- arn
-
- Type: string
The detector version ARN.
- createdTime
-
- Type: string
The timestamp when the detector version was created.
- description
-
- Type: string
The detector version description.
- detectorId
-
- Type: string
The detector ID.
- detectorVersionId
-
- Type: string
The detector version ID.
- externalModelEndpoints
-
- Type: Array of strings
The Amazon SageMaker model endpoints included in the detector version.
- lastUpdatedTime
-
- Type: string
The timestamp when the detector version was last updated.
- modelVersions
-
- Type: Array of ModelVersion structures
The model versions included in the detector version.
- ruleExecutionMode
-
- Type: string
The execution mode of the rule in the dectector
FIRST_MATCHEDindicates that Amazon Fraud Detector evaluates rules sequentially, first to last, stopping at the first matched rule. Amazon Fraud dectector then provides the outcomes for that single rule.ALL_MATCHEDindicates that Amazon Fraud Detector evaluates all rules and returns the outcomes for all matched rules. You can define and edit the rule mode at the detector version level, when it is in draft status. - rules
-
- Type: Array of Rule structures
The rules included in the detector version.
- status
-
- Type: string
The status of the detector version.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
GetDetectors
$result = $client->getDetectors([/* ... */]); $promise = $client->getDetectorsAsync([/* ... */]);
Gets all detectors or a single detector if a detectorId is specified. This is a paginated API. If you provide a null maxResults, this action retrieves a maximum of 10 records per page. If you provide a maxResults, the value must be between 5 and 10. To get the next page results, provide the pagination token from the GetDetectorsResponse as part of your request. A null pagination token fetches the records from the beginning.
Parameter Syntax
$result = $client->getDetectors([
'detectorId' => '<string>',
'maxResults' => <integer>,
'nextToken' => '<string>',
]);
Parameter Details
Members
Result Syntax
[
'detectors' => [
[
'arn' => '<string>',
'createdTime' => '<string>',
'description' => '<string>',
'detectorId' => '<string>',
'eventTypeName' => '<string>',
'lastUpdatedTime' => '<string>',
],
// ...
],
'nextToken' => '<string>',
]
Result Details
Members
- detectors
-
- Type: Array of Detector structures
The detectors.
- nextToken
-
- Type: string
The next page token.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
GetEntityTypes
$result = $client->getEntityTypes([/* ... */]); $promise = $client->getEntityTypesAsync([/* ... */]);
Gets all entity types or a specific entity type if a name is specified. This is a paginated API. If you provide a null maxResults, this action retrieves a maximum of 10 records per page. If you provide a maxResults, the value must be between 5 and 10. To get the next page results, provide the pagination token from the GetEntityTypesResponse as part of your request. A null pagination token fetches the records from the beginning.
Parameter Syntax
$result = $client->getEntityTypes([
'maxResults' => <integer>,
'name' => '<string>',
'nextToken' => '<string>',
]);
Parameter Details
Members
Result Syntax
[
'entityTypes' => [
[
'arn' => '<string>',
'createdTime' => '<string>',
'description' => '<string>',
'lastUpdatedTime' => '<string>',
'name' => '<string>',
],
// ...
],
'nextToken' => '<string>',
]
Result Details
Members
- entityTypes
-
- Type: Array of EntityType structures
An array of entity types.
- nextToken
-
- Type: string
The next page token.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
GetEventPrediction
$result = $client->getEventPrediction([/* ... */]); $promise = $client->getEventPredictionAsync([/* ... */]);
Evaluates an event against a detector version. If a version ID is not provided, the detector’s (ACTIVE) version is used.
Parameter Syntax
$result = $client->getEventPrediction([
'detectorId' => '<string>', // REQUIRED
'detectorVersionId' => '<string>',
'entities' => [ // REQUIRED
[
'entityId' => '<string>', // REQUIRED
'entityType' => '<string>', // REQUIRED
],
// ...
],
'eventId' => '<string>', // REQUIRED
'eventTimestamp' => '<string>', // REQUIRED
'eventTypeName' => '<string>', // REQUIRED
'eventVariables' => ['<string>', ...], // REQUIRED
'externalModelEndpointDataBlobs' => [
'<string>' => [
'byteBuffer' => <string || resource || Psr\Http\Message\StreamInterface>,
'contentType' => '<string>',
],
// ...
],
]);
Parameter Details
Members
- detectorId
-
- Required: Yes
- Type: string
The detector ID.
- detectorVersionId
-
- Type: string
The detector version ID.
- entities
-
- Required: Yes
- Type: Array of Entity structures
The entity type (associated with the detector's event type) and specific entity ID representing who performed the event. If an entity id is not available, use "UNKNOWN."
- eventId
-
- Required: Yes
- Type: string
The unique ID used to identify the event.
- eventTimestamp
-
- Required: Yes
- Type: string
Timestamp that defines when the event under evaluation occurred.
- eventTypeName
-
- Required: Yes
- Type: string
The event type associated with the detector specified for the prediction.
- eventVariables
-
- Required: Yes
- Type: Associative array of custom strings keys (variableName) to strings
Names of the event type's variables you defined in Amazon Fraud Detector to represent data elements and their corresponding values for the event you are sending for evaluation.
- externalModelEndpointDataBlobs
-
- Type: Associative array of custom strings keys (string) to ModelEndpointDataBlob structures
The Amazon SageMaker model endpoint input data blobs.
Result Syntax
[
'modelScores' => [
[
'modelVersion' => [
'arn' => '<string>',
'modelId' => '<string>',
'modelType' => 'ONLINE_FRAUD_INSIGHTS',
'modelVersionNumber' => '<string>',
],
'scores' => [<float>, ...],
],
// ...
],
'ruleResults' => [
[
'outcomes' => ['<string>', ...],
'ruleId' => '<string>',
],
// ...
],
]
Result Details
Members
- modelScores
-
- Type: Array of ModelScores structures
The model scores. Amazon Fraud Detector generates model scores between 0 and 1000, where 0 is low fraud risk and 1000 is high fraud risk. Model scores are directly related to the false positive rate (FPR). For example, a score of 600 corresponds to an estimated 10% false positive rate whereas a score of 900 corresponds to an estimated 2% false positive rate.
- ruleResults
-
- Type: Array of RuleResult structures
The results.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
GetEventTypes
$result = $client->getEventTypes([/* ... */]); $promise = $client->getEventTypesAsync([/* ... */]);
Gets all event types or a specific event type if name is provided. This is a paginated API. If you provide a null maxResults, this action retrieves a maximum of 10 records per page. If you provide a maxResults, the value must be between 5 and 10. To get the next page results, provide the pagination token from the GetEventTypesResponse as part of your request. A null pagination token fetches the records from the beginning.
Parameter Syntax
$result = $client->getEventTypes([
'maxResults' => <integer>,
'name' => '<string>',
'nextToken' => '<string>',
]);
Parameter Details
Members
Result Syntax
[
'eventTypes' => [
[
'arn' => '<string>',
'createdTime' => '<string>',
'description' => '<string>',
'entityTypes' => ['<string>', ...],
'eventVariables' => ['<string>', ...],
'labels' => ['<string>', ...],
'lastUpdatedTime' => '<string>',
'name' => '<string>',
],
// ...
],
'nextToken' => '<string>',
]
Result Details
Members
- eventTypes
-
- Type: Array of EventType structures
An array of event types.
- nextToken
-
- Type: string
The next page token.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
GetExternalModels
$result = $client->getExternalModels([/* ... */]); $promise = $client->getExternalModelsAsync([/* ... */]);
Gets the details for one or more Amazon SageMaker models that have been imported into the service. This is a paginated API. If you provide a null maxResults, this actions retrieves a maximum of 10 records per page. If you provide a maxResults, the value must be between 5 and 10. To get the next page results, provide the pagination token from the GetExternalModelsResult as part of your request. A null pagination token fetches the records from the beginning.
Parameter Syntax
$result = $client->getExternalModels([
'maxResults' => <integer>,
'modelEndpoint' => '<string>',
'nextToken' => '<string>',
]);
Parameter Details
Members
Result Syntax
[
'externalModels' => [
[
'arn' => '<string>',
'createdTime' => '<string>',
'inputConfiguration' => [
'csvInputTemplate' => '<string>',
'eventTypeName' => '<string>',
'format' => 'TEXT_CSV|APPLICATION_JSON',
'jsonInputTemplate' => '<string>',
'useEventVariables' => true || false,
],
'invokeModelEndpointRoleArn' => '<string>',
'lastUpdatedTime' => '<string>',
'modelEndpoint' => '<string>',
'modelEndpointStatus' => 'ASSOCIATED|DISSOCIATED',
'modelSource' => 'SAGEMAKER',
'outputConfiguration' => [
'csvIndexToVariableMap' => ['<string>', ...],
'format' => 'TEXT_CSV|APPLICATION_JSONLINES',
'jsonKeyToVariableMap' => ['<string>', ...],
],
],
// ...
],
'nextToken' => '<string>',
]
Result Details
Members
- externalModels
-
- Type: Array of ExternalModel structures
Gets the Amazon SageMaker models.
- nextToken
-
- Type: string
The next page token to be used in subsequent requests.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
GetKMSEncryptionKey
$result = $client->getKMSEncryptionKey([/* ... */]); $promise = $client->getKMSEncryptionKeyAsync([/* ... */]);
Gets the encryption key if a Key Management Service (KMS) customer master key (CMK) has been specified to be used to encrypt content in Amazon Fraud Detector.
Parameter Syntax
$result = $client->getKMSEncryptionKey([ ]);
Parameter Details
Members
Result Syntax
[
'kmsKey' => [
'kmsEncryptionKeyArn' => '<string>',
],
]
Result Details
Members
- kmsKey
-
- Type: KMSKey structure
The KMS encryption key.
Errors
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
GetLabels
$result = $client->getLabels([/* ... */]); $promise = $client->getLabelsAsync([/* ... */]);
Gets all labels or a specific label if name is provided. This is a paginated API. If you provide a null maxResults, this action retrieves a maximum of 50 records per page. If you provide a maxResults, the value must be between 10 and 50. To get the next page results, provide the pagination token from the GetGetLabelsResponse as part of your request. A null pagination token fetches the records from the beginning.
Parameter Syntax
$result = $client->getLabels([
'maxResults' => <integer>,
'name' => '<string>',
'nextToken' => '<string>',
]);
Parameter Details
Members
Result Syntax
[
'labels' => [
[
'arn' => '<string>',
'createdTime' => '<string>',
'description' => '<string>',
'lastUpdatedTime' => '<string>',
'name' => '<string>',
],
// ...
],
'nextToken' => '<string>',
]
Result Details
Members
- labels
-
- Type: Array of Label structures
An array of labels.
- nextToken
-
- Type: string
The next page token.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
GetModelVersion
$result = $client->getModelVersion([/* ... */]); $promise = $client->getModelVersionAsync([/* ... */]);
Gets the details of the specified model version.
Parameter Syntax
$result = $client->getModelVersion([
'modelId' => '<string>', // REQUIRED
'modelType' => 'ONLINE_FRAUD_INSIGHTS', // REQUIRED
'modelVersionNumber' => '<string>', // REQUIRED
]);
Parameter Details
Members
Result Syntax
[
'arn' => '<string>',
'externalEventsDetail' => [
'dataAccessRoleArn' => '<string>',
'dataLocation' => '<string>',
],
'modelId' => '<string>',
'modelType' => 'ONLINE_FRAUD_INSIGHTS',
'modelVersionNumber' => '<string>',
'status' => '<string>',
'trainingDataSchema' => [
'labelSchema' => [
'labelMapper' => [
'<string>' => ['<string>', ...],
// ...
],
],
'modelVariables' => ['<string>', ...],
],
'trainingDataSource' => 'EXTERNAL_EVENTS',
]
Result Details
Members
- arn
-
- Type: string
The model version ARN.
- externalEventsDetail
-
- Type: ExternalEventsDetail structure
The event details.
- modelId
-
- Type: string
The model ID.
- modelType
-
- Type: string
The model type.
- modelVersionNumber
-
- Type: string
The model version number.
- status
-
- Type: string
The model version status.
- trainingDataSchema
-
- Type: TrainingDataSchema structure
The training data schema.
- trainingDataSource
-
- Type: string
The training data source.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
GetModels
$result = $client->getModels([/* ... */]); $promise = $client->getModelsAsync([/* ... */]);
Gets one or more models. Gets all models for the AWS account if no model type and no model id provided. Gets all models for the AWS account and model type, if the model type is specified but model id is not provided. Gets a specific model if (model type, model id) tuple is specified.
This is a paginated API. If you provide a null maxResults, this action retrieves a maximum of 10 records per page. If you provide a maxResults, the value must be between 1 and 10. To get the next page results, provide the pagination token from the response as part of your request. A null pagination token fetches the records from the beginning.
Parameter Syntax
$result = $client->getModels([
'maxResults' => <integer>,
'modelId' => '<string>',
'modelType' => 'ONLINE_FRAUD_INSIGHTS',
'nextToken' => '<string>',
]);
Parameter Details
Members
Result Syntax
[
'models' => [
[
'arn' => '<string>',
'createdTime' => '<string>',
'description' => '<string>',
'eventTypeName' => '<string>',
'lastUpdatedTime' => '<string>',
'modelId' => '<string>',
'modelType' => 'ONLINE_FRAUD_INSIGHTS',
],
// ...
],
'nextToken' => '<string>',
]
Result Details
Members
- models
-
- Type: Array of Model structures
The array of models.
- nextToken
-
- Type: string
The next page token to be used in subsequent requests.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
GetOutcomes
$result = $client->getOutcomes([/* ... */]); $promise = $client->getOutcomesAsync([/* ... */]);
Gets one or more outcomes. This is a paginated API. If you provide a null maxResults, this actions retrieves a maximum of 100 records per page. If you provide a maxResults, the value must be between 50 and 100. To get the next page results, provide the pagination token from the GetOutcomesResult as part of your request. A null pagination token fetches the records from the beginning.
Parameter Syntax
$result = $client->getOutcomes([
'maxResults' => <integer>,
'name' => '<string>',
'nextToken' => '<string>',
]);
Parameter Details
Members
Result Syntax
[
'nextToken' => '<string>',
'outcomes' => [
[
'arn' => '<string>',
'createdTime' => '<string>',
'description' => '<string>',
'lastUpdatedTime' => '<string>',
'name' => '<string>',
],
// ...
],
]
Result Details
Members
- nextToken
-
- Type: string
The next page token for subsequent requests.
- outcomes
-
- Type: Array of Outcome structures
The outcomes.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
GetRules
$result = $client->getRules([/* ... */]); $promise = $client->getRulesAsync([/* ... */]);
Get all rules for a detector (paginated) if ruleId and ruleVersion are not specified. Gets all rules for the detector and the ruleId if present (paginated). Gets a specific rule if both the ruleId and the ruleVersion are specified.
This is a paginated API. Providing null maxResults results in retrieving maximum of 100 records per page. If you provide maxResults the value must be between 50 and 100. To get the next page result, a provide a pagination token from GetRulesResult as part of your request. Null pagination token fetches the records from the beginning.
Parameter Syntax
$result = $client->getRules([
'detectorId' => '<string>', // REQUIRED
'maxResults' => <integer>,
'nextToken' => '<string>',
'ruleId' => '<string>',
'ruleVersion' => '<string>',
]);
Parameter Details
Members
Result Syntax
[
'nextToken' => '<string>',
'ruleDetails' => [
[
'arn' => '<string>',
'createdTime' => '<string>',
'description' => '<string>',
'detectorId' => '<string>',
'expression' => '<string>',
'language' => 'DETECTORPL',
'lastUpdatedTime' => '<string>',
'outcomes' => ['<string>', ...],
'ruleId' => '<string>',
'ruleVersion' => '<string>',
],
// ...
],
]
Result Details
Members
- nextToken
-
- Type: string
The next page token to be used in subsequent requests.
- ruleDetails
-
- Type: Array of RuleDetail structures
The details of the requested rule.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
GetVariables
$result = $client->getVariables([/* ... */]); $promise = $client->getVariablesAsync([/* ... */]);
Gets all of the variables or the specific variable. This is a paginated API. Providing null maxSizePerPage results in retrieving maximum of 100 records per page. If you provide maxSizePerPage the value must be between 50 and 100. To get the next page result, a provide a pagination token from GetVariablesResult as part of your request. Null pagination token fetches the records from the beginning.
Parameter Syntax
$result = $client->getVariables([
'maxResults' => <integer>,
'name' => '<string>',
'nextToken' => '<string>',
]);
Parameter Details
Members
Result Syntax
[
'nextToken' => '<string>',
'variables' => [
[
'arn' => '<string>',
'createdTime' => '<string>',
'dataSource' => 'EVENT|MODEL_SCORE|EXTERNAL_MODEL_SCORE',
'dataType' => 'STRING|INTEGER|FLOAT|BOOLEAN',
'defaultValue' => '<string>',
'description' => '<string>',
'lastUpdatedTime' => '<string>',
'name' => '<string>',
'variableType' => '<string>',
],
// ...
],
]
Result Details
Members
- nextToken
-
- Type: string
The next page token to be used in subsequent requests.
- variables
-
- Type: Array of Variable structures
The names of the variables returned.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
ListTagsForResource
$result = $client->listTagsForResource([/* ... */]); $promise = $client->listTagsForResourceAsync([/* ... */]);
Lists all tags associated with the resource. This is a paginated API. To get the next page results, provide the pagination token from the response as part of your request. A null pagination token fetches the records from the beginning.
Parameter Syntax
$result = $client->listTagsForResource([
'maxResults' => <integer>,
'nextToken' => '<string>',
'resourceARN' => '<string>', // REQUIRED
]);
Parameter Details
Members
Result Syntax
[
'nextToken' => '<string>',
'tags' => [
[
'key' => '<string>',
'value' => '<string>',
],
// ...
],
]
Result Details
Members
- nextToken
-
- Type: string
The next token for subsequent requests.
- tags
-
- Type: Array of Tag structures
A collection of key and value pairs.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
PutDetector
$result = $client->putDetector([/* ... */]); $promise = $client->putDetectorAsync([/* ... */]);
Creates or updates a detector.
Parameter Syntax
$result = $client->putDetector([
'description' => '<string>',
'detectorId' => '<string>', // REQUIRED
'eventTypeName' => '<string>', // REQUIRED
'tags' => [
[
'key' => '<string>', // REQUIRED
'value' => '<string>', // REQUIRED
],
// ...
],
]);
Parameter Details
Members
- description
-
- Type: string
The description of the detector.
- detectorId
-
- Required: Yes
- Type: string
The detector ID.
- eventTypeName
-
- Required: Yes
- Type: string
The name of the event type.
- tags
-
- Type: Array of Tag structures
A collection of key and value pairs.
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
PutEntityType
$result = $client->putEntityType([/* ... */]); $promise = $client->putEntityTypeAsync([/* ... */]);
Creates or updates an entity type. An entity represents who is performing the event. As part of a fraud prediction, you pass the entity ID to indicate the specific entity who performed the event. An entity type classifies the entity. Example classifications include customer, merchant, or account.
Parameter Syntax
$result = $client->putEntityType([
'description' => '<string>',
'name' => '<string>', // REQUIRED
'tags' => [
[
'key' => '<string>', // REQUIRED
'value' => '<string>', // REQUIRED
],
// ...
],
]);
Parameter Details
Members
- description
-
- Type: string
The description.
- name
-
- Required: Yes
- Type: string
The name of the entity type.
- tags
-
- Type: Array of Tag structures
A collection of key and value pairs.
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating an internal server error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
PutEventType
$result = $client->putEventType([/* ... */]); $promise = $client->putEventTypeAsync([/* ... */]);
Creates or updates an event type. An event is a business activity that is evaluated for fraud risk. With Amazon Fraud Detector, you generate fraud predictions for events. An event type defines the structure for an event sent to Amazon Fraud Detector. This includes the variables sent as part of the event, the entity performing the event (such as a customer), and the labels that classify the event. Example event types include online payment transactions, account registrations, and authentications.
Parameter Syntax
$result = $client->putEventType([
'description' => '<string>',
'entityTypes' => ['<string>', ...], // REQUIRED
'eventVariables' => ['<string>', ...], // REQUIRED
'labels' => ['<string>', ...],
'name' => '<string>', // REQUIRED
'tags' => [
[
'key' => '<string>', // REQUIRED
'value' => '<string>', // REQUIRED
],
// ...
],
]);
Parameter Details
Members
- description
-
- Type: string
The description of the event type.
- entityTypes
-
- Required: Yes
- Type: Array of strings
The entity type for the event type. Example entity types: customer, merchant, account.
- eventVariables
-
- Required: Yes
- Type: Array of strings
The event type variables.
- labels
-
- Type: Array of strings
The event type labels.
- name
-
- Required: Yes
- Type: string
The name.
- tags
-
- Type: Array of Tag structures
A collection of key and value pairs.
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating an internal server error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
PutExternalModel
$result = $client->putExternalModel([/* ... */]); $promise = $client->putExternalModelAsync([/* ... */]);
Creates or updates an Amazon SageMaker model endpoint. You can also use this action to update the configuration of the model endpoint, including the IAM role and/or the mapped variables.
Parameter Syntax
$result = $client->putExternalModel([
'inputConfiguration' => [ // REQUIRED
'csvInputTemplate' => '<string>',
'eventTypeName' => '<string>',
'format' => 'TEXT_CSV|APPLICATION_JSON',
'jsonInputTemplate' => '<string>',
'useEventVariables' => true || false, // REQUIRED
],
'invokeModelEndpointRoleArn' => '<string>', // REQUIRED
'modelEndpoint' => '<string>', // REQUIRED
'modelEndpointStatus' => 'ASSOCIATED|DISSOCIATED', // REQUIRED
'modelSource' => 'SAGEMAKER', // REQUIRED
'outputConfiguration' => [ // REQUIRED
'csvIndexToVariableMap' => ['<string>', ...],
'format' => 'TEXT_CSV|APPLICATION_JSONLINES', // REQUIRED
'jsonKeyToVariableMap' => ['<string>', ...],
],
'tags' => [
[
'key' => '<string>', // REQUIRED
'value' => '<string>', // REQUIRED
],
// ...
],
]);
Parameter Details
Members
- inputConfiguration
-
- Required: Yes
- Type: ModelInputConfiguration structure
The model endpoint input configuration.
- invokeModelEndpointRoleArn
-
- Required: Yes
- Type: string
The IAM role used to invoke the model endpoint.
- modelEndpoint
-
- Required: Yes
- Type: string
The model endpoints name.
- modelEndpointStatus
-
- Required: Yes
- Type: string
The model endpoint’s status in Amazon Fraud Detector.
- modelSource
-
- Required: Yes
- Type: string
The source of the model.
- outputConfiguration
-
- Required: Yes
- Type: ModelOutputConfiguration structure
The model endpoint output configuration.
- tags
-
- Type: Array of Tag structures
A collection of key and value pairs.
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
PutKMSEncryptionKey
$result = $client->putKMSEncryptionKey([/* ... */]); $promise = $client->putKMSEncryptionKeyAsync([/* ... */]);
Specifies the Key Management Service (KMS) customer master key (CMK) to be used to encrypt content in Amazon Fraud Detector.
Parameter Syntax
$result = $client->putKMSEncryptionKey([
'kmsEncryptionKeyArn' => '<string>', // REQUIRED
]);
Parameter Details
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
PutLabel
$result = $client->putLabel([/* ... */]); $promise = $client->putLabelAsync([/* ... */]);
Creates or updates label. A label classifies an event as fraudulent or legitimate. Labels are associated with event types and used to train supervised machine learning models in Amazon Fraud Detector.
Parameter Syntax
$result = $client->putLabel([
'description' => '<string>',
'name' => '<string>', // REQUIRED
'tags' => [
[
'key' => '<string>', // REQUIRED
'value' => '<string>', // REQUIRED
],
// ...
],
]);
Parameter Details
Members
- description
-
- Type: string
The label description.
- name
-
- Required: Yes
- Type: string
The label name.
- tags
-
- Type: Array of Tag structures
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating an internal server error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
PutOutcome
$result = $client->putOutcome([/* ... */]); $promise = $client->putOutcomeAsync([/* ... */]);
Creates or updates an outcome.
Parameter Syntax
$result = $client->putOutcome([
'description' => '<string>',
'name' => '<string>', // REQUIRED
'tags' => [
[
'key' => '<string>', // REQUIRED
'value' => '<string>', // REQUIRED
],
// ...
],
]);
Parameter Details
Members
- description
-
- Type: string
The outcome description.
- name
-
- Required: Yes
- Type: string
The name of the outcome.
- tags
-
- Type: Array of Tag structures
A collection of key and value pairs.
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
TagResource
$result = $client->tagResource([/* ... */]); $promise = $client->tagResourceAsync([/* ... */]);
Assigns tags to a resource.
Parameter Syntax
$result = $client->tagResource([
'resourceARN' => '<string>', // REQUIRED
'tags' => [ // REQUIRED
[
'key' => '<string>', // REQUIRED
'value' => '<string>', // REQUIRED
],
// ...
],
]);
Parameter Details
Members
- resourceARN
-
- Required: Yes
- Type: string
The resource ARN.
- tags
-
- Required: Yes
- Type: Array of Tag structures
The tags to assign to the resource.
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
UntagResource
$result = $client->untagResource([/* ... */]); $promise = $client->untagResourceAsync([/* ... */]);
Removes tags from a resource.
Parameter Syntax
$result = $client->untagResource([
'resourceARN' => '<string>', // REQUIRED
'tagKeys' => ['<string>', ...], // REQUIRED
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
UpdateDetectorVersion
$result = $client->updateDetectorVersion([/* ... */]); $promise = $client->updateDetectorVersionAsync([/* ... */]);
Updates a detector version. The detector version attributes that you can update include models, external model endpoints, rules, rule execution mode, and description. You can only update a DRAFT detector version.
Parameter Syntax
$result = $client->updateDetectorVersion([
'description' => '<string>',
'detectorId' => '<string>', // REQUIRED
'detectorVersionId' => '<string>', // REQUIRED
'externalModelEndpoints' => ['<string>', ...], // REQUIRED
'modelVersions' => [
[
'arn' => '<string>',
'modelId' => '<string>', // REQUIRED
'modelType' => 'ONLINE_FRAUD_INSIGHTS', // REQUIRED
'modelVersionNumber' => '<string>', // REQUIRED
],
// ...
],
'ruleExecutionMode' => 'ALL_MATCHED|FIRST_MATCHED',
'rules' => [ // REQUIRED
[
'detectorId' => '<string>', // REQUIRED
'ruleId' => '<string>', // REQUIRED
'ruleVersion' => '<string>', // REQUIRED
],
// ...
],
]);
Parameter Details
Members
- description
-
- Type: string
The detector version description.
- detectorId
-
- Required: Yes
- Type: string
The parent detector ID for the detector version you want to update.
- detectorVersionId
-
- Required: Yes
- Type: string
The detector version ID.
- externalModelEndpoints
-
- Required: Yes
- Type: Array of strings
The Amazon SageMaker model endpoints to include in the detector version.
- modelVersions
-
- Type: Array of ModelVersion structures
The model versions to include in the detector version.
- ruleExecutionMode
-
- Type: string
The rule execution mode to add to the detector.
If you specify
FIRST_MATCHED, Amazon Fraud Detector evaluates rules sequentially, first to last, stopping at the first matched rule. Amazon Fraud dectector then provides the outcomes for that single rule.If you specifiy
ALL_MATCHED, Amazon Fraud Detector evaluates all rules and returns the outcomes for all matched rules. You can define and edit the rule mode at the detector version level, when it is in draft status.The default behavior is
FIRST_MATCHED. - rules
-
- Required: Yes
- Type: Array of Rule structures
The rules to include in the detector version.
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
UpdateDetectorVersionMetadata
$result = $client->updateDetectorVersionMetadata([/* ... */]); $promise = $client->updateDetectorVersionMetadataAsync([/* ... */]);
Updates the detector version's description. You can update the metadata for any detector version (DRAFT, ACTIVE, or INACTIVE).
Parameter Syntax
$result = $client->updateDetectorVersionMetadata([
'description' => '<string>', // REQUIRED
'detectorId' => '<string>', // REQUIRED
'detectorVersionId' => '<string>', // REQUIRED
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
UpdateDetectorVersionStatus
$result = $client->updateDetectorVersionStatus([/* ... */]); $promise = $client->updateDetectorVersionStatusAsync([/* ... */]);
Updates the detector version’s status. You can perform the following promotions or demotions using UpdateDetectorVersionStatus: DRAFT to ACTIVE, ACTIVE to INACTIVE, and INACTIVE to ACTIVE.
Parameter Syntax
$result = $client->updateDetectorVersionStatus([
'detectorId' => '<string>', // REQUIRED
'detectorVersionId' => '<string>', // REQUIRED
'status' => 'DRAFT|ACTIVE|INACTIVE', // REQUIRED
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
UpdateModel
$result = $client->updateModel([/* ... */]); $promise = $client->updateModelAsync([/* ... */]);
Updates a model. You can update the description attribute using this action.
Parameter Syntax
$result = $client->updateModel([
'description' => '<string>',
'modelId' => '<string>', // REQUIRED
'modelType' => 'ONLINE_FRAUD_INSIGHTS', // REQUIRED
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
UpdateModelVersion
$result = $client->updateModelVersion([/* ... */]); $promise = $client->updateModelVersionAsync([/* ... */]);
Updates a model version. Updating a model version retrains an existing model version using updated training data and produces a new minor version of the model. You can update the training data set location and data access role attributes using this action. This action creates and trains a new minor version of the model, for example version 1.01, 1.02, 1.03.
Parameter Syntax
$result = $client->updateModelVersion([
'externalEventsDetail' => [
'dataAccessRoleArn' => '<string>', // REQUIRED
'dataLocation' => '<string>', // REQUIRED
],
'majorVersionNumber' => '<string>', // REQUIRED
'modelId' => '<string>', // REQUIRED
'modelType' => 'ONLINE_FRAUD_INSIGHTS', // REQUIRED
'tags' => [
[
'key' => '<string>', // REQUIRED
'value' => '<string>', // REQUIRED
],
// ...
],
]);
Parameter Details
Members
- externalEventsDetail
-
- Type: ExternalEventsDetail structure
The event details.
- majorVersionNumber
-
- Required: Yes
- Type: string
The major version number.
- modelId
-
- Required: Yes
- Type: string
The model ID.
- modelType
-
- Required: Yes
- Type: string
The model type.
- tags
-
- Type: Array of Tag structures
A collection of key and value pairs.
Result Syntax
[
'modelId' => '<string>',
'modelType' => 'ONLINE_FRAUD_INSIGHTS',
'modelVersionNumber' => '<string>',
'status' => '<string>',
]
Result Details
Members
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account. -
An exception indicating an internal server error.
UpdateModelVersionStatus
$result = $client->updateModelVersionStatus([/* ... */]); $promise = $client->updateModelVersionStatusAsync([/* ... */]);
Updates the status of a model version.
You can perform the following status updates:
-
Change the
TRAINING_COMPLETEstatus toACTIVE. -
Change
ACTIVEtoINACTIVE.
Parameter Syntax
$result = $client->updateModelVersionStatus([
'modelId' => '<string>', // REQUIRED
'modelType' => 'ONLINE_FRAUD_INSIGHTS', // REQUIRED
'modelVersionNumber' => '<string>', // REQUIRED
'status' => 'ACTIVE|INACTIVE', // REQUIRED
]);
Parameter Details
Members
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
UpdateRuleMetadata
$result = $client->updateRuleMetadata([/* ... */]); $promise = $client->updateRuleMetadataAsync([/* ... */]);
Updates a rule's metadata. The description attribute can be updated.
Parameter Syntax
$result = $client->updateRuleMetadata([
'description' => '<string>', // REQUIRED
'rule' => [ // REQUIRED
'detectorId' => '<string>', // REQUIRED
'ruleId' => '<string>', // REQUIRED
'ruleVersion' => '<string>', // REQUIRED
],
]);
Parameter Details
Members
- description
-
- Required: Yes
- Type: string
The rule description.
- rule
-
- Required: Yes
- Type: Rule structure
The rule to update.
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
UpdateRuleVersion
$result = $client->updateRuleVersion([/* ... */]); $promise = $client->updateRuleVersionAsync([/* ... */]);
Updates a rule version resulting in a new rule version. Updates a rule version resulting in a new rule version (version 1, 2, 3 ...).
Parameter Syntax
$result = $client->updateRuleVersion([
'description' => '<string>',
'expression' => '<string>', // REQUIRED
'language' => 'DETECTORPL', // REQUIRED
'outcomes' => ['<string>', ...], // REQUIRED
'rule' => [ // REQUIRED
'detectorId' => '<string>', // REQUIRED
'ruleId' => '<string>', // REQUIRED
'ruleVersion' => '<string>', // REQUIRED
],
'tags' => [
[
'key' => '<string>', // REQUIRED
'value' => '<string>', // REQUIRED
],
// ...
],
]);
Parameter Details
Members
- description
-
- Type: string
The description.
- expression
-
- Required: Yes
- Type: string
The rule expression.
- language
-
- Required: Yes
- Type: string
The language.
- outcomes
-
- Required: Yes
- Type: Array of strings
The outcomes.
- rule
-
- Required: Yes
- Type: Rule structure
The rule to update.
- tags
-
- Type: Array of Tag structures
The tags to assign to the rule version.
Result Syntax
[
'rule' => [
'detectorId' => '<string>',
'ruleId' => '<string>',
'ruleVersion' => '<string>',
],
]
Result Details
Members
- rule
-
- Type: Rule structure
The new rule version that was created.
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
UpdateVariable
$result = $client->updateVariable([/* ... */]); $promise = $client->updateVariableAsync([/* ... */]);
Updates a variable.
Parameter Syntax
$result = $client->updateVariable([
'defaultValue' => '<string>',
'description' => '<string>',
'name' => '<string>', // REQUIRED
'variableType' => '<string>',
]);
Parameter Details
Members
- defaultValue
-
- Type: string
The new default value of the variable.
- description
-
- Type: string
The new description.
- name
-
- Required: Yes
- Type: string
The name of the variable.
- variableType
-
- Type: string
The variable type. For more information see Variable types.
Result Syntax
[]
Result Details
Errors
-
An exception indicating a specified value is not allowed.
-
An exception indicating the specified resource was not found.
-
An exception indicating an internal server error.
-
An exception indicating a throttling error.
-
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as
PutExternalModel, that specifies a role that is not in your account.
Shapes
AccessDeniedException
Description
An exception indicating Amazon Fraud Detector does not have the needed permissions. This can occur if you submit a request, such as PutExternalModel, that specifies a role that is not in your account.
Members
BatchCreateVariableError
Description
Provides the error of the batch create variable API.
Members
BatchGetVariableError
Description
Provides the error of the batch get variable API.
Members
ConflictException
Description
An exception indicating there was a conflict during a delete operation. The following delete operations can cause a conflict exception:
-
DeleteDetector: A conflict exception will occur if the detector has associated
RulesorDetectorVersions. You can only delete a detector if it has noRulesorDetectorVersions. -
DeleteDetectorVersion: A conflict exception will occur if the
DetectorVersionstatus isACTIVE. -
DeleteRule: A conflict exception will occur if the
RuleVersionis in use by an associatedACTIVEorINACTIVE DetectorVersion.
Members
DataValidationMetrics
Description
The model training validation messages.
Members
- fieldLevelMessages
-
- Type: Array of FieldValidationMessage structures
The field-specific model training validation messages.
- fileLevelMessages
-
- Type: Array of FileValidationMessage structures
The file-specific model training validation messages.
Detector
Description
The detector.
Members
- arn
-
- Type: string
The detector ARN.
- createdTime
-
- Type: string
Timestamp of when the detector was created.
- description
-
- Type: string
The detector description.
- detectorId
-
- Type: string
The detector ID.
- eventTypeName
-
- Type: string
The name of the event type.
- lastUpdatedTime
-
- Type: string
Timestamp of when the detector was last updated.
DetectorVersionSummary
Description
The summary of the detector version.
Members
Entity
Description
The entity details.
Members
EntityType
Description
The entity type details.
Members
EventType
Description
The event type details.
Members
- arn
-
- Type: string
The entity type ARN.
- createdTime
-
- Type: string
Timestamp of when the event type was created.
- description
-
- Type: string
The event type description.
- entityTypes
-
- Type: Array of strings
The event type entity types.
- eventVariables
-
- Type: Array of strings
The event type event variables.
- labels
-
- Type: Array of strings
The event type labels.
- lastUpdatedTime
-
- Type: string
Timestamp of when the event type was last updated.
- name
-
- Type: string
The event type name.
ExternalEventsDetail
Description
Details for the external events data used for model version training.
Members
ExternalModel
Description
The Amazon SageMaker model.
Members
- arn
-
- Type: string
The model ARN.
- createdTime
-
- Type: string
Timestamp of when the model was last created.
- inputConfiguration
-
- Type: ModelInputConfiguration structure
The input configuration.
- invokeModelEndpointRoleArn
-
- Type: string
The role used to invoke the model.
- lastUpdatedTime
-
- Type: string
Timestamp of when the model was last updated.
- modelEndpoint
-
- Type: string
The Amazon SageMaker model endpoints.
- modelEndpointStatus
-
- Type: string
The Amazon Fraud Detector status for the external model endpoint
- modelSource
-
- Type: string
The source of the model.
- outputConfiguration
-
- Type: ModelOutputConfiguration structure
The output configuration.
FieldValidationMessage
Description
The message details.
Members
FileValidationMessage
Description
The message details.
Members
InternalServerException
Description
An exception indicating an internal server error.
Members
KMSKey
Label
Description
The label details.
Members
LabelSchema
Description
The label schema.
Members
- labelMapper
-
- Required: Yes
- Type: Associative array of custom strings keys (string) to stringss
The label mapper maps the Amazon Fraud Detector supported model classification labels (
FRAUD,LEGIT) to the appropriate event type labels. For example, if "FRAUD" and "LEGIT" are Amazon Fraud Detector supported labels, this mapper could be:{"FRAUD" => ["0"],"LEGIT" => ["1"]}or{"FRAUD" => ["false"],"LEGIT" => ["true"]}or{"FRAUD" => ["fraud", "abuse"],"LEGIT" => ["legit", "safe"]}. The value part of the mapper is a list, because you may have multiple label variants from your event type for a single Amazon Fraud Detector label.
MetricDataPoint
Description
Model performance metrics data points.
Members
- fpr
-
- Type: float
The false positive rate. This is the percentage of total legitimate events that are incorrectly predicted as fraud.
- precision
-
- Type: float
The percentage of fraud events correctly predicted as fraudulent as compared to all events predicted as fraudulent.
- threshold
-
- Type: float
The model threshold that specifies an acceptable fraud capture rate. For example, a threshold of 500 means any model score 500 or above is labeled as fraud.
- tpr
-
- Type: float
The true positive rate. This is the percentage of total fraud the model detects. Also known as capture rate.
Model
Description
The model.
Members
- arn
-
- Type: string
The ARN of the model.
- createdTime
-
- Type: string
Timestamp of when the model was created.
- description
-
- Type: string
The model description.
- eventTypeName
-
- Type: string
The name of the event type.
- lastUpdatedTime
-
- Type: string
Timestamp of last time the model was updated.
- modelId
-
- Type: string
The model ID.
- modelType
-
- Type: string
The model type.
ModelEndpointDataBlob
Description
A pre-formed Amazon SageMaker model input you can include if your detector version includes an imported Amazon SageMaker model endpoint with pass-through input configuration.
Members
ModelInputConfiguration
Description
The Amazon SageMaker model input configuration.
Members
- csvInputTemplate
-
- Type: string
Template for constructing the CSV input-data sent to SageMaker. At event-evaluation, the placeholders for variable-names in the template will be replaced with the variable values before being sent to SageMaker.
- eventTypeName
-
- Type: string
The event type name.
- format
-
- Type: string
The format of the model input configuration. The format differs depending on if it is passed through to SageMaker or constructed by Amazon Fraud Detector.
- jsonInputTemplate
-
- Type: string
Template for constructing the JSON input-data sent to SageMaker. At event-evaluation, the placeholders for variable names in the template will be replaced with the variable values before being sent to SageMaker.
- useEventVariables
-
- Required: Yes
- Type: boolean
The event variables.
ModelOutputConfiguration
Description
Provides the Amazon Sagemaker model output configuration.
Members
- csvIndexToVariableMap
-
- Type: Associative array of custom strings keys (string) to strings
A map of CSV index values in the SageMaker response to the Amazon Fraud Detector variables.
- format
-
- Required: Yes
- Type: string
The format of the model output configuration.
- jsonKeyToVariableMap
-
- Type: Associative array of custom strings keys (string) to strings
A map of JSON keys in response from SageMaker to the Amazon Fraud Detector variables.
ModelScores
Description
The fraud prediction scores.
Members
- modelVersion
-
- Type: ModelVersion structure
The model version.
- scores
-
- Type: Associative array of custom strings keys (string) to floats
The model's fraud prediction scores.
ModelVersion
Description
The model version.
Members
ModelVersionDetail
Description
The details of the model version.
Members
- arn
-
- Type: string
The model version ARN.
- createdTime
-
- Type: string
The timestamp when the model was created.
- externalEventsDetail
-
- Type: ExternalEventsDetail structure
The event details.
- lastUpdatedTime
-
- Type: string
The timestamp when the model was last updated.
- modelId
-
- Type: string
The model ID.
- modelType
-
- Type: string
The model type.
- modelVersionNumber
-
- Type: string
The model version number.
- status
-
- Type: string
The status of the model version.
- trainingDataSchema
-
- Type: TrainingDataSchema structure
The training data schema.
- trainingDataSource
-
- Type: string
The model version training data source.
- trainingResult
-
- Type: TrainingResult structure
The training results.
Outcome
Description
The outcome.
Members
ResourceNotFoundException
Description
An exception indicating the specified resource was not found.
Members
Rule
Description
A rule.
Members
RuleDetail
Description
The details of the rule.
Members
- arn
-
- Type: string
The rule ARN.
- createdTime
-
- Type: string
The timestamp of when the rule was created.
- description
-
- Type: string
The rule description.
- detectorId
-
- Type: string
The detector for which the rule is associated.
- expression
-
- Type: string
The rule expression.
- language
-
- Type: string
The rule language.
- lastUpdatedTime
-
- Type: string
Timestamp of the last time the rule was updated.
- outcomes
-
- Type: Array of strings
The rule outcomes.
- ruleId
-
- Type: string
The rule ID.
- ruleVersion
-
- Type: string
The rule version.
RuleResult
Description
The rule results.
Members
Tag
Description
A key and value pair.
Members
ThrottlingException
TrainingDataSchema
Description
The training data schema.
Members
- labelSchema
-
- Required: Yes
- Type: LabelSchema structure
The label schema.
- modelVariables
-
- Required: Yes
- Type: Array of strings
The training data schema variables.
TrainingMetrics
Description
The training metric details.
Members
- auc
-
- Type: float
The area under the curve. This summarizes true positive rate (TPR) and false positive rate (FPR) across all possible model score thresholds. A model with no predictive power has an AUC of 0.5, whereas a perfect model has a score of 1.0.
- metricDataPoints
-
- Type: Array of MetricDataPoint structures
The data points details.
TrainingResult
Description
The training result details.
Members
- dataValidationMetrics
-
- Type: DataValidationMetrics structure
The validation metrics.
- trainingMetrics
-
- Type: TrainingMetrics structure
The training metric details.
ValidationException
Description
An exception indicating a specified value is not allowed.
Members
Variable
Description
The variable.
Members
- arn
-
- Type: string
The ARN of the variable.
- createdTime
-
- Type: string
The time when the variable was created.
- dataSource
-
- Type: string
The data source of the variable.
- dataType
-
- Type: string
The data type of the variable. For more information see Variable types.
- defaultValue
-
- Type: string
The default value of the variable.
- description
-
- Type: string
The description of the variable.
- lastUpdatedTime
-
- Type: string
The time when variable was last updated.
- name
-
- Type: string
The name of the variable.
- variableType
-
- Type: string
The variable type of the variable.
Valid Values:
AUTH_CODE | AVS | BILLING_ADDRESS_L1 | BILLING_ADDRESS_L2 | BILLING_CITY | BILLING_COUNTRY | BILLING_NAME | BILLING_PHONE | BILLING_STATE | BILLING_ZIP | CARD_BIN | CATEGORICAL | CURRENCY_CODE | EMAIL_ADDRESS | FINGERPRINT | FRAUD_LABEL | FREE_FORM_TEXT | IP_ADDRESS | NUMERIC | ORDER_ID | PAYMENT_TYPE | PHONE_NUMBER | PRICE | PRODUCT_CATEGORY | SHIPPING_ADDRESS_L1 | SHIPPING_ADDRESS_L2 | SHIPPING_CITY | SHIPPING_COUNTRY | SHIPPING_NAME | SHIPPING_PHONE | SHIPPING_STATE | SHIPPING_ZIP | USERAGENT
VariableEntry
Description
A variable in the list of variables for the batch create variable request.
Members
- dataSource
-
- Type: string
The data source of the variable.
- dataType
-
- Type: string
The data type of the variable.
- defaultValue
-
- Type: string
The default value of the variable.
- description
-
- Type: string
The description of the variable.
- name
-
- Type: string
The name of the variable.
- variableType
-
- Type: string
The type of the variable. For more information see Variable types.
Valid Values:
AUTH_CODE | AVS | BILLING_ADDRESS_L1 | BILLING_ADDRESS_L2 | BILLING_CITY | BILLING_COUNTRY | BILLING_NAME | BILLING_PHONE | BILLING_STATE | BILLING_ZIP | CARD_BIN | CATEGORICAL | CURRENCY_CODE | EMAIL_ADDRESS | FINGERPRINT | FRAUD_LABEL | FREE_FORM_TEXT | IP_ADDRESS | NUMERIC | ORDER_ID | PAYMENT_TYPE | PHONE_NUMBER | PRICE | PRODUCT_CATEGORY | SHIPPING_ADDRESS_L1 | SHIPPING_ADDRESS_L2 | SHIPPING_CITY | SHIPPING_COUNTRY | SHIPPING_NAME | SHIPPING_PHONE | SHIPPING_STATE | SHIPPING_ZIP | USERAGENT
