Amazon Forecast は新規顧客には利用できなくなりました。Amazon Forecast の既存のお客様は、通常どおりサービスを引き続き使用できます。[詳細はこちら](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # CreateExplainability **注記** Explainability は、AutoPredictor ([CreateAutoPredictor](API_CreateAutoPredictor.md)) から生成された予測および予測子でのみ使用できます Amazon Forecast Explainability を作成します。 **重要** Amazon Forecast は新規顧客には利用できなくなりました。Amazon Forecast の既存のお客様は、通常どおりサービスを引き続き使用できます。[詳細はこちら](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) Explainability は、データセットの属性が予測にどのように影響するかをよりよく理解するのに役立ちます。Amazon Forecast は、Impact スコアと呼ばれるメトリクスを使用して、各属性の相対的な影響を定量化し、それらが予測値を増加させるか減少させるかを決定します。 Forecast Explainability を有効にするには、関連する時系列、項目メタデータ、または祝祭日や Weather Index などの追加のデータセットの少なくとも 1 つを予測子に含める必要があります。 **注記** ARIMA (AutoRegressive Integrated Moving Average)、ETS (Exponential Smoothing State Space Model)、および NPTS (Non-Parametric Time Series) モデルには、外部時系列データは組み込まれていません。したがって、これらのモデルは、追加のデータセットを含めていても、説明可能性レポートを作成しません。 CreateExplainability は、Predictor ARN または Forecast ARN のいずれかを受け入れます。データセット内のすべての時系列と時間ポイントの集計された Impact スコアを受け取るには、予測子 ARN を入力します。特定の時系列および時間ポイントの Impact スコアを受け取るには、予測 ARN を入力します。 **予測子 ARN を使用した CreateExplainability** **注記** 予測子ごとに持つことができる Explainability リソースは 1 つだけです。[CreateAutoPredictor](API_CreateAutoPredictor.md) で `ExplainPredictor` を既に有効にしている場合、その予測子には既に Explainability リソースがあります。 Predictor ARN を入力する場合は、次のパラメータが必要です。 + `ExplainabilityName` - Explainability の一意の名前。 + `ResourceArn` - 予測子の Arn。 + `TimePointGranularity` - 「ALL」に設定する必要があります。 + `TimeSeriesGranularity` - 「ALL」に設定する必要があります。 次のパラメータには値を指定しないでください。 + `DataSource` - TimeSeriesGranularity が [SPECIFIC] の場合にのみ有効です。 + `Schema` - TimeSeriesGranularity が [SPECIFIC] の場合にのみ有効です。 + `StartDateTime` - TimePointGranularity が [SPECIFIC] の場合にのみ有効です。 + `EndDateTime` - TimePointGranularity が [SPECIFIC] の場合にのみ有効です。 **Forecast ARN を持つ CreateExplainability** **注記** 最大 50 の時系列と 500 の時間ポイントを指定できます。 Predictor 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](#API_CreateExplainability_RequestSyntax) ** データのソース、Amazon Forecast がデータにアクセスできるようにする AWS Identity and Access Management (IAM) ロール、およびオプションで AWS Key Management Service (KMS) キー。 型: [DataSource](API_DataSource.md) オブジェクト 必須: いいえ ** [EnableVisualization](#API_CreateExplainability_RequestSyntax) ** AWS コンソール内で表示可能な Explainability ビジュアライゼーションを作成します。 タイプ: ブール値 必須: いいえ ** [EndDateTime](#API_CreateExplainability_RequestSyntax) ** `TimePointGranularity` が `SPECIFIC` に設定されている場合、Explainability の最後の時間ポイントを定義します。 次のタイムスタンプ形式を使用します: yyyy-MM-ddTHH:mm:ss (例: 2015-01-01T20:00:00) タイプ: 文字列 長さの制限: 最大長は 19。 パターン: `^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$` 必須: いいえ ** [ExplainabilityConfig](#API_CreateExplainability_RequestSyntax) ** Explainability の時系列と時間ポイントの粒度を定義する構成設定。 型: [ExplainabilityConfig](API_ExplainabilityConfig.md) オブジェクト 必須: はい ** [ExplainabilityName](#API_CreateExplainability_RequestSyntax) ** Explainability の一意の名前。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 63 です。 パターン: `^[a-zA-Z][a-zA-Z0-9_]*` 必須: はい ** [ResourceArn](#API_CreateExplainability_RequestSyntax) ** Explainability の作成に使用される予測子または予測の Amazon リソースネーム (ARN)。 タイプ: 文字列 長さの制約: 最大長は 256 です。 パターン: `arn:([a-z\d-]+):forecast:.*:.*:.+` 必須: はい ** [Schema](#API_CreateExplainability_RequestSyntax) ** データセットのフィールドを定義します。 型: [Schema](API_Schema.md) オブジェクト 必須: いいえ ** [StartDateTime](#API_CreateExplainability_RequestSyntax) ** `TimePointGranularity` が `SPECIFIC` に設定されている場合、Explainability の最初のポイントを定義します。 次のタイムスタンプ形式を使用します: yyyy-MM-ddTHH:mm:ss (例: 2015-01-01T20:00:00) タイプ: 文字列 長さの制限: 最大長は 19。 パターン: `^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$` 必須: いいえ ** [Tags](#API_CreateExplainability_RequestSyntax) ** リソースの分類と整理に役立つオプションのメタデータ。各タグはキーとオプションの値で構成され、どちらもお客様側が定義します。タグのキーと値では、大文字と小文字が区別されます。 タグには以下の制限があります。 + タグキーは、リソースごとにそれぞれ一意である必要があります。また、各タグキーに設定できる値は 1 つのみです。 + リソースあたりのタグの最大数: 50。 + キーの最大長 128 文字 (Unicode) (UTF-8)。 + 値の最大長: 256 文字 (Unicode) (UTF-8)。 + 使用可能な文字: すべての文字と数字、UTF-8 で表現可能なスペース、および \$1 - = 。\$1 : / @。タグ付けスキーマが他のサービスやリソースで使用されている場合、それらのサービスの文字制限も適用されます。 + キープレフィックスには、`aws:` または `AWS:` の大文字または小文字の組み合わせを含めることはできません。値にはこのプレフィックスを付けることができます。タグ値には `aws` がプレフィックスとして付されているが、キーには付されていない場合、Forecast は、それをユーザータグとみなし、タグ数の上限である 50 個を計算する際に算入します。`aws` のキープレフィックスのみを持つタグは、リソース制限あたりのタグに算入されません。このプレフィックスが含まれるタグキーを編集したり削除することはできません。 型: [Tag](API_Tag.md) オブジェクトの配列 配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。 必須: いいえ ## レスポンスの構文 ``` { "ExplainabilityArn": "string" } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [ExplainabilityArn](#API_CreateExplainability_ResponseSyntax) ** 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 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateExplainability) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateExplainability) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateExplainability) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateExplainability) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateExplainability) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateExplainability) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateExplainability) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateExplainability) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateExplainability) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateExplainability)