翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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
-
データセットのインポートジョブが作成された時点。
型: タイムスタンプ
- 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)。
型: 倍精度
- DataSource
-
インポートするトレーニングデータの場所と、Amazon Forecast がデータにアクセスするために引き受けることができる AWS Identity and Access Management (IAM) ロール。
暗号化を使用する場合は、
DataSourceに AWS Key Management Service (KMS) キーが含まれます。タイプ：DataSource オブジェクト
- EstimatedTimeRemainingInMinutes
-
データセットのインポートジョブが完了するまでの推定残り時間 (分)。
型: 長整数
- FieldStatistics
-
入力データの各フィールドに関する統計情報。
タイプ: Statistics オブジェクトマップへの文字列です。
キーの長さの制限: 最大長は 256 です。
キーパターン:
^[a-zA-Z0-9\_]+$ - Format
-
インポートされたデータの形式は CSV または PARQUETのいずれかです。
型: 文字列
長さの制限: 最大長は 7 です。
Pattern:
^CSV|PARQUET$ - GeolocationFormat
-
geolocation 属性の形式。有効な値:
"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- ジョブが終了または失敗した時点。
型: タイムスタンプ
-
- Message
-
エラーが発生した場合は、エラーに関する情報メッセージ。
型: 文字列
- Status
-
データセットのインポートジョブのステータス。含まれる状態は次のとおりです。
-
ACTIVE -
CREATE_PENDING,CREATE_IN_PROGRESS,CREATE_FAILED -
DELETE_PENDING,DELETE_IN_PROGRESS,DELETE_FAILED -
CREATE_STOPPING,CREATE_STOPPED
型: 文字列
長さの制限：最大長は 256 です。
-
- TimestampFormat
-
データセット内のタイムスタンプの形式。指定する形式は、データセットが作成されたときに指定された
DataFrequencyによって異なります。以下の形式がサポートされています-
「yyyy-MM-dd」
次のデータ周波数の場合: Y、M、W、D
-
「yyyy-MM-dd HH:mm:ss」
次のデータ頻度の場合: H、30min、15min、および 1min。オプションで、Y、M、W、および D
型: 文字列
長さの制限：最大長は 256 です。
パターン：
^[a-zA-Z0-9\-\:\.\,\'\s]+$ -
- TimeZone
-
データセット内のすべての項目に適用される単一のタイムゾーン
型: 文字列
長さの制限：最大長は 256 です。
パターン：
^[a-zA-Z0-9\/\+\-\_]+$ - UseGeolocationForTimeZone
-
TimeZoneが geolocation 属性から自動的に派生するかどうか。タイプ: ブール
エラー
- InvalidInputException
-
無効な値または有効な範囲を超える値が含まれているため、リクエストを処理できません。
HTTP ステータスコード：400
- ResourceNotFoundException
-
その Amazon リソースネーム (ARN) を持つリソースが見つかりません。ARN を確認して、もう一度お試しください。
HTTP ステータスコード：400
その他の参照資料
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
