リクエストの構文リクエストパラメータレスポンスの構文レスポンス要素エラー以下の資料も参照してください。

CreateExplainability

注記

Explainability は、 AutoPredictor （CreateAutoPredictor) から生成された Forecasts と Predictor でのみ使用できます。

Amazon Forecast Explainability を作成します。

重要

Amazon Forecast は、新規のお客様は利用できなくなりました。Amazon Forecast の既存のお客様は、通常どおりサービスを引き続き使用できます。詳細はこちら

Explainability は、データセットの属性が予測にどのように影響するかをよりよく理解するのに役立ちます。Amazon Forecast は、Impact スコアと呼ばれるメトリクスを使用して、各属性の相対的な影響を定量化し、それらが予測値を増加させるか減少させるかを決定します。

Forecast Explainability を有効にするには、関連する時系列、項目メタデータ、または祝祭日や Weather Index などの追加のデータセットの少なくとも 1 つを予測子に含める必要があります。

注記

ARIMA (AutoRegressive 積分移動平均）、 ETS (指数平滑状態空間モデル）、 NPTS (非パラメータ時系列) の各モデルには、外部時系列データは組み込まれていません。したがって、これらのモデルでは、追加のデータセットを含めても、説明可能性レポートは作成されません。

CreateExplainability は、予測子 ARNまたは予測のいずれかを受け入れますARN。データセット内のすべての時系列と時点について集計された Impact スコアを受け取るには、予測子を指定しますARN。特定の時系列と時間ポイントの Impact スコアを受け取るには、Forecast を指定しますARN。

CreateExplainability 予測子を使用する ARN

注記

予測子ごとに持つことができる Explainability リソースは 1 つだけです。CreateAutoPredictor で ExplainPredictor を既に有効にしている場合、その予測子には既に Explainability リソースがあります。

予測子を指定するときは、次のパラメータが必要ですARN。

ExplainabilityName - Explainability の一意の名前。
ResourceArn - 予測子の Arn。
TimePointGranularity - ALL「」に設定する必要があります。
TimeSeriesGranularity - ALL「」に設定する必要があります。

次のパラメータには値を指定しないでください。

DataSource - TimeSeriesGranularity がSPECIFIC「」の場合にのみ有効です。
Schema - TimeSeriesGranularity がSPECIFIC「」の場合にのみ有効です。
StartDateTime - TimePointGranularity がSPECIFIC「」の場合にのみ有効です。
EndDateTime - TimePointGranularity がSPECIFIC「」の場合にのみ有効です。

CreateExplainability Forecast を使用する ARN

注記

最大 50 の時系列と 500 の時間ポイントを指定できます。

予測子を指定するときは、次のパラメータが必要ですARN。

ExplainabilityName - Explainability の一意の名前。
ResourceArn - 予測の Arn。
TimePointGranularity - ALL「」またはSPECIFIC「」のいずれか。
TimeSeriesGranularity - ALL「」またはSPECIFIC「」のいずれか。

TimeSeriesGranularity をSPECIFIC「」に設定する場合は、以下も指定する必要があります。

DataSource - 時系列を指定するCSVファイルの S3 の場所。
Schema - スキーマは、データソースにリストされている属性と属性タイプを定義します。

TimePointGranularity をSPECIFIC「」に設定する場合は、以下も指定する必要があります。

StartDateTime - 時間ポイントの範囲の最初のタイムスタンプ。
EndDateTime - 時間ポイントの範囲の最後のタイムスタンプ。

リクエストの構文


{
   "DataSource": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "EnableVisualization": boolean,
   "EndDateTime": "string",
   "ExplainabilityConfig": { 
      "TimePointGranularity": "string",
      "TimeSeriesGranularity": "string"
   },
   "ExplainabilityName": "string",
   "ResourceArn": "string",
   "Schema": { 
      "Attributes": [ 
         { 
            "AttributeName": "string",
            "AttributeType": "string"
         }
      ]
   },
   "StartDateTime": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

リクエストパラメータ

リクエストは、 JSON形式の次のデータを受け入れます。

DataSource

データのソース、Amazon Forecast がデータにアクセスできるようにする AWS Identity and Access Management （IAM) ロール、およびオプションで AWS Key Management Service （KMS) キー。

型: DataSource オブジェクト

必須：いいえ

EnableVisualization

AWS コンソール内で表示可能な Explainability ビジュアライゼーションを作成します。

型: ブール値

必須：いいえ

EndDateTime

TimePointGranularity が SPECIFIC に設定されている場合、Explainability の最後の時間ポイントを定義します。

次のタイムスタンプ形式を使用します: yyyy-MM-dd THH:mm:ss (例: 2015-01-01T200:00)

型: 文字列

長さの制限: 最大長は 19。

パターン: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$

必須: いいえ

ExplainabilityConfig

Explainability の時系列と時間ポイントの粒度を定義する構成設定。

型: ExplainabilityConfig オブジェクト

必須：はい

ExplainabilityName

Explainability の一意の名前。

型: 文字列

長さの制限：最小長は 1 です。最大長は 63 です。

Pattern: ^[a-zA-Z][a-zA-Z0-9_]*

必須：はい

ResourceArn

Explainability の作成に使用される Predictor または Forecast の Amazon リソースネーム (ARN）。

型: 文字列

長さの制限：最大長は 256 です。

Pattern: arn:([a-z\d-]+):forecast:.*:.*:.+

必須：はい

Schema

データセットのフィールドを定義します。

型: Schema オブジェクト

必須：いいえ

StartDateTime

TimePointGranularity が SPECIFIC に設定されている場合、Explainability の最初のポイントを定義します。

次のタイムスタンプ形式を使用します: yyyy-MM-dd THH:mm:ss (例: 2015-01-01T200:00)

型: 文字列

長さの制限: 最大長は 19。

パターン: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$

必須: いいえ

Tags

リソースの分類と整理に役立つオプションのメタデータ。タグはそれぞれ、1 つのキーとオプションの 1 つの値で設定されており、どちらもお客様側が定義します。タグのキーと値では、大文字と小文字が区別されます。

タグには以下の制限があります。

タグキーは、リソースごとにそれぞれ一意である必要があります。また、各タグキーに設定できる値は 1 つのみです。
リソースあたりのタグの最大数: 50。
キーの最大長: UTF-8 で 128 Unicode 文字。
値の最大長: UTF-8 で 256 文字の Unicode 文字。
使用できる文字: すべての文字と数字、UTF-8 で表されるスペース、+ - = 。_ : / @。タグ付けスキーマが他のサービスやリソースで使用されている場合、それらのサービスの文字制限も適用されます。
キープレフィックスには、aws: または AWS: の大文字または小文字の組み合わせを含めることはできません。値にはこのプレフィックスを付けることができます。タグ値には aws がプレフィックスとして付されているが、キーには付されていない場合、Forecast は、それをユーザータグとみなし、タグ数の上限である 50 個を計算する際に算入します。aws のキープレフィックスのみを持つタグは、リソース制限あたりのタグに算入されません。このプレフィックスが含まれるタグキーを編集したり削除することはできません。

型: Tag オブジェクトの配列

配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。

必須：いいえ

レスポンスの構文


{
   "ExplainabilityArn": "string"
}

レスポンス要素

アクションが成功すると、サービスは 200 HTTP レスポンスを返します。

次のデータは、サービスによって JSON 形式で返されます。

ExplainabilityArn

Explainability の Amazon リソースネーム (ARN）。

型: 文字列

長さの制限：最大長は 256 です。

パターン: arn:([a-z\d-]+):forecast:.*:.*:.+

エラー

InvalidInputException

無効な値または有効な範囲を超える値が含まれているため、リクエストを処理できません。

HTTP ステータスコード: 400

LimitExceededException

アカウントあたりのリソース数の制限を超えました。

HTTP ステータスコード: 400

ResourceAlreadyExistsException

この名前のリソースは既に存在します。別の名前で再試行してください。

HTTP ステータスコード: 400

ResourceInUseException

指定されたリソースは使用中です。

HTTP ステータスコード: 400

ResourceNotFoundException

Amazon リソースネーム () を持つリソースが見つかりませんARN。を確認してARN、もう一度試してください。

HTTP ステータスコード: 400

以下の資料も参照してください。

言語固有ののいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

CreateDatasetImportJob

CreateExplainabilityExport