CreateForecastExportJob - Amazon Forecast

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

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

CreateForecastExportJob

CreateForecast操作建立的預測匯出到您的 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 的許可

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

若要取得所有預測匯出工單的清單,請使用ListForecastExportJobs作業。

注意

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

請求語法

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

請求參數

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

Destination

您想要儲存預測的位置,以及 Amazon 預測可以擔任存取該位置的 AWS Identity and Access Management (IAM) 角色。預測必須匯出至 Amazon S3 儲存貯體。

如果使用加密,則Destination必須包含 AWS Key Management Service (KMS) 金鑰。IAM角色必須允許 Amazon Forecast 權限才能存取金鑰。

類型:DataDestination 物件

必要:是

ForecastArn

您要匯出的預測的 Amazon 資源名稱 (ARN)。

類型:字串

長度限制:長度上限為 256。

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

必要:是

ForecastExportJobName

預測匯出工作的名稱。

類型:字串

長度限制:長度下限為 1。長度上限為 63。

模式:^[a-zA-Z][a-zA-Z0-9_]*

必要:是

Format

匯出資料的格式,CSV或PARQUET。預設值為CSV。

類型:字串

長度限制:最大長度為 7。

模式:^CSV|PARQUET$

必要:否

Tags

套用至預測匯出工作的選擇性中繼資料,可協助您對其進行分類和組織。每個標籤皆包含由您定義的一個金鑰與一個選用值。

以下基本限制適用於標籤:

  • 每個資源的最大標籤數量-50。

  • 對於每一個資源,每個標籤金鑰必須是唯一的,且每個標籤金鑰只能有一個值。

  • 最大金鑰長度-UTF -8 中 128 個萬國碼字元。

  • 最大值長度-UTF -8 中 256 個萬國碼字元。

  • 如果您的標記結構描述是跨多項服務和資源使用,請記得其他服務可能會有字元使用限制。通常允許的字符是:字母,數字和空格在 UTF -8 中表示,以及以下字符:+-=. _:/@。

  • 標籤鍵與值皆區分大小寫。

  • 請勿使用aws:AWS:、或任何大寫或小寫的組合,例如索引鍵的前置字元,因為它會保留供 AWS 使用。您無法使用此字首編輯或刪除標籤關鍵字。值可以有這個前綴。如果標籤值aws作為其前綴,但鍵沒有,則 Forecast 將其視為使用者標記,並將計入 50 個標籤的限制。只有 key prefix 的標籤aws不會計入每個資源限制的標籤。

類型:Tag 物件陣列

陣列成員:項目數下限為 0。項目數上限為 200。

必要:否

回應語法

{ "ForecastExportJobArn": "string" }

回應元素

如果動作成功,服務會傳回 HTTP 200 回應。

服務會以JSON格式傳回下列資料。

ForecastExportJobArn

匯出任務的 Amazon 資源名稱 (ARN)。

類型:字串

長度限制:長度上限為 256。

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

錯誤

InvalidInputException

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

HTTP狀態碼:4

LimitExceededException

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

HTTP狀態碼:4

ResourceAlreadyExistsException

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

HTTP狀態碼:4

ResourceInUseException

指定的資源正在使用中。

HTTP狀態碼:4

ResourceNotFoundException

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

HTTP狀態碼:4

另請參閱

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