本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CreateFilter
创建建议筛选器。有关更多信息，请参阅筛选建议和用户细分。
请求语法
{
"datasetGroupArn": "string",
"filterExpression": "string",
"name": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}请求参数
请求接受采用 JSON 格式的以下数据。
- datasetGroupArn
-
筛选器将属于的数据集组的 ARN。
类型：字符串
长度限制：最大长度为 256。
模式：
arn:([a-z\d-]+):personalize:.*:.*:.+必需：是
- filterExpression
-
筛选器表达式定义建议中包含或排除哪些物品。筛选器表达式必须遵循特定的格式规则。有关筛选器表达式结构和语法的信息，请参阅筛选器表达式。
类型：字符串
长度限制：长度下限为 1。最大长度为 2500。
必需：是
- name
-
要创建的筛选器的名称。
类型：字符串
长度限制：长度下限为 1。最大长度为 63。
模式：
^[a-zA-Z0-9][a-zA-Z0-9\-_]*必需：是
-
要应用于筛选器的标签列表。
类型：Tag 对象数组
数组成员：最少 0 项。最多 200 项。
必需：否
响应语法
{
"filterArn": "string"
}响应元素
如果此操作成功，则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
- filterArn
-
新筛选器的 ARN。
类型：字符串
长度限制：最大长度为 256。
模式：
arn:([a-z\d-]+):personalize:.*:.*:.+
错误
- InvalidInputException
-
为字段或参数提供有效值。
HTTP 状态代码：400
- LimitExceededException
-
超出每秒请求次数的限制。
HTTP 状态代码：400
- ResourceAlreadyExistsException
-
指定资源已经存在。
HTTP 状态代码：400
- ResourceNotFoundException
-
找不到指定的资源。
HTTP 状态代码：400
- TooManyTagsException
-
您已超出您可以应用到此资源的最大标签数量。
HTTP 状态代码：400
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息，请参阅以下内容：