CreateWhatIfForecastExport - Amazon Forecast
請求語法請求參數回應語法回應元素錯誤另請參閱

Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。進一步了解"

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

CreateWhatIfForecastExport

將CreateWhatIfForecast操作建立的預測匯出到您的 Amazon Simple Storage Service (Amazon S3) 儲存貯體。預測檔案名稱將符合下列慣例：

≈<ForecastExportJobName>_<ExportTimestamp>_<PartNumber>

該 < ExportTimestamp > 組件是在 Java SimpleDateFormat（年-月-日-毫米-THH SSZ）。

重要

Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用該服務。了解更多」

您必須指定一個DataDestination物件，該物件包含 Amazon Forecast 可假定存取 Amazon S3 儲存貯體的 AWS Identity and Access Management (IAM) 角色。如需詳細資訊，請參閱設定 Amazon Forecast 的許可。

如需詳細資訊，請參閱產生預測。

若要取得所有假設預測匯出工單的清單，請使用此ListWhatIfForecastExports作業。

注意

必須先執行預測匯出任務，ACTIVE才能存取 Amazon S3 儲存貯體中的預測。Status若要取得狀態，請使用DescribeWhatIfForecastExport作業。

請求語法

{
   "Destination": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "Format": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "WhatIfForecastArns": [ "string" ],
   "WhatIfForecastExportName": "string"
}

請求參數

請求接受以下JSON格式的數據。

Destination

您想要儲存預測的位置，以及 Amazon 預測可以擔任存取該位置的 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 資源名稱（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 資源名稱（ARN）。

類型：字串

長度限制：最大長度為 300。

模式：arn:([a-z\d-]+):forecast:.*:.*:.+

錯誤

InvalidInputException

我們無法處理要求，因為它包含無效值或超出有效範圍的值。

HTTP狀態碼:

LimitExceededException

已超過每個帳號的資源數量限制。

HTTP狀態碼:

ResourceAlreadyExistsException

已有此名稱的資源。請使用不同的名稱再試一次。

HTTP狀態碼:

ResourceInUseException

指定的資源正在使用中。

HTTP狀態碼:

ResourceNotFoundException

我們找不到具有該 Amazon 資源名稱（ARN）的資源。檢查ARN並再試一次。

HTTP狀態碼:

另請參閱

如需有關API在其中一種特定語言中使用此功能的詳細資訊 AWS SDKs，請參閱下列內容：