DescribeDatasetImportJob - Amazon Forecast

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

DescribeDatasetImportJob

說明使用該作業建立的資料集匯入工CreateDatasetImportJob作。

除了列出CreateDatasetImportJob請求中提供的參數之外,此操作還包括以下屬性:

  • CreationTime

  • LastModificationTime

  • DataSize

  • FieldStatistics

  • Status

  • Message-如果發生錯誤,請提供有關錯誤的資訊。

請求語法

{ "DatasetImportJobArn": "string" }

請求參數

請求接受採用 JSON 格式的下列資料。

DatasetImportJobArn

資料集匯入任務的 Amazon 資源名稱 (ARN)。

類型:字串

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

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

必要:是

回應語法

{ "CreationTime": number, "DatasetArn": "string", "DatasetImportJobArn": "string", "DatasetImportJobName": "string", "DataSize": number, "DataSource": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "EstimatedTimeRemainingInMinutes": number, "FieldStatistics": { "string" : { "Avg": number, "Count": number, "CountDistinct": number, "CountDistinctLong": number, "CountLong": number, "CountNan": number, "CountNanLong": number, "CountNull": number, "CountNullLong": number, "Max": "string", "Min": "string", "Stddev": number } }, "Format": "string", "GeolocationFormat": "string", "ImportMode": "string", "LastModificationTime": number, "Message": "string", "Status": "string", "TimestampFormat": "string", "TimeZone": "string", "UseGeolocationForTimeZone": boolean }

回應元素

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

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

CreationTime

建立資料集匯入工作的時間。

類型:Timestamp

DatasetArn

訓練資料匯入到的資料集的 Amazon 資源名稱 (ARN)。

類型:字串

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

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

DatasetImportJobArn

資料集匯入任務的 ARN。

類型:字串

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

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

DatasetImportJobName

資料集匯入工作的名稱。

類型:字串

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

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

DataSize

匯入工作完成後,資料集的大小 (GB),以 GB 為單位。

類型:Double

DataSource

要匯入的訓練資料的位置,以及 Amazon Forecast 可以承擔存取資料的 AWS Identity and Access Management (IAM) 角色。

如果使用加密,請DataSource包含 AWS Key Management Service (KMS) 金鑰。

類型:DataSource 物件

EstimatedTimeRemainingInMinutes

資料集匯入工作完成的預估剩餘時間 (以分鐘為單位)。

類型:Long

FieldStatistics

有關輸入數據中每個字段的統計信息。

類型:字串至Statistics物件對映

索引鍵長度限制:最大長度為 256。

金鑰模式:^[a-zA-Z0-9\_]+$

Format

匯入資料的格式,CSV 或實木複合地板。

類型:字串

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

模式:^CSV|PARQUET$

GeolocationFormat

地理位置屬性的格式。有效值:"LAT_LONG""CC_POSTALCODE"

類型:字串

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

模式:^[a-zA-Z0-9_]+$

ImportMode

資料集匯入工作的匯入模式,「完整」或「增量」。

類型:字串

有效值:FULL | INCREMENTAL

LastModificationTime

上次修改資源的時間。時間戳記取決於工作的狀態:

  • CREATE_PENDING-該CreationTime.

  • CREATE_IN_PROGRESS-目前的時間戳記。

  • CREATE_STOPPING-目前的時間戳記。

  • CREATE_STOPPED-工作停止的時候

  • ACTIVECREATE_FAILED-工作完成或失敗時。

類型:Timestamp

Message

如果發生錯誤,則會顯示有關錯誤的資訊訊息。

類型:字串

Status

資料集匯入工作的狀態。各州包括:

  • ACTIVE

  • CREATE_PENDING, CREATE_IN_PROGRESS, CREATE_FAILED

  • DELETE_PENDING, DELETE_IN_PROGRESS, DELETE_FAILED

  • CREATE_STOPPING, CREATE_STOPPED

類型:字串

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

TimestampFormat

資料集中時間戳記的格式。您指定的格式取決於建立資料集時所指DataFrequency定的格式。支持以下格式

  • 「年-月-日」

    對於以下數據頻率:Y,M,W 和 D

  • "yyyy-MM-dd HH:mm:ss"

    對於下列資料頻率:H、30 分鐘、15 分鐘和 1 分鐘;以及可選的,用於 Y、M、W 和 D

類型:字串

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

模式:^[a-zA-Z0-9\-\:\.\,\'\s]+$

TimeZone

套用至資料集中每個項目的單一時區

類型:字串

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

模式:^[a-zA-Z0-9\/\+\-\_]+$

UseGeolocationForTimeZone

無論TimeZone是從地理位置屬性自動派生。

類型:布林值

錯誤

InvalidInputException

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

HTTP 狀態碼:400

ResourceNotFoundException

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

HTTP 狀態碼:400

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: