Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。進一步了解"
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CreateExplainability
注意
無法解釋僅適用於從 () 產生的預測和預測值 AutoPredictor CreateAutoPredictor
創建一個 Amazon Forecast 解釋。
重要
Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用該服務。了解更多」
解釋功能可幫助您更好地了解數據集中的屬性如何影響預測。Amazon Forecast 使用稱為「影響分數」的指標來量化每個屬性的相對影響，並判斷它們是否增加或減少預測值。
若要啟用 Forecast 解釋功能，您的預測值必須至少包含下列其中一項：相關時間序列、項目中繼資料或其他資料集，例如假日和天氣索引。
注意
ARIMA(AutoRegressive 整合移動平均線)、ETS (指數平滑狀態空間模型) 和 NPTS (非參數式時間序列) 模型不包含外部時間序列資料。因此，即使您包含額外的資料集，這些模型也不會建立無法解釋的報表。
CreateExplainability 接受「Forecast 值」ARN 或「預測」。ARN若要接收資料集中所有時間序列和時間點的彙總影響分數，請提供預測值ARN。若要接收特定時間序列和時間點的影響分數，請提供「Forecast」ARN。
CreateExplainability 使用預測值 ARN
注意
每個預測器只能有一個可解釋性資源。如果您已ExplainPredictor在中啟用CreateAutoPredictor，則該預測器已具有可解釋性資源。
提供預測值ARN時需要下列參數：
-
ExplainabilityName-解釋功能的唯一名稱。 -
ResourceArn-預測器的阿恩 -
TimePointGranularity-必須設定為「ALL」。 -
TimeSeriesGranularity-必須設定為「ALL」。
請勿為下列參數指定值：
-
DataSource-僅在 TimeSeriesGranularity 為「SPECIFIC」時有效。 -
Schema-僅在 TimeSeriesGranularity 為「SPECIFIC」時有效。 -
StartDateTime-僅在 TimePointGranularity 為「SPECIFIC」時有效。 -
EndDateTime-僅在 TimePointGranularity 為「SPECIFIC」時有效。
CreateExplainability 與 Forecast ARN
注意
您最多可以指定 50 個時間序列和 500 個時間點。
提供預測值ARN時需要下列參數：
-
ExplainabilityName-解釋功能的唯一名稱。 -
ResourceArn-預測的阿恩。 -
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 主控台中檢視的「解釋性」視覺效果。
類型：布林值
必要：否
- EndDateTime
-
如果
TimePointGranularity設定為SPECIFIC，則定義「無法解釋」的最後一個時間點。使用下列時間戳記格式：年-月-日:公釐:SS (例如：2015-01-01T20: THH 00:00)
類型：字串
長度限制：最大長度為 19。
模式：
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$必要：否
- ExplainabilityConfig
-
定義「解釋功能」之時間序列和時間點精細度的組態設定。
類型：ExplainabilityConfig 物件
必要：是
- ExplainabilityName
-
解釋的唯一名稱。
類型：字串
長度限制：長度下限為 1。長度上限為 63。
模式：
^[a-zA-Z][a-zA-Z0-9_]*必要：是
- ResourceArn
-
用於創建解釋的 Forecast 或預測的 Amazon 資源名稱（ARN）。
類型：字串
長度限制：長度上限為 256。
模式：
arn:([a-z\d-]+):forecast:.*:.*:.+必要：是
- Schema
-
定義資料集的欄位。
類型：Schema 物件
必要：否
- StartDateTime
-
如果
TimePointGranularity設定為SPECIFIC，則定義「解釋性」的第一點。使用下列時間戳記格式：年-月-日:公釐:SS (例如：2015-01-01T20: THH 00:00)
類型：字串
長度限制：最大長度為 19。
模式：
^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$必要：否
- Tags
-
選用的中繼資料可協助您分類和組織資源。每個標籤皆包含由您定義的一個金鑰與一個選用值。標籤鍵與值皆區分大小寫。
以下限制適用於標籤：
-
對於每個資源，每個標籤鍵必須是唯一的，並且每個標籤鍵必須有一個值。
-
每個資源的標籤數上限：50。
-
最大金鑰長度：128 個萬國碼字元 UTF -8。
-
最大值長度：UTF-8 中 256 個萬國碼字元。
-
接受的字元：所有字母和數字、UTF -8 中可表示的空格，以及 +-=。_：/@。 如果您的標記結構描述在其他服務和資源之間使用，則這些服務的字元限制也適用。
-
關鍵字首碼不能包含或的任何大寫或小寫組
aws:合。AWS:值可以有這個前綴。如果標籤值aws作為其前綴，但鍵沒有，則 Forecast 將其視為使用者標籤，並將計入 50 個標籤的限制。只有 key prefix 的標籤aws不會計入每個資源限制的標籤。您無法使用此字首編輯或刪除標籤關鍵字。
類型：Tag 物件陣列
陣列成員：項目數下限為 0。項目數上限為 200。
必要：否
-
回應語法
{
"ExplainabilityArn": "string"
}回應元素
如果動作成功，服務會傳回 HTTP 200 回應。
服務會以JSON格式傳回下列資料。
- ExplainabilityArn
-
Amazon 資源名稱（ARN）的解釋性。
類型：字串
長度限制：長度上限為 256。
模式：
arn:([a-z\d-]+):forecast:.*:.*:.+
錯誤
- InvalidInputException
-
我們無法處理要求，因為它包含無效值或超出有效範圍的值。
HTTP狀態碼:
- LimitExceededException
-
已超過每個帳號的資源數量限制。
HTTP狀態碼:
- ResourceAlreadyExistsException
-
已有此名稱的資源。請使用不同的名稱再試一次。
HTTP狀態碼:
- ResourceInUseException
-
指定的資源正在使用中。
HTTP狀態碼:
- ResourceNotFoundException
-
我們找不到具有該 Amazon 資源名稱（ARN）的資源。檢查ARN並再試一次。
HTTP狀態碼:
另請參閱
如需有關API在其中一種特定語言中使用此功能的詳細資訊 AWS SDKs，請參閱下列內容：
