本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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
-工作停止的時候 -
ACTIVE
或CREATE_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 的詳細資訊,請參閱下列內容: