PutEventType - Amazon Fraud Detector

PutEventType

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.

Request Syntax

{ "description": "string", "entityTypes": [ "string" ], "eventIngestion": "string", "eventOrchestration": { "eventBridgeEnabled": boolean }, "eventVariables": [ "string" ], "labels": [ "string" ], "name": "string", "tags": [ { "key": "string", "value": "string" } ] }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

description

The description of the event type.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 128.

Required: No

entityTypes

The entity type for the event type. Example entity types: customer, merchant, account.

Type: Array of strings

Array Members: Minimum number of 1 item.

Required: Yes

eventIngestion

Specifies if ingestion is enabled or disabled.

Type: String

Valid Values: ENABLED | DISABLED

Required: No

eventOrchestration

Enables or disables event orchestration. If enabled, you can send event predictions to select AWS services for downstream processing of the events.

Type: EventOrchestration object

Required: No

eventVariables

The event type variables.

Type: Array of strings

Array Members: Minimum number of 1 item.

Required: Yes

labels

The event type labels.

Type: Array of strings

Required: No

name

The name.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: ^[0-9a-z_-]+$

Required: Yes

tags

A collection of key and value pairs.

Type: Array of Tag objects

Array Members: Minimum number of 0 items. Maximum number of 200 items.

Required: No

Response Elements

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

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.

HTTP Status Code: 400

ConflictException

An exception indicating there was a conflict during a delete operation.

HTTP Status Code: 400

InternalServerException

An exception indicating an internal server error.

HTTP Status Code: 500

ThrottlingException

An exception indicating a throttling error.

HTTP Status Code: 400

ValidationException

An exception indicating a specified value is not allowed.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: