本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 資料類型
<a name="API_Types"></a>

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 執行期支援下列資料類型：
+  [PredictedAction](API_RS_PredictedAction.md) 
+  [PredictedItem](API_RS_PredictedItem.md) 
+  [Promotion](API_RS_Promotion.md) 

# Amazon Personalize
<a name="API_Types_Amazon_Personalize"></a>

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
<a name="API_Algorithm"></a>

描述自訂演算法。

## 目錄
<a name="API_Algorithm_Contents"></a>

 ** algorithmArn **   <a name="personalize-Type-Algorithm-algorithmArn"></a>
演算法的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** algorithmImage **   <a name="personalize-Type-Algorithm-algorithmImage"></a>
演算法映像的 Docker 容器 URI。  
類型：[AlgorithmImage](API_AlgorithmImage.md) 物件  
必要：否

 ** creationDateTime **   <a name="personalize-Type-Algorithm-creationDateTime"></a>
演算法建立的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** defaultHyperParameterRanges **   <a name="personalize-Type-Algorithm-defaultHyperParameterRanges"></a>
指定預設超參數、其範圍，以及它們是否可調校。可調整的超參數可以在超參數最佳化 (HPO) 期間決定其值。  
類型：[DefaultHyperParameterRanges](API_DefaultHyperParameterRanges.md) 物件  
必要：否

 ** defaultHyperParameters **   <a name="personalize-Type-Algorithm-defaultHyperParameters"></a>
指定預設超參數。  
類型：字串到字串映射  
映射項目：最多 100 個項目。  
金鑰長度限制：長度上限為 256。  
值長度限制：長度上限為 1000。  
必要：否

 ** defaultResourceConfig **   <a name="personalize-Type-Algorithm-defaultResourceConfig"></a>
指定訓練任務和平行訓練任務的預設最大數量。  
類型：字串到字串映射  
映射項目：最多 100 個項目。  
金鑰長度限制：長度上限為 256。  
值長度限制：長度上限為 1000。  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-Algorithm-lastUpdatedDateTime"></a>
演算法上次更新的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** name **   <a name="personalize-Type-Algorithm-name"></a>
演算法的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** roleArn **   <a name="personalize-Type-Algorithm-roleArn"></a>
角色的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** trainingInputMode **   <a name="personalize-Type-Algorithm-trainingInputMode"></a>
訓練輸入模式。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_Algorithm_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Algorithm) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Algorithm) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Algorithm) 

# AlgorithmImage
<a name="API_AlgorithmImage"></a>

描述演算法映像。

## 目錄
<a name="API_AlgorithmImage_Contents"></a>

 ** dockerURI **   <a name="personalize-Type-AlgorithmImage-dockerURI"></a>
演算法映像的 Docker 容器 URI。  
類型：字串  
長度限制：長度上限為 256。  
必要：是

 ** name **   <a name="personalize-Type-AlgorithmImage-name"></a>
演算法映像的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

## 另請參閱
<a name="API_AlgorithmImage_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AlgorithmImage) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AlgorithmImage) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AlgorithmImage) 

# AutoMLConfig
<a name="API_AutoMLConfig"></a>

解決方案執行 AutoML (`performAutoML` 在 [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 中為 true) 時，Amazon Personalize 會從指定清單中決定哪個配方最佳化指定的指標。Amazon Personalize 接著會針對解決方案使用該配方。

## 目錄
<a name="API_AutoMLConfig_Contents"></a>

 ** metricName **   <a name="personalize-Type-AutoMLConfig-metricName"></a>
要最佳化的指標。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** recipeList **   <a name="personalize-Type-AutoMLConfig-recipeList"></a>
候選配方清單。  
類型：字串陣列  
陣列成員：最多 100 個項目。  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

## 另請參閱
<a name="API_AutoMLConfig_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AutoMLConfig) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AutoMLConfig) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AutoMLConfig) 

# AutoMLResult
<a name="API_AutoMLResult"></a>

當解決方案執行 AutoML (`performAutoML`在 [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 中為 true) 時， 會指定最佳最佳化指定指標的配方。

## 目錄
<a name="API_AutoMLResult_Contents"></a>

 ** bestRecipeArn **   <a name="personalize-Type-AutoMLResult-bestRecipeArn"></a>
最佳配方的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

## 另請參閱
<a name="API_AutoMLResult_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AutoMLResult) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AutoMLResult) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AutoMLResult) 

# AutoTrainingConfig
<a name="API_AutoTrainingConfig"></a>

當 `performAutoTraining` 為 true 時要使用的自動訓練組態。

## 目錄
<a name="API_AutoTrainingConfig_Contents"></a>

 ** schedulingExpression **   <a name="personalize-Type-AutoTrainingConfig-schedulingExpression"></a>
指定自動訓練新解決方案版本的頻率。以 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?\)`  
必要：否

## 另請參閱
<a name="API_AutoTrainingConfig_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AutoTrainingConfig) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AutoTrainingConfig) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AutoTrainingConfig) 

# BatchInferenceJob
<a name="API_BatchInferenceJob"></a>

包含批次推論任務的相關資訊。

## 目錄
<a name="API_BatchInferenceJob_Contents"></a>

 ** batchInferenceJobArn **   <a name="personalize-Type-BatchInferenceJob-batchInferenceJobArn"></a>
批次推論任務的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** batchInferenceJobConfig **   <a name="personalize-Type-BatchInferenceJob-batchInferenceJobConfig"></a>
批次推論任務組態詳細資訊的字串對字串映射。  
類型：[BatchInferenceJobConfig](API_BatchInferenceJobConfig.md) 物件  
必要：否

 ** batchInferenceJobMode **   <a name="personalize-Type-BatchInferenceJob-batchInferenceJobMode"></a>
任務的模式。  
類型：字串  
有效值:`BATCH_INFERENCE | THEME_GENERATION`   
必要：否

 ** creationDateTime **   <a name="personalize-Type-BatchInferenceJob-creationDateTime"></a>
建立批次推論任務的時間。  
類型：Timestamp  
必要：否

 ** failureReason **   <a name="personalize-Type-BatchInferenceJob-failureReason"></a>
如果批次推論任務失敗，則為失敗原因。  
類型：字串  
必要：否

 ** filterArn **   <a name="personalize-Type-BatchInferenceJob-filterArn"></a>
用於批次推論任務之篩選條件的 ARN。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** jobInput **   <a name="personalize-Type-BatchInferenceJob-jobInput"></a>
導致用於產生批次推論任務的輸入資料的 Amazon S3 路徑。  
類型：[BatchInferenceJobInput](API_BatchInferenceJobInput.md) 物件  
必要：否

 ** jobName **   <a name="personalize-Type-BatchInferenceJob-jobName"></a>
批次推論任務的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** jobOutput **   <a name="personalize-Type-BatchInferenceJob-jobOutput"></a>
Amazon S3 儲存貯體，其中包含批次推論任務產生的輸出資料。  
類型：[BatchInferenceJobOutput](API_BatchInferenceJobOutput.md) 物件  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-BatchInferenceJob-lastUpdatedDateTime"></a>
批次推論任務上次更新的時間。  
類型：Timestamp  
必要：否

 ** numResults **   <a name="personalize-Type-BatchInferenceJob-numResults"></a>
批次推論任務產生的建議數目。此數字包含針對失敗的輸入記錄產生的錯誤訊息。  
類型：整數  
必要：否

 ** roleArn **   <a name="personalize-Type-BatchInferenceJob-roleArn"></a>
請求批次推論任務的 Amazon Identity and Access Management (IAM) 角色 ARN。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`  
必要：否

 ** solutionVersionArn **   <a name="personalize-Type-BatchInferenceJob-solutionVersionArn"></a>
建立批次推論任務之解決方案版本的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** status **   <a name="personalize-Type-BatchInferenceJob-status"></a>
批次推論任務的狀態。狀態是下列其中一個值：  
+ 待定
+ 進行中
+ ACTIVE
+ 建立失敗
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** themeGenerationConfig **   <a name="personalize-Type-BatchInferenceJob-themeGenerationConfig"></a>
任務的主題產生設定。  
類型：[ThemeGenerationConfig](API_ThemeGenerationConfig.md) 物件  
必要：否

## 另請參閱
<a name="API_BatchInferenceJob_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJob) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJob) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJob) 

# BatchInferenceJobConfig
<a name="API_BatchInferenceJobConfig"></a>

批次推論任務的組態詳細資訊。

## 目錄
<a name="API_BatchInferenceJobConfig_Contents"></a>

 ** itemExplorationConfig **   <a name="personalize-Type-BatchInferenceJobConfig-itemExplorationConfig"></a>
字串對字串映射，指定探勘組態超參數，包括 `explorationWeight`和 `explorationItemAgeCutOff`，您想要用來設定 Amazon Personalize 在建議項目時使用的項目探勘量。請參閱[使用者個人化](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html)。  
類型：字串到字串映射  
映射項目：最多 100 個項目。  
金鑰長度限制：長度上限為 256。  
值長度限制：長度上限為 1000。  
必要：否

 ** rankingInfluence **   <a name="personalize-Type-BatchInferenceJobConfig-rankingInfluence"></a>
POPULARITY 和 FRESHNESS 的排名影響值映射。針對每個索引鍵，指定介於 0.0 和 1.0 之間的數值，以決定排名因素對最終建議的影響程度。接近 1.0 的值提供更多的權重給係數，而接近 0.0 的值則降低其影響。如果未指定，則兩者都預設為 0.0。  
類型：String 到 double 映射  
有效金鑰：`POPULARITY | FRESHNESS`  
有效範圍：最小值為 0。最大值為 1。  
必要：否

## 另請參閱
<a name="API_BatchInferenceJobConfig_SeeAlso"></a>

如需在其中一種語言特定 AWSSDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobConfig) 
+  [AWS適用於 Java V2 的 SDK](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
<a name="API_BatchInferenceJobInput"></a>

批次推論任務的輸入組態。

## 目錄
<a name="API_BatchInferenceJobInput_Contents"></a>

 ** s3DataSource **   <a name="personalize-Type-BatchInferenceJobInput-s3DataSource"></a>
包含您輸入資料的 Amazon S3 位置的 URI。Amazon S3 儲存貯體必須與您呼叫的 API 端點位於相同的區域。  
類型：[S3DataConfig](API_S3DataConfig.md) 物件  
必要：是

## 另請參閱
<a name="API_BatchInferenceJobInput_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobInput) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobInput) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobInput) 

# BatchInferenceJobOutput
<a name="API_BatchInferenceJobOutput"></a>

批次推論任務的輸出組態參數。

## 目錄
<a name="API_BatchInferenceJobOutput_Contents"></a>

 ** s3DataDestination **   <a name="personalize-Type-BatchInferenceJobOutput-s3DataDestination"></a>
儲存批次推論任務輸出的 Amazon S3 儲存貯體資訊。  
類型：[S3DataConfig](API_S3DataConfig.md) 物件  
必要：是

## 另請參閱
<a name="API_BatchInferenceJobOutput_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobOutput) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobOutput) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobOutput) 

# BatchInferenceJobSummary
<a name="API_BatchInferenceJobSummary"></a>

[BatchInferenceJob](https://docs.aws.amazon.com/personalize/latest/dg/API_BatchInferenceJob.html) 的截斷版本。[ListBatchInferenceJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListBatchInferenceJobs.html) 操作會傳回批次推論任務摘要的清單。

## 目錄
<a name="API_BatchInferenceJobSummary_Contents"></a>

 ** batchInferenceJobArn **   <a name="personalize-Type-BatchInferenceJobSummary-batchInferenceJobArn"></a>
批次推論任務的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** batchInferenceJobMode **   <a name="personalize-Type-BatchInferenceJobSummary-batchInferenceJobMode"></a>
任務的 模式。  
類型：字串  
有效值:`BATCH_INFERENCE | THEME_GENERATION`   
必要：否

 ** creationDateTime **   <a name="personalize-Type-BatchInferenceJobSummary-creationDateTime"></a>
建立批次推論任務的時間。  
類型：Timestamp  
必要：否

 ** failureReason **   <a name="personalize-Type-BatchInferenceJobSummary-failureReason"></a>
如果批次推論任務失敗，則為失敗原因。  
類型：字串  
必要：否

 ** jobName **   <a name="personalize-Type-BatchInferenceJobSummary-jobName"></a>
批次推論任務的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-BatchInferenceJobSummary-lastUpdatedDateTime"></a>
批次推論任務上次更新的時間。  
類型：Timestamp  
必要：否

 ** solutionVersionArn **   <a name="personalize-Type-BatchInferenceJobSummary-solutionVersionArn"></a>
批次推論任務所使用的解決方案版本的 ARN。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** status **   <a name="personalize-Type-BatchInferenceJobSummary-status"></a>
批次推論任務的狀態。狀態是下列其中一個值：  
+ 待定
+ 進行中
+ ACTIVE
+ 建立失敗
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_BatchInferenceJobSummary_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobSummary) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobSummary) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobSummary) 

# BatchSegmentJob
<a name="API_BatchSegmentJob"></a>

包含批次區段任務的相關資訊。

## 目錄
<a name="API_BatchSegmentJob_Contents"></a>

 ** batchSegmentJobArn **   <a name="personalize-Type-BatchSegmentJob-batchSegmentJobArn"></a>
批次區段任務的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** creationDateTime **   <a name="personalize-Type-BatchSegmentJob-creationDateTime"></a>
建立批次區段任務的時間。  
類型：Timestamp  
必要：否

 ** failureReason **   <a name="personalize-Type-BatchSegmentJob-failureReason"></a>
如果批次區段任務失敗，則為失敗原因。  
類型：字串  
必要：否

 ** filterArn **   <a name="personalize-Type-BatchSegmentJob-filterArn"></a>
用於批次區段任務之篩選條件的 ARN。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** jobInput **   <a name="personalize-Type-BatchSegmentJob-jobInput"></a>
導致用於產生批次區段任務的輸入資料的 Amazon S3 路徑。  
類型：[BatchSegmentJobInput](API_BatchSegmentJobInput.md) 物件  
必要：否

 ** jobName **   <a name="personalize-Type-BatchSegmentJob-jobName"></a>
批次區段任務的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** jobOutput **   <a name="personalize-Type-BatchSegmentJob-jobOutput"></a>
Amazon S3 儲存貯體，其中包含批次區段任務產生的輸出資料。  
類型：[BatchSegmentJobOutput](API_BatchSegmentJobOutput.md) 物件  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-BatchSegmentJob-lastUpdatedDateTime"></a>
批次區段任務上次更新的時間。  
類型：Timestamp  
必要：否

 ** numResults **   <a name="personalize-Type-BatchSegmentJob-numResults"></a>
批次區段任務針對每一行輸入資料產生的預測使用者數目。每個客群的使用者數量上限為 500 萬。  
類型：整數  
必要：否

 ** roleArn **   <a name="personalize-Type-BatchSegmentJob-roleArn"></a>
請求批次區段任務的 Amazon Identity and Access Management (IAM) 角色的 ARN。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`  
必要：否

 ** solutionVersionArn **   <a name="personalize-Type-BatchSegmentJob-solutionVersionArn"></a>
批次區段任務用來產生批次區段之解決方案版本的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** status **   <a name="personalize-Type-BatchSegmentJob-status"></a>
批次區段任務的狀態。狀態是下列其中一個值：  
+ 待定
+ 進行中
+ ACTIVE
+ 建立失敗
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_BatchSegmentJob_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJob) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJob) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJob) 

# BatchSegmentJobInput
<a name="API_BatchSegmentJobInput"></a>

批次區段任務的輸入組態。

## 目錄
<a name="API_BatchSegmentJobInput_Contents"></a>

 ** s3DataSource **   <a name="personalize-Type-BatchSegmentJobInput-s3DataSource"></a>
Amazon S3 輸入或輸出儲存貯體的組態詳細資訊。  
類型：[S3DataConfig](API_S3DataConfig.md) 物件  
必要：是

## 另請參閱
<a name="API_BatchSegmentJobInput_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJobInput) 
+  [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJobInput) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJobInput) 

# BatchSegmentJobOutput
<a name="API_BatchSegmentJobOutput"></a>

批次區段任務的輸出組態參數。

## 目錄
<a name="API_BatchSegmentJobOutput_Contents"></a>

 ** s3DataDestination **   <a name="personalize-Type-BatchSegmentJobOutput-s3DataDestination"></a>
Amazon S3 輸入或輸出儲存貯體的組態詳細資訊。  
類型：[S3DataConfig](API_S3DataConfig.md) 物件  
必要：是

## 另請參閱
<a name="API_BatchSegmentJobOutput_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJobOutput) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJobOutput) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJobOutput) 

# BatchSegmentJobSummary
<a name="API_BatchSegmentJobSummary"></a>

[BatchSegmentJob](https://docs.aws.amazon.com/personalize/latest/dg/API_BatchSegmentJob.html) 資料類型的截斷版本。[ListBatchSegmentJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListBatchSegmentJobs.html) 操作會傳回批次區段任務摘要的清單。

## 目錄
<a name="API_BatchSegmentJobSummary_Contents"></a>

 ** batchSegmentJobArn **   <a name="personalize-Type-BatchSegmentJobSummary-batchSegmentJobArn"></a>
批次區段任務的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** creationDateTime **   <a name="personalize-Type-BatchSegmentJobSummary-creationDateTime"></a>
建立批次區段任務的時間。  
類型：Timestamp  
必要：否

 ** failureReason **   <a name="personalize-Type-BatchSegmentJobSummary-failureReason"></a>
如果批次區段任務失敗，則為失敗原因。  
類型：字串  
必要：否

 ** jobName **   <a name="personalize-Type-BatchSegmentJobSummary-jobName"></a>
批次區段任務的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-BatchSegmentJobSummary-lastUpdatedDateTime"></a>
批次區段任務上次更新的時間。  
類型：Timestamp  
必要：否

 ** solutionVersionArn **   <a name="personalize-Type-BatchSegmentJobSummary-solutionVersionArn"></a>
批次區段任務用來產生批次區段之解決方案版本的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** status **   <a name="personalize-Type-BatchSegmentJobSummary-status"></a>
批次區段任務的狀態。狀態是下列其中一個值：  
+ 待定
+ 進行中
+ ACTIVE
+ 建立失敗
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_BatchSegmentJobSummary_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJobSummary) 
+  [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJobSummary) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJobSummary) 

# Campaign
<a name="API_Campaign"></a>

描述解決方案版本部署的物件。如需行銷活動的詳細資訊，請參閱 [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html)。

## 目錄
<a name="API_Campaign_Contents"></a>

 ** campaignArn **   <a name="personalize-Type-Campaign-campaignArn"></a>
行銷活動的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** campaignConfig **   <a name="personalize-Type-Campaign-campaignConfig"></a>
行銷活動的組態詳細資訊。  
類型：[CampaignConfig](API_CampaignConfig.md) 物件  
必要：否

 ** creationDateTime **   <a name="personalize-Type-Campaign-creationDateTime"></a>
行銷活動建立的日期和時間 (Unix 格式）。  
類型：Timestamp  
必要：否

 ** failureReason **   <a name="personalize-Type-Campaign-failureReason"></a>
如果行銷活動失敗，則為失敗背後的原因。  
類型：字串  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-Campaign-lastUpdatedDateTime"></a>
行銷活動上次更新的日期和時間 (Unix 格式）。  
類型：Timestamp  
必要：否

 ** latestCampaignUpdate **   <a name="personalize-Type-Campaign-latestCampaignUpdate"></a>
提供行銷活動更新的屬性摘要。如需完整清單，請呼叫 [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) API。  
只有當行銷活動至少有一個`UpdateCampaign`呼叫時，才會傳回 `latestCampaignUpdate` 欄位。
類型：[CampaignUpdateSummary](API_CampaignUpdateSummary.md) 物件  
必要：否

 ** minProvisionedTPS **   <a name="personalize-Type-Campaign-minProvisionedTPS"></a>
指定每秒請求的最低佈建交易 （建議）。較高的 `minProvisionedTPS`會增加您的帳單。我們建議從 1 開始 `minProvisionedTPS`（預設值）。使用 Amazon CloudWatch 指標追蹤您的用量，並視需要增加 `minProvisionedTPS`。  
類型：整數  
有效範圍：最小值為 1。  
必要：否

 ** name **   <a name="personalize-Type-Campaign-name"></a>
行銷活動的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** solutionVersionArn **   <a name="personalize-Type-Campaign-solutionVersionArn"></a>
行銷活動使用的解決方案版本的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** status **   <a name="personalize-Type-Campaign-status"></a>
行銷活動的狀態。  
行銷活動可以處於下列其中一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_Campaign_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Campaign) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Campaign) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Campaign) 

# CampaignConfig
<a name="API_CampaignConfig"></a>

行銷活動的組態詳細資訊。

## 目錄
<a name="API_CampaignConfig_Contents"></a>

 ** enableMetadataWithRecommendations **   <a name="personalize-Type-CampaignConfig-enableMetadataWithRecommendations"></a>
是否針對行銷活動啟用具有建議的中繼資料。如果啟用，您可以在建議請求中指定項目資料集中的資料欄。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 **   <a name="personalize-Type-CampaignConfig-itemExplorationConfig"></a>
指定探勘組態超參數，包括 `explorationWeight`和 `explorationItemAgeCutOff`，您想要用來設定 Amazon Personalize 在建議項目時使用的項目探勘量。只有當您的解決方案使用[使用者個人化](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html)配方時，才提供`itemExplorationConfig`資料。  
類型：字串到字串映射  
映射項目：最多 100 個項目。  
金鑰長度限制：長度上限為 256。  
值長度限制：長度上限為 1000。  
必要：否

 ** rankingInfluence **   <a name="personalize-Type-CampaignConfig-rankingInfluence"></a>
POPULARITY 和 FRESHNESS 的排名影響值映射。針對每個索引鍵，指定介於 0.0 和 1.0 之間的數值，以決定排名因素對最終建議的影響程度。接近 1.0 的值提供更多的權重給係數，而接近 0.0 的值則降低其影響。如果未指定，則兩者都預設為 0.0。  
類型：String 到 double 映射  
有效金鑰：`POPULARITY | FRESHNESS`  
有效範圍：最小值為 0。最大值為 1。  
必要：否

 ** syncWithLatestSolutionVersion **   <a name="personalize-Type-CampaignConfig-syncWithLatestSolutionVersion"></a>
行銷活動是否自動更新以使用解決方案的最新解決方案版本 （訓練模型）。如果您指定 `True`，則必須為 `SolutionVersionArn` 參數指定*解決方案*的 ARN。它必須是 `SolutionArn/$LATEST` 格式。預設值為 `False`，您必須手動更新行銷活動以部署最新的解決方案版本。  
 如需自動行銷活動更新的詳細資訊，請參閱[啟用自動行銷活動更新](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update)。  
類型：布林值  
必要：否

## 另請參閱
<a name="API_CampaignConfig_SeeAlso"></a>

如需在其中一種語言特定 AWSSDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CampaignConfig) 
+  [AWS適用於 Java V2 的 SDK](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
<a name="API_CampaignSummary"></a>

提供行銷活動屬性的摘要。如需完整清單，請呼叫 [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) API。

## 目錄
<a name="API_CampaignSummary_Contents"></a>

 ** campaignArn **   <a name="personalize-Type-CampaignSummary-campaignArn"></a>
行銷活動的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** creationDateTime **   <a name="personalize-Type-CampaignSummary-creationDateTime"></a>
行銷活動建立的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** failureReason **   <a name="personalize-Type-CampaignSummary-failureReason"></a>
如果行銷活動失敗，則為失敗背後的原因。  
類型：字串  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-CampaignSummary-lastUpdatedDateTime"></a>
行銷活動上次更新的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** name **   <a name="personalize-Type-CampaignSummary-name"></a>
行銷活動的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** status **   <a name="personalize-Type-CampaignSummary-status"></a>
行銷活動的狀態。  
行銷活動可以處於下列其中一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_CampaignSummary_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CampaignSummary) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CampaignSummary) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CampaignSummary) 

# CampaignUpdateSummary
<a name="API_CampaignUpdateSummary"></a>

提供行銷活動更新的屬性摘要。如需完整清單，請呼叫 [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) API。

## 目錄
<a name="API_CampaignUpdateSummary_Contents"></a>

 ** campaignConfig **   <a name="personalize-Type-CampaignUpdateSummary-campaignConfig"></a>
行銷活動的組態詳細資訊。  
類型：[CampaignConfig](API_CampaignConfig.md) 物件  
必要：否

 ** creationDateTime **   <a name="personalize-Type-CampaignUpdateSummary-creationDateTime"></a>
建立行銷活動更新的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** failureReason **   <a name="personalize-Type-CampaignUpdateSummary-failureReason"></a>
如果行銷活動更新失敗，則為失敗背後的原因。  
類型：字串  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-CampaignUpdateSummary-lastUpdatedDateTime"></a>
行銷活動更新上次更新的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** minProvisionedTPS **   <a name="personalize-Type-CampaignUpdateSummary-minProvisionedTPS"></a>
指定 Amazon Personalize 將支援的每秒請求的最低佈建交易 （建議）。  
類型：整數  
有效範圍：最小值為 1。  
必要：否

 ** solutionVersionArn **   <a name="personalize-Type-CampaignUpdateSummary-solutionVersionArn"></a>
部署解決方案版本的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** status **   <a name="personalize-Type-CampaignUpdateSummary-status"></a>
行銷活動更新的狀態。  
行銷活動更新可以處於下列其中一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_CampaignUpdateSummary_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CampaignUpdateSummary) 
+  [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CampaignUpdateSummary) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CampaignUpdateSummary) 

# CategoricalHyperParameterRange
<a name="API_CategoricalHyperParameterRange"></a>

提供分類超參數的名稱和範圍。

## 目錄
<a name="API_CategoricalHyperParameterRange_Contents"></a>

 ** name **   <a name="personalize-Type-CategoricalHyperParameterRange-name"></a>
超參數的名稱。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** values **   <a name="personalize-Type-CategoricalHyperParameterRange-values"></a>
超參數分類的清單。  
類型：字串陣列  
陣列成員：最多 100 個項目。  
長度限制：長度上限為 1000。  
必要：否

## 另請參閱
<a name="API_CategoricalHyperParameterRange_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CategoricalHyperParameterRange) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CategoricalHyperParameterRange) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CategoricalHyperParameterRange) 

# ContinuousHyperParameterRange
<a name="API_ContinuousHyperParameterRange"></a>

提供連續超參數的名稱和範圍。

## 目錄
<a name="API_ContinuousHyperParameterRange_Contents"></a>

 ** maxValue **   <a name="personalize-Type-ContinuousHyperParameterRange-maxValue"></a>
超參數的最大允許值。  
類型：Double  
有效範圍：最小值為 -1000000。  
必要：否

 ** minValue **   <a name="personalize-Type-ContinuousHyperParameterRange-minValue"></a>
超參數的最小允許值。  
類型：Double  
有效範圍：最小值為 -1000000。  
必要：否

 ** name **   <a name="personalize-Type-ContinuousHyperParameterRange-name"></a>
超參數的名稱。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_ContinuousHyperParameterRange_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ContinuousHyperParameterRange) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ContinuousHyperParameterRange) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ContinuousHyperParameterRange) 

# DataDeletionJob
<a name="API_DataDeletionJob"></a>

描述任務，該任務會批次從 Amazon Personalize 資料集群組中刪除對特定使用者的所有參考。如需建立資料刪除任務的詳細資訊，請參閱[刪除使用者](https://docs.aws.amazon.com/personalize/latest/dg/delete-records.html)。

## 目錄
<a name="API_DataDeletionJob_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DataDeletionJob-creationDateTime"></a>
資料刪除任務的建立日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** dataDeletionJobArn **   <a name="personalize-Type-DataDeletionJob-dataDeletionJobArn"></a>
資料刪除任務的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** datasetGroupArn **   <a name="personalize-Type-DataDeletionJob-datasetGroupArn"></a>
任務從中刪除記錄之資料集群組的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** dataSource **   <a name="personalize-Type-DataDeletionJob-dataSource"></a>
描述包含要上傳至資料集之資料的資料來源，或從 Amazon Personalize 刪除的記錄清單。  
類型：[DataSource](API_DataSource.md) 物件  
必要：否

 ** failureReason **   <a name="personalize-Type-DataDeletionJob-failureReason"></a>
如果資料刪除任務失敗， 會提供原因。  
類型：字串  
必要：否

 ** jobName **   <a name="personalize-Type-DataDeletionJob-jobName"></a>
資料刪除任務的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-DataDeletionJob-lastUpdatedDateTime"></a>
上次更新資料刪除任務的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** numDeleted **   <a name="personalize-Type-DataDeletionJob-numDeleted"></a>
COMPLETED 任務刪除的記錄數目。  
類型：整數  
必要：否

 ** roleArn **   <a name="personalize-Type-DataDeletionJob-roleArn"></a>
具有從 Amazon S3 資料來源讀取許可之 IAM 角色的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`  
必要：否

 ** status **   <a name="personalize-Type-DataDeletionJob-status"></a>
資料刪除任務的狀態。  
資料刪除任務可以有下列其中一種狀態：  
+ 待定 > IN\$1PROGRESS > COMPLETED -or- FAILED
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_DataDeletionJob_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DataDeletionJob) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DataDeletionJob) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DataDeletionJob) 

# DataDeletionJobSummary
<a name="API_DataDeletionJobSummary"></a>

提供資料刪除任務屬性的摘要。如需完整清單，請呼叫 [DescribeDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataDeletionJob.html) API 操作。

## 目錄
<a name="API_DataDeletionJobSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DataDeletionJobSummary-creationDateTime"></a>
資料刪除任務的建立日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** dataDeletionJobArn **   <a name="personalize-Type-DataDeletionJobSummary-dataDeletionJobArn"></a>
資料刪除任務的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** datasetGroupArn **   <a name="personalize-Type-DataDeletionJobSummary-datasetGroupArn"></a>
任務從中刪除記錄之資料集群組的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** failureReason **   <a name="personalize-Type-DataDeletionJobSummary-failureReason"></a>
如果資料刪除任務失敗， 會提供原因。  
類型：字串  
必要：否

 ** jobName **   <a name="personalize-Type-DataDeletionJobSummary-jobName"></a>
資料刪除任務的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-DataDeletionJobSummary-lastUpdatedDateTime"></a>
上次更新資料刪除任務的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** status **   <a name="personalize-Type-DataDeletionJobSummary-status"></a>
資料刪除任務的狀態。  
資料刪除任務可以具有下列其中一種狀態：  
+ 待定 > IN\$1PROGRESS > COMPLETED -or- FAILED
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_DataDeletionJobSummary_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DataDeletionJobSummary) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DataDeletionJobSummary) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DataDeletionJobSummary) 

# Dataset
<a name="API_Dataset"></a>

提供資料集的中繼資料。

## 目錄
<a name="API_Dataset_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-Dataset-creationDateTime"></a>
資料集的建立日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** datasetArn **   <a name="personalize-Type-Dataset-datasetArn"></a>
您要用於中繼資料之資料集的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** datasetGroupArn **   <a name="personalize-Type-Dataset-datasetGroupArn"></a>
資料集群組的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** datasetType **   <a name="personalize-Type-Dataset-datasetType"></a>
下列其中一值：  
+ 互動
+ 項目
+ 使用者
+ 動作
+ Action\$1Interactions
類型：字串  
長度限制：長度上限為 256。  
模式：`^[A-Za-z_]+$`  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-Dataset-lastUpdatedDateTime"></a>
顯示資料集更新時間的時間戳記。  
類型：Timestamp  
必要：否

 ** latestDatasetUpdate **   <a name="personalize-Type-Dataset-latestDatasetUpdate"></a>
描述資料集的最新更新。  
類型：[DatasetUpdateSummary](API_DatasetUpdateSummary.md) 物件  
必要：否

 ** name **   <a name="personalize-Type-Dataset-name"></a>
資料集的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** schemaArn **   <a name="personalize-Type-Dataset-schemaArn"></a>
相關聯結構描述的 ARN。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** status **   <a name="personalize-Type-Dataset-status"></a>
資料集的狀態。  
資料集可為下列任一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** trackingId **   <a name="personalize-Type-Dataset-trackingId"></a>
動作互動資料集的事件追蹤器 ID。您可以在 `PutActionInteractions` API 操作中指定追蹤器的 ID。Amazon Personalize 會使用它，將新資料導向至資料集群組中的動作互動資料集。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_Dataset_SeeAlso"></a>

如需在其中一種語言特定 AWSSDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Dataset) 
+  [AWS適用於 Java V2 的 SDK](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
<a name="API_DatasetExportJob"></a>

描述將資料集匯出至 Amazon S3 儲存貯體的任務。如需詳細資訊，請參閱 [CreateDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html)。

資料集匯出任務可以處於下列其中一種狀態：
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED

## 目錄
<a name="API_DatasetExportJob_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetExportJob-creationDateTime"></a>
資料集匯出任務的建立日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** datasetArn **   <a name="personalize-Type-DatasetExportJob-datasetArn"></a>
要匯出之資料集的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** datasetExportJobArn **   <a name="personalize-Type-DatasetExportJob-datasetExportJobArn"></a>
資料集匯出任務的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** failureReason **   <a name="personalize-Type-DatasetExportJob-failureReason"></a>
如果資料集匯出任務失敗， 會提供原因。  
類型：字串  
必要：否

 ** ingestionMode **   <a name="personalize-Type-DatasetExportJob-ingestionMode"></a>
根據您匯入資料的方式，要匯出的資料。您可以選擇匯出使用資料集`BULK`匯入任務匯入的資料、增量匯入`PUT`的資料 （使用主控台、PutEvents、PutUsers 和 PutItems 操作），或`ALL`兩種類型的資料。預設值為 `PUT`。  
類型：字串  
有效值:`BULK | PUT | ALL`   
必要：否

 ** jobName **   <a name="personalize-Type-DatasetExportJob-jobName"></a>
匯出任務的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** jobOutput **   <a name="personalize-Type-DatasetExportJob-jobOutput"></a>
存放任務輸出的 Amazon S3 儲存貯體路徑。例如：  
 `s3://bucket-name/folder-name/`   
類型：[DatasetExportJobOutput](API_DatasetExportJobOutput.md) 物件  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetExportJob-lastUpdatedDateTime"></a>
資料集匯出任務的狀態上次更新的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** roleArn **   <a name="personalize-Type-DatasetExportJob-roleArn"></a>
IAM 服務角色的 Amazon Resource Name (ARN)，其具有將資料新增至輸出 Amazon S3 儲存貯體的許可。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** status **   <a name="personalize-Type-DatasetExportJob-status"></a>
資料集匯出任務的狀態。  
資料集匯出任務可以處於下列其中一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_DatasetExportJob_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetExportJob) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetExportJob) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetExportJob) 

# DatasetExportJobOutput
<a name="API_DatasetExportJobOutput"></a>

資料集匯出任務的輸出組態參數。

## 目錄
<a name="API_DatasetExportJobOutput_Contents"></a>

 ** s3DataDestination **   <a name="personalize-Type-DatasetExportJobOutput-s3DataDestination"></a>
Amazon S3 輸入或輸出儲存貯體的組態詳細資訊。  
類型：[S3DataConfig](API_S3DataConfig.md) 物件  
必要：是

## 另請參閱
<a name="API_DatasetExportJobOutput_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetExportJobOutput) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetExportJobOutput) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetExportJobOutput) 

# DatasetExportJobSummary
<a name="API_DatasetExportJobSummary"></a>

提供資料集匯出任務屬性的摘要。如需完整清單，請呼叫 [DescribeDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html) API。

## 目錄
<a name="API_DatasetExportJobSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetExportJobSummary-creationDateTime"></a>
資料集匯出任務建立的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** datasetExportJobArn **   <a name="personalize-Type-DatasetExportJobSummary-datasetExportJobArn"></a>
資料集匯出任務的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** failureReason **   <a name="personalize-Type-DatasetExportJobSummary-failureReason"></a>
如果資料集匯出任務失敗，則為失敗背後的原因。  
類型：字串  
必要：否

 ** jobName **   <a name="personalize-Type-DatasetExportJobSummary-jobName"></a>
資料集匯出任務的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetExportJobSummary-lastUpdatedDateTime"></a>
資料集匯出任務狀態上次更新的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** status **   <a name="personalize-Type-DatasetExportJobSummary-status"></a>
資料集匯出任務的狀態。  
資料集匯出任務可以處於下列其中一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_DatasetExportJobSummary_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetExportJobSummary) 
+  [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetExportJobSummary) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetExportJobSummary) 

# DatasetGroup
<a name="API_DatasetGroup"></a>

資料集群組是相關資料集的集合 （項目互動、使用者、項目、動作、動作互動）。您可以透過呼叫 [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) 金鑰來加密 群組中的資料集。

## 目錄
<a name="API_DatasetGroup_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetGroup-creationDateTime"></a>
資料集群組的建立日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** datasetGroupArn **   <a name="personalize-Type-DatasetGroup-datasetGroupArn"></a>
資料集群組的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** domain **   <a name="personalize-Type-DatasetGroup-domain"></a>
網域資料集群組的網域。  
類型：字串  
有效值:`ECOMMERCE | VIDEO_ON_DEMAND`   
必要：否

 ** failureReason **   <a name="personalize-Type-DatasetGroup-failureReason"></a>
如果建立資料集群組失敗， 會提供原因。  
類型：字串  
必要：否

 ** kmsKeyArn **   <a name="personalize-Type-DatasetGroup-kmsKeyArn"></a>
用來加密資料集之 (KMS) 金鑰的 Amazon Resource Name AWS Key Management Service (ARN)。  
類型：字串  
長度限制：長度上限為 2048。  
模式：`arn:aws.*:kms:.*:[0-9]{12}:key/.*`  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetGroup-lastUpdatedDateTime"></a>
資料集群組的上次更新日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** name **   <a name="personalize-Type-DatasetGroup-name"></a>
資料集群組的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** roleArn **   <a name="personalize-Type-DatasetGroup-roleArn"></a>
具有存取 AWS Identity and Access Management (KMS) 金鑰許可之 AWS Key Management Service (IAM) 角色的 ARN。只有在同時指定 KMS 金鑰時，提供 IAM 角色才有效。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`  
必要：否

 ** status **   <a name="personalize-Type-DatasetGroup-status"></a>
資料集群組的目前狀態。  
資料集群組可以處於下列其中一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
+ 刪除擱置中
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_DatasetGroup_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetGroup) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetGroup) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetGroup) 

# DatasetGroupSummary
<a name="API_DatasetGroupSummary"></a>

提供資料集群組屬性的摘要。如需完整清單，請呼叫 [DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html) API。

## 目錄
<a name="API_DatasetGroupSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetGroupSummary-creationDateTime"></a>
建立資料集群組的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** datasetGroupArn **   <a name="personalize-Type-DatasetGroupSummary-datasetGroupArn"></a>
資料集群組的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** domain **   <a name="personalize-Type-DatasetGroupSummary-domain"></a>
網域資料集群組的網域。  
類型：字串  
有效值:`ECOMMERCE | VIDEO_ON_DEMAND`   
必要：否

 ** failureReason **   <a name="personalize-Type-DatasetGroupSummary-failureReason"></a>
如果建立資料集群組失敗，則失敗背後的原因。  
類型：字串  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetGroupSummary-lastUpdatedDateTime"></a>
資料集群組上次更新的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** name **   <a name="personalize-Type-DatasetGroupSummary-name"></a>
資料集群組的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** status **   <a name="personalize-Type-DatasetGroupSummary-status"></a>
資料集群組的狀態。  
資料集群組可以處於下列其中一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
+ 刪除擱置中
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_DatasetGroupSummary_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetGroupSummary) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetGroupSummary) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetGroupSummary) 

# DatasetImportJob
<a name="API_DatasetImportJob"></a>

描述將訓練資料從資料來源 (Amazon S3 儲存貯體) 匯入 Amazon Personalize 資料集的任務。如需詳細資訊，請參閱 [CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html)。

資料集匯入任務可處於下列任意一種狀態：
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED

## 目錄
<a name="API_DatasetImportJob_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetImportJob-creationDateTime"></a>
資料集匯入任務的建立日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** datasetArn **   <a name="personalize-Type-DatasetImportJob-datasetArn"></a>
接收匯入資料之資料集的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** datasetImportJobArn **   <a name="personalize-Type-DatasetImportJob-datasetImportJobArn"></a>
資料集匯入任務的 ARN。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** dataSource **   <a name="personalize-Type-DatasetImportJob-dataSource"></a>
此為 Amazon S3 儲存貯體，其中包含要匯入的訓練資料。  
類型：[DataSource](API_DataSource.md) 物件  
必要：否

 ** failureReason **   <a name="personalize-Type-DatasetImportJob-failureReason"></a>
如果資料集匯入任務失敗， 會提供原因。  
類型：字串  
必要：否

 ** importMode **   <a name="personalize-Type-DatasetImportJob-importMode"></a>
資料集匯入任務用來匯入新記錄的匯入模式。  
類型：字串  
有效值:`FULL | INCREMENTAL`   
必要：否

 ** jobName **   <a name="personalize-Type-DatasetImportJob-jobName"></a>
匯入任務的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetImportJob-lastUpdatedDateTime"></a>
上次更新資料集的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** publishAttributionMetricsToS3 **   <a name="personalize-Type-DatasetImportJob-publishAttributionMetricsToS3"></a>
任務是否針對指標屬性將指標發佈至 Amazon S3。  
類型：布林值  
必要：否

 ** roleArn **   <a name="personalize-Type-DatasetImportJob-roleArn"></a>
此為 IAM 角色的 ARN，該角色具有從 Amazon S3 資料來源讀取資料的許可。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** status **   <a name="personalize-Type-DatasetImportJob-status"></a>
資料集匯入任務的狀態。  
資料集匯入任務可處於下列任意一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_DatasetImportJob_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetImportJob) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetImportJob) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetImportJob) 

# DatasetImportJobSummary
<a name="API_DatasetImportJobSummary"></a>

提供資料集匯入任務屬性的摘要。如需完整清單，請呼叫 [DescribeDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html) API。

## 目錄
<a name="API_DatasetImportJobSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetImportJobSummary-creationDateTime"></a>
資料集匯入任務建立的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** datasetImportJobArn **   <a name="personalize-Type-DatasetImportJobSummary-datasetImportJobArn"></a>
資料集匯入任務的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** failureReason **   <a name="personalize-Type-DatasetImportJobSummary-failureReason"></a>
如果資料集匯入任務失敗，則為失敗背後的原因。  
類型：字串  
必要：否

 ** importMode **   <a name="personalize-Type-DatasetImportJobSummary-importMode"></a>
用於更新資料集中資料的資料集匯入任務的匯入模式。如需詳細資訊，請參閱[更新現有的大量資料](https://docs.aws.amazon.com/personalize/latest/dg/updating-existing-bulk-data.html)。  
類型：字串  
有效值:`FULL | INCREMENTAL`   
必要：否

 ** jobName **   <a name="personalize-Type-DatasetImportJobSummary-jobName"></a>
資料集匯入任務的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetImportJobSummary-lastUpdatedDateTime"></a>
資料集匯入任務狀態上次更新的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** status **   <a name="personalize-Type-DatasetImportJobSummary-status"></a>
資料集匯入任務的狀態。  
資料集匯入任務可處於下列任意一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_DatasetImportJobSummary_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetImportJobSummary) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetImportJobSummary) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetImportJobSummary) 

# DatasetSchema
<a name="API_DatasetSchema"></a>

描述資料集的結構描述。如需結構描述的詳細資訊，請參閱 [CreateSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html)。

## 目錄
<a name="API_DatasetSchema_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetSchema-creationDateTime"></a>
建立結構描述的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** domain **   <a name="personalize-Type-DatasetSchema-domain"></a>
您為網域資料集群組中的資料集所建立的結構描述網域。  
類型：字串  
有效值:`ECOMMERCE | VIDEO_ON_DEMAND`   
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetSchema-lastUpdatedDateTime"></a>
上次更新結構描述的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** name **   <a name="personalize-Type-DatasetSchema-name"></a>
結構描述的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** schema **   <a name="personalize-Type-DatasetSchema-schema"></a>
結構描述。  
類型：字串  
長度限制：長度上限為 20000。  
必要：否

 ** schemaArn **   <a name="personalize-Type-DatasetSchema-schemaArn"></a>
結構描述的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

## 另請參閱
<a name="API_DatasetSchema_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetSchema) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetSchema) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetSchema) 

# DatasetSchemaSummary
<a name="API_DatasetSchemaSummary"></a>

提供資料集結構描述屬性的摘要。如需完整清單，請呼叫 [DescribeSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSchema.html) API。

## 目錄
<a name="API_DatasetSchemaSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetSchemaSummary-creationDateTime"></a>
建立結構描述的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** domain **   <a name="personalize-Type-DatasetSchemaSummary-domain"></a>
您為網域資料集群組中的資料集所建立的結構描述網域。  
類型：字串  
有效值:`ECOMMERCE | VIDEO_ON_DEMAND`   
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetSchemaSummary-lastUpdatedDateTime"></a>
上次更新結構描述的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** name **   <a name="personalize-Type-DatasetSchemaSummary-name"></a>
結構描述的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** schemaArn **   <a name="personalize-Type-DatasetSchemaSummary-schemaArn"></a>
結構描述的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

## 另請參閱
<a name="API_DatasetSchemaSummary_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetSchemaSummary) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetSchemaSummary) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetSchemaSummary) 

# DatasetSummary
<a name="API_DatasetSummary"></a>

提供資料集屬性的摘要。如需完整清單，請呼叫 [DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html) API。

## 目錄
<a name="API_DatasetSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetSummary-creationDateTime"></a>
建立資料集的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** datasetArn **   <a name="personalize-Type-DatasetSummary-datasetArn"></a>
資料集的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** datasetType **   <a name="personalize-Type-DatasetSummary-datasetType"></a>
資料集類型。下列其中一值：  
+ 互動
+ 項目
+ 使用者
+ 事件互動
類型：字串  
長度限制：長度上限為 256。  
模式：`^[A-Za-z_]+$`  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetSummary-lastUpdatedDateTime"></a>
上次更新資料集的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** name **   <a name="personalize-Type-DatasetSummary-name"></a>
資料集的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** status **   <a name="personalize-Type-DatasetSummary-status"></a>
資料集的狀態。  
資料集可為下列任一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_DatasetSummary_SeeAlso"></a>

如需在其中一種語言特定 AWSSDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetSummary) 
+  [AWS適用於 Java V2 的 SDK](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
<a name="API_DatasetUpdateSummary"></a>

描述資料集的更新。

## 目錄
<a name="API_DatasetUpdateSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetUpdateSummary-creationDateTime"></a>
資料集更新的建立日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** failureReason **   <a name="personalize-Type-DatasetUpdateSummary-failureReason"></a>
如果更新資料集失敗， 會提供原因。  
類型：字串  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetUpdateSummary-lastUpdatedDateTime"></a>
資料集的上次更新日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** schemaArn **   <a name="personalize-Type-DatasetUpdateSummary-schemaArn"></a>
取代資料集先前結構描述之結構描述的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** status **   <a name="personalize-Type-DatasetUpdateSummary-status"></a>
資料集更新的狀態。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_DatasetUpdateSummary_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetUpdateSummary) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetUpdateSummary) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetUpdateSummary) 

# DataSource
<a name="API_DataSource"></a>

描述包含要上傳至資料集之資料的資料來源，或從 Amazon Personalize 刪除的記錄清單。

## 目錄
<a name="API_DataSource_Contents"></a>

 ** dataLocation **   <a name="personalize-Type-DataSource-dataLocation"></a>
對於資料集匯入任務，儲存您要上傳至資料集之資料的 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)://.+`  
必要：否

## 另請參閱
<a name="API_DataSource_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DataSource) 
+  [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DataSource) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DataSource) 

# DefaultCategoricalHyperParameterRange
<a name="API_DefaultCategoricalHyperParameterRange"></a>

提供分類超參數的名稱和預設範圍，以及超參數是否可調校。可調整的超參數可以在超參數最佳化 (HPO) 期間決定其值。

## 目錄
<a name="API_DefaultCategoricalHyperParameterRange_Contents"></a>

 ** isTunable **   <a name="personalize-Type-DefaultCategoricalHyperParameterRange-isTunable"></a>
超參數是否可調校。  
類型：布林值  
必要：否

 ** name **   <a name="personalize-Type-DefaultCategoricalHyperParameterRange-name"></a>
超參數的名稱。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** values **   <a name="personalize-Type-DefaultCategoricalHyperParameterRange-values"></a>
超參數分類的清單。  
類型：字串陣列  
陣列成員：最多 100 個項目。  
長度限制：長度上限為 1000。  
必要：否

## 另請參閱
<a name="API_DefaultCategoricalHyperParameterRange_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultCategoricalHyperParameterRange) 
+  [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultCategoricalHyperParameterRange) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultCategoricalHyperParameterRange) 

# DefaultContinuousHyperParameterRange
<a name="API_DefaultContinuousHyperParameterRange"></a>

提供連續超參數的名稱和預設範圍，以及超參數是否可調校。可調整的超參數可以在超參數最佳化 (HPO) 期間決定其值。

## 目錄
<a name="API_DefaultContinuousHyperParameterRange_Contents"></a>

 ** isTunable **   <a name="personalize-Type-DefaultContinuousHyperParameterRange-isTunable"></a>
超參數是否可調校。  
類型：布林值  
必要：否

 ** maxValue **   <a name="personalize-Type-DefaultContinuousHyperParameterRange-maxValue"></a>
超參數的最大允許值。  
類型：Double  
有效範圍：最小值為 -1000000。  
必要：否

 ** minValue **   <a name="personalize-Type-DefaultContinuousHyperParameterRange-minValue"></a>
超參數的最小允許值。  
類型：Double  
有效範圍：最小值為 -1000000。  
必要：否

 ** name **   <a name="personalize-Type-DefaultContinuousHyperParameterRange-name"></a>
超參數的名稱。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_DefaultContinuousHyperParameterRange_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultContinuousHyperParameterRange) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultContinuousHyperParameterRange) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultContinuousHyperParameterRange) 

# DefaultHyperParameterRanges
<a name="API_DefaultHyperParameterRanges"></a>

指定超參數及其預設範圍。超參數可以是分類、持續或整數值。

## 目錄
<a name="API_DefaultHyperParameterRanges_Contents"></a>

 ** categoricalHyperParameterRanges **   <a name="personalize-Type-DefaultHyperParameterRanges-categoricalHyperParameterRanges"></a>
分類超參數及其預設範圍。  
類型：[DefaultCategoricalHyperParameterRange](API_DefaultCategoricalHyperParameterRange.md) 物件陣列  
陣列成員：最多 100 個項目。  
必要：否

 ** continuousHyperParameterRanges **   <a name="personalize-Type-DefaultHyperParameterRanges-continuousHyperParameterRanges"></a>
連續超參數及其預設範圍。  
類型：[DefaultContinuousHyperParameterRange](API_DefaultContinuousHyperParameterRange.md) 物件陣列  
陣列成員：最多 100 個項目。  
必要：否

 ** integerHyperParameterRanges **   <a name="personalize-Type-DefaultHyperParameterRanges-integerHyperParameterRanges"></a>
整數值的超參數及其預設範圍。  
類型：[DefaultIntegerHyperParameterRange](API_DefaultIntegerHyperParameterRange.md) 物件陣列  
陣列成員：最多 100 個項目。  
必要：否

## 另請參閱
<a name="API_DefaultHyperParameterRanges_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultHyperParameterRanges) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultHyperParameterRanges) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultHyperParameterRanges) 

# DefaultIntegerHyperParameterRange
<a name="API_DefaultIntegerHyperParameterRange"></a>

提供整數值超參數的名稱和預設範圍，以及超參數是否可調校。可調整的超參數可以在超參數最佳化 (HPO) 期間決定其值。

## 目錄
<a name="API_DefaultIntegerHyperParameterRange_Contents"></a>

 ** isTunable **   <a name="personalize-Type-DefaultIntegerHyperParameterRange-isTunable"></a>
指出超參數是否可調校。  
類型：布林值  
必要：否

 ** maxValue **   <a name="personalize-Type-DefaultIntegerHyperParameterRange-maxValue"></a>
超參數的最大允許值。  
類型：整數  
有效範圍：最大值為 1000000。  
必要：否

 ** minValue **   <a name="personalize-Type-DefaultIntegerHyperParameterRange-minValue"></a>
超參數的最小允許值。  
類型：整數  
有效範圍：最小值為 -1000000。  
必要：否

 ** name **   <a name="personalize-Type-DefaultIntegerHyperParameterRange-name"></a>
超參數的名稱。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_DefaultIntegerHyperParameterRange_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultIntegerHyperParameterRange) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultIntegerHyperParameterRange) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultIntegerHyperParameterRange) 

# EventParameters
<a name="API_EventParameters"></a>

描述用於建立解決方案的事件參數。

## 目錄
<a name="API_EventParameters_Contents"></a>

 ** eventType **   <a name="personalize-Type-EventParameters-eventType"></a>
要考慮建立解決方案的事件類型名稱。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** eventValueThreshold **   <a name="personalize-Type-EventParameters-eventValueThreshold"></a>
事件類型的閾值。只有值大於或等於此閾值的事件才會考慮建立解決方案。  
類型：Double  
必要：否

 ** weight **   <a name="personalize-Type-EventParameters-weight"></a>
事件類型的權重。權重越高，表示所建立解決方案的事件類型就越重要。  
類型：Double  
有效範圍：最小值為 0。最大值為 1。  
必要：否

## 另請參閱
<a name="API_EventParameters_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventParameters) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventParameters) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventParameters) 

# EventsConfig
<a name="API_EventsConfig"></a>

描述用於建立解決方案的事件組態。

## 目錄
<a name="API_EventsConfig_Contents"></a>

 ** eventParametersList **   <a name="personalize-Type-EventsConfig-eventParametersList"></a>
事件參數清單，其中包含事件類型及其事件值閾值和權重。  
類型：[EventParameters](API_EventParameters.md) 物件陣列  
陣列成員：最多 10 個項目。  
必要：否

## 另請參閱
<a name="API_EventsConfig_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventsConfig) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventsConfig) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventsConfig) 

# EventTracker
<a name="API_EventTracker"></a>

提供事件追蹤器的相關資訊。

## 目錄
<a name="API_EventTracker_Contents"></a>

 ** accountId **   <a name="personalize-Type-EventTracker-accountId"></a>
擁有事件追蹤器 AWS 的帳戶。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** creationDateTime **   <a name="personalize-Type-EventTracker-creationDateTime"></a>
建立事件追蹤器的日期和時間 (Unix 格式）。  
類型：Timestamp  
必要：否

 ** datasetGroupArn **   <a name="personalize-Type-EventTracker-datasetGroupArn"></a>
接收事件資料的資料集群組的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** eventTrackerArn **   <a name="personalize-Type-EventTracker-eventTrackerArn"></a>
事件追蹤器的 ARN。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-EventTracker-lastUpdatedDateTime"></a>
事件追蹤器上次更新的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** name **   <a name="personalize-Type-EventTracker-name"></a>
事件追蹤器的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** status **   <a name="personalize-Type-EventTracker-status"></a>
事件追蹤器的狀態。  
事件追蹤器可以處於下列其中一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** trackingId **   <a name="personalize-Type-EventTracker-trackingId"></a>
事件追蹤器的 ID。在對 [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html) API 的請求中包含此 ID。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_EventTracker_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventTracker) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventTracker) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventTracker) 

# EventTrackerSummary
<a name="API_EventTrackerSummary"></a>

提供事件追蹤器屬性的摘要。如需完整清單，請呼叫 [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html) API。

## 目錄
<a name="API_EventTrackerSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-EventTrackerSummary-creationDateTime"></a>
建立事件追蹤器的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** eventTrackerArn **   <a name="personalize-Type-EventTrackerSummary-eventTrackerArn"></a>
事件追蹤器的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-EventTrackerSummary-lastUpdatedDateTime"></a>
事件追蹤器上次更新的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** name **   <a name="personalize-Type-EventTrackerSummary-name"></a>
事件追蹤器的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** status **   <a name="personalize-Type-EventTrackerSummary-status"></a>
事件追蹤器的狀態。  
事件追蹤器可以處於下列其中一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_EventTrackerSummary_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventTrackerSummary) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventTrackerSummary) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventTrackerSummary) 

# FeatureTransformation
<a name="API_FeatureTransformation"></a>

提供功能轉換資訊。特徵轉換是將原始輸入資料修改為更適合於模型培訓之形式的過程。

## 目錄
<a name="API_FeatureTransformation_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-FeatureTransformation-creationDateTime"></a>
功能轉換的建立日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** defaultParameters **   <a name="personalize-Type-FeatureTransformation-defaultParameters"></a>
提供功能轉換的預設參數。  
類型：字串到字串映射  
映射項目：最多 100 個項目。  
金鑰長度限制：長度上限為 256。  
值長度限制：長度上限為 1000。  
必要：否

 ** featureTransformationArn **   <a name="personalize-Type-FeatureTransformation-featureTransformationArn"></a>
FeatureTransformation 物件的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-FeatureTransformation-lastUpdatedDateTime"></a>
特徵轉換的上次更新日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** name **   <a name="personalize-Type-FeatureTransformation-name"></a>
功能轉換的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** status **   <a name="personalize-Type-FeatureTransformation-status"></a>
功能轉換的狀態。  
功能轉換可以處於下列其中一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_FeatureTransformation_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/FeatureTransformation) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/FeatureTransformation) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/FeatureTransformation) 

# FieldsForThemeGeneration
<a name="API_FieldsForThemeGeneration"></a>

主題產生之組態詳細資訊的字串對字串映射。

## 目錄
<a name="API_FieldsForThemeGeneration_Contents"></a>

 ** itemName **   <a name="personalize-Type-FieldsForThemeGeneration-itemName"></a>
項目資料集資料欄的名稱，用於在資料集中存放每個項目的名稱。  
類型：字串  
長度限制：長度上限為 150。  
模式：`[A-Za-z_][A-Za-z\d_]*`  
必要：是

## 另請參閱
<a name="API_FieldsForThemeGeneration_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/FieldsForThemeGeneration) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/FieldsForThemeGeneration) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/FieldsForThemeGeneration) 

# Filter
<a name="API_Filter"></a>

包含建議篩選條件的相關資訊，包括其 ARN、狀態和篩選條件表達式。

## 目錄
<a name="API_Filter_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-Filter-creationDateTime"></a>
建立篩選條件的時間。  
類型：Timestamp  
必要：否

 ** datasetGroupArn **   <a name="personalize-Type-Filter-datasetGroupArn"></a>
篩選條件所屬之資料集群組的 ARN。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** failureReason **   <a name="personalize-Type-Filter-failureReason"></a>
如果篩選條件失敗，其失敗的原因。  
類型：字串  
必要：否

 ** filterArn **   <a name="personalize-Type-Filter-filterArn"></a>
篩選條件的 ARN。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** filterExpression **   <a name="personalize-Type-Filter-filterExpression"></a>
指定要篩選掉建議結果的項目互動類型。篩選條件表達式必須遵循特定格式規則。如需篩選條件表達式結構和語法的資訊，請參閱[篩選條件表達](https://docs.aws.amazon.com/personalize/latest/dg/filter-expressions.html)式。  
類型：字串  
長度限制：長度下限為 1。長度上限為 2500。  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-Filter-lastUpdatedDateTime"></a>
上次更新篩選條件的時間。  
類型：Timestamp  
必要：否

 ** name **   <a name="personalize-Type-Filter-name"></a>
篩選條件的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** status **   <a name="personalize-Type-Filter-status"></a>
篩選條件的狀態。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_Filter_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Filter) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Filter) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Filter) 

# FilterSummary
<a name="API_FilterSummary"></a>

篩選條件屬性的簡短摘要。

## 目錄
<a name="API_FilterSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-FilterSummary-creationDateTime"></a>
建立篩選條件的時間。  
類型：Timestamp  
必要：否

 ** datasetGroupArn **   <a name="personalize-Type-FilterSummary-datasetGroupArn"></a>
篩選條件所屬之資料集群組的 ARN。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** failureReason **   <a name="personalize-Type-FilterSummary-failureReason"></a>
如果篩選條件失敗，則表示失敗的原因。  
類型：字串  
必要：否

 ** filterArn **   <a name="personalize-Type-FilterSummary-filterArn"></a>
篩選條件的 ARN。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-FilterSummary-lastUpdatedDateTime"></a>
上次更新篩選條件的時間。  
類型：Timestamp  
必要：否

 ** name **   <a name="personalize-Type-FilterSummary-name"></a>
篩選條件的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** status **   <a name="personalize-Type-FilterSummary-status"></a>
篩選條件的狀態。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_FilterSummary_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/FilterSummary) 
+  [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/FilterSummary) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/FilterSummary) 

# HPOConfig
<a name="API_HPOConfig"></a>

描述超參數優化 (HPO) 的屬性。

## 目錄
<a name="API_HPOConfig_Contents"></a>

 ** algorithmHyperParameterRanges **   <a name="personalize-Type-HPOConfig-algorithmHyperParameterRanges"></a>
超參數及其允許的範圍。  
類型：[HyperParameterRanges](API_HyperParameterRanges.md) 物件  
必要：否

 ** hpoObjective **   <a name="personalize-Type-HPOConfig-hpoObjective"></a>
HPO 期間要最佳化的指標。  
Amazon Personalize 目前不支援設定 `hpoObjective`。
類型：[HPOObjective](API_HPOObjective.md) 物件  
必要：否

 ** hpoResourceConfig **   <a name="personalize-Type-HPOConfig-hpoResourceConfig"></a>
描述 HPO 的資源組態。  
類型：[HPOResourceConfig](API_HPOResourceConfig.md) 物件  
必要：否

## 另請參閱
<a name="API_HPOConfig_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HPOConfig) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HPOConfig) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HPOConfig) 

# HPOObjective
<a name="API_HPOObjective"></a>

超參數最佳化 (HPO) 期間要最佳化的指標。

**注意**  
Amazon Personalize 目前不支援設定 `hpoObjective`。

## 目錄
<a name="API_HPOObjective_Contents"></a>

 ** metricName **   <a name="personalize-Type-HPOObjective-metricName"></a>
指標的名稱  
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** metricRegex **   <a name="personalize-Type-HPOObjective-metricRegex"></a>
在訓練任務日誌中尋找指標的規則表達式。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** type **   <a name="personalize-Type-HPOObjective-type"></a>
指標的類型。有效值為 `Maximize` 和 `Minimize`。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_HPOObjective_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HPOObjective) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HPOObjective) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HPOObjective) 

# HPOResourceConfig
<a name="API_HPOResourceConfig"></a>

描述超參數最佳化 (HPO) 的資源組態。

## 目錄
<a name="API_HPOResourceConfig_Contents"></a>

 ** maxNumberOfTrainingJobs **   <a name="personalize-Type-HPOResourceConfig-maxNumberOfTrainingJobs"></a>
建立解決方案版本時的訓練任務數量上限。`maxNumberOfTrainingJobs` 的最大值為 `40`。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** maxParallelTrainingJobs **   <a name="personalize-Type-HPOResourceConfig-maxParallelTrainingJobs"></a>
建立解決方案版本時的平行訓練任務數量上限。`maxParallelTrainingJobs` 的最大值為 `10`。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_HPOResourceConfig_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HPOResourceConfig) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HPOResourceConfig) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HPOResourceConfig) 

# HyperParameterRanges
<a name="API_HyperParameterRanges"></a>

指定超參數及其範圍。超參數可以是分類、持續或整數值。

## 目錄
<a name="API_HyperParameterRanges_Contents"></a>

 ** categoricalHyperParameterRanges **   <a name="personalize-Type-HyperParameterRanges-categoricalHyperParameterRanges"></a>
分類超參數及其範圍。  
類型：[CategoricalHyperParameterRange](API_CategoricalHyperParameterRange.md) 物件陣列  
陣列成員：最多 100 個項目。  
必要：否

 ** continuousHyperParameterRanges **   <a name="personalize-Type-HyperParameterRanges-continuousHyperParameterRanges"></a>
連續超參數及其範圍。  
類型：[ContinuousHyperParameterRange](API_ContinuousHyperParameterRange.md) 物件陣列  
陣列成員：最多 100 個項目。  
必要：否

 ** integerHyperParameterRanges **   <a name="personalize-Type-HyperParameterRanges-integerHyperParameterRanges"></a>
整數值的超參數及其範圍。  
類型：[IntegerHyperParameterRange](API_IntegerHyperParameterRange.md) 物件陣列  
陣列成員：最多 100 個項目。  
必要：否

## 另請參閱
<a name="API_HyperParameterRanges_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HyperParameterRanges) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HyperParameterRanges) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HyperParameterRanges) 

# IntegerHyperParameterRange
<a name="API_IntegerHyperParameterRange"></a>

提供整數值超參數的名稱和範圍。

## 目錄
<a name="API_IntegerHyperParameterRange_Contents"></a>

 ** maxValue **   <a name="personalize-Type-IntegerHyperParameterRange-maxValue"></a>
超參數的最大允許值。  
類型：整數  
有效範圍：最大值為 1000000。  
必要：否

 ** minValue **   <a name="personalize-Type-IntegerHyperParameterRange-minValue"></a>
超參數的最小允許值。  
類型：整數  
有效範圍：最小值為 -1000000。  
必要：否

 ** name **   <a name="personalize-Type-IntegerHyperParameterRange-name"></a>
超參數的名稱。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_IntegerHyperParameterRange_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/IntegerHyperParameterRange) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/IntegerHyperParameterRange) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/IntegerHyperParameterRange) 

# MetricAttribute
<a name="API_MetricAttribute"></a>

包含指標屬性回報的指標資訊。如需詳細資訊，請參閱[測量建議的影響](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)。

## 目錄
<a name="API_MetricAttribute_Contents"></a>

 ** eventType **   <a name="personalize-Type-MetricAttribute-eventType"></a>
指標的事件類型。  
類型：字串  
長度限制：長度上限為 256。  
必要：是

 ** expression **   <a name="personalize-Type-MetricAttribute-expression"></a>
屬性的表達式。可用的函數為 `SUM()`或 `SAMPLECOUNT()`。對於 SUM() 函數，請提供資料集類型 （互動或項目） 和資料欄，以加總為參數。例如 SUM(Items.PRICE)。  
類型：字串  
長度限制：長度上限為 256。  
必要：是

 ** metricName **   <a name="personalize-Type-MetricAttribute-metricName"></a>
指標的名稱。此名稱可協助您識別 Amazon CloudWatch 或 Amazon S3 中的指標。  
類型：字串  
長度限制：長度上限為 256。  
必要：是

## 另請參閱
<a name="API_MetricAttribute_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttribute) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttribute) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttribute) 

# MetricAttribution
<a name="API_MetricAttribution"></a>

包含指標屬性的相關資訊。指標屬性會針對您匯入 Amazon Personalize 的資料建立報告。根據您匯入資料的方式，您可以在 Amazon CloudWatch 或 Amazon S3 中檢視報告。如需詳細資訊，請參閱[測量建議的影響](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)。

## 目錄
<a name="API_MetricAttribution_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-MetricAttribution-creationDateTime"></a>
指標屬性的建立日期時間。  
類型：Timestamp  
必要：否

 ** datasetGroupArn **   <a name="personalize-Type-MetricAttribution-datasetGroupArn"></a>
指標屬性的資料集群組 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** failureReason **   <a name="personalize-Type-MetricAttribution-failureReason"></a>
指標屬性的失敗原因。  
類型：字串  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-MetricAttribution-lastUpdatedDateTime"></a>
指標屬性的上次更新日期時間。  
類型：Timestamp  
必要：否

 ** metricAttributionArn **   <a name="personalize-Type-MetricAttribution-metricAttributionArn"></a>
指標屬性的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** metricsOutputConfig **   <a name="personalize-Type-MetricAttribution-metricsOutputConfig"></a>
指標屬性的輸出組態。  
類型：[MetricAttributionOutput](API_MetricAttributionOutput.md) 物件  
必要：否

 ** name **   <a name="personalize-Type-MetricAttribution-name"></a>
指標屬性的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** status **   <a name="personalize-Type-MetricAttribution-status"></a>
指標屬性的狀態。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_MetricAttribution_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttribution) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttribution) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttribution) 

# MetricAttributionOutput
<a name="API_MetricAttributionOutput"></a>

指標屬性的輸出組態詳細資訊。

## 目錄
<a name="API_MetricAttributionOutput_Contents"></a>

 ** roleArn **   <a name="personalize-Type-MetricAttributionOutput-roleArn"></a>
IAM 服務角色的 Amazon Resource Name (ARN)，其具有將資料新增至輸出 Amazon S3 儲存貯體並將指標新增至 Amazon CloudWatch 的許可。如需詳細資訊，請參閱[測量建議的影響](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 **   <a name="personalize-Type-MetricAttributionOutput-s3DataDestination"></a>
Amazon S3 輸入或輸出儲存貯體的組態詳細資訊。  
類型：[S3DataConfig](API_S3DataConfig.md) 物件  
必要：否

## 另請參閱
<a name="API_MetricAttributionOutput_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttributionOutput) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttributionOutput) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttributionOutput) 

# MetricAttributionSummary
<a name="API_MetricAttributionSummary"></a>

提供指標屬性屬性的摘要。如需完整清單，請呼叫 [DescribeMetricAttribution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeMetricAttribution.html)。

## 目錄
<a name="API_MetricAttributionSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-MetricAttributionSummary-creationDateTime"></a>
指標屬性的建立日期時間。  
類型：Timestamp  
必要：否

 ** failureReason **   <a name="personalize-Type-MetricAttributionSummary-failureReason"></a>
指標屬性的失敗原因。  
類型：字串  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-MetricAttributionSummary-lastUpdatedDateTime"></a>
指標屬性的上次更新日期時間。  
類型：Timestamp  
必要：否

 ** metricAttributionArn **   <a name="personalize-Type-MetricAttributionSummary-metricAttributionArn"></a>
指標屬性的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** name **   <a name="personalize-Type-MetricAttributionSummary-name"></a>
指標屬性的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** status **   <a name="personalize-Type-MetricAttributionSummary-status"></a>
指標屬性的狀態。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_MetricAttributionSummary_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttributionSummary) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttributionSummary) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttributionSummary) 

# OptimizationObjective
<a name="API_OptimizationObjective"></a>

描述解決方案的其他目標，例如最大化串流分鐘數或增加收入。如需詳細資訊[，請參閱最佳化解決方案](https://docs.aws.amazon.com/personalize/latest/dg/optimizing-solution-for-objective.html)。

## 目錄
<a name="API_OptimizationObjective_Contents"></a>

 ** itemAttribute **   <a name="personalize-Type-OptimizationObjective-itemAttribute"></a>
與最佳化目標相關的項目資料集中的數值中繼資料欄。例如，VIDEO\$1LENGTH （最大化串流分鐘） 或 PRICE （最大化收入）。  
類型：字串  
長度限制：長度下限為 1。長度上限為 150。  
必要：否

 ** objectiveSensitivity **   <a name="personalize-Type-OptimizationObjective-objectiveSensitivity"></a>
指定 Amazon Personalize 如何平衡最佳化目標的重要性與相關性。  
類型：字串  
有效值:`LOW | MEDIUM | HIGH | OFF`   
必要：否

## 另請參閱
<a name="API_OptimizationObjective_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/OptimizationObjective) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/OptimizationObjective) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/OptimizationObjective) 

# Recipe
<a name="API_Recipe"></a>

提供配方的相關資訊。當您使用 [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 操作時，每個配方都會提供 Amazon Personalize 用於模型訓練的演算法。

## 目錄
<a name="API_Recipe_Contents"></a>

 ** algorithmArn **   <a name="personalize-Type-Recipe-algorithmArn"></a>
Amazon Personalize 用來訓練模型之演算法的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** creationDateTime **   <a name="personalize-Type-Recipe-creationDateTime"></a>
建立配方的日期和時間 (Unix 格式）。  
類型：Timestamp  
必要：否

 ** description **   <a name="personalize-Type-Recipe-description"></a>
配方的描述。  
類型：字串  
必要：否

 ** featureTransformationArn **   <a name="personalize-Type-Recipe-featureTransformationArn"></a>
FeatureTransformation 物件的 ARN。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-Recipe-lastUpdatedDateTime"></a>
配方上次更新的日期和時間 (Unix 格式）。  
類型：Timestamp  
必要：否

 ** name **   <a name="personalize-Type-Recipe-name"></a>
配方的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** recipeArn **   <a name="personalize-Type-Recipe-recipeArn"></a>
配方的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** recipeType **   <a name="personalize-Type-Recipe-recipeType"></a>
下列其中一值：  
+ PERSONALIZED\$1RANKING
+ RELATED\$1ITEMS
+ USER\$1PERSONALIZATION
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** status **   <a name="personalize-Type-Recipe-status"></a>
配方的狀態。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_Recipe_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Recipe) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Recipe) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Recipe) 

# RecipeSummary
<a name="API_RecipeSummary"></a>

提供配方屬性的摘要。如需完整清單，請呼叫 [DescribeRecipe](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecipe.html) API。

## 目錄
<a name="API_RecipeSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-RecipeSummary-creationDateTime"></a>
建立配方的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** domain **   <a name="personalize-Type-RecipeSummary-domain"></a>
配方的網域 （如果配方是網域資料集群組使用案例）。  
類型：字串  
有效值:`ECOMMERCE | VIDEO_ON_DEMAND`   
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-RecipeSummary-lastUpdatedDateTime"></a>
配方上次更新的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** name **   <a name="personalize-Type-RecipeSummary-name"></a>
配方的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** recipeArn **   <a name="personalize-Type-RecipeSummary-recipeArn"></a>
配方的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** status **   <a name="personalize-Type-RecipeSummary-status"></a>
配方的狀態。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_RecipeSummary_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecipeSummary) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecipeSummary) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecipeSummary) 

# Recommender
<a name="API_Recommender"></a>

描述網域資料集群組的建議產生器。您可以在網域資料集群組中針對特定網域使用案例 （網域配方） 建立推薦者，並在 [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) 請求中指定推薦者。

## 目錄
<a name="API_Recommender_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-Recommender-creationDateTime"></a>
建立建議程式的日期和時間 (Unix 格式）。  
類型：Timestamp  
必要：否

 ** datasetGroupArn **   <a name="personalize-Type-Recommender-datasetGroupArn"></a>
包含建議程式之網域資料集群組的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** failureReason **   <a name="personalize-Type-Recommender-failureReason"></a>
如果建議者失敗，則為失敗背後的原因。  
類型：字串  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-Recommender-lastUpdatedDateTime"></a>
建議者上次更新的日期和時間 (Unix 格式）。  
類型：Timestamp  
必要：否

 ** latestRecommenderUpdate **   <a name="personalize-Type-Recommender-latestRecommenderUpdate"></a>
提供建議者最新更新的摘要。  
類型：[RecommenderUpdateSummary](API_RecommenderUpdateSummary.md) 物件  
必要：否

 ** modelMetrics **   <a name="personalize-Type-Recommender-modelMetrics"></a>
提供評估指標，協助您判斷建議者的效能。如需詳細資訊，請參閱[評估推薦者](https://docs.aws.amazon.com/personalize/latest/dg/evaluating-recommenders.html)。  
類型：String 到 double 映射  
映射項目：最多 100 個項目。  
金鑰長度限制：長度上限為 256。  
必要：否

 ** name **   <a name="personalize-Type-Recommender-name"></a>
建議者的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** recipeArn **   <a name="personalize-Type-Recommender-recipeArn"></a>
建立建議者的配方 （網域資料集群組使用案例） 的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** recommenderArn **   <a name="personalize-Type-Recommender-recommenderArn"></a>
建議者的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** recommenderConfig **   <a name="personalize-Type-Recommender-recommenderConfig"></a>
建議者的組態詳細資訊。  
類型：[RecommenderConfig](API_RecommenderConfig.md) 物件  
必要：否

 ** status **   <a name="personalize-Type-Recommender-status"></a>
建議者的狀態。  
建議者可以處於下列其中一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
+ 停止待定 > 停止 IN\$1PROGRESS > 非作用中 > 啟動待定 > 啟動 IN\$1PROGRESS > 作用中
+ DELETE PENDING > DELETE IN\$1PROGRESS
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_Recommender_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Recommender) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Recommender) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Recommender) 

# RecommenderConfig
<a name="API_RecommenderConfig"></a>

建議者的組態詳細資訊。

## 目錄
<a name="API_RecommenderConfig_Contents"></a>

 ** enableMetadataWithRecommendations **   <a name="personalize-Type-RecommenderConfig-enableMetadataWithRecommendations"></a>
是否為推薦者啟用具有建議的中繼資料。如果啟用，您可以在建議請求中指定項目資料集中的資料欄。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 **   <a name="personalize-Type-RecommenderConfig-itemExplorationConfig"></a>
指定探勘組態超參數，包括 `explorationWeight`和 `explorationItemAgeCutOff`，您想要用來設定 Amazon Personalize 在建議項目時使用的項目探勘量。只有在您的推薦者為使用者產生個人化建議 （非熱門項目或類似項目） 時，才提供`itemExplorationConfig`資料。  
類型：字串到字串映射  
映射項目：最多 100 個項目。  
金鑰長度限制：長度上限為 256。  
值長度限制：長度上限為 1000。  
必要：否

 ** minRecommendationRequestsPerSecond **   <a name="personalize-Type-RecommenderConfig-minRecommendationRequestsPerSecond"></a>
指定 Amazon Personalize 將支援的每秒請求的最低佈建建議請求。較高的 `minRecommendationRequestsPerSecond`會增加您的帳單。我們建議從 1 開始 `minRecommendationRequestsPerSecond`（預設值）。使用 Amazon CloudWatch 指標追蹤您的用量，並視需要增加 `minRecommendationRequestsPerSecond`。  
類型：整數  
有效範圍：最小值為 1。  
必要：否

 ** trainingDataConfig **   <a name="personalize-Type-RecommenderConfig-trainingDataConfig"></a>
 指定建立網域建議程式時要使用的訓練資料組態。  
類型：[TrainingDataConfig](API_TrainingDataConfig.md) 物件  
必要：否

## 另請參閱
<a name="API_RecommenderConfig_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecommenderConfig) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecommenderConfig) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecommenderConfig) 

# RecommenderSummary
<a name="API_RecommenderSummary"></a>

提供建議者的屬性摘要。

## 目錄
<a name="API_RecommenderSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-RecommenderSummary-creationDateTime"></a>
建立建議程式的日期和時間 (Unix 格式）。  
類型：Timestamp  
必要：否

 ** datasetGroupArn **   <a name="personalize-Type-RecommenderSummary-datasetGroupArn"></a>
包含建議程式之網域資料集群組的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-RecommenderSummary-lastUpdatedDateTime"></a>
建議者上次更新的日期和時間 (Unix 格式）。  
類型：Timestamp  
必要：否

 ** name **   <a name="personalize-Type-RecommenderSummary-name"></a>
建議者的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** recipeArn **   <a name="personalize-Type-RecommenderSummary-recipeArn"></a>
建立推薦者的配方 （網域資料集群組使用案例） 的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** recommenderArn **   <a name="personalize-Type-RecommenderSummary-recommenderArn"></a>
推薦者的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** recommenderConfig **   <a name="personalize-Type-RecommenderSummary-recommenderConfig"></a>
建議者的組態詳細資訊。  
類型：[RecommenderConfig](API_RecommenderConfig.md) 物件  
必要：否

 ** status **   <a name="personalize-Type-RecommenderSummary-status"></a>
建議者的狀態。推薦者可以處於下列其中一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
+ 停止待定 > 停止 IN\$1PROGRESS > 非作用中 > 啟動待定 > 啟動 IN\$1PROGRESS > 作用中
+ DELETE PENDING > DELETE IN\$1PROGRESS
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_RecommenderSummary_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecommenderSummary) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecommenderSummary) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecommenderSummary) 

# RecommenderUpdateSummary
<a name="API_RecommenderUpdateSummary"></a>

提供建議者更新的屬性摘要。如需完整清單，請呼叫 [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) API。

## 目錄
<a name="API_RecommenderUpdateSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-RecommenderUpdateSummary-creationDateTime"></a>
建立建議程式更新的日期和時間 （以 Unix 格式顯示）。  
類型：Timestamp  
必要：否

 ** failureReason **   <a name="personalize-Type-RecommenderUpdateSummary-failureReason"></a>
如果建議者更新失敗，則為失敗背後的原因。  
類型：字串  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-RecommenderUpdateSummary-lastUpdatedDateTime"></a>
上次更新建議程式的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** recommenderConfig **   <a name="personalize-Type-RecommenderUpdateSummary-recommenderConfig"></a>
建議程式更新的組態詳細資訊。  
類型：[RecommenderConfig](API_RecommenderConfig.md) 物件  
必要：否

 ** status **   <a name="personalize-Type-RecommenderUpdateSummary-status"></a>
建議程式更新的狀態。建議程式更新可以處於下列其中一種狀態：  
CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED  
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_RecommenderUpdateSummary_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecommenderUpdateSummary) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecommenderUpdateSummary) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecommenderUpdateSummary) 

# S3DataConfig
<a name="API_S3DataConfig"></a>

Amazon S3 輸入或輸出儲存貯體的組態詳細資訊。

## 目錄
<a name="API_S3DataConfig_Contents"></a>

 ** path **   <a name="personalize-Type-S3DataConfig-path"></a>
Amazon S3 儲存貯體的檔案路徑。  
類型：字串  
長度限制：長度上限為 256。  
模式：`(s3|http|https)://.+`  
必要：是

 ** kmsKeyArn **   <a name="personalize-Type-S3DataConfig-kmsKeyArn"></a>
Amazon Personalize 用來加密或解密輸入和輸出檔案的 AWS Key Management Service (KMS) 金鑰的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 2048。  
模式：`arn:aws.*:kms:.*:[0-9]{12}:key/.*`  
必要：否

## 另請參閱
<a name="API_S3DataConfig_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/S3DataConfig) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/S3DataConfig) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/S3DataConfig) 

# Solution
<a name="API_Solution"></a>

**重要**  
根據預設，所有新解決方案都會使用自動訓練。透過自動訓練，您會在解決方案處於作用中狀態時產生訓練成本。為了避免不必要的成本，您可以在完成後[更新解決方案](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)，或建立新的解決方案。

## 目錄
<a name="API_Solution_Contents"></a>

 ** autoMLResult **   <a name="personalize-Type-Solution-autoMLResult"></a>
當 `performAutoML` 為 true 時，指定找到的最佳配方。  
類型：[AutoMLResult](API_AutoMLResult.md) 物件  
必要：否

 ** creationDateTime **   <a name="personalize-Type-Solution-creationDateTime"></a>
解決方案的建立日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** datasetGroupArn **   <a name="personalize-Type-Solution-datasetGroupArn"></a>
提供訓練資料之資料集群組的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** eventType **   <a name="personalize-Type-Solution-eventType"></a>
用來訓練模型的事件類型 (例如「按一下」或「喜歡」)。若未提供任何 `eventType`，無論類型為何，Amazon Personalize 都會使用所有互動進行相等權重的訓練。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-Solution-lastUpdatedDateTime"></a>
上次更新解決方案的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** latestSolutionUpdate **   <a name="personalize-Type-Solution-latestSolutionUpdate"></a>
提供解決方案最新更新的摘要。  
類型：[SolutionUpdateSummary](API_SolutionUpdateSummary.md) 物件  
必要：否

 ** latestSolutionVersion **   <a name="personalize-Type-Solution-latestSolutionVersion"></a>
描述解決方案的最新版本，包括狀態和 ARN。  
類型：[SolutionVersionSummary](API_SolutionVersionSummary.md) 物件  
必要：否

 ** name **   <a name="personalize-Type-Solution-name"></a>
解決方案的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** performAutoML **   <a name="personalize-Type-Solution-performAutoML"></a>
我們不建議啟用自動化機器學習。相反地，請將您的使用案例與可用的 Amazon Personalize 配方比對。如需詳細資訊，請參閱[判斷您的使用案例](https://docs.aws.amazon.com/personalize/latest/dg/determining-use-case.html)。
若為 true，Amazon Personalize 會從解決方案組態的指定清單中搜尋最佳 USER\$1PERSONALIZE 配方 (不得指定 `recipeArn`)。若為 false (預設)，Amazon Personalize 會使用 `recipeArn` 來訓練。  
類型：布林值  
必要：否

 ** performAutoTraining **   <a name="personalize-Type-Solution-performAutoTraining"></a>
指定解決方案是否自動建立解決方案版本。預設值為 ，`True`且解決方案每 7 天會自動建立新的解決方案版本。  
如需自動訓練的詳細資訊，請參閱[建立和設定解決方案](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html)。  
類型：布林值  
必要：否

 ** performHPO **   <a name="personalize-Type-Solution-performHPO"></a>
是否要在選擇的配方上執行超參數最佳化 (HPO)。預設值為 `false`。  
類型：布林值  
必要：否

 ** performIncrementalUpdate **   <a name="personalize-Type-Solution-performIncrementalUpdate"></a>
布林值，指出是否在模型上執行增量訓練更新。啟用時，這可讓模型更頻繁地從新資料中學習，而無需完整重新訓練，從而實現近乎即時的個人化。只有使用語意相似性配方的解決方案才支援此參數  
類型：布林值  
必要：否

 ** recipeArn **   <a name="personalize-Type-Solution-recipeArn"></a>
用來建立解決方案的配方 ARN。當 `performAutoML`為 false 時，此為必要項目。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** solutionArn **   <a name="personalize-Type-Solution-solutionArn"></a>
解決方案的 ARN。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** solutionConfig **   <a name="personalize-Type-Solution-solutionConfig"></a>
描述解決方案的組態屬性。  
類型：[SolutionConfig](API_SolutionConfig.md) 物件  
必要：否

 ** status **   <a name="personalize-Type-Solution-status"></a>
解決方案的狀態。  
解決方案可以處於下列其中一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_Solution_SeeAlso"></a>

如需在其中一種語言特定 AWSSDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Solution) 
+  [AWS適用於 Java V2 的 SDK](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
<a name="API_SolutionConfig"></a>

描述解決方案的組態屬性。

## 目錄
<a name="API_SolutionConfig_Contents"></a>

 ** algorithmHyperParameters **   <a name="personalize-Type-SolutionConfig-algorithmHyperParameters"></a>
列出演算法超參數及其值。  
類型：字串到字串映射  
映射項目：最多 100 個項目。  
金鑰長度限制：長度上限為 256。  
值長度限制：長度上限為 1000。  
必要：否

 ** autoMLConfig **   <a name="personalize-Type-SolutionConfig-autoMLConfig"></a>
[AutoMLConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_AutoMLConfig.html) 物件包含執行 AutoML 時要搜尋的配方清單。  
類型：[AutoMLConfig](API_AutoMLConfig.md) 物件  
必要：否

 ** autoTrainingConfig **   <a name="personalize-Type-SolutionConfig-autoTrainingConfig"></a>
指定要使用的自動訓練組態。  
類型：[AutoTrainingConfig](API_AutoTrainingConfig.md) 物件  
必要：否

 ** eventsConfig **   <a name="personalize-Type-SolutionConfig-eventsConfig"></a>
描述事件的組態，其中包含事件參數的清單。您最多可以指定 10 個事件參數。事件用於建立解決方案。  
類型：[EventsConfig](API_EventsConfig.md) 物件  
必要：否

 ** eventValueThreshold **   <a name="personalize-Type-SolutionConfig-eventValueThreshold"></a>
只有值大於或等於閾值的事件才會用於訓練模型。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** featureTransformationParameters **   <a name="personalize-Type-SolutionConfig-featureTransformationParameters"></a>
列出特徵轉換參數。  
類型：字串到字串映射  
映射項目：最多 100 個項目。  
金鑰長度限制：長度上限為 256。  
值長度限制：長度上限為 1000。  
必要：否

 ** hpoConfig **   <a name="personalize-Type-SolutionConfig-hpoConfig"></a>
描述超參數優化 (HPO) 的屬性。  
類型：[HPOConfig](API_HPOConfig.md) 物件  
必要：否

 ** optimizationObjective **   <a name="personalize-Type-SolutionConfig-optimizationObjective"></a>
描述解決方案的其他目標，例如最大化串流分鐘數或增加收入。如需詳細資訊[，請參閱最佳化解決方案](https://docs.aws.amazon.com/personalize/latest/dg/optimizing-solution-for-objective.html)。  
類型：[OptimizationObjective](API_OptimizationObjective.md) 物件  
必要：否

 ** trainingDataConfig **   <a name="personalize-Type-SolutionConfig-trainingDataConfig"></a>
 指定建立自訂解決方案版本 （訓練模型） 時要使用的訓練資料組態。  
類型：[TrainingDataConfig](API_TrainingDataConfig.md) 物件  
必要：否

## 另請參閱
<a name="API_SolutionConfig_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionConfig) 
+  [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionConfig) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionConfig) 

# SolutionSummary
<a name="API_SolutionSummary"></a>

提供解決方案屬性的摘要。如需完整清單，請呼叫 [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) API。

## 目錄
<a name="API_SolutionSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-SolutionSummary-creationDateTime"></a>
建立解決方案的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-SolutionSummary-lastUpdatedDateTime"></a>
上次更新解決方案的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** name **   <a name="personalize-Type-SolutionSummary-name"></a>
解決方案的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** recipeArn **   <a name="personalize-Type-SolutionSummary-recipeArn"></a>
解決方案所用配方的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** solutionArn **   <a name="personalize-Type-SolutionSummary-solutionArn"></a>
解決方案的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** status **   <a name="personalize-Type-SolutionSummary-status"></a>
解決方案的狀態。  
解決方案可以處於下列其中一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_SolutionSummary_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionSummary) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionSummary) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionSummary) 

# SolutionUpdateConfig
<a name="API_SolutionUpdateConfig"></a>

解決方案更新的組態詳細資訊。

## 目錄
<a name="API_SolutionUpdateConfig_Contents"></a>

 ** autoTrainingConfig **   <a name="personalize-Type-SolutionUpdateConfig-autoTrainingConfig"></a>
當 `performAutoTraining` 為 true 時要使用的自動訓練組態。  
類型：[AutoTrainingConfig](API_AutoTrainingConfig.md) 物件  
必要：否

 ** eventsConfig **   <a name="personalize-Type-SolutionUpdateConfig-eventsConfig"></a>
描述事件的組態，其中包含事件參數的清單。您最多可以指定 10 個事件參數。事件用於建立解決方案。  
類型：[EventsConfig](API_EventsConfig.md) 物件  
必要：否

## 另請參閱
<a name="API_SolutionUpdateConfig_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionUpdateConfig) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionUpdateConfig) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionUpdateConfig) 

# SolutionUpdateSummary
<a name="API_SolutionUpdateSummary"></a>

提供解決方案更新的屬性摘要。如需完整清單，請呼叫 [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) API。

## 目錄
<a name="API_SolutionUpdateSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-SolutionUpdateSummary-creationDateTime"></a>
建立解決方案更新的日期和時間 (Unix 格式）。  
類型：Timestamp  
必要：否

 ** failureReason **   <a name="personalize-Type-SolutionUpdateSummary-failureReason"></a>
如果解決方案更新失敗，則為失敗背後的原因。  
類型：字串  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-SolutionUpdateSummary-lastUpdatedDateTime"></a>
上次更新解決方案的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** performAutoTraining **   <a name="personalize-Type-SolutionUpdateSummary-performAutoTraining"></a>
解決方案是否自動建立解決方案版本。  
類型：布林值  
必要：否

 ** performIncrementalUpdate **   <a name="personalize-Type-SolutionUpdateSummary-performIncrementalUpdate"></a>
布林值，指出是否在模型上執行增量訓練更新。啟用時，針對具有作用中行銷活動的解決方案版本執行增量訓練，並允許模型更頻繁地從新資料中學習，而不需要完整重新訓練，這可實現近乎即時的個人化。只有使用語意相似性配方的解決方案才支援此參數。預設值為 `true`。  
請注意，在下一次完整訓練發生之前，某些分數和屬性 （例如用於對 aws-semantic-similarity 配方的排名影響的項目熱門度和新鮮度更新） 可能不會更新。  
類型：布林值  
必要：否

 ** solutionUpdateConfig **   <a name="personalize-Type-SolutionUpdateSummary-solutionUpdateConfig"></a>
解決方案的組態詳細資訊。  
類型：[SolutionUpdateConfig](API_SolutionUpdateConfig.md) 物件  
必要：否

 ** status **   <a name="personalize-Type-SolutionUpdateSummary-status"></a>
解決方案更新的狀態。解決方案更新可以處於下列其中一種狀態：  
CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED  
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_SolutionUpdateSummary_SeeAlso"></a>

如需在其中一種語言特定 AWSSDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionUpdateSummary) 
+  [AWS適用於 Java V2 的 SDK](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
<a name="API_SolutionVersion"></a>

提供自訂資料集群組中特定版本[解決方案](https://docs.aws.amazon.com/personalize/latest/dg/API_Solution.html)相關資訊的物件。

## 目錄
<a name="API_SolutionVersion_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-SolutionVersion-creationDateTime"></a>
建立此版本解決方案的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** datasetGroupArn **   <a name="personalize-Type-SolutionVersion-datasetGroupArn"></a>
提供訓練資料的資料集群組的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** eventType **   <a name="personalize-Type-SolutionVersion-eventType"></a>
用來訓練模型的事件類型 (例如「按一下」或「喜歡」)。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** failureReason **   <a name="personalize-Type-SolutionVersion-failureReason"></a>
如果訓練解決方案版本失敗，則表示失敗的原因。  
類型：字串  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-SolutionVersion-lastUpdatedDateTime"></a>
上次更新解決方案的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** name **   <a name="personalize-Type-SolutionVersion-name"></a>
解決方案版本的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** performAutoML **   <a name="personalize-Type-SolutionVersion-performAutoML"></a>
若為 true，Amazon Personalize 會根據解決方案組態搜尋最佳配方。當 false （預設值） 時，Amazon Personalize 會使用 `recipeArn`。  
類型：布林值  
必要：否

 ** performHPO **   <a name="personalize-Type-SolutionVersion-performHPO"></a>
是否要在選擇的配方上執行超參數最佳化 (HPO)。預設值為 `false`。  
類型：布林值  
必要：否

 ** performIncrementalUpdate **   <a name="personalize-Type-SolutionVersion-performIncrementalUpdate"></a>
解決方案版本是否應執行增量更新。當設定為 true 時，訓練只會處理自上次訓練以來變更的資料，類似於當 trainingMode 設定為 UPDATE 時。這只能與使用使用者個人化配方的解決方案版本搭配使用。  
類型：布林值  
必要：否

 ** recipeArn **   <a name="personalize-Type-SolutionVersion-recipeArn"></a>
解決方案中使用的配方 ARN。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** solutionArn **   <a name="personalize-Type-SolutionVersion-solutionArn"></a>
解決方案的 ARN。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** solutionConfig **   <a name="personalize-Type-SolutionVersion-solutionConfig"></a>
描述解決方案的組態屬性。  
類型：[SolutionConfig](API_SolutionConfig.md) 物件  
必要：否

 ** solutionVersionArn **   <a name="personalize-Type-SolutionVersion-solutionVersionArn"></a>
解決方案版本的 ARN。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** status **   <a name="personalize-Type-SolutionVersion-status"></a>
解決方案版本的狀態。  
解決方案版本可以處於下列其中一種狀態：  
+ 建立擱置中
+ CREATE IN\$1PROGRESS
+ ACTIVE
+ 建立失敗
+ 建立停止
+ 建立已停止
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** trainingHours **   <a name="personalize-Type-SolutionVersion-trainingHours"></a>
用於訓練模型的時間。您需要支付訓練模型所需的時間費用。只有在 Amazon Personalize 成功訓練模型之後，才會顯示此欄位。  
類型：Double  
有效範圍：最小值為 0。  
必要：否

 ** trainingMode **   <a name="personalize-Type-SolutionVersion-trainingMode"></a>
建立解決方案版本時要執行的訓練範圍。`FULL` 訓練會考慮資料集群組中的所有資料。只會`UPDATE`處理自上次訓練以來變更的資料。只有使用使用者個人化配方建立的解決方案版本才能使用 `UPDATE`。  
類型：字串  
有效值:`FULL | UPDATE | AUTOTRAIN`   
必要：否

 ** trainingType **   <a name="personalize-Type-SolutionVersion-trainingType"></a>
解決方案版本是自動還是手動建立的。  
類型：字串  
有效值:`AUTOMATIC | MANUAL`   
必要：否

 ** tunedHPOParams **   <a name="personalize-Type-SolutionVersion-tunedHPOParams"></a>
如果已執行超參數最佳化， 會包含最佳效能模型的超參數值。  
類型：[TunedHPOParams](API_TunedHPOParams.md) 物件  
必要：否

## 另請參閱
<a name="API_SolutionVersion_SeeAlso"></a>

如需在其中一種語言特定 AWSSDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionVersion) 
+  [AWS適用於 Java V2 的 SDK](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
<a name="API_SolutionVersionSummary"></a>

提供解決方案版本的屬性摘要。如需完整清單，請呼叫 [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) API。

## 目錄
<a name="API_SolutionVersionSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-SolutionVersionSummary-creationDateTime"></a>
建立此版本解決方案的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** failureReason **   <a name="personalize-Type-SolutionVersionSummary-failureReason"></a>
如果解決方案版本失敗，則為失敗背後的原因。  
類型：字串  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-SolutionVersionSummary-lastUpdatedDateTime"></a>
解決方案版本上次更新的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** solutionVersionArn **   <a name="personalize-Type-SolutionVersionSummary-solutionVersionArn"></a>
解決方案版本的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** status **   <a name="personalize-Type-SolutionVersionSummary-status"></a>
解決方案版本的狀態。  
解決方案版本可以處於下列其中一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** trainingMode **   <a name="personalize-Type-SolutionVersionSummary-trainingMode"></a>
建立解決方案版本時要執行的訓練範圍。`FULL` 訓練會考慮資料集群組中的所有資料。只會`UPDATE`處理自上次訓練以來變更的資料。只有使用使用者個人化配方建立的解決方案版本才能使用 `UPDATE`。  
類型：字串  
有效值:`FULL | UPDATE | AUTOTRAIN`   
必要：否

 ** trainingType **   <a name="personalize-Type-SolutionVersionSummary-trainingType"></a>
解決方案版本是自動還是手動建立的。  
類型：字串  
有效值:`AUTOMATIC | MANUAL`   
必要：否

## 另請參閱
<a name="API_SolutionVersionSummary_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionVersionSummary) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionVersionSummary) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionVersionSummary) 

# Tag
<a name="API_Tag"></a>

您套用至資源的選用中繼資料，可協助您分類和組織這些中繼資料。每個標籤皆包含由您定義的一個金鑰與一個選用值。如需詳細資訊，請參閱[標記 Amazon Personalize 資源](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)。

## 目錄
<a name="API_Tag_Contents"></a>

 ** tagKey **   <a name="personalize-Type-Tag-tagKey"></a>
構成標籤的鍵/值對的一部分。索引鍵是一般標籤，作用就像更特定標籤值的類別。  
類型：字串  
長度限制：長度下限為 1。長度上限為 128。  
模式：`^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`  
必要：是

 ** tagValue **   <a name="personalize-Type-Tag-tagValue"></a>
組成標籤之鍵值對的選用部分。值就像標籤類別 (索引鍵) 內的描述項。  
類型：字串  
長度限制：長度下限為 0。長度上限為 256。  
模式：`^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`  
必要：是

## 另請參閱
<a name="API_Tag_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Tag) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Tag) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Tag) 

# ThemeGenerationConfig
<a name="API_ThemeGenerationConfig"></a>

使用批次推論任務產生佈景主題的組態詳細資訊。

## 目錄
<a name="API_ThemeGenerationConfig_Contents"></a>

 ** fieldsForThemeGeneration **   <a name="personalize-Type-ThemeGenerationConfig-fieldsForThemeGeneration"></a>
用於為批次推論任務產生描述性主題的欄位。  
類型：[FieldsForThemeGeneration](API_FieldsForThemeGeneration.md) 物件  
必要：是

## 另請參閱
<a name="API_ThemeGenerationConfig_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ThemeGenerationConfig) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ThemeGenerationConfig) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ThemeGenerationConfig) 

# TrainingDataConfig
<a name="API_TrainingDataConfig"></a>

建立網域建議程式或自訂解決方案版本 （訓練模型） 時要使用的訓練資料組態。

## 目錄
<a name="API_TrainingDataConfig_Contents"></a>

 ** excludedDatasetColumns **   <a name="personalize-Type-TrainingDataConfig-excludedDatasetColumns"></a>
指定要從訓練中排除的資料欄。每個索引鍵都是資料集類型，而每個值都是欄的清單。排除資料欄以控制 Amazon Personalize 用於產生建議的資料。  
 例如，您可能有一個欄，只想用來篩選建議。您可以將此資料欄排除在訓練之外，Amazon Personalize 只會在篩選時考慮此資料欄。  
類型：字串到字串陣列映射  
映射項目：最多 3 個項目。  
金鑰長度限制：長度上限為 256。  
金鑰模式：`^[A-Za-z_]+$`  
陣列成員：最多 50 個項目。  
長度限制：長度上限為 150。  
模式：`[A-Za-z_][A-Za-z\d_]*`  
必要：否

 ** includedDatasetColumns **   <a name="personalize-Type-TrainingDataConfig-includedDatasetColumns"></a>
指定要從訓練中包含的資料欄。每個索引鍵都是資料集類型，而每個值都是欄的清單。包含資料欄以控制 Amazon Personalize 用於產生建議的資料。  
例如，您可能在項目資料集中有多個資料欄，但只想使用標題和描述進行訓練。您只能包含這兩欄用於訓練，Amazon Personalize 只會考慮包含的欄用於訓練。  
類型：字串到字串陣列映射  
映射項目：最多 3 個項目。  
金鑰長度限制：長度上限為 256。  
金鑰模式：`^[A-Za-z_]+$`  
陣列成員：最多 50 個項目。  
長度限制：長度上限為 150。  
模式：`[A-Za-z_][A-Za-z\d_]*`  
必要：否

## 另請參閱
<a name="API_TrainingDataConfig_SeeAlso"></a>

如需在其中一種語言特定 AWSSDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/TrainingDataConfig) 
+  [AWS適用於 Java V2 的 SDK](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
<a name="API_TunedHPOParams"></a>

如果已執行超參數最佳化 (HPO)， 會包含最佳效能模型的超參數值。

## 目錄
<a name="API_TunedHPOParams_Contents"></a>

 ** algorithmHyperParameters **   <a name="personalize-Type-TunedHPOParams-algorithmHyperParameters"></a>
最佳效能模型的超參數值清單。  
類型：字串到字串映射  
映射項目：最多 100 個項目。  
金鑰長度限制：長度上限為 256。  
值長度限制：長度上限為 1000。  
必要：否

## 另請參閱
<a name="API_TunedHPOParams_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/TunedHPOParams) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/TunedHPOParams) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/TunedHPOParams) 

# Amazon Personalize Events
<a name="API_Types_Amazon_Personalize_Events"></a>

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
<a name="API_UBS_Action"></a>

代表使用 `PutActions` API 新增至動作資料集的動作中繼資料。如需詳細資訊，請參閱[個別匯入動作](https://docs.aws.amazon.com/personalize/latest/dg/importing-actions.html)。

## 目錄
<a name="API_UBS_Action_Contents"></a>

 ** actionId **   <a name="personalize-Type-UBS_Action-actionId"></a>
與動作相關聯的 ID。  
類型：字串  
長度限制：長度下限為 1。長度上限為 256。  
必要：是

 ** properties **   <a name="personalize-Type-UBS_Action-properties"></a>
動作特定中繼資料的字串映射。映射中的每個元素都由索引鍵/值對組成。例如 `{"value": "100"}`。  
金鑰使用符合動作資料集結構描述中欄位的駱駝案例名稱。在上一個範例中， `value`符合動作結構描述中定義的「VALUE」欄位。對於分類字串資料，若要包含單一動作的多個類別，請使用管道分隔符號 () 分隔每個類別`|`。例如 `\"Deluxe|Premium\"`。  
類型：字串  
長度限制：長度下限為 1。長度上限為 32000。  
必要：否

## 另請參閱
<a name="API_UBS_Action_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/Action) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/Action) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/Action) 

# ActionInteraction
<a name="API_UBS_ActionInteraction"></a>

代表使用 `PutActionInteractions` API 傳送的動作互動事件。

## 目錄
<a name="API_UBS_ActionInteraction_Contents"></a>

 ** actionId **   <a name="personalize-Type-UBS_ActionInteraction-actionId"></a>
使用者互動的動作 ID。這對應至動作互動結構描述`ACTION_ID`的欄位。  
類型：字串  
長度限制：長度下限為 1。長度上限為 256。  
必要：是

 ** eventType **   <a name="personalize-Type-UBS_ActionInteraction-eventType"></a>
動作互動事件的類型。您可以指定 `Viewed`、 `Taken`和 `Not Taken`事件類型。如需動作互動事件類型資料的詳細資訊，請參閱[事件類型資料](https://docs.aws.amazon.com/personalize/latest/dg/action-interaction-event-type-data.html)。  
類型：字串  
長度限制：長度下限為 1。長度上限為 256。  
必要：是

 ** sessionId **   <a name="personalize-Type-UBS_ActionInteraction-sessionId"></a>
與使用者造訪相關聯的 ID。當使用者第一次造訪您的網站或使用應用程式`sessionId`時，您的應用程式會產生唯一的 。  
類型：字串  
長度限制：長度下限為 1。長度上限為 256。  
必要：是

 ** timestamp **   <a name="personalize-Type-UBS_ActionInteraction-timestamp"></a>
動作互動事件發生時的時間戳記。時間戳記必須是 Unix epoch 時間格式，以秒為單位。  
類型：Timestamp  
必要：是

 ** eventId **   <a name="personalize-Type-UBS_ActionInteraction-eventId"></a>
與事件相關聯的 ID。如果未提供事件 ID，Amazon Personalize 會為事件產生唯一的 ID。事件 ID 不會用作模型的輸入。Amazon Personalize 使用事件 ID 來區分唯一事件。具有相同事件 ID 的第一個之後的任何後續事件都不會用於模型訓練。  
類型：字串  
長度限制：長度下限為 1。長度上限為 256。  
必要：否

 ** impression **   <a name="personalize-Type-UBS_ActionInteraction-impression"></a>
動作 IDs 清單，代表您已向使用者顯示的動作序列。例如 `["actionId1", "actionId2", "actionId3"]`。Amazon Personalize 不會使用來自動作互動事件的曝光資料。相反地，請記錄每個動作的多個事件，並使用 `Viewed`事件類型。  
類型：字串陣列  
陣列成員：項目數下限為 1。最多 25 個項目。  
長度限制：長度下限為 1。長度上限為 256。  
必要：否

 ** properties **   <a name="personalize-Type-UBS_ActionInteraction-properties"></a>
您可以選擇記錄的事件特定資料的字串映射。例如，如果使用者採取動作 ID 以外的動作，您也可以傳送使用者採取的動作數目。  
映射中的每個項目都由索引鍵/值對組成。例如   
 `{"numberOfActions": "12"}`   
金鑰使用符合動作互動結構描述中欄位的駱駝案例名稱。在上述範例中， `numberOfActions`會符合動作互動結構描述中定義的 'NUMBER\$1OF\$1ACTIONS' 欄位。  
 下列項目不能包含為屬性的關鍵字 （不區分大小寫）。  
+  userId 
+  sessionId 
+ eventType
+ timestamp
+ recommendationId
+ 印模
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
必要：否

 ** recommendationId **   <a name="personalize-Type-UBS_ActionInteraction-recommendationId"></a>
包含使用者互動之動作的建議清單 ID。  
類型：字串  
長度限制：長度下限為 1。長度上限為 40。  
必要：否

 ** userId **   <a name="personalize-Type-UBS_ActionInteraction-userId"></a>
與動作互動的使用者 ID。這對應至動作互動結構描述`USER_ID`的欄位。  
類型：字串  
長度限制：長度下限為 1。長度上限為 256。  
必要：否

## 另請參閱
<a name="API_UBS_ActionInteraction_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/ActionInteraction) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/ActionInteraction) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/ActionInteraction) 

# Event
<a name="API_UBS_Event"></a>

代表使用 `PutEvents` API 傳送的項目互動事件資訊。

## 目錄
<a name="API_UBS_Event_Contents"></a>

 ** eventType **   <a name="personalize-Type-UBS_Event-eventType"></a>
事件的類型，例如點選或下載。此屬性對應至項目互動資料集結構描述`EVENT_TYPE`的欄位，並取決於您正在追蹤的事件類型。  
類型：字串  
長度限制：長度下限為 1。長度上限為 256。  
必要：是

 ** sentAt **   <a name="personalize-Type-UBS_Event-sentAt"></a>
事件發生時用戶端的時間戳記 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：是

 ** eventId **   <a name="personalize-Type-UBS_Event-eventId"></a>
與事件相關聯的 ID。如果未提供事件 ID，Amazon Personalize 會為事件產生唯一的 ID。事件 ID 不會用作模型的輸入。Amazon Personalize 使用事件 ID 來區分唯一事件。第一個 之後具有相同事件 ID 的任何後續事件都不會用於模型訓練。  
類型：字串  
長度限制：長度下限為 1。長度上限為 256。  
必要：否

 ** eventValue **   <a name="personalize-Type-UBS_Event-eventValue"></a>
對應至項目互動結構描述 `EVENT_VALUE` 欄位的事件值。  
類型：浮點數  
必要：否

 ** impression **   <a name="personalize-Type-UBS_Event-impression"></a>
項目 IDs 清單，代表您已向使用者顯示的項目序列。例如 `["itemId1", "itemId2", "itemId3"]`。提供項目清單，以手動記錄事件的曝光資料。如需記錄印模資料的詳細資訊，請參閱[記錄印模資料](https://docs.aws.amazon.com/personalize/latest/dg/recording-events.html#putevents-including-impressions-data)。  
類型：字串陣列  
陣列成員：項目數下限為 1。最多 25 個項目。  
長度限制：長度下限為 1。長度上限為 256。  
必要：否

 ** itemId **   <a name="personalize-Type-UBS_Event-itemId"></a>
對應至項目互動資料集結構描述`ITEM_ID`欄位的項目 ID 金鑰。  
類型：字串  
長度限制：長度下限為 1。長度上限為 256。  
必要：否

 ** metricAttribution **   <a name="personalize-Type-UBS_Event-metricAttribution"></a>
包含與事件相關聯的指標屬性資訊。如需指標屬性的詳細資訊，請參閱[測量建議的影響](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)。  
類型：[MetricAttribution](API_UBS_MetricAttribution.md) 物件  
必要：否

 ** properties **   <a name="personalize-Type-UBS_Event-properties"></a>
您可以選擇記錄的事件特定資料的字串映射。例如，如果使用者對您的網站上的電影評分，但電影 ID (`itemId`) 和評分 (`eventValue`) 除外，您也可以傳送使用者所做的電影評分數量。  
映射中的每個項目都由索引鍵/值對組成。例如   
 `{"numberOfRatings": "12"}`   
金鑰使用符合項目互動資料集結構描述中欄位的駱駝案例名稱。在上述範例中， `numberOfRatings`會符合項目互動資料集結構描述中定義的 'NUMBER\$1OF\$1RATINGS' 欄位。  
 下列項目不能包含為屬性的關鍵字 （不區分大小寫）。  
+  userId 
+  sessionId 
+ eventType
+ timestamp
+ recommendationId
+ 印模
類型：字串  
長度限制：長度下限為 1。長度上限為 1024。  
必要：否

 ** recommendationId **   <a name="personalize-Type-UBS_Event-recommendationId"></a>
包含使用者互動項目的建議清單 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。  
必要：否

## 另請參閱
<a name="API_UBS_Event_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/Event) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/Event) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/Event) 

# Item
<a name="API_UBS_Item"></a>

代表使用 `PutItems` API 新增至項目資料集的項目中繼資料。如需詳細資訊，請參閱[個別匯入項目](https://docs.aws.amazon.com/personalize/latest/dg/importing-items.html)。

## 目錄
<a name="API_UBS_Item_Contents"></a>

 ** itemId **   <a name="personalize-Type-UBS_Item-itemId"></a>
與項目相關聯的 ID。  
類型：字串  
長度限制：長度下限為 1。長度上限為 256。  
必要：是

 ** properties **   <a name="personalize-Type-UBS_Item-properties"></a>
項目特定中繼資料的字串映射。映射中的每個元素都由索引鍵/值對組成。例如 `{"numberOfRatings": "12"}`。  
金鑰使用符合項目資料集結構描述中欄位的駱駝案例名稱。在上一個範例中， `numberOfRatings`符合項目結構描述中定義的 'NUMBER\$1OF\$1RATINGS' 欄位。對於分類字串資料，若要包含單一項目的多個類別，請使用管道分隔符號 () 分隔每個類別`|`。例如 `\"Horror|Action\"`。  
類型：字串  
長度限制：長度下限為 1。長度上限為 32000。  
必要：否

## 另請參閱
<a name="API_UBS_Item_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/Item) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/Item) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/Item) 

# MetricAttribution
<a name="API_UBS_MetricAttribution"></a>

包含與事件相關聯的指標屬性資訊。如需指標屬性的詳細資訊，請參閱[測量建議的影響](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html)。

## 目錄
<a name="API_UBS_MetricAttribution_Contents"></a>

 ** eventAttributionSource **   <a name="personalize-Type-UBS_MetricAttribution-eventAttributionSource"></a>
事件的來源，例如第三方。  
類型：字串  
長度限制：長度上限為 1024。  
模式：`^[\x20-\x7E]*[\x21-\x7E]+[\x20-\x7E]*$`  
必要：是

## 另請參閱
<a name="API_UBS_MetricAttribution_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/MetricAttribution) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/MetricAttribution) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/MetricAttribution) 

# User
<a name="API_UBS_User"></a>

代表使用 `PutUsers` API 新增至使用者資料集的使用者中繼資料。如需詳細資訊，請參閱[個別匯入使用者](https://docs.aws.amazon.com/personalize/latest/dg/importing-users.html)。

## 目錄
<a name="API_UBS_User_Contents"></a>

 ** userId **   <a name="personalize-Type-UBS_User-userId"></a>
與使用者相關聯的 ID。  
類型：字串  
長度限制：長度下限為 1。長度上限為 256。  
必要：是

 ** properties **   <a name="personalize-Type-UBS_User-properties"></a>
使用者特定中繼資料的字串映射。映射中的每個元素都由索引鍵/值對組成。例如 `{"numberOfVideosWatched": "45"}`。  
金鑰使用符合使用者資料集結構描述中欄位的駱駝案例名稱。在上一個範例中， `numberOfVideosWatched`符合使用者結構描述中定義的 'NUMBER\$1OF\$1VIDEOS\$1WATCHED' 欄位。對於分類字串資料，若要包含單一使用者的多個類別，請使用管道分隔符號 () 分隔每個類別`|`。例如 `\"Member|Frequent shopper\"`。  
類型：字串  
長度限制：長度下限為 1。長度上限為 24000。  
必要：否

## 另請參閱
<a name="API_UBS_User_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/User) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/User) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/User) 

# Amazon Personalize Runtime
<a name="API_Types_Amazon_Personalize_Runtime"></a>

Amazon Personalize 執行期支援下列資料類型：
+  [PredictedAction](API_RS_PredictedAction.md) 
+  [PredictedItem](API_RS_PredictedItem.md) 
+  [Promotion](API_RS_Promotion.md) 

# PredictedAction
<a name="API_RS_PredictedAction"></a>

識別動作的物件。

[GetActionRecommendations](API_RS_GetActionRecommendations.md) API 會傳回 `PredictedAction`的清單。

## 目錄
<a name="API_RS_PredictedAction_Contents"></a>

 ** actionId **   <a name="personalize-Type-RS_PredictedAction-actionId"></a>
建議動作的 ID。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** score **   <a name="personalize-Type-RS_PredictedAction-score"></a>
建議動作的分數。如需動作分數的資訊，請參閱[動作建議評分的運作方式](https://docs.aws.amazon.com/personalize/latest/dg/how-action-recommendation-scoring-works.html)。  
類型：Double  
必要：否

## 另請參閱
<a name="API_RS_PredictedAction_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/PredictedAction) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/PredictedAction) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/PredictedAction) 

# PredictedItem
<a name="API_RS_PredictedItem"></a>

識別項目的物件。

[GetRecommendations](API_RS_GetRecommendations.md) 和 [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) APIs 會傳回 的清單`PredictedItem`。

## 目錄
<a name="API_RS_PredictedItem_Contents"></a>

 ** itemId **   <a name="personalize-Type-RS_PredictedItem-itemId"></a>
建議項目 ID。  
類型：字串  
長度限制：長度上限為 256。  
必要：否

 ** metadata **   <a name="personalize-Type-RS_PredictedItem-metadata"></a>
項目資料集中項目的中繼資料。  
類型：字串到字串映射  
金鑰長度限制：長度上限為 150。  
值長度限制：長度上限為 20000。  
必要：否

 ** promotionName **   <a name="personalize-Type-RS_PredictedItem-promotionName"></a>
包含預測項目的提升名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** reason **   <a name="personalize-Type-RS_PredictedItem-reason"></a>
如果您使用 User-Personalization-v2，則會列出項目包含在建議中的原因清單。可能的原因包括下列項目：  
+ 提升項目 - 指出項目已包含在您在建議請求中套用的提升中。
+ 探勘 - 表示探勘中包含該項目。透過探勘，建議包括互動資料較少或使用者相關性較低的項目。如需探勘的詳細資訊，請參閱[探](https://docs.aws.amazon.com/personalize/latest/dg/use-case-recipe-features.html#about-exploration)勘。
+  熱門項目 - 指出項目已包含在預留位置熱門項目中。如果您使用篩選條件，取決於篩選條件移除的建議數量，Amazon Personalize 可能會新增預留位置項目，以符合`numResults`您的建議請求。這些項目是根據互動資料，符合您篩選條件的熱門項目。他們沒有使用者的相關性分數。
類型：字串陣列  
長度限制：長度上限為 256。  
必要：否

 ** score **   <a name="personalize-Type-RS_PredictedItem-score"></a>
模型確定性數值表示項目將是下一個使用者選擇。如需評分邏輯的詳細資訊，請參閱 [建議分數](getting-recommendations.md#how-scores-work)。  
類型：Double  
必要：否

## 另請參閱
<a name="API_RS_PredictedItem_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/PredictedItem) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/PredictedItem) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/PredictedItem) 

# Promotion
<a name="API_RS_Promotion"></a>

包含提升的相關資訊。提升定義適用於建議項目可設定子集的其他業務規則。

## 目錄
<a name="API_RS_Promotion_Contents"></a>

 ** filterArn **   <a name="personalize-Type-RS_Promotion-filterArn"></a>
提升所使用的篩選條件 Amazon Resource Name (ARN)。此篩選條件定義提升項目的條件。如需詳細資訊，請參閱[提升篩選條件](https://docs.aws.amazon.com/personalize/latest/dg/promoting-items.html#promotion-filters)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** filterValues **   <a name="personalize-Type-RS_Promotion-filterValues"></a>
提升項目時要使用的值。針對提升篩選條件表達式中的每個預留位置參數，提供參數名稱 （在相符的情況下） 做為索引鍵，並提供篩選條件值 （做為對應值）。以逗號分隔一個參數的多個值。  
對於使用 `INCLUDE`元素包含項目的篩選條件表達式，您必須為表達式中定義的所有參數提供值。對於具有使用 `EXCLUDE`元素排除項目之表達式的篩選條件，您可以省略 `filter-values`。在此情況下，Amazon Personalize 不會使用表達式的該部分來篩選建議。  
如需建立篩選條件的詳細資訊，請參閱[篩選建議和使用者客群](https://docs.aws.amazon.com/personalize/latest/dg/filter.html)。  
類型：字串到字串映射  
映射項目：最多 25 個項目。  
金鑰長度限制：長度上限為 50。  
金鑰模式：`[A-Za-z0-9_]+`  
值長度限制：長度上限為 1000。  
必要：否

 ** name **   <a name="personalize-Type-RS_Promotion-name"></a>
提升的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** percentPromotedItems **   <a name="personalize-Type-RS_Promotion-percentPromotedItems"></a>
要套用提升的建議項目百分比。  
類型：整數  
有效範圍：最小值為 1。最大值為 100。  
必要：否

## 另請參閱
<a name="API_RS_Promotion_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/Promotion) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/Promotion) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/Promotion)