

截至 2025 年 11 月 7 日，亚马逊 Fraud Detector 不再向新客户开放。要获得与 Amazon Fraud Detector 类似的功能 SageMaker，请浏览亚马逊 AutoGluon、和 AWS WAF。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Lists
<a name="lists"></a>

列表是事件数据集中变量的一组输入数据。您在与探测器关联的规则中使用输入数据。规则是一种条件，它告诉 Amazon Fraud Detector 在欺诈预测期间如何解释输入数据。例如，您可以创建 IP 地址列表，然后创建规则，在列表中包含特定 IP 地址时拒绝访问。使用列表的规则`@list_name`以 `$ip_address_value` in 格式表示。

借助 Amazon Fraud Detector，您无需更新关联规则即可通过添加或删除数据来管理列表。与您的列表关联的规则会自动包含新添加或删除的数据。

一个列表最多可以包含 100,000 个唯一条目，每个条目的长度最多 320 个字符。默认情况下，您在规则中使用的每个列表都与亚马逊欺诈检测器的 [变量类型](variables.md#variable-types) FREE\$1FORM\$1TEXT 相关联。您可以随时为列表分配变量类型。您最多可以在一条规则中使用 3 个列表。

您可以在 Amazon Fraud Detector 控制台、使用 API、使用或使用 AWS 软件开发工具包创建列表、向列表中添加条目、删除列表或删除列表中的一个或多个条目 AWS CLI，或者为列表分配变量类型。

# 创建清单
<a name="create-list"></a>

您可以创建包含事件数据集中变量的输入数据（条目）的列表，并在规则表达式中使用该列表。无需更新使用列表的规则，即可动态管理列表中的条目。

要创建列表，您必须先指定一个名称，然后可以选择将该列表与 Amazon Fraud Detector [变量类型](variables.md#variable-types) 支持的列表关联起来。默认情况下，Amazon Fraud Detector 假设列表为 FREE\$1FORM\$1TEXT 变量类型。

您可以在 Amazon Fraud Detector 控制台中使用 API、使用或使用 AWS 软件开发工具包创建列表。 AWS CLI

## 使用 Amazon Fraud Detector 控制台创建清单
<a name="create-list-console"></a>

**创建清单**

1. 打开 [AWS 管理控制台](https://console.aws.amazon.com/)，登录您的账户。导航至 Amazon Fraud Detector。

1. 在左侧导航窗格中，选择**列表**。

1. 在 “**列表**” 下方的详细信息

   1. 在**列表名称**中，输入列表的名称。

   1. （可选）在**描述**中输入描述。

   1. （可选）在**变量类型**中，为列表选择变量类型。
**重要**  
如果您的列表包含 IP 地址，请务必选择 **IP\$1** ADDRESS 作为变量类型。如果您未选择变量类型，Amazon Fraud Detector 会假定列表为 **FREE\$1FORM\$1TEX** T 变量类型。

1. 在**添加列表数据中**，添加列表条目，每行一个条目。您也可以从电子表格中复制和粘贴条目。
**注意**  
确保条目没有使用逗号分隔，并且在列表中是唯一的。如果输入两个相同的条目，则只会添加一个。

1. 选择**创建**。

## 使用创建列表 适用于 Python (Boto3) 的 AWS SDK
<a name="create-list-sdk"></a>

您可以通过指定列表名称来创建列表。创建列表时，您可以选择提供描述、关联变量类型或向列表中添加条目。或者，您可以稍后通过添加条目或描述来更新列表。如果您在创建列表时尚未分配变量类型，则可以稍后为该列表分配变量类型。列表的变量类型在赋值后无法更改。

**重要**  
如果您的列表包含 IP 地址，请确保将 **IP\$1ADDRESS** 分配为变量类型。如果你没有分配变量类型，Amazon Fraud Detector 会假设列表是 **FREE\$1FORM\$1TEXT** 变量类型。

以下示例使用 [CreateList](https://docs.aws.amazon.com//frauddetector/latest/api/API_CreateList.html)API 操作通过提供描述、变量类型和添加四个列表条目来创建列表。`allow_email_ids`

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

fraudDetector.create_list (
     name = 'allow_email_ids',
     description = 'legitimate email_ids'
     variableType = 'EMAIL_ADDRESS',
     elements = ['emailId _1', 'emailId_2', 'emailId_3','emailId_4']
     )
```

# 在列表中添加条目
<a name="add-entries-in-list"></a>

创建列表后，您可以随时在列表中添加或追加条目。在列表中添加或追加条目时，无需更新与列表关联的规则。该规则会自动合并新添加的条目。

您的列表最多可以包含 100,000 个唯一条目，每个条目最多可以包含 320 个字符。

您可以使用 API、使用或使用软件开发工具包在 Amazon Fraud AWS Detecto AWS CLI r 控制台中添加条目。

## 使用 Amazon Fraud Detector 控制台在列表中添加条目
<a name="add-entries-in-list-console"></a>

**在列表中添加一个或多个条目**

1. 打开 [AWS 管理控制台](https://console.aws.amazon.com/)，登录您的账户。导航至 Amazon Fraud Detector。

1. 在左侧导航窗格中，选择**列表**。

1. 在**列表**页面中，选择要向其添加条目的列表。

1. 在列表详细信息页面中，选择 “**列出数据**” 选项卡，然后选择 “**添加数据**”。

1. 在 “**添加列表数据**” 框中，每行添加一个条目或从电子表格中复制并粘贴条目。确保不要使用逗号分隔条目。

1. 选择**添加**。

## 使用在列表中添加条目 适用于 Python (Boto3) 的 AWS SDK
<a name="add-entries-in-list-sdk"></a>

以下示例使用 [UpdateList](https://docs.aws.amazon.com//frauddetector/latest/api/API_UpdateList.html)API 操作在`allow_email_ids`列表中添加两个新条目。确保您要添加的条目在列表中是唯一的。

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

fraudDetector.update_list (
     name = 'allow_email_ids',
     updateMode = 'APPEND'
     elements = ['emailId_11','emailId_12']
```

# 为列表分配变量类型
<a name="assign-variable-type-list"></a>

您在规则中使用的每个列表都必须与 Amazon Fraud Detector 的[变量类型](variables.md#variable-types)变量类型相关联。默认情况下，Amazon Fraud Detector 假设列表为 FREE\$1FORM\$1TEXT 变量类型。需要注意的是，由 IP 地址组成的列表必须与 IP\$1ADDRESS 变量类型相关联。

您可以在创建列表时或以后的任何时候将列表与变量类型相关联。如果您已经将列表与变量类型关联并想稍后对其进行更改，则必须创建一个新列表。您无法更改列表的变量类型。

您可以在 Amazon Fraud Detector 控制台中使用 API、使用或使用 AWS 软件开发工具包分配变量类型。 AWS CLI

## 使用 Amazon Fraud Detector 控制台为列表分配变量类型
<a name="assign-variable-type-list-console"></a>

**为列表分配变量类型**

1. 打开 [AWS 管理控制台](https://console.aws.amazon.com/)，登录您的账户。导航至 Amazon Fraud Detector。

1. 在左侧导航窗格中，选择**列表**。

1. 在**列表**页面中，选择要为其分配变量类型的列表。

1. 在列表详细信息页面中，选择**操作**，然后选择**编辑列表**。

1. 在 **“编辑” 列表**框中，为列表选择变量类型。

1. 选择**保存**。

## 使用将变量类型分配给列表 适用于 Python (Boto3) 的 AWS SDK
<a name="assign-variable-type-list-sdk"></a>

以下示例使用 [UpdateList](https://docs.aws.amazon.com//frauddetector/latest/api/API_UpdateList.html)API 操作为`allow_ip_address`列表分配变量类型。

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

fraudDetector.update_list (
     name = 'allow_ip_address',
     variableType = 'IP_ADDRESS'     
)
```

# 删除名单
<a name="delete-list"></a>

您可以删除未在任何规则中使用的列表。当您删除列表时，Amazon Fraud Detector 会永久删除该列表和列表中的所有条目。

您可以使用 API、 AWS CLI 或软件开发工具包在 Amazon Fraud AWS Detector 控制台中删除列表。

## 使用 Amazon Fraud Detector 控制台删除名单
<a name="delete-list-console"></a>

**删除名单**

1. 打开 [AWS 管理控制台](https://console.aws.amazon.com/)，登录您的账户。导航至 Amazon Fraud Detector。

1. 在左侧导航窗格中，选择**列表**

1. 在**列表**页面中，选择要删除的列表。

1. 在列表详细信息页面中，选择**操作**并选择**删除列表**。

1. 选择 “**删除列表”**。

## 使用 “删除列表” 适用于 Python (Boto3) 的 AWS SDK
<a name="delete-list-sdk"></a>

以下示例使用 [DeleteList](https://docs.aws.amazon.com//frauddetector/latest/api/API_DeleteList.html)API 操作进行删除`allow_email_ids`。

```
import boto3
                        fraudDetector = boto3.client('frauddetector')
fraudDetector.delete_list(
   name = 'allow_email_ids' 
)
```

# 从列表中删除条目
<a name="delete-entries-list"></a>

您可以随时从列表中删除一个或多个条目。删除列表中的条目时，无需更新与该列表关联的规则。该规则会自动合并更新的列表。

您可以使用 API、 AWS CLI 或软件开发工具包从 Amazon Fraud AWS Detector 控制台的列表中删除条目。

## 使用 Amazon Fraud Detector 控制台从列表中删除条目
<a name="delete-entries-list-console"></a>

**从列表中删除一个或多个条目**

1. 打开 [AWS 管理控制台](https://console.aws.amazon.com/)，登录您的账户。导航至 Amazon Fraud Detector。

1. 在左侧导航窗格中，选择**列表**

1. 在**列表**页面中，选择包含要删除的条目的列表。

1. 在列表详细信息页面中，选择 “**列出数据**” 选项卡，然后选择要删除的条目。

1. 选择 “**删除**”，然后再次选择 “**删除**” 进行确认。

## 使用从列表中删除条目 适用于 Python (Boto3) 的 AWS SDK
<a name="delete-entries-list-sdk"></a>

在以下示例中，[UpdateList](https://docs.aws.amazon.com//frauddetector/latest/api/API_UpdateList.html)API 操作从`allow_email_ids`列表中删除条目。

```
import boto3
                        fraudDetector = boto3.client('frauddetector')
fraudDetector.update_list(
   name = 'allow_email_ids',
   updateMode = 'REMOVE',
   elements = ['emailId_4', 'emailId_12']
)
```

# 从列表中删除所有条目
<a name="delete-all-entries-list"></a>

如果规则中未使用列表，则可以删除列表中的所有条目。您可以删除列表中的所有条目，然后在同一列表中添加条目。

您可以使用 API、 AWS CLI 或软件开发工具包从 Amazon Fraud AWS Detector 控制台的列表中删除条目。

## 使用 Amazon Fraud Detector 控制台从列表中删除所有条目
<a name="delete-all-entries-list-console"></a>

**从列表中删除所有条目**

1. 打开 [AWS 管理控制台](https://console.aws.amazon.com/)，登录您的账户。导航至 Amazon Fraud Detector。

1. 在左侧导航窗格中，选择**列表**

1. 在**列表**页面中，选择包含要删除的条目的列表。

1. 在列表详细信息页面中，选择 “**列出数据**” 选项卡，然后选择 “**全部删除**”。

1. 在 “**全部删除**” 框中，键入`delete all`进行确认，然后选择 “**删除所有列表数据**”。

## 使用删除列表中的所有条目 适用于 Python (Boto3) 的 AWS SDK
<a name="delete-all-entries-list-sdk"></a>

在以下示例中，[UpdateList](https://docs.aws.amazon.com//frauddetector/latest/api/API_UpdateList.html)API 操作从`allow_email_ids`列表中删除所有条目。

```
import boto3
                        fraudDetector = boto3.client('frauddetector')
fraudDetector.update_list(
   name = 'allow_email_ids',
   updateMode = 'REPLACE',
   elements = []
)
```