本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 数据类型 Amazon Personalize 支持以下数据类型： + [Algorithm](API_Algorithm.md) + [AlgorithmImage](API_AlgorithmImage.md) + [AutoMLConfig](API_AutoMLConfig.md) + [AutoMLResult](API_AutoMLResult.md) + [AutoTrainingConfig](API_AutoTrainingConfig.md) + [BatchInferenceJob](API_BatchInferenceJob.md) + [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md) + [BatchInferenceJobInput](API_BatchInferenceJobInput.md) + [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md) + [BatchInferenceJobSummary](API_BatchInferenceJobSummary.md) + [BatchSegmentJob](API_BatchSegmentJob.md) + [BatchSegmentJobInput](API_BatchSegmentJobInput.md) + [BatchSegmentJobOutput](API_BatchSegmentJobOutput.md) + [BatchSegmentJobSummary](API_BatchSegmentJobSummary.md) + [Campaign](API_Campaign.md) + [CampaignConfig](API_CampaignConfig.md) + [CampaignSummary](API_CampaignSummary.md) + [CampaignUpdateSummary](API_CampaignUpdateSummary.md) + [CategoricalHyperParameterRange](API_CategoricalHyperParameterRange.md) + [ContinuousHyperParameterRange](API_ContinuousHyperParameterRange.md) + [DataDeletionJob](API_DataDeletionJob.md) + [DataDeletionJobSummary](API_DataDeletionJobSummary.md) + [Dataset](API_Dataset.md) + [DatasetExportJob](API_DatasetExportJob.md) + [DatasetExportJobOutput](API_DatasetExportJobOutput.md) + [DatasetExportJobSummary](API_DatasetExportJobSummary.md) + [DatasetGroup](API_DatasetGroup.md) + [DatasetGroupSummary](API_DatasetGroupSummary.md) + [DatasetImportJob](API_DatasetImportJob.md) + [DatasetImportJobSummary](API_DatasetImportJobSummary.md) + [DatasetSchema](API_DatasetSchema.md) + [DatasetSchemaSummary](API_DatasetSchemaSummary.md) + [DatasetSummary](API_DatasetSummary.md) + [DatasetUpdateSummary](API_DatasetUpdateSummary.md) + [DataSource](API_DataSource.md) + [DefaultCategoricalHyperParameterRange](API_DefaultCategoricalHyperParameterRange.md) + [DefaultContinuousHyperParameterRange](API_DefaultContinuousHyperParameterRange.md) + [DefaultHyperParameterRanges](API_DefaultHyperParameterRanges.md) + [DefaultIntegerHyperParameterRange](API_DefaultIntegerHyperParameterRange.md) + [EventParameters](API_EventParameters.md) + [EventsConfig](API_EventsConfig.md) + [EventTracker](API_EventTracker.md) + [EventTrackerSummary](API_EventTrackerSummary.md) + [FeatureTransformation](API_FeatureTransformation.md) + [FieldsForThemeGeneration](API_FieldsForThemeGeneration.md) + [Filter](API_Filter.md) + [FilterSummary](API_FilterSummary.md) + [HPOConfig](API_HPOConfig.md) + [HPOObjective](API_HPOObjective.md) + [HPOResourceConfig](API_HPOResourceConfig.md) + [HyperParameterRanges](API_HyperParameterRanges.md) + [IntegerHyperParameterRange](API_IntegerHyperParameterRange.md) + [MetricAttribute](API_MetricAttribute.md) + [MetricAttribution](API_MetricAttribution.md) + [MetricAttributionOutput](API_MetricAttributionOutput.md) + [MetricAttributionSummary](API_MetricAttributionSummary.md) + [OptimizationObjective](API_OptimizationObjective.md) + [Recipe](API_Recipe.md) + [RecipeSummary](API_RecipeSummary.md) + [Recommender](API_Recommender.md) + [RecommenderConfig](API_RecommenderConfig.md) + [RecommenderSummary](API_RecommenderSummary.md) + [RecommenderUpdateSummary](API_RecommenderUpdateSummary.md) + [S3DataConfig](API_S3DataConfig.md) + [Solution](API_Solution.md) + [SolutionConfig](API_SolutionConfig.md) + [SolutionSummary](API_SolutionSummary.md) + [SolutionUpdateConfig](API_SolutionUpdateConfig.md) + [SolutionUpdateSummary](API_SolutionUpdateSummary.md) + [SolutionVersion](API_SolutionVersion.md) + [SolutionVersionSummary](API_SolutionVersionSummary.md) + [Tag](API_Tag.md) + [ThemeGenerationConfig](API_ThemeGenerationConfig.md) + [TrainingDataConfig](API_TrainingDataConfig.md) + [TunedHPOParams](API_TunedHPOParams.md) Amazon Personalize Events 支持以下数据类型： + [Action](API_UBS_Action.md) + [ActionInteraction](API_UBS_ActionInteraction.md) + [Event](API_UBS_Event.md) + [Item](API_UBS_Item.md) + [MetricAttribution](API_UBS_MetricAttribution.md) + [User](API_UBS_User.md) Amazon Personalize Runtime 支持以下数据类型： + [PredictedAction](API_RS_PredictedAction.md) + [PredictedItem](API_RS_PredictedItem.md) + [Promotion](API_RS_Promotion.md) # Amazon Personalize Amazon Personalize 支持以下数据类型： + [Algorithm](API_Algorithm.md) + [AlgorithmImage](API_AlgorithmImage.md) + [AutoMLConfig](API_AutoMLConfig.md) + [AutoMLResult](API_AutoMLResult.md) + [AutoTrainingConfig](API_AutoTrainingConfig.md) + [BatchInferenceJob](API_BatchInferenceJob.md) + [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md) + [BatchInferenceJobInput](API_BatchInferenceJobInput.md) + [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md) + [BatchInferenceJobSummary](API_BatchInferenceJobSummary.md) + [BatchSegmentJob](API_BatchSegmentJob.md) + [BatchSegmentJobInput](API_BatchSegmentJobInput.md) + [BatchSegmentJobOutput](API_BatchSegmentJobOutput.md) + [BatchSegmentJobSummary](API_BatchSegmentJobSummary.md) + [Campaign](API_Campaign.md) + [CampaignConfig](API_CampaignConfig.md) + [CampaignSummary](API_CampaignSummary.md) + [CampaignUpdateSummary](API_CampaignUpdateSummary.md) + [CategoricalHyperParameterRange](API_CategoricalHyperParameterRange.md) + [ContinuousHyperParameterRange](API_ContinuousHyperParameterRange.md) + [DataDeletionJob](API_DataDeletionJob.md) + [DataDeletionJobSummary](API_DataDeletionJobSummary.md) + [Dataset](API_Dataset.md) + [DatasetExportJob](API_DatasetExportJob.md) + [DatasetExportJobOutput](API_DatasetExportJobOutput.md) + [DatasetExportJobSummary](API_DatasetExportJobSummary.md) + [DatasetGroup](API_DatasetGroup.md) + [DatasetGroupSummary](API_DatasetGroupSummary.md) + [DatasetImportJob](API_DatasetImportJob.md) + [DatasetImportJobSummary](API_DatasetImportJobSummary.md) + [DatasetSchema](API_DatasetSchema.md) + [DatasetSchemaSummary](API_DatasetSchemaSummary.md) + [DatasetSummary](API_DatasetSummary.md) + [DatasetUpdateSummary](API_DatasetUpdateSummary.md) + [DataSource](API_DataSource.md) + [DefaultCategoricalHyperParameterRange](API_DefaultCategoricalHyperParameterRange.md) + [DefaultContinuousHyperParameterRange](API_DefaultContinuousHyperParameterRange.md) + [DefaultHyperParameterRanges](API_DefaultHyperParameterRanges.md) + [DefaultIntegerHyperParameterRange](API_DefaultIntegerHyperParameterRange.md) + [EventParameters](API_EventParameters.md) + [EventsConfig](API_EventsConfig.md) + [EventTracker](API_EventTracker.md) + [EventTrackerSummary](API_EventTrackerSummary.md) + [FeatureTransformation](API_FeatureTransformation.md) + [FieldsForThemeGeneration](API_FieldsForThemeGeneration.md) + [Filter](API_Filter.md) + [FilterSummary](API_FilterSummary.md) + [HPOConfig](API_HPOConfig.md) + [HPOObjective](API_HPOObjective.md) + [HPOResourceConfig](API_HPOResourceConfig.md) + [HyperParameterRanges](API_HyperParameterRanges.md) + [IntegerHyperParameterRange](API_IntegerHyperParameterRange.md) + [MetricAttribute](API_MetricAttribute.md) + [MetricAttribution](API_MetricAttribution.md) + [MetricAttributionOutput](API_MetricAttributionOutput.md) + [MetricAttributionSummary](API_MetricAttributionSummary.md) + [OptimizationObjective](API_OptimizationObjective.md) + [Recipe](API_Recipe.md) + [RecipeSummary](API_RecipeSummary.md) + [Recommender](API_Recommender.md) + [RecommenderConfig](API_RecommenderConfig.md) + [RecommenderSummary](API_RecommenderSummary.md) + [RecommenderUpdateSummary](API_RecommenderUpdateSummary.md) + [S3DataConfig](API_S3DataConfig.md) + [Solution](API_Solution.md) + [SolutionConfig](API_SolutionConfig.md) + [SolutionSummary](API_SolutionSummary.md) + [SolutionUpdateConfig](API_SolutionUpdateConfig.md) + [SolutionUpdateSummary](API_SolutionUpdateSummary.md) + [SolutionVersion](API_SolutionVersion.md) + [SolutionVersionSummary](API_SolutionVersionSummary.md) + [Tag](API_Tag.md) + [ThemeGenerationConfig](API_ThemeGenerationConfig.md) + [TrainingDataConfig](API_TrainingDataConfig.md) + [TunedHPOParams](API_TunedHPOParams.md) # Algorithm 描述自定义算法。 ## 目录 ** algorithmArn ** 算法的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** algorithmImage ** 算法映像的 Docker 容器的 URI。类型：[AlgorithmImage](API_AlgorithmImage.md) 对象必需：否 ** creationDateTime ** 算法的创建日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** defaultHyperParameterRanges ** 指定默认超参数、其范围及其是否可调。可以在超参数优化 (HPO) 期间确定可调超参数的值。类型：[DefaultHyperParameterRanges](API_DefaultHyperParameterRanges.md) 对象必需：否 ** defaultHyperParameters ** 指定默认超参数。类型：字符串到字符串映射映射条目：最多 100 项。键长度限制：最大长度为 256。值长度限制：最大长度为 1000。必需：否 ** defaultResourceConfig ** 指定默认最大训练作业数和并行训练作业数。类型：字符串到字符串映射映射条目：最多 100 项。键长度限制：最大长度为 256。值长度限制：最大长度为 1000。必需：否 ** lastUpdatedDateTime ** 上次更新算法的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** name ** 算法的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** roleArn ** 角色的 Amazon 资源名称（ARN）。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** trainingInputMode ** 训练输入模式。类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Algorithm) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Algorithm) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Algorithm) # AlgorithmImage 描述算法映像。 ## 目录 ** dockerURI ** 算法映像的 Docker 容器的 URI。类型：字符串长度约束：最大长度为 256。必需：是 ** name ** 算法映像的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AlgorithmImage) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AlgorithmImage) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AlgorithmImage) # AutoMLConfig 当解决方案执行 AutoML（[CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 中 `performAutoML` 为 ture）时，Amazon Personalize 会从指定列表中确定哪个食谱对给定指标进行优化。然后，Amazon Personalize 将该食谱用于解决方案。 ## 目录 ** metricName ** 要优化的指标。类型：字符串长度约束：最大长度为 256。必需：否 ** recipeList ** 候选食谱列表。类型：字符串数组数组成员：最多 100 项。长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AutoMLConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AutoMLConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AutoMLConfig) # AutoMLResult 当解决方案执行 AutoML（`performAutoML` 在 [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 中为 true）时，指定最能优化指定指标的食谱。 ## 目录 ** bestRecipeArn ** 最佳食谱的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AutoMLResult) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AutoMLResult) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AutoMLResult) # AutoTrainingConfig 当 `performAutoTraining` 为 true 时要使用的自动训练配置。 ## 目录 ** schedulingExpression ** 指定自动训练新解决方案版本的频率。以 rate(*value* *unit*) 格式指定 rate 表达式。对于值，指定一个介于 1 和 30 之间的数字。对于单位，指定 `day` 或 `days`。例如，要每 5 天自动创建一个新的解决方案版本，请指定 `rate(5 days)`。默认为每 7 天进行一次训练。有关自动训练的更多信息，请参阅[创建和配置解决方案](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html)。类型：字符串长度限制：长度下限为 1。最大长度为 16。模式：`rate$\d+ days?$` 必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AutoTrainingConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AutoTrainingConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AutoTrainingConfig) # BatchInferenceJob 包含批量推理作业的相关信息。 ## 目录 ** batchInferenceJobArn ** 批量推理作业的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** batchInferenceJobConfig ** 批量推理作业的配置详细信息的字符串到字符串映射。类型：[BatchInferenceJobConfig](API_BatchInferenceJobConfig.md) 对象必需：否 ** batchInferenceJobMode ** 作业的模式。类型：字符串有效值：`BATCH_INFERENCE | THEME_GENERATION` 必需：否 ** creationDateTime ** 创建批量推理作业的时间。类型：时间戳必需：否 ** failureReason ** 如果批量推理作业失败，则为其原因。类型：字符串必需：否 ** filterArn ** 批量推理作业中使用的筛选器的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** jobInput ** 指向用于生成批量推理作业的输入数据的 Amazon S3 路径。类型：[BatchInferenceJobInput](API_BatchInferenceJobInput.md) 对象必需：否 ** jobName ** 批量推理作业的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** jobOutput ** 包含批量推理作业生成的输出数据的 Amazon S3 存储桶。类型：[BatchInferenceJobOutput](API_BatchInferenceJobOutput.md) 对象必需：否 ** lastUpdatedDateTime ** 上次更新批量推理作业的时间。类型：时间戳必需：否 ** numResults ** 批量推理作业生成的建议数量。此数字包括为失败的输入记录生成的错误消息数。类型：整数必需：否 ** roleArn ** 请求批量推理作业的 Amazon Identity and Access Management (IAM) 角色的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 必需：否 ** solutionVersionArn ** 创建批量推理作业所依据的解决方案版本的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** status ** 批量推理作业的状态。状态是以下值之一： + PENDING + IN PROGRESS + ACTIVE + CREATE FAILED 类型：字符串长度约束：最大长度为 256。必需：否 ** themeGenerationConfig ** 作业的主题生成设置。类型：[ThemeGenerationConfig](API_ThemeGenerationConfig.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJob) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJob) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJob) # BatchInferenceJobConfig 批量推理作业的配置详情。 ## 内容 ** itemExplorationConfig ** 指定浏览配置超参数的字符串到字符串映射，包括 `explorationWeight` 和 `explorationItemAgeCutOff`，您希望用它来配置 Amazon Personalize 在推荐物品时使用的物品浏览量。请参见 [User-Personalization](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html)。类型：字符串到字符串映射映射条目：最多 100 项。键长度限制：最大长度为 256。值长度限制：最大长度为 1000。必需：否 ** rankingInfluence ** 排名地图影响受欢迎程度和新鲜度值。对于每个关键字，指定一个介于 0.0 和 1.0 之间的数值，该数值确定该排名因子对最终推荐的影响程度。值接近 1.0 会使因子得到更大的权重，而接近 0.0 的值会降低其影响。如果未指定，则两者都默认为 0.0。类型：字符串到双映射有效密钥：`POPULARITY | FRESHNESS` 有效范围：最小值为 0。最大值为 1。必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWSSDKs，请参阅以下内容： + [AWS适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobConfig) + [AWS适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobConfig) + [AWS适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobConfig) # BatchInferenceJobInput 批量推理作业的输入配置。 ## 目录 ** s3DataSource ** 包含输入数据的 Amazon S3 位置的 URI。Amazon S3 存储桶必须与您要调用的 API 端点位于同一区域。类型：[S3DataConfig](API_S3DataConfig.md) 对象必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobInput) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobInput) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobInput) # BatchInferenceJobOutput 批量推理作业的输出配置参数。 ## 目录 ** s3DataDestination ** 存储批量推理作业输出的 Amazon S3 存储桶的相关信息。类型：[S3DataConfig](API_S3DataConfig.md) 对象必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobOutput) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobOutput) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobOutput) # BatchInferenceJobSummary [BatchInferenceJob](https://docs.aws.amazon.com/personalize/latest/dg/API_BatchInferenceJob.html) 的截断版本。[ListBatchInferenceJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListBatchInferenceJobs.html) 操作返回批量推理作业摘要列表。 ## 目录 ** batchInferenceJobArn ** 批量推理作业的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** batchInferenceJobMode ** 作业的模式。类型：字符串有效值：`BATCH_INFERENCE | THEME_GENERATION` 必需：否 ** creationDateTime ** 创建批量推理作业的时间。类型：时间戳必需：否 ** failureReason ** 如果批量推理作业失败，则为其原因。类型：字符串必需：否 ** jobName ** 批量推理作业的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** lastUpdatedDateTime ** 上次更新批量推理作业的时间。类型：时间戳必需：否 ** solutionVersionArn ** 批量推理作业使用的解决方案版本的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** status ** 批量推理作业的状态。状态是以下值之一： + PENDING + IN PROGRESS + ACTIVE + CREATE FAILED 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobSummary) # BatchSegmentJob 包含批量细分作业的相关信息。 ## 目录 ** batchSegmentJobArn ** 批量细分作业的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** creationDateTime ** 创建批量细分作业的时间。类型：时间戳必需：否 ** failureReason ** 如果批量细分作业失败，则为其原因。类型：字符串必需：否 ** filterArn ** 批量细分作业中使用的筛选器的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** jobInput ** 指向用于生成批量细分作业的输入数据的 Amazon S3 路径。类型：[BatchSegmentJobInput](API_BatchSegmentJobInput.md) 对象必需：否 ** jobName ** 批量细分作业的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** jobOutput ** 包含批量细分作业生成的输出数据的 Amazon S3 存储桶。类型：[BatchSegmentJobOutput](API_BatchSegmentJobOutput.md) 对象必需：否 ** lastUpdatedDateTime ** 上次更新批量细分作业的时间。类型：时间戳必需：否 ** numResults ** 批量细分作业为每行输入数据生成的预测用户数。每个细分的最大用户数为 500 万。类型：整数必需：否 ** roleArn ** 请求批量细分作业的 Amazon Identity and Access Management (IAM) 角色的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 必需：否 ** solutionVersionArn ** 批量细分作业用于生成批量细分的解决方案版本的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** status ** 批量细分作业的状态。状态是以下值之一： + PENDING + IN PROGRESS + ACTIVE + CREATE FAILED 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJob) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJob) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJob) # BatchSegmentJobInput 批量细分作业的输入配置。 ## 目录 ** s3DataSource ** Amazon S3 输入或输出存储桶的配置详细信息。类型：[S3DataConfig](API_S3DataConfig.md) 对象必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJobInput) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJobInput) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJobInput) # BatchSegmentJobOutput 批量细分作业的输出配置参数。 ## 目录 ** s3DataDestination ** Amazon S3 输入或输出存储桶的配置详细信息。类型：[S3DataConfig](API_S3DataConfig.md) 对象必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJobOutput) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJobOutput) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJobOutput) # BatchSegmentJobSummary [BatchSegmentJob](https://docs.aws.amazon.com/personalize/latest/dg/API_BatchSegmentJob.html) 数据类型的截断版本。[ListBatchSegmentJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListBatchSegmentJobs.html) 操作返回批量细分作业摘要列表。 ## 目录 ** batchSegmentJobArn ** 批量细分作业的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** creationDateTime ** 创建批量细分作业的时间。类型：时间戳必需：否 ** failureReason ** 如果批量细分作业失败，则为其原因。类型：字符串必需：否 ** jobName ** 批量细分作业的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** lastUpdatedDateTime ** 上次更新批量细分作业的时间。类型：时间戳必需：否 ** solutionVersionArn ** 批量细分作业用于生成批量细分的解决方案版本的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** status ** 批量细分作业的状态。状态是以下值之一： + PENDING + IN PROGRESS + ACTIVE + CREATE FAILED 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJobSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJobSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJobSummary) # Campaign 描述解决方案版本部署的对象。有关市场活动的更多信息，请参阅 [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html)。 ## 目录 ** campaignArn ** 市场活动的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** campaignConfig ** 市场活动的配置详情。类型：[CampaignConfig](API_CampaignConfig.md) 对象必需：否 ** creationDateTime ** 市场活动创建的日期和时间（采用 Unix 格式）。类型：时间戳必需：否 ** failureReason ** 市场活动失败背后的原因。类型：字符串必需：否 ** lastUpdatedDateTime ** 上次市场活动的更新日期和时间（采用 Unix 格式）。类型：时间戳必需：否 ** latestCampaignUpdate ** 提供市场活动更新的属性摘要。如需完整列表，请调用 [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) API。仅当市场活动至少接到一个 `latestCampaignUpdate` 电话时，才会返回 `UpdateCampaign` 字段。类型：[CampaignUpdateSummary](API_CampaignUpdateSummary.md) 对象必需：否 ** minProvisionedTPS ** 指定请求的最低预调配每秒事务量（建议）。高 `minProvisionedTPS` 会增加您的账单费用。我们建议从 1 开始设置 `minProvisionedTPS`（默认值）。使用 Amazon CloudWatch 指标跟踪您的使用情况，并在必要时增加 `minProvisionedTPS`。类型：整数有效范围：最小值为 1。必需：否 ** name ** 活动的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** solutionVersionArn ** 市场活动使用的解决方案版本的 Amazon 资源名称（ARN）。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** status ** 市场活动的状态。市场活动可处于以下几种状态之一： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Campaign) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Campaign) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Campaign) # CampaignConfig 市场活动的配置详情。 ## 内容 ** enableMetadataWithRecommendations ** 是否为市场活动启用了带有建议的元数据。如果启用，则可以在建议请求中指定物品数据集中的列。Amazon Personalize 会在建议响应中返回每个物品的这些数据。有关为市场活动启用元数据的信息，请参阅[在市场活动建议中启用元数据](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata)。如果您在建议中启用元数据，则会产生额外费用。有关更多信息，请参阅 [Amazon Personalize 定价](https://aws.amazon.com/personalize/pricing/)。类型：布尔值必需：否 ** itemExplorationConfig ** 指定浏览配置超参数，包括 `explorationWeight` 和 `explorationItemAgeCutOff`，您希望用它来配置 Amazon Personalize 在推荐物品时使用的物品浏览量。仅当您的解决方案使用 [User-Personalization ](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html)食谱时，才提供 `itemExplorationConfig` 数据。类型：字符串到字符串映射映射条目：最多 100 项。键长度限制：最大长度为 256。值长度限制：最大长度为 1000。必需：否 ** rankingInfluence ** 排名地图影响受欢迎程度和新鲜度值。对于每个关键字，指定一个介于 0.0 和 1.0 之间的数值，该数值确定该排名因子对最终推荐的影响程度。值接近 1.0 会使因子得到更大的权重，而接近 0.0 的值会降低其影响。如果未指定，则两者都默认为 0.0。类型：字符串到双映射有效密钥：`POPULARITY | FRESHNESS` 有效范围：最小值为 0。最大值为 1。必需：否 ** syncWithLatestSolutionVersion ** 市场活动是否自动更新为使用解决方案的最新解决方案版本（经过训练的模型）。如果指定为 `True`，则必须为 `SolutionVersionArn` 参数指定*解决方案*的 ARN。ARN 的格式必须为 `SolutionArn/$LATEST`。默认设置为 `False`，您必须手动更新市场活动才能部署最新的解决方案版本。有关自动市场活动更新的更多信息，请参阅[启用自动市场活动更新](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update)。类型：布尔值必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWSSDKs，请参阅以下内容： + [AWS适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CampaignConfig) + [AWS适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CampaignConfig) + [AWS适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CampaignConfig) # CampaignSummary 提供活动属性摘要。如需完整列表，请调用 [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) API。 ## 目录 ** campaignArn ** 市场活动的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** creationDateTime ** 活动创建的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** failureReason ** 市场活动失败背后的原因。类型：字符串必需：否 ** lastUpdatedDateTime ** 上次更新市场活动的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** name ** 活动的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** status ** 市场活动的状态。市场活动可处于以下几种状态之一： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CampaignSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CampaignSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CampaignSummary) # CampaignUpdateSummary 提供市场活动更新的属性摘要。如需完整列表，请调用 [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) API。 ## 目录 ** campaignConfig ** 市场活动的配置详情。类型：[CampaignConfig](API_CampaignConfig.md) 对象必需：否 ** creationDateTime ** 创建市场活动更新的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** failureReason ** 市场活动更新失败背后的原因。类型：字符串必需：否 ** lastUpdatedDateTime ** 上次更新市场活动的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** minProvisionedTPS ** 指定 Amazon Personalize 将支持的请求的最低预调配每秒事务数（建议）。类型：整数有效范围：最小值为 1。必需：否 ** solutionVersionArn ** 部署的解决方案版本的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** status ** 市场活动更新的状态。市场活动更新可处于以下几种状态之一： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CampaignUpdateSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CampaignUpdateSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CampaignUpdateSummary) # CategoricalHyperParameterRange 提供分类超参数的名称和范围。 ## 目录 ** name ** 超参数的名称。类型：字符串长度约束：最大长度为 256。必需：否 ** values ** 超参数的类别列表。类型：字符串数组数组成员：最多 100 项。长度限制：最大长度为 1000。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CategoricalHyperParameterRange) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CategoricalHyperParameterRange) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CategoricalHyperParameterRange) # ContinuousHyperParameterRange 提供连续超参数的名称和范围。 ## 目录 ** maxValue ** 超参数的最大允许值。类型：双精度有效范围：最小值为 -1000000。必需：否 ** minValue ** 超参数的最小允许值。类型：双精度有效范围：最小值为 -1000000。必需：否 ** name ** 超参数的名称。类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ContinuousHyperParameterRange) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ContinuousHyperParameterRange) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ContinuousHyperParameterRange) # DataDeletionJob 描述一项作业，该作业批量删除对 Amazon Personalize 数据集组中特定用户的所有引用。有关创建数据删除作业的信息，请参阅[删除用户](https://docs.aws.amazon.com/personalize/latest/dg/delete-records.html)。 ## 目录 ** creationDateTime ** 数据删除作业的创建日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** dataDeletionJobArn ** 数据删除作业的 Amazon 资源名称（ARN）。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** datasetGroupArn ** 作业要从中删除记录的数据集组的 Amazon 资源名称（ARN）。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** dataSource ** 描述了包含要上传到数据集的数据来源，或者要从 Amazon Personalize 删除的记录列表。类型：[DataSource](API_DataSource.md) 对象必需：否 ** failureReason ** 如果数据删除作业失败，请提供原因。类型：字符串必需：否 ** jobName ** 数据删除作业的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** lastUpdatedDateTime ** 上次更新数据删除作业的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** numDeleted ** 已完成作业删除的记录数。类型：整数必需：否 ** roleArn ** 有权从 Amazon S3 数据来源读取的 IAM 角色的 Amazon 资源名称（ARN）。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 必需：否 ** status ** 数据删除作业的状态。数据删除作业可能具有以下某一状态： + PENDING > IN\$1PROGRESS > COMPLETED 或 FAILED 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DataDeletionJob) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DataDeletionJob) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DataDeletionJob) # DataDeletionJobSummary 提供数据删除作业属性的摘要。如需完整列表，请调用 [DescribeDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataDeletionJob.html) API 操作。 ## 目录 ** creationDateTime ** 数据删除作业的创建日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** dataDeletionJobArn ** 数据删除作业的 Amazon 资源名称（ARN）。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** datasetGroupArn ** 作业已从中删除记录的数据集组的 Amazon 资源名称（ARN）。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** failureReason ** 如果数据删除作业失败，请提供原因。类型：字符串必需：否 ** jobName ** 数据删除作业的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** lastUpdatedDateTime ** 上次更新数据删除作业的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** status ** 数据删除作业的状态。数据删除作业可能具有以下某一状态： + PENDING > IN\$1PROGRESS > COMPLETED 或 FAILED 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DataDeletionJobSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DataDeletionJobSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DataDeletionJobSummary) # Dataset 提供数据集的元数据。 ## 内容 ** creationDateTime ** 数据集的创建日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** datasetArn ** 您想要元数据的数据集的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** datasetGroupArn ** 数据集组的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** datasetType ** 下列值之一： + 交互 + 物品 + 用户 + 操作 + Action\$1Interactions 类型：字符串长度约束：最大长度为 256。模式：`^[A-Za-z_]+$` 必需：否 ** lastUpdatedDateTime ** 显示数据集更新时间的时间戳。类型：时间戳必需：否 ** latestDatasetUpdate ** 描述数据集的最新更新。类型：[DatasetUpdateSummary](API_DatasetUpdateSummary.md) 对象必需：否 ** name ** 数据集的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** schemaArn ** 关联架构的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** status ** 数据集的状态。数据集可处于以下几种状态之一： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 类型：字符串长度约束：最大长度为 256。必需：否 ** trackingId ** 操作交互数据集的事件跟踪器的 ID。您可以在 `PutActionInteractions` API 操作中指定跟踪器的 ID。Amazon Personalize 使用它来将新数据定向到数据集组中的操作交互数据集。类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWSSDKs，请参阅以下内容： + [AWS适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Dataset) + [AWS适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Dataset) + [AWS适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Dataset) # DatasetExportJob 描述将数据集导出到 Amazon S3 存储桶的作业。有关更多信息，请参阅 [CreateDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html)。数据集导出作业可处于以下几种状态之一： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED ## 目录 ** creationDateTime ** 数据集导出作业的创建日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** datasetArn ** 要导出的数据集的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** datasetExportJobArn ** 数据集导出作业的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** failureReason ** 如果数据集导出作业失败，请提供原因。类型：字符串必需：否 ** ingestionMode ** 要导出的数据，取决于您导入数据的方式。您可以选择导出使用数据集导入作业导入的 `BULK` 数据、增量导入的 `PUT` 数据（使用控制台、PutEvents、PutUsers 和 PutItems 操作），或者同时导出这两种类型的 `ALL`。默认值为 `PUT`。类型：字符串有效值：`BULK | PUT | ALL` 必需：否 ** jobName ** 导出作业的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** jobOutput ** 指向存储作业输出的 Amazon S3 存储桶的路径。例如： `s3://bucket-name/folder-name/` 类型：[DatasetExportJobOutput](API_DatasetExportJobOutput.md) 对象必需：否 ** lastUpdatedDateTime ** 上次更新数据集导出作业状态的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** roleArn ** 有权向输出 Amazon S3 存储桶添加数据的 IAM 服务角色的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** status ** 数据集导出作业的状态。数据集导出作业可处于以下几种状态之一： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetExportJob) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetExportJob) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetExportJob) # DatasetExportJobOutput 数据集导出作业的输出配置参数。 ## 目录 ** s3DataDestination ** Amazon S3 输入或输出存储桶的配置详细信息。类型：[S3DataConfig](API_S3DataConfig.md) 对象必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetExportJobOutput) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetExportJobOutput) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetExportJobOutput) # DatasetExportJobSummary 提供数据集导出作业的属性摘要。如需完整列表，请调用 [DescribeDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html) API。 ## 目录 ** creationDateTime ** 创建数据集导出作业的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** datasetExportJobArn ** 数据集导出作业的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** failureReason ** 如果数据集导出作业失败，则为其原因。类型：字符串必需：否 ** jobName ** 数据集导出作业的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** lastUpdatedDateTime ** 上次更新数据集导出作业状态的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** status ** 数据集导出作业的状态。数据集导出作业可处于以下几种状态之一： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetExportJobSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetExportJobSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetExportJobSummary) # DatasetGroup 数据集组是相关数据集（物品交互、用户、物品、操作、操作交互）的集合。您可通过调用 [CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html) 创建数据集组。然后通过调用 [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html) 创建一个数据集并将其添加到数据集组。数据集组用于通过调用 [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 创建和训练解决方案。数据集组只能包含每种数据集类型中的一种。您可以指定 AWS Key Management Service (KMS) 密钥来加密组中的数据集。 ## 目录 ** creationDateTime ** 数据集组的创建日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** datasetGroupArn ** 数据集组的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** domain ** 域数据集组的域。类型：字符串有效值：`ECOMMERCE | VIDEO_ON_DEMAND` 必需：否 ** failureReason ** 如果创建数据集组失败，请提供原因。类型：字符串必需：否 ** kmsKeyArn ** 用于加密数据集的 AWS Key Management Service (KMS) 密钥的 Amazon 资源名称（ARN）。类型：字符串长度约束：最大长度为 2048。模式：`arn:aws.*:kms:.*:[0-9]{12}:key/.*` 必需：否 ** lastUpdatedDateTime ** 数据集组的上次更新日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** name ** 数据集组的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** roleArn ** 有权访问 AWS Key Management Service (KMS) 密钥的 AWS Identity and Access Management (IAM) 角色的 ARN。仅当同时指定 KMS 密钥时，提供 IAM 角色才有效。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 必需：否 ** status ** 数据集组的当前状态。数据集组可处于以下几种状态之一： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED + DELETE PENDING 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetGroup) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetGroup) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetGroup) # DatasetGroupSummary 提供数据集组的属性摘要。如需完整列表，请调用 [DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html) API。 ## 目录 ** creationDateTime ** 创建数据集组的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** datasetGroupArn ** 数据集组的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** domain ** 域数据集组的域。类型：字符串有效值：`ECOMMERCE | VIDEO_ON_DEMAND` 必需：否 ** failureReason ** 如果创建数据集组失败，则为其原因。类型：字符串必需：否 ** lastUpdatedDateTime ** 上次更新数据集组的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** name ** 数据集组的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** status ** 数据集组的状态。数据集组可处于以下几种状态之一： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED + DELETE PENDING 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetGroupSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetGroupSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetGroupSummary) # DatasetImportJob 描述将训练数据从数据来源（Amazon S3 桶）导入到 Amazon Personalize 数据集的作业。有关更多信息，请参阅 [CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html)。数据集导入作业可处于以下几种状态之一： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED ## 目录 ** creationDateTime ** 数据集导入作业的创建日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** datasetArn ** 接收导入数据的数据集的 Amazon 资源名称（ARN）。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** datasetImportJobArn ** 数据集导入作业的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** dataSource ** 包含要导入的训练数据的 Amazon S3 桶。类型：[DataSource](API_DataSource.md) 对象必需：否 ** failureReason ** 如果数据集导入作业失败，请提供原因。类型：字符串必需：否 ** importMode ** 数据集导入作业用于导入新记录的导入模式。类型：字符串有效值：`FULL | INCREMENTAL` 必需：否 ** jobName ** 导入作业的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** lastUpdatedDateTime ** 上次更新数据集的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** publishAttributionMetricsToS3 ** 作业是否向 Amazon S3 发布指标以进行指标归因。类型：布尔值必需：否 ** roleArn ** 有权读取 Amazon S3 数据来源的 IAM 角色的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** status ** 数据集导入作业的状态。数据集导入作业可处于以下几种状态之一： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetImportJob) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetImportJob) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetImportJob) # DatasetImportJobSummary 提供数据集导入作业的属性摘要。如需完整列表，请调用 [DescribeDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html) API。 ## 目录 ** creationDateTime ** 创建数据集导入作业的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** datasetImportJobArn ** 数据集导入作业的 Amazon 资源名称（ARN）。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** failureReason ** 如果数据集导入作业失败，则为其原因。类型：字符串必需：否 ** importMode ** 数据集导入作业用于更新数据集中的数据的导入模式。有关更多信息，请参阅[更新现有批量数据](https://docs.aws.amazon.com/personalize/latest/dg/updating-existing-bulk-data.html)。类型：字符串有效值：`FULL | INCREMENTAL` 必需：否 ** jobName ** 数据集导入作业的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** lastUpdatedDateTime ** 上次更新数据集导入作业状态的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** status ** 数据集导入作业的状态。数据集导入作业可处于以下几种状态之一： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetImportJobSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetImportJobSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetImportJobSummary) # DatasetSchema 描述数据集的架构。有关架构的更多信息，请参阅 [CreateSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html)。 ## 目录 ** creationDateTime ** 架构的创建日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** domain ** 为域数据集组中的数据集创建的架构的域。类型：字符串有效值：`ECOMMERCE | VIDEO_ON_DEMAND` 必需：否 ** lastUpdatedDateTime ** 上次更新架构的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** name ** 架构的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** schema ** 架构。类型：字符串长度限制：最大长度为 20000。必需：否 ** schemaArn ** 架构的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetSchema) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetSchema) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetSchema) # DatasetSchemaSummary 提供数据集架构的属性摘要。如需完整列表，请调用 [DescribeSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSchema.html) API。 ## 目录 ** creationDateTime ** 架构的创建日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** domain ** 为域数据集组中的数据集创建的架构的域。类型：字符串有效值：`ECOMMERCE | VIDEO_ON_DEMAND` 必需：否 ** lastUpdatedDateTime ** 上次更新架构的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** name ** 架构的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** schemaArn ** 架构的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetSchemaSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetSchemaSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetSchemaSummary) # DatasetSummary 提供数据集属性摘要。如需完整列表，请调用 [DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html)API。 ## 内容 ** creationDateTime ** 数据集的创建日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** datasetArn ** 数据集的 Amazon 资源名称（ARN）。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** datasetType ** 数据集类型。下列值之一： + 交互 + 物品 + Users + 事件-交互类型：字符串长度约束：最大长度为 256。模式：`^[A-Za-z_]+$` 必需：否 ** lastUpdatedDateTime ** 上次更新数据集的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** name ** 数据集的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** status ** 数据集的状态。数据集可处于以下几种状态之一： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWSSDKs，请参阅以下内容： + [AWS适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetSummary) + [AWS适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetSummary) + [AWS适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetSummary) # DatasetUpdateSummary 描述数据集的更新。 ## 目录 ** creationDateTime ** 数据集更新的创建日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** failureReason ** 如果更新数据集失败，请提供原因。类型：字符串必需：否 ** lastUpdatedDateTime ** 数据集的上次更新日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** schemaArn ** 取代了数据集先前架构的架构的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** status ** 数据集更新的状态。类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetUpdateSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetUpdateSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetUpdateSummary) # DataSource 描述了包含要上传到数据集的数据来源，或者要从 Amazon Personalize 删除的记录列表。 ## 目录 ** dataLocation ** 对于数据集导入作业，这是存储了要上传到数据集的数据的 Amazon S3 存储桶路径。对于数据删除作业，这是存储了待删除记录列表的 Amazon S3 存储桶路径。例如： `s3://bucket-name/folder-name/fileName.csv` 如果您的 CSV 文件位于 Amazon S3 存储桶的某个文件夹中，并且您希望导入作业或数据删除作业考虑多个文件，则可以指定该文件夹的路径。对于数据删除作业，Amazon Personalize 会使用该文件夹及任何子文件夹中的所有文件。使用以下语法，在文件夹名称后面加上 `/`： `s3://bucket-name/folder-name/` 类型：字符串长度约束：最大长度为 256。模式：`(s3|http|https)://.+` 必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DataSource) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DataSource) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DataSource) # DefaultCategoricalHyperParameterRange 提供分类超参数的名称和默认范围，以及超参数是否可调。可以在超参数优化 (HPO) 期间确定可调超参数的值。 ## 目录 ** isTunable ** 超参数是否可调。类型：布尔值必需：否 ** name ** 超参数的名称。类型：字符串长度约束：最大长度为 256。必需：否 ** values ** 超参数的类别列表。类型：字符串数组数组成员：最多 100 项。长度限制：最大长度为 1000。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultCategoricalHyperParameterRange) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultCategoricalHyperParameterRange) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultCategoricalHyperParameterRange) # DefaultContinuousHyperParameterRange 提供连续超参数的名称和默认范围，以及超参数是否可调。可以在超参数优化 (HPO) 期间确定可调超参数的值。 ## 目录 ** isTunable ** 超参数是否可调。类型：布尔值必需：否 ** maxValue ** 超参数的最大允许值。类型：双精度有效范围：最小值为 -1000000。必需：否 ** minValue ** 超参数的最小允许值。类型：双精度有效范围：最小值为 -1000000。必需：否 ** name ** 超参数的名称。类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultContinuousHyperParameterRange) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultContinuousHyperParameterRange) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultContinuousHyperParameterRange) # DefaultHyperParameterRanges 指定超参数及其默认范围。超参数可以是分类值、连续值或整数值。 ## 目录 ** categoricalHyperParameterRanges ** 类别超参数及其默认范围。类型：[DefaultCategoricalHyperParameterRange](API_DefaultCategoricalHyperParameterRange.md) 对象数组数组成员：最多 100 项。必需：否 ** continuousHyperParameterRanges ** 连续超参数及其默认范围。类型：[DefaultContinuousHyperParameterRange](API_DefaultContinuousHyperParameterRange.md) 对象数组数组成员：最多 100 项。必需：否 ** integerHyperParameterRanges ** 整数值超参数及其默认范围。类型：[DefaultIntegerHyperParameterRange](API_DefaultIntegerHyperParameterRange.md) 对象数组数组成员：最多 100 项。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultHyperParameterRanges) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultHyperParameterRanges) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultHyperParameterRanges) # DefaultIntegerHyperParameterRange 提供整数值超参数的名称和默认范围，以及超参数是否可调。可以在超参数优化 (HPO) 期间确定可调超参数的值。 ## 目录 ** isTunable ** 表示超参数是否可调。类型：布尔值必需：否 ** maxValue ** 超参数的最大允许值。类型：整数有效范围：最大值为 1000000。必需：否 ** minValue ** 超参数的最小允许值。类型：整数有效范围：最小值为 -1000000。必需：否 ** name ** 超参数的名称。类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultIntegerHyperParameterRange) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultIntegerHyperParameterRange) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultIntegerHyperParameterRange) # EventParameters 描述用于创建解决方案的事件参数。 ## 目录 ** eventType ** 创建解决方案时要考虑的事件类型的名称。类型：字符串长度约束：最大长度为 256。必需：否 ** eventValueThreshold ** 事件类型的阈值。只有值大于或等于此阈值的事件才会被考虑用于创建解决方案。类型：双精度必需：否 ** weight ** 事件类型的权重。权重越高意味着事件类型对创建的解决方案越重要。类型：双精度有效范围：最小值为 0。最大值为 1。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventParameters) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventParameters) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventParameters) # EventsConfig 描述用于创建解决方案的事件配置。 ## 目录 ** eventParametersList ** 事件参数列表，其中包含事件类型及其事件值阈值和权重。类型：[EventParameters](API_EventParameters.md) 对象数组数组成员：最多 10 项。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventsConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventsConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventsConfig) # EventTracker 提供有关事件跟踪器的信息。 ## 目录 ** accountId ** 拥有事件跟踪器的 AWS 账户。类型：字符串长度约束：最大长度为 256。必需：否 ** creationDateTime ** 创建事件跟踪器的日期和时间（采用 Unix 格式）。类型：时间戳必需：否 ** datasetGroupArn ** 接收事件数据的数据集组的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** eventTrackerArn ** 事件跟踪器的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** lastUpdatedDateTime ** 上次更新事件跟踪器的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** name ** 事件跟踪器的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** status ** 事件跟踪器的状态。事件跟踪器可以处于以下某种状态： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 类型：字符串长度约束：最大长度为 256。必需：否 ** trackingId ** 事件跟踪器的 ID。在向 [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html) API 发出的请求中包含此 ID。类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventTracker) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventTracker) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventTracker) # EventTrackerSummary 提供事件跟踪器属性摘要。如需完整列表，请调用 [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html) API。 ## 目录 ** creationDateTime ** 创建事件跟踪器的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** eventTrackerArn ** 事件跟踪器的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** lastUpdatedDateTime ** 上次更新事件跟踪器的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** name ** 事件跟踪器的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** status ** 事件跟踪器的状态。事件跟踪器可以处于以下某种状态： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventTrackerSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventTrackerSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventTrackerSummary) # FeatureTransformation 提供特征转换信息。特征转换是将原始输入数据修改为更适合模型训练的格式的过程。 ## 目录 ** creationDateTime ** 特征转换的创建日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** defaultParameters ** 提供特征转换的默认参数。类型：字符串到字符串映射映射条目：最多 100 项。键长度限制：最大长度为 256。值长度限制：最大长度为 1000。必需：否 ** featureTransformationArn ** FeatureTransformation 对象的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** lastUpdatedDateTime ** 特征转换的上次更新日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** name ** 特征转换的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** status ** 特征转换的状态。特征转换可以处于以下某种状态： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/FeatureTransformation) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/FeatureTransformation) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/FeatureTransformation) # FieldsForThemeGeneration 主题生成的配置详细信息的字符串到字符串映射。 ## 目录 ** itemName ** 用于在数据集中存储每个物品的名称的物品数据集列的名称。类型：字符串长度限制：最大长度为 150。模式：`[A-Za-z_][A-Za-z\d_]*` 必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/FieldsForThemeGeneration) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/FieldsForThemeGeneration) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/FieldsForThemeGeneration) # Filter 包含有关建议筛选器的信息，包括其 ARN、状态和筛选器表达式。 ## 目录 ** creationDateTime ** 创建筛选器的时间。类型：时间戳必需：否 ** datasetGroupArn ** 筛选器所属数据集组的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** failureReason ** 如果筛选失败，请说明原因。类型：字符串必需：否 ** filterArn ** 筛选器的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** filterExpression ** 指定要从建议结果中筛选出来的物品交互类型。筛选器表达式必须遵循特定的格式规则。有关筛选器表达式结构和语法的信息，请参阅[筛选器表达式](https://docs.aws.amazon.com/personalize/latest/dg/filter-expressions.html)。类型：字符串长度限制：长度下限为 1。最大长度为 2500。必需：否 ** lastUpdatedDateTime ** 上次更新筛选器的时间。类型：时间戳必需：否 ** name ** 筛选器的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** status ** 筛选器的状态。类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Filter) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Filter) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Filter) # FilterSummary 筛选器属性的简短摘要。 ## 目录 ** creationDateTime ** 创建筛选器的时间。类型：时间戳必需：否 ** datasetGroupArn ** 筛选器所属数据集组的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** failureReason ** 如果筛选失败，请说明原因。类型：字符串必需：否 ** filterArn ** 筛选器的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** lastUpdatedDateTime ** 上次更新筛选器的时间。类型：时间戳必需：否 ** name ** 筛选器的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** status ** 筛选器的状态。类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/FilterSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/FilterSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/FilterSummary) # HPOConfig 描述超参数优化（HPO）的属性。 ## 目录 ** algorithmHyperParameterRanges ** 超参数及其允许范围。类型：[HyperParameterRanges](API_HyperParameterRanges.md) 对象必需：否 ** hpoObjective ** HPO 期间要优化的指标。 Amazon Personalize 目前不支持配置 `hpoObjective`。类型：[HPOObjective](API_HPOObjective.md) 对象必需：否 ** hpoResourceConfig ** 描述 HPO 的资源配置。类型：[HPOResourceConfig](API_HPOResourceConfig.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HPOConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HPOConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HPOConfig) # HPOObjective 超参数优化（HPO）期间要优化的指标。 **注意** Amazon Personalize 目前不支持配置 `hpoObjective`。 ## 目录 ** metricName ** 指标的名称。类型：字符串长度约束：最大长度为 256。必需：否 ** metricRegex ** 用于在训练任务日志中查找指标的正则表达式。类型：字符串长度约束：最大长度为 256。必需：否 ** type ** 指标的类型。有效值为 `Maximize` 和 `Minimize`。类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HPOObjective) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HPOObjective) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HPOObjective) # HPOResourceConfig 描述超参数优化（HPO）的资源配置。 ## 目录 ** maxNumberOfTrainingJobs ** 创建解决方案版本时的最大训练任务数。`maxNumberOfTrainingJobs` 的最大值为 `40`。类型：字符串长度约束：最大长度为 256。必需：否 ** maxParallelTrainingJobs ** 创建解决方案版本时的最大并行训练任务数。`maxParallelTrainingJobs` 的最大值为 `10`。类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HPOResourceConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HPOResourceConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HPOResourceConfig) # HyperParameterRanges 指定超参数及其范围。超参数可以是分类值、连续值或整数值。 ## 目录 ** categoricalHyperParameterRanges ** 分类超参数及其范围。类型：[CategoricalHyperParameterRange](API_CategoricalHyperParameterRange.md) 对象数组数组成员：最多 100 项。必需：否 ** continuousHyperParameterRanges ** 连续超参数及其范围。类型：[ContinuousHyperParameterRange](API_ContinuousHyperParameterRange.md) 对象数组数组成员：最多 100 项。必需：否 ** integerHyperParameterRanges ** 整数值超参数及其范围。类型：[IntegerHyperParameterRange](API_IntegerHyperParameterRange.md) 对象数组数组成员：最多 100 项。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HyperParameterRanges) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HyperParameterRanges) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HyperParameterRanges) # IntegerHyperParameterRange 提供整数值超参数的名称和范围。 ## 目录 ** maxValue ** 超参数的最大允许值。类型：整数有效范围：最大值为 1000000。必需：否 ** minValue ** 超参数的最小允许值。类型：整数有效范围：最小值为 -1000000。必需：否 ** name ** 超参数的名称。类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/IntegerHyperParameterRange) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/IntegerHyperParameterRange) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/IntegerHyperParameterRange) # MetricAttribute 包含有关指标归因报告的指标的信息。有关更多信息，请参阅[衡量建议的影响](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)。 ## 目录 ** eventType ** 指标事件类型。类型：字符串长度约束：最大长度为 256。必需：是 ** expression ** 属性的表达式。可用函数为 `SUM()` 或 `SAMPLECOUNT()`。对于 SUM() 函数，提供数据集类型（交互或物品）及要求和的列作为参数。例如 SUM(Items.PRICE)。类型：字符串长度约束：最大长度为 256。必需：是 ** metricName ** 指标名称。该名称可帮助您识别 Amazon CloudWatch 或 Amazon S3 中的指标。类型：字符串长度约束：最大长度为 256。必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttribute) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttribute) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttribute) # MetricAttribution 包含有关指标归因的信息。指标归因会针对您导入 Amazon Personalize 的数据创建报告。根据您导入数据的方式，您可以在 Amazon CloudWatch 或 Amazon S3 中查看报告。有关更多信息，请参阅[衡量建议的影响](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)。 ## 目录 ** creationDateTime ** 指标归因的创建日期和时间。类型：时间戳必需：否 ** datasetGroupArn ** 指标归因的数据集组 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** failureReason ** 指标归因的失败原因。类型：字符串必需：否 ** lastUpdatedDateTime ** 指标归因的上次更新日期和时间。类型：时间戳必需：否 ** metricAttributionArn ** 指标归因的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** metricsOutputConfig ** 指标归因的输出配置。类型：[MetricAttributionOutput](API_MetricAttributionOutput.md) 对象必需：否 ** name ** 指标归因的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** status ** 指标归因的状态。类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttribution) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttribution) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttribution) # MetricAttributionOutput 指标归因的输出配置详细信息。 ## 目录 ** roleArn ** 有权向输出 Amazon S3 存储桶添加数据并向 Amazon CloudWatch 添加指标的 IAM 服务角色的 Amazon 资源名称 (ARN)。有关更多信息，请参阅[衡量建议的影响](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 必需：是 ** s3DataDestination ** Amazon S3 输入或输出存储桶的配置详细信息。类型：[S3DataConfig](API_S3DataConfig.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttributionOutput) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttributionOutput) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttributionOutput) # MetricAttributionSummary 提供指标归因属性的摘要。如需完整列表，请调用 [DescribeMetricAttribution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeMetricAttribution.html)。 ## 目录 ** creationDateTime ** 指标归因的创建日期和时间。类型：时间戳必需：否 ** failureReason ** 指标归因的失败原因。类型：字符串必需：否 ** lastUpdatedDateTime ** 指标归因的上次更新日期和时间。类型：时间戳必需：否 ** metricAttributionArn ** 指标归因的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** name ** 指标归因的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** status ** 指标归因的状态。类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttributionSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttributionSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttributionSummary) # OptimizationObjective 描述解决方案的其他目标，例如最大限度地提高流时长或增加收入。有关更多信息，请参阅[优化解决方案](https://docs.aws.amazon.com/personalize/latest/dg/optimizing-solution-for-objective.html)。 ## 目录 ** itemAttribute ** 物品数据集中与优化目标相关的数值元数据列。例如，VIDEO\$1LENGTH（可最大限度地提高流时长）或 PRICE（可最大限度地提高收入）。类型：字符串长度限制：长度下限为 1。最大长度为 150。必需：否 ** objectiveSensitivity ** 指定 Amazon Personalize 如何平衡优化目标的重要性与相关性。类型：字符串有效值：`LOW | MEDIUM | HIGH | OFF` 必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/OptimizationObjective) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/OptimizationObjective) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/OptimizationObjective) # Recipe 提供有关食谱的信息。每个食谱都提供了一种算法，供 Amazon Personalize 在您使用 [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 操作时在模型训练期间使用。 ## 目录 ** algorithmArn ** Amazon Personalize 用来训练模型的算法的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** creationDateTime ** 创建食谱的日期和时间（采用 Unix 格式）。类型：时间戳必需：否 ** description ** 对食谱的描述。类型：字符串必需：否 ** featureTransformationArn ** FeatureTransformation 对象的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** lastUpdatedDateTime ** 上次更新食谱的日期和时间（采用 Unix 格式）。类型：时间戳必需：否 ** name ** 食谱的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** recipeArn ** 食谱的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** recipeType ** 下列值之一： + PERSONALIZED\$1RANKING + RELATED\$1ITEMS + USER\$1PERSONALIZATION 类型：字符串长度约束：最大长度为 256。必需：否 ** status ** 食谱的状态。类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Recipe) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Recipe) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Recipe) # RecipeSummary 提供食谱属性摘要。如需完整列表，请调用 [DescribeRecipe](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecipe.html) API。 ## 目录 ** creationDateTime ** 创建食谱的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** domain ** 食谱的域（如果食谱是域数据集组使用案例）。类型：字符串有效值：`ECOMMERCE | VIDEO_ON_DEMAND` 必需：否 ** lastUpdatedDateTime ** 上次更新食谱的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** name ** 食谱的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** recipeArn ** 食谱的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** status ** 食谱的状态。类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecipeSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecipeSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecipeSummary) # Recommender 描述域数据集组的建议生成器。您可以在域数据集组中为特定域使用案例（域食谱）创建推荐器，然后在 [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) 请求中指定推荐器。 ## 目录 ** creationDateTime ** 推荐器的创建日期和时间（采用 Unix 格式）。类型：时间戳必需：否 ** datasetGroupArn ** 包含推荐器的域数据集组的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** failureReason ** 如果推荐器失败，请说明原因。类型：字符串必需：否 ** lastUpdatedDateTime ** 上次更新推荐器的日期和时间（采用 Unix 格式）。类型：时间戳必需：否 ** latestRecommenderUpdate ** 提供推荐器最新更新的摘要。类型：[RecommenderUpdateSummary](API_RecommenderUpdateSummary.md) 对象必需：否 ** modelMetrics ** 提供评估指标，以帮助您确定推荐器的性能。有关更多信息，请参阅[评估推荐器](https://docs.aws.amazon.com/personalize/latest/dg/evaluating-recommenders.html)。类型：字符串到双映射映射条目：最多 100 项。键长度限制：最大长度为 256。必需：否 ** name ** 推荐器的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** recipeArn ** 创建推荐器的食谱（域数据集组使用案例）的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** recommenderArn ** 推荐器的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** recommenderConfig ** 推荐器的配置详细信息。类型：[RecommenderConfig](API_RecommenderConfig.md) 对象必需：否 ** status ** 推荐器的状态。推荐器可处于以下一种状态： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED + STOP PENDING > STOP IN\$1PROGRESS > INACTIVE > START PENDING > START IN\$1PROGRESS > ACTIVE + DELETE PENDING > DELETE IN\$1PROGRESS 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Recommender) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Recommender) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Recommender) # RecommenderConfig 推荐器的配置详细信息。 ## 目录 ** enableMetadataWithRecommendations ** 是否为推荐器启用了带有建议的元数据。如果启用，则可以在建议请求中指定物品数据集中的列。Amazon Personalize 会在建议响应中返回每个物品的这些数据。有关为推荐器启用元数据的信息，请参阅[在推荐器建议中启用元数据](https://docs.aws.amazon.com/personalize/latest/dg/creating-recommenders.html#create-recommender-return-metadata)。如果您在建议中启用元数据，则会产生额外费用。有关更多信息，请参阅 [Amazon Personalize 定价](https://aws.amazon.com/personalize/pricing/)。类型：布尔值必需：否 ** itemExplorationConfig ** 指定浏览配置超参数，包括 `explorationWeight` 和 `explorationItemAgeCutOff`，您希望用它来配置 Amazon Personalize 在推荐物品时使用的物品浏览量。只有当您的推荐器为用户生成个性化建议（而非热门物品或类似物品）时，才提供 `itemExplorationConfig` 数据。类型：字符串到字符串映射映射条目：最多 100 项。键长度限制：最大长度为 256。值长度限制：最大长度为 1000。必需：否 ** minRecommendationRequestsPerSecond ** 指定 Amazon Personalize 将支持的请求的最低预调配建议每秒请求数。高 `minRecommendationRequestsPerSecond` 会增加您的账单费用。我们建议从 1 开始设置 `minRecommendationRequestsPerSecond`（默认值）。使用 Amazon CloudWatch 指标跟踪您的使用情况，并在必要时增加 `minRecommendationRequestsPerSecond`。类型：整数有效范围：最小值为 1。必需：否 ** trainingDataConfig ** 指定创建域推荐器时要使用的训练数据配置。类型：[TrainingDataConfig](API_TrainingDataConfig.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecommenderConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecommenderConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecommenderConfig) # RecommenderSummary 提供推荐器属性摘要。 ## 目录 ** creationDateTime ** 推荐器的创建日期和时间（采用 Unix 格式）。类型：时间戳必需：否 ** datasetGroupArn ** 包含推荐器的域数据集组的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** lastUpdatedDateTime ** 上次更新推荐器的日期和时间（采用 Unix 格式）。类型：时间戳必需：否 ** name ** 推荐器的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** recipeArn ** 创建推荐器的食谱（域数据集组使用案例）的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** recommenderArn ** 推荐器的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** recommenderConfig ** 推荐器的配置详细信息。类型：[RecommenderConfig](API_RecommenderConfig.md) 对象必需：否 ** status ** 推荐器的状态。推荐器可处于以下一种状态： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED + STOP PENDING > STOP IN\$1PROGRESS > INACTIVE > START PENDING > START IN\$1PROGRESS > ACTIVE + DELETE PENDING > DELETE IN\$1PROGRESS 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecommenderSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecommenderSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecommenderSummary) # RecommenderUpdateSummary 提供推荐器更新的属性摘要。如需完整列表，请调用 [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) API。 ## 目录 ** creationDateTime ** 推荐器更新的创建日期和时间（采用 Unix 格式）。类型：时间戳必需：否 ** failureReason ** 如果推荐器更新失败，请说明原因。类型：字符串必需：否 ** lastUpdatedDateTime ** 上次更新推荐器更新的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** recommenderConfig ** 推荐器更新的配置详细信息。类型：[RecommenderConfig](API_RecommenderConfig.md) 对象必需：否 ** status ** 推荐器更新的状态。推荐器更新可处于以下一种状态： CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecommenderUpdateSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecommenderUpdateSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecommenderUpdateSummary) # S3DataConfig Amazon S3 输入或输出存储桶的配置详细信息。 ## 目录 ** path ** Amazon S3 存储桶的文件路径。类型：字符串长度约束：最大长度为 256。模式：`(s3|http|https)://.+` 必需：是 ** kmsKeyArn ** Amazon Personalize 用来加密或解密输入和输出文件的 AWS Key Management Service (KMS) 密钥的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 2048。模式：`arn:aws.*:kms:.*:[0-9]{12}:key/.*` 必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/S3DataConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/S3DataConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/S3DataConfig) # Solution **重要** 默认情况下，所有新解决方案都使用自动训练。如果使用自动训练，则在解决方案处于活动状态时，就会产生训练费用。为避免产生不必要的费用，在完成后，可以[更新解决方案](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html)以关闭自动训练。有关训练费用的信息，请参阅 [Amazon Personalize 定价](https://aws.amazon.com/personalize/pricing/)。提供有关解决方案的信息的对象。解决方案包括 Amazon Personalize 用来生成推荐的自定义配方、自定义参数和经过训练的模型（解决方案版本）。创建解决方案后，就不能更改其配置。如果您需要进行更改，则可以使用 Amazon Personalize 控制台[克隆解决方案](https://docs.aws.amazon.com/personalize/latest/dg/cloning-solution.html)或创建一个新的解决方案。 ## 内容 ** autoMLResult ** 如果 `performAutoML` 为 true，请指定找到的最佳食谱。类型：[AutoMLResult](API_AutoMLResult.md) 对象必需：否 ** creationDateTime ** 解决方案的创建日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** datasetGroupArn ** 提供训练数据的数据集组的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** eventType ** 用于训练模型的事件类型（例如，“单击”或“点赞”）。如果没有提供 `eventType`，Amazon Personalize 将使用所有交互进行同等权重的训练，而不考虑类型。类型：字符串长度约束：最大长度为 256。必需：否 ** lastUpdatedDateTime ** 上次更新解决方案的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** latestSolutionUpdate ** 提供解决方案最新更新的摘要。类型：[SolutionUpdateSummary](API_SolutionUpdateSummary.md) 对象必需：否 ** latestSolutionVersion ** 描述解决方案的最新版本，包括状态和 ARN。类型：[SolutionVersionSummary](API_SolutionVersionSummary.md) 对象必需：否 ** name ** 解决方案的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** performAutoML ** 我们建议不要启用自动机器学习。相反，请将您的使用案例与可用的 Amazon Personalize 配方匹配。有关更多信息，请参阅 [Determining your use case](https://docs.aws.amazon.com/personalize/latest/dg/determining-use-case.html)（确定您的使用案例）。如果为 true，Amazon Personalize 会从解决方案配置中指定的列表中搜索最佳 USER\$1PERSONALIZATION 食谱（不得指定 `recipeArn`）。如果为 false（默认值），Amazon Personalize 将使用 `recipeArn` 进行训练。类型：布尔值必需：否 ** performAutoTraining ** 指定解决方案是否自动创建解决方案版本。默认设置为 `True`，解决方案每 7 天自动创建新的解决方案版本。有关自动训练的更多信息，请参阅[创建和配置解决方案](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html)。类型：布尔值必需：否 ** performHPO ** 是否对所选食谱执行超参数优化（HPO）。默认值为 `false`。类型：布尔值必需：否 ** performIncrementalUpdate ** 一个布尔值，用于指示是否对模型执行增量训练更新。启用后，它允许模型更频繁地从新数据中学习，而无需进行全面的再训练，从而实现近乎实时的个性化。只有使用语义相似度配方的解决方案才支持此参数类型：布尔值必需：否 ** recipeArn ** 用于创建解决方案的食谱的 ARN。当 `performAutoML` 为 false 时，这是必需的。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** solutionArn ** 解决方案的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** solutionConfig ** 描述解决方案的配置属性。类型：[SolutionConfig](API_SolutionConfig.md) 对象必需：否 ** status ** 解决方案的状态。解决方案可处于以下几种状态之一： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWSSDKs，请参阅以下内容： + [AWS适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Solution) + [AWS适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Solution) + [AWS适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Solution) # SolutionConfig 描述解决方案的配置属性。 ## 目录 ** algorithmHyperParameters ** 列出算法超参数及其值。类型：字符串到字符串映射映射条目：最多 100 项。键长度限制：最大长度为 256。值长度限制：最大长度为 1000。必需：否 ** autoMLConfig ** 包含当执行 AutoML 时要搜索的食谱列表的 [AutoMLConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_AutoMLConfig.html) 对象。类型：[AutoMLConfig](API_AutoMLConfig.md) 对象必需：否 ** autoTrainingConfig ** 指定要使用的自动训练配置。类型：[AutoTrainingConfig](API_AutoTrainingConfig.md) 对象必需：否 ** eventsConfig ** 描述事件的配置，其中包含事件参数列表。您可以指定最多 10 个事件参数。事件用于创建解决方案。类型：[EventsConfig](API_EventsConfig.md) 对象必需：否 ** eventValueThreshold ** 仅具有大于或等于阈值的值的事件用于训练模型。类型：字符串长度约束：最大长度为 256。必需：否 ** featureTransformationParameters ** 列出特征转换参数。类型：字符串到字符串映射映射条目：最多 100 项。键长度限制：最大长度为 256。值长度限制：最大长度为 1000。必需：否 ** hpoConfig ** 描述超参数优化（HPO）的属性。类型：[HPOConfig](API_HPOConfig.md) 对象必需：否 ** optimizationObjective ** 描述解决方案的其他目标，例如最大限度地提高流时长或增加收入。有关更多信息，请参阅[优化解决方案](https://docs.aws.amazon.com/personalize/latest/dg/optimizing-solution-for-objective.html)。类型：[OptimizationObjective](API_OptimizationObjective.md) 对象必需：否 ** trainingDataConfig ** 指定创建自定义解决方案版本（经过训练的模型）时要使用的训练数据配置。类型：[TrainingDataConfig](API_TrainingDataConfig.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionConfig) # SolutionSummary 提供解决方案属性摘要。如需完整列表，请调用 [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) API。 ## 目录 ** creationDateTime ** 创建解决方案的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** lastUpdatedDateTime ** 上次更新解决方案的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** name ** 解决方案的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** recipeArn ** 解决方案使用的食谱的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** solutionArn ** 解决方案的 Amazon 资源名称（ARN）。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** status ** 解决方案的状态。解决方案可处于以下几种状态之一： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionSummary) # SolutionUpdateConfig 解决方案更新的配置详细信息。 ## 目录 ** autoTrainingConfig ** 当 `performAutoTraining` 为 true 时要使用的自动训练配置。类型：[AutoTrainingConfig](API_AutoTrainingConfig.md) 对象必需：否 ** eventsConfig ** 描述事件的配置，其中包含事件参数列表。您可以指定最多 10 个事件参数。事件用于创建解决方案。类型：[EventsConfig](API_EventsConfig.md) 对象必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionUpdateConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionUpdateConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionUpdateConfig) # SolutionUpdateSummary 提供解决方案更新属性的摘要。如需完整列表，请调用 [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html)API。 ## 内容 ** creationDateTime ** 解决方案更新的创建日期和时间（采用 Unix 格式）。类型：时间戳必需：否 ** failureReason ** 如果解决方案更新失败，则为其原因。类型：字符串必需：否 ** lastUpdatedDateTime ** 上次更新解决方案更新的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** performAutoTraining ** 解决方案是否自动创建解决方案版本。类型：布尔值必需：否 ** performIncrementalUpdate ** 一个布尔值，用于指示是否对模型执行增量训练更新。启用后，将对具有活跃营销活动的解决方案版本进行增量训练，并允许模型更频繁地从新数据中学习，而无需进行全面的再训练，从而实现近乎实时的个性化。只有使用语义相似度配方的解决方案才支持此参数。默认值为 `true`。请注意，某些分数和属性（例如更新物品受欢迎程度和用于通过 aws-semantic-similarity配方影响排名的新鲜度）可能要等到下一次完整训练才会更新。类型：布尔值必需：否 ** solutionUpdateConfig ** 解决方案的配置详细信息。类型：[SolutionUpdateConfig](API_SolutionUpdateConfig.md) 对象必需：否 ** status ** 解决方案更新的状态。解决方案更新可处于以下几种状态之一： CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED 类型：字符串长度约束：最大长度为 256。必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWSSDKs，请参阅以下内容： + [AWS适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionUpdateSummary) + [AWS适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionUpdateSummary) + [AWS适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionUpdateSummary) # SolutionVersion 一个对象，用于提供有关自定义数据集组中特定版[解决方案](https://docs.aws.amazon.com/personalize/latest/dg/API_Solution.html)的信息。 ## 内容 ** creationDateTime ** 创建此版解决方案的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** datasetGroupArn ** 提供训练数据的数据集组的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** eventType ** 用于训练模型的事件类型（例如，“单击”或“点赞”）。类型：字符串长度约束：最大长度为 256。必需：否 ** failureReason ** 如果训练解决方案版本失败，则为其原因。类型：字符串必需：否 ** lastUpdatedDateTime ** 上次更新解决方案的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** name ** 解决方案版本的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** performAutoML ** 如果为 true，Amazon Personalize 会根据解决方案配置搜索最佳食谱。如果为 false（默认值），Amazon Personalize 将使用 `recipeArn`。类型：布尔值必需：否 ** performHPO ** 是否对所选食谱执行超参数优化（HPO）。默认值为 `false`。类型：布尔值必需：否 ** performIncrementalUpdate ** 解决方案版本是否应执行增量更新。设置为 true 时，训练将仅处理自上次训练以来发生更改的数据，类似于 TrainingMode 设置为 UPDATE 的情况。这只能用于使用用户个性化配方的解决方案版本。类型：布尔值必需：否 ** recipeArn ** 解决方案中使用的食谱的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** solutionArn ** 解决方案的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** solutionConfig ** 描述解决方案的配置属性。类型：[SolutionConfig](API_SolutionConfig.md) 对象必需：否 ** solutionVersionArn ** 解决方案版本的 ARN。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** status ** 解决方案版本的状态。解决方案版本可以处于下列状态之一： + CREATE PENDING + CREATE IN\$1PROGRESS + ACTIVE + CREATE FAILED + CREATE STOPPING + CREATE STOPPED 类型：字符串长度约束：最大长度为 256。必需：否 ** trainingHours ** 用于训练模型的时间。您需要为训练模型所花费的时间付费。只有在 Amazon Personalize 成功训练模型之后，才会显示此字段。类型：双精度有效范围：最小值为 0。必需：否 ** trainingMode ** 创建解决方案版本时要执行的训练的范围。`FULL` 训练会考虑数据集组中的所有数据。`UPDATE` 仅处理自上次训练以来发生变化的数据。只有通过 User-Personalization 配方创建的解决方案版本才能使用 `UPDATE`。类型：字符串有效值：`FULL | UPDATE | AUTOTRAIN` 必需：否 ** trainingType ** 解决方案版本是自动创建还是手动创建。类型：字符串有效值：`AUTOMATIC | MANUAL` 必需：否 ** tunedHPOParams ** 如果执行了超参数优化，则包含性能最佳模型的超参数值。类型：[TunedHPOParams](API_TunedHPOParams.md) 对象必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWSSDKs，请参阅以下内容： + [AWS适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionVersion) + [AWS适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionVersion) + [AWS适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionVersion) # SolutionVersionSummary 提供解决方案版本的属性摘要。如需完整列表，请调用 [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) API。 ## 目录 ** creationDateTime ** 创建此版解决方案的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** failureReason ** 如果解决方案版本失败，则为其原因。类型：字符串必需：否 ** lastUpdatedDateTime ** 上次更新解决方案版本的日期和时间（采用 Unix 时间）。类型：时间戳必需：否 ** solutionVersionArn ** 解决方案版本的 Amazon 资源名称 (ARN)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** status ** 解决方案版本的状态。解决方案版本可以处于下列状态之一： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED 类型：字符串长度约束：最大长度为 256。必需：否 ** trainingMode ** 创建解决方案版本时要执行的训练的范围。`FULL` 训练会考虑数据集组中的所有数据。`UPDATE` 仅处理自上次训练以来发生变化的数据。只有通过 User-Personalization 配方创建的解决方案版本才能使用 `UPDATE`。类型：字符串有效值：`FULL | UPDATE | AUTOTRAIN` 必需：否 ** trainingType ** 解决方案版本是自动创建还是手动创建。类型：字符串有效值：`AUTOMATIC | MANUAL` 必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionVersionSummary) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionVersionSummary) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionVersionSummary) # Tag 您应用于资源以帮助您对其进行分类和组织的可选元数据。每个标签都包含定义的一个键和一个可选值。有关更多信息，请参阅[标记 Amazon Personalize 资源](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)。 ## 目录 ** tagKey ** 构成标签的键-值对的一个部分。键是一种常见的标签，行为类似于更具体的标签值的类别。类型：字符串长度限制：长度下限为 1。最大长度为 128。模式：`^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` 必需：是 ** tagValue ** 构成标签的键-值对的可选部分。值充当标签类别（键）中的描述符。类型：字符串长度约束：最小长度为 0。最大长度为 256。模式：`^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` 必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Tag) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Tag) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Tag) # ThemeGenerationConfig 使用批量推理作业生成主题的配置详细信息。 ## 目录 ** fieldsForThemeGeneration ** 用于为批量推理作业生成描述性主题的字段。类型：[FieldsForThemeGeneration](API_FieldsForThemeGeneration.md) 对象必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ThemeGenerationConfig) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ThemeGenerationConfig) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ThemeGenerationConfig) # TrainingDataConfig 创建域推荐器或自定义解决方案版本（经过训练的模型）时要使用的训练数据配置。 ## 内容 ** excludedDatasetColumns ** 指定要从训练中排除的列。每个键都是一个数据集类型，每个值都是一个列列表。排除列以控制 Amazon Personalize 使用哪些数据生成建议。例如，可能有一列，您只想将其用来筛选建议。您可以将此列排除在训练之外，Amazon Personalize 只有在筛选时才会考虑该列。类型：字符串到字符串数组映射映射条目：最多 3 项。密钥长度限制：最大长度为 256。键模式：`^[A-Za-z_]+$` 数组成员：最多 50 项。长度限制：最大长度为 150。模式：`[A-Za-z_][A-Za-z\d_]*` 必需：否 ** includedDatasetColumns ** 指定训练中要包含的列。每个键都是一个数据集类型，每个值都是一个列列表。包括用于控制 Amazon Personalize 使用哪些数据生成推荐的列。例如，您的项目数据集中可能有多列，但只想使用标题和描述进行训练。您只能将这两列包含在培训中，Amazon Personalize 将仅考虑培训中包含的列。类型：字符串到字符串数组映射映射条目：最多 3 项。密钥长度限制：最大长度为 256。键模式：`^[A-Za-z_]+$` 数组成员：最多 50 项。长度限制：最大长度为 150。模式：`[A-Za-z_][A-Za-z\d_]*` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWSSDKs，请参阅以下内容： + [AWS适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/TrainingDataConfig) + [AWS适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/TrainingDataConfig) + [AWS适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/TrainingDataConfig) # TunedHPOParams 如果执行了超参数优化 (HPO)，则包含性能最佳模型的超参数值。 ## 目录 ** algorithmHyperParameters ** 性能最佳模型的超参数值列表。类型：字符串到字符串映射映射条目：最多 100 项。键长度限制：最大长度为 256。值长度限制：最大长度为 1000。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/TunedHPOParams) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/TunedHPOParams) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/TunedHPOParams) # Amazon Personalize Events Amazon Personalize Events 支持以下数据类型： + [Action](API_UBS_Action.md) + [ActionInteraction](API_UBS_ActionInteraction.md) + [Event](API_UBS_Event.md) + [Item](API_UBS_Item.md) + [MetricAttribution](API_UBS_MetricAttribution.md) + [User](API_UBS_User.md) # Action 表示使用 `PutActions` API 添加到操作数据集的操作元数据。有关更多信息，请参阅[单独导入操作](https://docs.aws.amazon.com/personalize/latest/dg/importing-actions.html)。 ## 目录 ** actionId ** 与操作关联的 ID。类型：字符串长度限制：最小长度为 1。最大长度为 256。必需：是 ** properties ** 操作特定的元数据的字符串映射。映射中的每个元素都由一个键值对组成。例如 `{"value": "100"}`。键使用与操作数据集架构中的字段匹配的采用驼峰式大小写的名称。在前面的示例中，`value` 与在操作架构中定义的“VALUE”字段相匹配。对于分类字符串数据，要包含单个操作的多个类别，请使用竖线分隔符 (`|`) 分隔每个类别。例如 `\"Deluxe|Premium\"`。类型：字符串长度限制：最小长度为 1。最大长度为 32000。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/Action) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/Action) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/Action) # ActionInteraction 表示使用 `PutActionInteractions` API 发送的操作交互事件。 ## 目录 ** actionId ** 用户与其交互的操作的 ID。这与操作交互架构的 `ACTION_ID` 字段相对应。类型：字符串长度限制：最小长度为 1。最大长度为 256。必需：是 ** eventType ** 操作交互事件的类型。您可以指定 `Viewed`、`Taken` 和 `Not Taken` 事件类型。有关操作交互事件类型数据的更多信息，请参阅[事件类型数据](https://docs.aws.amazon.com/personalize/latest/dg/action-interaction-event-type-data.html)。类型：字符串长度限制：最小长度为 1。最大长度为 256。必需：是 ** sessionId ** 与用户的访问关联的 ID。当用户首次访问您的网站或使用您的应用程序时，您的应用程序会生成唯一 `sessionId`。类型：字符串长度限制：最小长度为 1。最大长度为 256。必需：是 ** timestamp ** 操作交互事件发生时的时间戳。时间戳必须采用 Unix 纪元时间格式，以秒为单位。类型：时间戳必需：是 ** eventId ** 与事件关联的 ID。如果未提供事件 ID，则 Amazon Personalize 会为事件生成一个唯一的 ID。事件 ID 不用作模型的输入。Amazon Personalize 使用事件 ID 来区分唯一事件。模型训练中不使用第一个事件之后具有相同事件 ID 的任何后续事件。类型：字符串长度限制：最小长度为 1。最大长度为 256。必需：否 ** impression ** 操作 ID 列表，表示您已向用户展示的操作的顺序。例如 `["actionId1", "actionId2", "actionId3"]`。Amazon Personalize 不使用来自操作交互事件的展示数据。而是为每个操作记录多个事件并使用 `Viewed` 事件类型。类型：字符串数组数组成员：最少 1 个物品。最多 25 项。长度限制：最小长度为 1。最大长度为 256。必需：否 ** properties ** 您可以选择记录的事件特定数据的字符串映射。例如，如果用户采取了除操作 ID 以外的操作，您可能还会发送该用户采取的操作数量。映射中的每个物品都由一个键值对组成。例如， `{"numberOfActions": "12"}` 键使用与操作交互架构中的字段匹配的采用驼峰式大小写的名称。在上面的示例中，`numberOfActions` 将匹配在操作交互架构中定义的“NUMBER\$1OF\$1ACTIONS”字段。以下内容不能作为属性的关键字包括在内（不区分大小写）。 + userId + sessionId + eventType + timestamp + recommendationId + impression 类型：字符串长度限制：长度下限为 1。最大长度为 1024。必需：否 ** recommendationId ** 包含用户与之交互的操作的建议列表的 ID。类型：字符串长度限制：长度下限为 1。最大长度为 40。必需：否 ** userId ** 与操作交互的用户的 ID。这与操作交互架构的 `USER_ID` 字段相对应。类型：字符串长度限制：最小长度为 1。最大长度为 256。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/ActionInteraction) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/ActionInteraction) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/ActionInteraction) # Event 表示使用 `PutEvents` API 发送的物品交互事件信息。 ## 目录 ** eventType ** 事件的类型，例如单击或下载。此属性对应于物品交互数据集架构的 `EVENT_TYPE` 字段，并取决于您要跟踪的事件类型。类型：字符串长度限制：最小长度为 1。最大长度为 256。必需：是 ** sentAt ** 事件发生时客户端的时间戳（采用 Unix 时间）。类型：时间戳必需：是 ** eventId ** 与事件关联的 ID。如果未提供事件 ID，则 Amazon Personalize 会为事件生成一个唯一的 ID。事件 ID 不用作模型的输入。Amazon Personalize 使用事件 ID 来区分唯一事件。模型训练中不使用第一个事件之后具有相同事件 ID 的任何后续事件。类型：字符串长度限制：最小长度为 1。最大长度为 256。必需：否 ** eventValue ** 与物品交互架构的 `EVENT_VALUE` 字段对应的事件值。类型：浮点值必需：否 ** impression ** 物品 ID 列表，代表您向用户展示的物品顺序。例如 `["itemId1", "itemId2", "itemId3"]`。提供物品列表以手动记录事件的展示数据。有关记录展示数据的更多信息，请参阅[记录展示数据](https://docs.aws.amazon.com/personalize/latest/dg/recording-events.html#putevents-including-impressions-data)。类型：字符串数组数组成员：最少 1 个物品。最多 25 项。长度限制：最小长度为 1。最大长度为 256。必需：否 ** itemId ** 与物品交互数据集的架构中的 `ITEM_ID` 字段对应的物品 ID 键。类型：字符串长度限制：最小长度为 1。最大长度为 256。必需：否 ** metricAttribution ** 包含与事件关联的指标归因的相关信息。有关指标归因的更多信息，请参阅[衡量建议的影响](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)。类型：[MetricAttribution](API_UBS_MetricAttribution.md) 对象必需：否 ** properties ** 您可以选择记录的事件特定数据的字符串映射。例如，如果用户在您的网站上对电影进行评分，则除了电影 ID (`itemId`) 和评分 (`eventValue`) 外，您还可以发送该用户对电影做出的评分数量。映射中的每个物品都由一个键值对组成。例如， `{"numberOfRatings": "12"}` 键使用与物品交互数据集架构中的字段匹配的采用驼峰式大小写的名称。在上面的示例中，`numberOfRatings` 将匹配在物品交互数据集的架构中定义的“NUMBER\$1OF\$1RATINGS”字段。以下内容不能作为属性的关键字包括在内（不区分大小写）。 + userId + sessionId + eventType + timestamp + recommendationId + impression 类型：字符串长度限制：长度下限为 1。最大长度为 1024。必需：否 ** recommendationId ** 包含用户与之交互的物品的建议列表的 ID。提供 `recommendationId`，让 Amazon Personalize 隐式记录您向用户展示的建议作为展示数据。或者，在您使用指标归因来衡量建议的影响时，提供 `recommendationId`。有关记录展示数据的更多信息，请参阅[记录展示数据](https://docs.aws.amazon.com/personalize/latest/dg/recording-events.html#putevents-including-impressions-data)。有关创建指标归因的更多信息，请参阅[衡量建议的影响](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)。类型：字符串长度限制：长度下限为 1。最大长度为 40。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/Event) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/Event) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/Event) # Item 表示使用 `PutItems` API 添加到物品数据集的物品元数据。有关更多信息，请参阅[单独导入物品](https://docs.aws.amazon.com/personalize/latest/dg/importing-items.html)。 ## 目录 ** itemId ** 与物品关联的 ID。类型：字符串长度限制：最小长度为 1。最大长度为 256。必需：是 ** properties ** 特定于物品的元数据的字符串映射。映射中的每个元素都由一个键值对组成。例如 `{"numberOfRatings": "12"}`。键使用与物品数据集架构中的字段匹配的采用驼峰式大小写的名称。在前面的示例中，`numberOfRatings` 将匹配物品架构中定义的“NUMBER\$1OF\$1RATINGS”字段。对于分类字符串数据，要包含单个物品的多个类别，请使用竖线分隔符 (`|`) 分隔每个类别。例如 `\"Horror|Action\"`。类型：字符串长度限制：最小长度为 1。最大长度为 32000。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/Item) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/Item) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/Item) # MetricAttribution 包含与事件关联的指标归因的相关信息。有关指标归因的更多信息，请参阅[衡量建议的影响](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)。 ## 目录 ** eventAttributionSource ** 事件的源，例如第三方。类型：字符串长度限制：最大长度为 1024。模式：`^[\x20-\x7E]*[\x21-\x7E]+[\x20-\x7E]*$` 必需：是 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/MetricAttribution) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/MetricAttribution) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/MetricAttribution) # User 表示使用 `PutUsers` API 添加到用户数据集的用户元数据。有关更多信息，请参阅[单独导入用户](https://docs.aws.amazon.com/personalize/latest/dg/importing-users.html)。 ## 目录 ** userId ** 与用户关联的 ID。类型：字符串长度限制：最小长度为 1。最大长度为 256。必需：是 ** properties ** 用户特定元数据的字符串映射。映射中的每个元素都由一个键值对组成。例如 `{"numberOfVideosWatched": "45"}`。键使用与用户数据集架构中的字段匹配的采用驼峰式大小写的名称。在前面的示例中，`numberOfVideosWatched` 将匹配用户架构中定义的“NUMBER\$1OF\$1VIDEOS\$1WATCHED”字段。对于分类字符串数据，要包含单个用户的多个类别，请使用竖线分隔符 (`|`) 分隔每个类别。例如 `\"Member|Frequent shopper\"`。类型：字符串长度限制：长度下限为 1。最大长度为 24000。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/User) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/User) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/User) # Amazon Personalize Runtime Amazon Personalize Runtime 支持以下数据类型： + [PredictedAction](API_RS_PredictedAction.md) + [PredictedItem](API_RS_PredictedItem.md) + [Promotion](API_RS_Promotion.md) # PredictedAction 标识操作的对象。 [GetActionRecommendations](API_RS_GetActionRecommendations.md) API 返回 `PredictedAction` 的列表。 ## 目录 ** actionId ** 建议操作的 ID。类型：字符串长度约束：最大长度为 256。必需：否 ** score ** 建议操作的分数。有关操作分数的信息，请参阅[操作建议评分的工作原理](https://docs.aws.amazon.com/personalize/latest/dg/how-action-recommendation-scoring-works.html)。类型：双精度必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/PredictedAction) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/PredictedAction) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/PredictedAction) # PredictedItem 标识物品的对象。 [GetRecommendations](API_RS_GetRecommendations.md) 和 [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) API 会返回 `PredictedItem` 的列表。 ## 目录 ** itemId ** 推荐的物品 ID。类型：字符串长度约束：最大长度为 256。必需：否 ** metadata ** 有关物品数据集中的物品的元数据。类型：字符串到字符串映射键长度限制：最大长度为 150。值长度限制：最大长度为 20000。必需：否 ** promotionName ** 包含预测物品的推广名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** reason ** 如果您使用 User-Personalization-v2，则会有一份理由清单，说明为什么在推荐中包括该物品。可能的原因包括： + 推广物品 - 表示您在推荐请求中应用的推广活动中包括该物品。 + 浏览 - 表示该物品包括在浏览中。使用浏览时，推荐包括的物品具有更少的交互数据或用户相关性。有关浏览的更多信息，请参阅[浏览](https://docs.aws.amazon.com/personalize/latest/dg/use-case-recipe-features.html#about-exploration)。 + 热门物品 - 表示该物品作为占位符热门物品包括在内。如果您使用筛选条件，那么根据筛选条件删除的推荐数量，Amazon Personalize 可能会添加占位符物品以满足推荐请求的 `numResults`。这些物品是基于交互数据的热门物品，符合您的筛选条件。它们没有针对用户的相关性评分。类型：字符串数组长度约束：最大长度为 256。必需：否 ** score ** 模型对物品将成为下一个用户选择的确定性的数字表示。有关评分逻辑的更多信息，请参阅[建议分数](getting-recommendations.md#how-scores-work)。类型：双精度必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/PredictedItem) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/PredictedItem) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/PredictedItem) # Promotion 包含有关推广的信息。推广定义了其他业务规则，这些规则适用于可配置的建议物品子集。 ## 目录 ** filterArn ** 推广使用的筛选器的 Amazon 资源名称 (ARN)。此筛选器定义了推广物品的标准。有关更多信息，请参阅[推广筛选器](https://docs.aws.amazon.com/personalize/latest/dg/promoting-items.html#promotion-filters)。类型：字符串长度约束：最大长度为 256。模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 必需：否 ** filterValues ** 推广物品时要使用的值。对于推广的筛选器表达式中的每个占位符参数，提供参数名称（大小写相符）作为键，提供筛选器值作为对应的值。用英文逗号分隔一个参数的多个值。对于使用 `INCLUDE` 元素来包含物品的筛选器表达式，您必须为表达式中定义的所有参数提供值。对于带有使用 `EXCLUDE` 元素排除物品的表达式的筛选器，您可以省略 `filter-values`。在本例中，Amazon Personalize 未使用表达式的这一部分来筛选建议。有关创建筛选器的更多信息，请参阅[筛选建议和用户细分](https://docs.aws.amazon.com/personalize/latest/dg/filter.html)。类型：字符串到字符串映射映射条目：最多 25 项。键长度限制：最大长度为 50。键模式：`[A-Za-z0-9_]+` 值长度限制：最大长度为 1000。必需：否 ** name ** 推广的名称。类型：字符串长度限制：最小长度为 1。最大长度为 63。模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 必需：否 ** percentPromotedItems ** 要应用推广的推荐物品所占的百分比。类型：整数有效范围：最小值为 1。最大值为 100。必需：否 ## 另请参阅有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容： + [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/Promotion) + [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/Promotion) + [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/Promotion)