DescribeDatasetImportJob - Amazon Forecast

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、以下を参照してください。