Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # CreateAutoPredictor 建立 Amazon Forecast 預測器。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) Amazon Forecast 會使用 AutoPredictor 建立預測器，這涉及將演算法的最佳組合套用至資料集中的每個時間序列。您可以使用 [CreateAutoPredictor](#API_CreateAutoPredictor)建立新的預測器或升級/重新訓練現有的預測器。 **建立新的預測器** 建立新預測器時需要下列參數： + `PredictorName` - 預測器的唯一名稱。 + `DatasetGroupArn` - 用來訓練預測器之資料集群組的 ARN。 + `ForecastFrequency` - 預測的精細程度 （每小時、每日、每週等）。 + `ForecastHorizon` - 模型預測的時間步驟數目。預測期間也稱為預測長度。 建立新的預測器時，請勿指定 的值`ReferencePredictorArn`。 **升級和重新訓練預測器** 重新訓練或升級預測器時，需要下列參數： + `PredictorName` - 預測器的唯一名稱。 + `ReferencePredictorArn` - 要重新訓練或升級之預測器的 ARN。 升級或重新訓練預測器時，請僅指定 `ReferencePredictorArn`和 的值`PredictorName`。 ## 請求語法 ``` { "DataConfig": { "AdditionalDatasets": [ { "Configuration": { "string" : [ "string" ] }, "Name": "string" } ], "AttributeConfigs": [ { "AttributeName": "string", "Transformations": { "string" : "string" } } ], "DatasetGroupArn": "string" }, "EncryptionConfig": { "KMSKeyArn": "string", "RoleArn": "string" }, "ExplainPredictor": boolean, "ForecastDimensions": [ "string" ], "ForecastFrequency": "string", "ForecastHorizon": number, "ForecastTypes": [ "string" ], "MonitorConfig": { "MonitorName": "string" }, "OptimizationMetric": "string", "PredictorName": "string", "ReferencePredictorArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "TimeAlignmentBoundary": { "DayOfMonth": number, "DayOfWeek": "string", "Hour": number, "Month": "string" } } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [DataConfig](#API_CreateAutoPredictor_RequestSyntax) ** 資料集群組和任何其他資料集的資料組態。 類型：[DataConfig](API_DataConfig.md) 物件 必要：否 ** [EncryptionConfig](#API_CreateAutoPredictor_RequestSyntax) ** Amazon Forecast 可以擔任的 AWS Key Management Service (KMS) 金鑰和 AWS Identity and Access Management (IAM) 角色，以存取金鑰。您可以在 [CreateDataset](API_CreateDataset.md)和 [CreatePredictor](API_CreatePredictor.md)請求中指定此選用物件。 類型：[EncryptionConfig](API_EncryptionConfig.md) 物件 必要：否 ** [ExplainPredictor](#API_CreateAutoPredictor_RequestSyntax) ** 為預測器建立可解釋性資源。 類型：布林值 必要：否 ** [ForecastDimensions](#API_CreateAutoPredictor_RequestSyntax) ** 維度 （欄位） 名稱陣列，指定如何將產生的預測分組。 例如，如果您要在所有商店中產生項目銷售的預測，且資料集包含 `store_id` 欄位，則您可以指定 `store_id`做為維度，以將每個商店的銷售預測分組。 類型：字串陣列 陣列成員：項目數下限為 1。項目數上限為 10。 長度限制：長度下限為 1。長度上限為 63。 模式：`^[a-zA-Z][a-zA-Z0-9_]*` 必要：否 ** [ForecastFrequency](#API_CreateAutoPredictor_RequestSyntax) ** 預測中的預測頻率。 有效間隔為整數，後跟 Y (年)、M (月)、W (週)、D (天)、H (小時) 和 min (分鐘)。例如，"1D" 表示每隔一天，"15min" 表示每隔 15 分鐘。您無法指定會與下一個較大頻率重疊的值。例如，這意味著您不能指定頻率為 60 分鐘，因為這相當於 1 小時。每個頻率的有效值如下： + 分鐘–1-59 + 小時–1-23 + 天–1-6 + 週–1-4 + 月–1-11 + 年 – 1 因此，如果您希望每兩週預測一次，請指定 "2W"。或者，如果您希望每季度預測一次，請指定 "3M"。 頻率必須大於或等於 TARGET\$1TIME\$1SERIES 資料集頻率。 提供 RELATED\$1TIME\$1SERIES 資料集時，頻率必須等於 RELATED\$1TIME\$1SERIES 資料集頻率。 類型：字串 長度限制：長度下限為 1。長度上限為 5。 模式：`^Y|M|W|D|H|30min|15min|10min|5min|1min$` 必要：否 ** [ForecastHorizon](#API_CreateAutoPredictor_RequestSyntax) ** 模型預測的時間步驟數目。預測期間也稱為預測長度。 最大預測期間是 500 個時間步驟或 TARGET\$1TIME\$1SERIES 資料集長度的 1/4。如果您要重新訓練現有的 AutoPredictor，則最大預測期間為 500 個時間步驟或 TARGET\$1TIME\$1SERIES 資料集長度的 1/3。 如果您要升級至 AutoPredictor 或重新訓練現有的 AutoPredictor，則無法更新預測期間參數。您可以在資料集中提供較長的時間序列，以滿足此要求。 類型：整數 必要：否 ** [ForecastTypes](#API_CreateAutoPredictor_RequestSyntax) ** 用來訓練預測器的預測類型。您最多可以指定五種預測類型。預測類型可以是 0.01 到 0.99 之間的分位數，增量單位為 0.01 或更高。您也可以使用 指定平均預測`mean`。 類型：字串陣列 陣列成員：項目數下限為 1。項目數上限為 20。 長度限制：長度下限為 2。長度上限為 4。 模式：`(^0?\.\d\d?$|^mean$)` 必要：否 ** [MonitorConfig](#API_CreateAutoPredictor_RequestSyntax) ** 預測器監控的組態詳細資訊。提供監視器資源的名稱，以啟用預測器監控。 預測器監控可讓您查看預測器的效能如何隨時間變化。如需詳細資訊，請參閱[預測器監控](https://docs.aws.amazon.com/forecast/latest/dg/predictor-monitoring.html)。 類型：[MonitorConfig](API_MonitorConfig.md) 物件 必要：否 ** [OptimizationMetric](#API_CreateAutoPredictor_RequestSyntax) ** 用於最佳化預測器的準確度指標。 類型：字串 有效值:`WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE` 必要：否 ** [PredictorName](#API_CreateAutoPredictor_RequestSyntax) ** 預測器的唯一名稱 類型：字串 長度限制：長度下限為 1。長度上限為 63。 模式：`^[a-zA-Z][a-zA-Z0-9_]*` 必要：是 ** [ReferencePredictorArn](#API_CreateAutoPredictor_RequestSyntax) ** 要重新訓練或升級之預測器的 ARN。只有在重新訓練或升級預測器時，才會使用此參數。建立新的預測器時，請勿為此參數指定值。 升級或重新訓練預測器時，請僅指定 `ReferencePredictorArn`和 的值`PredictorName`。的值`PredictorName`必須是唯一的預測器名稱。 類型：字串 長度限制：長度上限為 256。 模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：否 ** [Tags](#API_CreateAutoPredictor_RequestSyntax) ** 選用中繼資料，可協助您分類和整理預測器。每個標籤皆包含由您定義的一個金鑰與一個選用值。標籤鍵與值皆區分大小寫。 以下限制適用於標籤： + 對於每個資源，每個標籤索引鍵必須是唯一的，而且每個標籤索引鍵都必須有一個值。 + 每個資源的標籤數量上限：50。 + 金鑰長度上限：UTF-8 128 個 Unicode 字元。 + 最大值長度：UTF-8 256 個 Unicode 字元。 + 接受的字元：所有字母和數字、以 UTF-8 表示的空格，以及 \$1 - = 。\$1 ：/ @。 如果您的標記結構描述用於其他 服務和資源，則這些服務的角色限制也適用。 + 金鑰字首不能包含 或 的任何大寫`aws:`或小寫組合`AWS:`。值可以有此字首。如果標籤值具有 `aws` 作為其字首，但索引鍵沒有，則預測會將其視為使用者標籤，並計入 50 個標籤的限制。只有 金鑰字首的標籤`aws`不會計入每個資源限制的標籤。您無法使用此字首編輯或刪除標籤索引鍵。 類型：[Tag](API_Tag.md) 物件陣列 陣列成員：項目數下限為 0。項目數上限為 200。 必要：否 ** [TimeAlignmentBoundary](#API_CreateAutoPredictor_RequestSyntax) ** 時間界限 Forecast 使用 來對齊和彙總任何不符合預測頻率的資料。以鍵值對形式提供時間和時間界限的單位。如需指定時間界限的詳細資訊，請參閱[指定時間界限](https://docs.aws.amazon.com/forecast/latest/dg/data-aggregation.html#specifying-time-boundary)。如果您未提供時間界限，預測會使用一組[預設時間界限](https://docs.aws.amazon.com/forecast/latest/dg/data-aggregation.html#default-time-boundaries)。 類型：[TimeAlignmentBoundary](API_TimeAlignmentBoundary.md) 物件 必要：否 ## 回應語法 ``` { "PredictorArn": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [PredictorArn](#API_CreateAutoPredictor_ResponseSyntax) ** 預測器的 Amazon Resource Name (ARN)。 類型：字串 長度限制：長度上限為 256。 模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceAlreadyExistsException ** 已有具有此名稱的資源。請用不同的名稱再試一次。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateAutoPredictor) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateAutoPredictor) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateAutoPredictor) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateAutoPredictor) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateAutoPredictor) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateAutoPredictor) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateAutoPredictor) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateAutoPredictor) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateAutoPredictor) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateAutoPredictor)