Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。進一步了解」
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
CreateWhatIfForecastExport
將 CreateWhatIfForecast操作建立的預測匯出至 Amazon Simple Storage Service (Amazon S3) 儲存貯體。預測檔案名稱將符合下列慣例:
≈<ForecastExportJobName>_<ExportTimestamp>_<PartNumber>
<ExportTimestamp> 元件位於 Java SimpleDateFormat (yyyy-MM-ddTHH-mm-ssZ) 中。
重要
Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。進一步了解」
您必須指定包含 (IAM) 角色的DataDestination AWS Identity and Access Management 物件,Amazon Forecast 可以擔任該角色來存取 Amazon S3 儲存貯體。如需詳細資訊,請參閱設定 Amazon Forecast 的許可。
如需詳細資訊,請參閱產生預測。
若要取得所有預測匯出任務的清單,請使用 ListWhatIfForecastExports操作。
注意
預測匯出任務Status的 必須在您可以存取 Amazon S3 儲存貯體中的預測ACTIVE之前。若要取得 狀態,請使用 DescribeWhatIfForecastExport操作。
請求語法
{
"Destination": {
"S3Config": {
"KMSKeyArn": "string",
"Path": "string",
"RoleArn": "string"
}
},
"Format": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"WhatIfForecastArns": [ "string" ],
"WhatIfForecastExportName": "string"
}
請求參數
請求接受採用 JSON 格式的下列資料。
- Destination
-
您要儲存預測的位置,以及 Amazon Forecast 可以擔任以存取該位置的 AWS Identity and Access Management (IAM) 角色。預測必須匯出至 Amazon S3 儲存貯體。
如果使用加密,
Destination必須包含 AWS Key Management Service (KMS) 金鑰。IAM 角色必須允許 Amazon Forecast 許可存取金鑰。類型:DataDestination 物件
必要:是
- Format
-
匯出資料的格式,CSV 或 PARQUET。
類型:字串
長度限制:長度上限為 7。
模式:
^CSV|PARQUET$必要:否
- Tags
-
要套用至預測內容的標籤清單。
類型:Tag 物件陣列
陣列成員:項目數下限為 0。項目數上限為 200。
必要:否
- WhatIfForecastArns
-
要匯出的假設預測 Amazon Resource Name (ARNs清單。
類型:字串陣列
陣列成員:項目數下限為 1。項目數上限為 50。
長度限制:長度上限為 300。
模式:
arn:([a-z\d-]+):forecast:.*:.*:.+必要:是
- WhatIfForecastExportName
-
要匯出之假設預測的名稱。
類型:字串
長度限制:長度下限為 1。長度上限為 63。
模式:
^[a-zA-Z][a-zA-Z0-9_]*必要:是
回應語法
{
"WhatIfForecastExportArn": "string"
}
回應元素
如果動作成功,則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- WhatIfForecastExportArn
-
假設預測的 Amazon Resource Name (ARN)。
類型:字串
長度限制:長度上限為 300。
模式:
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 的詳細資訊,請參閱下列內容: