Amazon Forecast は、新規顧客では利用できなくなりました。Amazon Forecast の既存のお客様は、通常どおりサービスを引き続き使用できます。詳細はこちら
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
DescribeDatasetImportJob
CreateDatasetImportJob オペレーションを使用して作成されたデータセットのインポートジョブについて説明します。
重要
Amazon Forecast は、新規のお客様は利用できなくなりました。Amazon Forecast の既存のお客様は、通常どおりサービスを引き続き使用できます。詳細はこちら
このオペレーションは、CreateDatasetImportJob
リクエストで提供されたパラメータの一覧表示に加えて、次のプロパティを含めます。
-
CreationTime
-
LastModificationTime
-
DataSize
-
FieldStatistics
-
Status
-
Message
- エラーが発生した場合は、エラーに関する情報。
リクエストの構文
{
"DatasetImportJobArn": "string
"
}
リクエストパラメータ
リクエストは、 JSON形式の次のデータを受け入れます。
- DatasetImportJobArn
-
データセットのインポートジョブの Amazon リソースネーム (ARN)。
型: 文字列
長さの制限:最大長は 256 です。
Pattern:
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
}
レスポンス要素
アクションが成功すると、サービスは 200 HTTP レスポンスを返します。
次のデータは、 サービスによって 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) ロール。
暗号化が使用されている場合、 には AWS Key Management Service (KMS) キー
DataSource
が含まれます。型: DataSource オブジェクト
- EstimatedTimeRemainingInMinutes
-
データセットのインポートジョブが完了するまでの推定残り時間 (分)。
型: 長整数
- FieldStatistics
-
入力データの各フィールドに関する統計情報。
タイプ: Statistics オブジェクトマップへの文字列です。
キーの長さの制限: 最大長は 256 です。
キーパターン:
^[a-zA-Z0-9\_]+$
- Format
-
インポートされたデータの形式、CSVまたはPARQUET。
型: 文字列
長さの制限: 最大長は 7 です。
パターン:
^CSV|PARQUET$
- GeolocationFormat
-
geolocation 属性の形式。有効な値:
"LAT_LONG"
および"CC_POSTALCODE"
。型: 文字列
長さの制限:最大長は 256 です。
パターン:
^[a-zA-Z0-9_]+$
- ImportMode
-
データセットのインポートジョブのインポートモード、 FULLまたは INCREMENTAL。
型: 文字列
有効な値:
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
以下の資料も参照してください。
言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。