Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。進一步了解"
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CreateAutoPredictor
建立 Amazon Forecast 預測器。
重要
Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。進一步了解"
Amazon Forecast 會使用 AutoPredictor 建立預測器，這涉及將演算法的最佳組合套用至資料集中的每個時間序列。您可以使用 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
-
資料集群組和任何其他資料集的資料組態。
類型：DataConfig 物件
必要：否
- EncryptionConfig
-
Amazon Forecast 可以擔任的 AWS Key Management Service (KMS) 金鑰和 AWS Identity and Access Management (IAM) 角色來存取金鑰。您可以在 CreateDataset和 CreatePredictor請求中指定此選用物件。
類型：EncryptionConfig 物件
必要：否
- ExplainPredictor
-
為預測器建立可解釋性資源。
類型：布林值
必要：否
- ForecastDimensions
-
維度 （欄位） 名稱陣列，指定如何將產生的預測分組。
例如，如果您正在為所有商店的項目銷售產生預測，且資料集包含
store_id欄位，則指定store_id做為將每個商店的銷售預測分組的維度。類型：字串陣列
陣列成員：項目數下限為 1。項目數上限為 10。
長度限制：長度下限為 1。長度上限為 63。
模式：
^[a-zA-Z][a-zA-Z0-9_]*必要：否
- ForecastFrequency
-
預測中的預測頻率。
有效間隔為整數，後跟 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_TIME_SERIES 資料集頻率。
提供 RELATED_TIME_SERIES 資料集時，頻率必須等於 RELATED_TIME_SERIES 資料集頻率。
類型：字串
長度限制：長度下限為 1。長度上限為 5。
模式：
^Y|M|W|D|H|30min|15min|10min|5min|1min$必要：否
-
- ForecastHorizon
-
模型預測的時間步驟數目。預測期間也稱為預測長度。
最大預測時間範圍為 500 個時間步進或 TARGET_TIME_SERIES 資料集長度的 1/4。如果您要重新訓練現有的 AutoPredictor，則最大預測時間範圍為 500 個時間步進或 TARGET_TIME_SERIES 資料集長度的 1/3。
如果您要升級至 AutoPredictor 或重新訓練現有的 AutoPredictor，則無法更新預測地平線參數。您可以在資料集中提供較長的時間序列，以滿足此要求。
類型：整數
必要：否
- ForecastTypes
-
用來訓練預測器的預測類型。您最多可以指定五種預測類型。預測類型可以是 0.01 到 0.99 之間的分位數，增量單位為 0.01 或更高。您也可以使用 指定平均預測
mean。類型：字串陣列
陣列成員：項目數下限為 1。項目數上限為 20。
長度限制：長度下限為 2。長度上限為 4。
模式：
(^0?\.\d\d?$|^mean$)必要：否
- MonitorConfig
-
預測器監控的組態詳細資訊。提供監視器資源的名稱，以啟用預測器監控。
預測器監控可讓您了解預測器的效能如何隨時間變化。如需詳細資訊，請參閱預測器監控。
類型：MonitorConfig 物件
必要：否
- OptimizationMetric
-
用來最佳化預測器的準確度指標。
類型：字串
有效值:
WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE必要：否
- PredictorName
-
預測器的唯一名稱
類型：字串
長度限制：長度下限為 1。長度上限為 63。
模式：
^[a-zA-Z][a-zA-Z0-9_]*必要：是
- ReferencePredictorArn
-
要重新訓練或升級之預測器的 ARN。此參數只會在重新訓練或升級預測器時使用。建立新的預測器時，請勿為此參數指定值。
升級或重新訓練預測器時，請僅指定
ReferencePredictorArn和 的值PredictorName。的值PredictorName必須是唯一的預測器名稱。類型：字串
長度限制：長度上限為 256。
模式：
arn:([a-z\d-]+):forecast:.*:.*:.+必要：否
- Tags
-
選用中繼資料，協助您分類和整理預測器。每個標籤皆包含由您定義的一個金鑰與一個選用值。標籤鍵與值皆區分大小寫。
以下限制適用於標籤：
-
對於每個資源，每個標籤索引鍵必須是唯一的，且每個標籤索引鍵必須有一個值。
-
每個資源的標籤數量上限：50。
-
金鑰長度上限：UTF-8 中 128 個 Unicode 字元。
-
最大值長度：UTF-8 中的 256 個 Unicode 字元。
-
接受的字元：所有字母和數字、UTF-8 代表的空格，以及 + - = 。_ ：/ @。 如果您的標記結構描述用於其他 服務和資源，則這些服務的字元限制也適用。
-
金鑰字首不能包含 或 的任何大寫
aws:或小寫組合AWS:。值可以有此字首。如果標籤值具有aws作為其字首，但金鑰沒有，預測會將其視為使用者標籤，並將計入 50 個標籤的限制。僅包含 金鑰字首的標籤aws不會計入每個資源限制的標籤。您無法編輯或刪除具有此字首的標籤索引鍵。
類型：Tag 物件陣列
陣列成員：項目數下限為 0。項目數上限為 200。
必要：否
-
- TimeAlignmentBoundary
-
時間界限預測使用 來對齊和彙總任何不符合預測頻率的資料。以索引鍵值對形式提供時間和時間界限的單位。如需指定時間界限的詳細資訊，請參閱指定時間界限。如果您未提供時間界限，預測會使用一組預設時間界限。
類型：TimeAlignmentBoundary 物件
必要：否
回應語法
{
"PredictorArn": "string"
}回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- PredictorArn
-
預測器的 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 的詳細資訊，請參閱下列內容：
