Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # DescribeDatasetImportJob 描述使用 [CreateDatasetImportJob](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetImportJob.html) 操作建立的資料集匯入任務。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 除了列出`CreateDatasetImportJob`請求中提供的參數之外，此操作還包含下列屬性： + `CreationTime` + `LastModificationTime` + `DataSize` + `FieldStatistics` + `Status` + `Message` - 如果發生錯誤，請提供錯誤的相關資訊。 ## 請求語法 ``` { "DatasetImportJobArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [DatasetImportJobArn](#API_DescribeDatasetImportJob_RequestSyntax) ** 資料集匯入任務的 Amazon Resource Name (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](#API_DescribeDatasetImportJob_ResponseSyntax) ** 資料集匯入任務建立時。類型：Timestamp ** [DatasetArn](#API_DescribeDatasetImportJob_ResponseSyntax) ** 訓練資料匯入目的地之資料集的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [DatasetImportJobArn](#API_DescribeDatasetImportJob_ResponseSyntax) ** 資料集匯入任務的 ARN。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [DatasetImportJobName](#API_DescribeDatasetImportJob_ResponseSyntax) ** 資料集匯入任務的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` ** [DataSize](#API_DescribeDatasetImportJob_ResponseSyntax) ** 匯入任務完成後，資料集的大小，以 GB (GB) 為單位。類型：Double ** [DataSource](#API_DescribeDatasetImportJob_ResponseSyntax) ** 要匯入的訓練資料位置和 AWS Identity and Access Management (IAM) 角色，Amazon Forecast 可以擔任該角色來存取資料。如果使用加密， `DataSource`會包含 AWS Key Management Service (KMS) 金鑰。類型：[DataSource](API_DataSource.md) 物件 ** [EstimatedTimeRemainingInMinutes](#API_DescribeDatasetImportJob_ResponseSyntax) ** 資料集匯入任務的估計剩餘分鐘數。類型：Long ** [FieldStatistics](#API_DescribeDatasetImportJob_ResponseSyntax) ** 輸入資料中每個欄位的統計資訊。類型：字串到[Statistics](API_Statistics.md)物件映射金鑰長度限制：長度上限為 256。金鑰模式：`^[a-zA-Z0-9\_]+$` ** [Format](#API_DescribeDatasetImportJob_ResponseSyntax) ** 匯入資料的格式，CSV 或 PARQUET。類型：字串長度限制：長度上限為 7。模式：`^CSV|PARQUET$` ** [GeolocationFormat](#API_DescribeDatasetImportJob_ResponseSyntax) ** 地理位置屬性的格式。有效值：`"LAT_LONG"` 和 `"CC_POSTALCODE"`。類型：字串長度限制：長度上限為 256。模式：`^[a-zA-Z0-9_]+$` ** [ImportMode](#API_DescribeDatasetImportJob_ResponseSyntax) ** 資料集匯入任務的匯入模式，FULL 或 INCREMENTAL。類型：字串有效值:`FULL | INCREMENTAL` ** [LastModificationTime](#API_DescribeDatasetImportJob_ResponseSyntax) ** 上次修改資源的時間。時間戳記取決於任務的狀態： + `CREATE_PENDING` - `CreationTime`。 + `CREATE_IN_PROGRESS` - 目前的時間戳記。 + `CREATE_STOPPING` - 目前的時間戳記。 + `CREATE_STOPPED` - 任務停止時。 + `ACTIVE` 或 `CREATE_FAILED` - 任務完成或失敗時。類型：Timestamp ** [Message](#API_DescribeDatasetImportJob_ResponseSyntax) ** 如果發生錯誤，則會顯示有關錯誤的資訊訊息。類型：字串 ** [Status](#API_DescribeDatasetImportJob_ResponseSyntax) ** 資料集匯入任務的狀態。狀態包括： + `ACTIVE` + `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` + `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` + `CREATE_STOPPING`, `CREATE_STOPPED` 類型：字串長度限制：長度上限為 256。 ** [TimestampFormat](#API_DescribeDatasetImportJob_ResponseSyntax) ** 資料集中的時間戳記格式。您指定的格式取決於建立資料集時`DataFrequency`指定的。支援下列格式 + "yyyy-MM-dd" 對於下列資料頻率：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](#API_DescribeDatasetImportJob_ResponseSyntax) ** 套用至資料集中每個項目的單一時區類型：字串長度限制：長度上限為 256。模式：`^[a-zA-Z0-9\/\+\-\_]+$` ** [UseGeolocationForTimeZone](#API_DescribeDatasetImportJob_ResponseSyntax) ** `TimeZone` 是否自動衍生自地理位置屬性。類型：布林值 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DescribeDatasetImportJob) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribeDatasetImportJob) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeDatasetImportJob) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribeDatasetImportJob) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DescribeDatasetImportJob) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeDatasetImportJob) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DescribeDatasetImportJob) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribeDatasetImportJob) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribeDatasetImportJob) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeDatasetImportJob)