Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。進一步了解"
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
CreatePredictorBacktestExportJob
匯出 CreateAutoPredictor或 CreatePredictor操作所產生的回溯測試預測和準確性指標。包含 CSV 或 Parquet 檔案的兩個資料夾會匯出至您指定的 S3 儲存貯體。
重要
Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。進一步了解"
匯出檔案名稱將符合下列慣例:
<ExportJobName>_<ExportTimestamp>_<PartNumber>.csv
<ExportTimestamp> 元件採用 Java SimpleDate 格式 (yyyy-MM-ddTHH-mm-ssZ)。
您必須指定包含 Amazon S3 儲存貯體和 AWS Identity and Access Management (IAM) 角色的DataDestination物件,Amazon Forecast 可以擔任該角色來存取 Amazon S3 儲存貯體。如需詳細資訊,請參閱設定 Amazon Forecast 的許可。
注意
匯出任務Status
的 必須在您可以存取 Amazon S3 儲存貯體中的匯出ACTIVE
之前。若要取得 狀態,請使用 DescribePredictorBacktestExportJob操作。
請求語法
{
"Destination": {
"S3Config": {
"KMSKeyArn": "string
",
"Path": "string
",
"RoleArn": "string
"
}
},
"Format": "string
",
"PredictorArn": "string
",
"PredictorBacktestExportJobName": "string
",
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
]
}
請求參數
請求接受採用 JSON 格式的下列資料。
- Destination
-
匯出任務的目的地。提供 S3 路徑、允許 Amazon Forecast 存取位置的 AWS Identity and Access Management (IAM) 角色,以及 AWS Key Management Service (KMS) 金鑰 (選用)。
類型:DataDestination 物件
必要:是
- Format
-
匯出資料的格式,CSV 或 PARQUET。預設值為 CSV。
類型:字串
長度限制:長度上限為 7。
模式:
^CSV|PARQUET$
必要:否
- PredictorArn
-
您要匯出之預測器的 Amazon Resource Name (ARN)。
類型:字串
長度限制:長度上限為 256。
模式:
arn:([a-z\d-]+):forecast:.*:.*:.+
必要:是
- PredictorBacktestExportJobName
-
回溯測試匯出任務的名稱。
類型:字串
長度限制:長度下限為 1。長度上限為 63。
模式:
^[a-zA-Z][a-zA-Z0-9_]*
必要:是
- Tags
-
選用中繼資料,可協助您分類和組織回溯測試。每個標籤皆包含由您定義的一個金鑰與一個選用值。標籤鍵與值皆區分大小寫。
以下限制適用於標籤:
-
對於每個資源,每個標籤索引鍵必須是唯一的,且每個標籤索引鍵必須有一個值。
-
每個資源的標籤數量上限:50。
-
金鑰長度上限:UTF-8 中 128 個 Unicode 字元。
-
最大值長度:UTF-8 中的 256 個 Unicode 字元。
-
接受的字元:所有字母和數字、UTF-8 代表的空格,以及 + - = 。_ :/ @。 如果您的標記結構描述用於其他 服務和資源,則這些服務的字元限制也適用。
-
金鑰字首不能包含 或 的任何大寫
aws:
或小寫組合AWS:
。值可以有此字首。如果標籤值具有aws
作為其字首,但金鑰沒有,則預測會將其視為使用者標籤,並將計入 50 個標籤的限制。僅包含 金鑰字首的標籤aws
不會計入每個資源限制的標籤。您無法編輯或刪除具有此字首的標籤索引鍵。
類型:Tag 物件陣列
陣列成員:項目數下限為 0。項目數上限為 200。
必要:否
-
回應語法
{
"PredictorBacktestExportJobArn": "string"
}
回應元素
如果動作成功,則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- PredictorBacktestExportJobArn
-
您要匯出之預測器回溯測試匯出任務的 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 的詳細資訊,請參閱下列內容: