Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # Amazon Forecast Service Amazon Forecast Service 支援下列動作： + [CreateAutoPredictor](API_CreateAutoPredictor.md) + [CreateDataset](API_CreateDataset.md) + [CreateDatasetGroup](API_CreateDatasetGroup.md) + [CreateDatasetImportJob](API_CreateDatasetImportJob.md) + [CreateExplainability](API_CreateExplainability.md) + [CreateExplainabilityExport](API_CreateExplainabilityExport.md) + [CreateForecast](API_CreateForecast.md) + [CreateForecastExportJob](API_CreateForecastExportJob.md) + [CreateMonitor](API_CreateMonitor.md) + [CreatePredictor](API_CreatePredictor.md) + [CreatePredictorBacktestExportJob](API_CreatePredictorBacktestExportJob.md) + [CreateWhatIfAnalysis](API_CreateWhatIfAnalysis.md) + [CreateWhatIfForecast](API_CreateWhatIfForecast.md) + [CreateWhatIfForecastExport](API_CreateWhatIfForecastExport.md) + [DeleteDataset](API_DeleteDataset.md) + [DeleteDatasetGroup](API_DeleteDatasetGroup.md) + [DeleteDatasetImportJob](API_DeleteDatasetImportJob.md) + [DeleteExplainability](API_DeleteExplainability.md) + [DeleteExplainabilityExport](API_DeleteExplainabilityExport.md) + [DeleteForecast](API_DeleteForecast.md) + [DeleteForecastExportJob](API_DeleteForecastExportJob.md) + [DeleteMonitor](API_DeleteMonitor.md) + [DeletePredictor](API_DeletePredictor.md) + [DeletePredictorBacktestExportJob](API_DeletePredictorBacktestExportJob.md) + [DeleteResourceTree](API_DeleteResourceTree.md) + [DeleteWhatIfAnalysis](API_DeleteWhatIfAnalysis.md) + [DeleteWhatIfForecast](API_DeleteWhatIfForecast.md) + [DeleteWhatIfForecastExport](API_DeleteWhatIfForecastExport.md) + [DescribeAutoPredictor](API_DescribeAutoPredictor.md) + [DescribeDataset](API_DescribeDataset.md) + [DescribeDatasetGroup](API_DescribeDatasetGroup.md) + [DescribeDatasetImportJob](API_DescribeDatasetImportJob.md) + [DescribeExplainability](API_DescribeExplainability.md) + [DescribeExplainabilityExport](API_DescribeExplainabilityExport.md) + [DescribeForecast](API_DescribeForecast.md) + [DescribeForecastExportJob](API_DescribeForecastExportJob.md) + [DescribeMonitor](API_DescribeMonitor.md) + [DescribePredictor](API_DescribePredictor.md) + [DescribePredictorBacktestExportJob](API_DescribePredictorBacktestExportJob.md) + [DescribeWhatIfAnalysis](API_DescribeWhatIfAnalysis.md) + [DescribeWhatIfForecast](API_DescribeWhatIfForecast.md) + [DescribeWhatIfForecastExport](API_DescribeWhatIfForecastExport.md) + [GetAccuracyMetrics](API_GetAccuracyMetrics.md) + [ListDatasetGroups](API_ListDatasetGroups.md) + [ListDatasetImportJobs](API_ListDatasetImportJobs.md) + [ListDatasets](API_ListDatasets.md) + [ListExplainabilities](API_ListExplainabilities.md) + [ListExplainabilityExports](API_ListExplainabilityExports.md) + [ListForecastExportJobs](API_ListForecastExportJobs.md) + [ListForecasts](API_ListForecasts.md) + [ListMonitorEvaluations](API_ListMonitorEvaluations.md) + [ListMonitors](API_ListMonitors.md) + [ListPredictorBacktestExportJobs](API_ListPredictorBacktestExportJobs.md) + [ListPredictors](API_ListPredictors.md) + [ListTagsForResource](API_ListTagsForResource.md) + [ListWhatIfAnalyses](API_ListWhatIfAnalyses.md) + [ListWhatIfForecastExports](API_ListWhatIfForecastExports.md) + [ListWhatIfForecasts](API_ListWhatIfForecasts.md) + [ResumeResource](API_ResumeResource.md) + [StopResource](API_StopResource.md) + [TagResource](API_TagResource.md) + [UntagResource](API_UntagResource.md) + [UpdateDatasetGroup](API_UpdateDatasetGroup.md) # CreateAutoPredictor 建立 Amazon Forecast 預測器。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) Amazon Forecast 會使用 AutoPredictor 建立預測器，這涉及將演算法的最佳組合套用至資料集中的每個時間序列。您可以使用 [CreateAutoPredictor](#API_CreateAutoPredictor)建立新的預測器或升級/重新訓練現有的預測器。 **建立新的預測器** 建立新預測器時需要下列參數： + `PredictorName` - 預測器的唯一名稱。 + `DatasetGroupArn` - 用來訓練預測器之資料集群組的 ARN。 + `ForecastFrequency` - 預測的精細程度（每小時、每日、每週等）。 + `ForecastHorizon` - 模型預測的時間步驟數目。預測期間也稱為預測長度。建立新的預測器時，請勿指定的值`ReferencePredictorArn`。 **升級和重新訓練預測器** 重新訓練或升級預測器時，需要下列參數： + `PredictorName` - 預測器的唯一名稱。 + `ReferencePredictorArn` - 要重新訓練或升級之預測器的 ARN。升級或重新訓練預測器時，請僅指定 `ReferencePredictorArn`和的值`PredictorName`。 ## 請求語法 ``` { "DataConfig": { "AdditionalDatasets": [ { "Configuration": { "string" : [ "string" ] }, "Name": "string" } ], "AttributeConfigs": [ { "AttributeName": "string", "Transformations": { "string" : "string" } } ], "DatasetGroupArn": "string" }, "EncryptionConfig": { "KMSKeyArn": "string", "RoleArn": "string" }, "ExplainPredictor": boolean, "ForecastDimensions": [ "string" ], "ForecastFrequency": "string", "ForecastHorizon": number, "ForecastTypes": [ "string" ], "MonitorConfig": { "MonitorName": "string" }, "OptimizationMetric": "string", "PredictorName": "string", "ReferencePredictorArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "TimeAlignmentBoundary": { "DayOfMonth": number, "DayOfWeek": "string", "Hour": number, "Month": "string" } } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [DataConfig](#API_CreateAutoPredictor_RequestSyntax) ** 資料集群組和任何其他資料集的資料組態。類型：[DataConfig](API_DataConfig.md) 物件必要：否 ** [EncryptionConfig](#API_CreateAutoPredictor_RequestSyntax) ** Amazon Forecast 可以擔任的 AWS Key Management Service (KMS) 金鑰和 AWS Identity and Access Management (IAM) 角色，以存取金鑰。您可以在 [CreateDataset](API_CreateDataset.md)和 [CreatePredictor](API_CreatePredictor.md)請求中指定此選用物件。類型：[EncryptionConfig](API_EncryptionConfig.md) 物件必要：否 ** [ExplainPredictor](#API_CreateAutoPredictor_RequestSyntax) ** 為預測器建立可解釋性資源。類型：布林值必要：否 ** [ForecastDimensions](#API_CreateAutoPredictor_RequestSyntax) ** 維度（欄位）名稱陣列，指定如何將產生的預測分組。例如，如果您要在所有商店中產生項目銷售的預測，且資料集包含 `store_id` 欄位，則您可以指定 `store_id`做為維度，以將每個商店的銷售預測分組。類型：字串陣列陣列成員：項目數下限為 1。項目數上限為 10。長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` 必要：否 ** [ForecastFrequency](#API_CreateAutoPredictor_RequestSyntax) ** 預測中的預測頻率。有效間隔為整數，後跟 Y (年)、M (月)、W (週)、D (天)、H (小時) 和 min (分鐘)。例如，"1D" 表示每隔一天，"15min" 表示每隔 15 分鐘。您無法指定會與下一個較大頻率重疊的值。例如，這意味著您不能指定頻率為 60 分鐘，因為這相當於 1 小時。每個頻率的有效值如下： + 分鐘–1-59 + 小時–1-23 + 天–1-6 + 週–1-4 + 月–1-11 + 年 – 1 因此，如果您希望每兩週預測一次，請指定 "2W"。或者，如果您希望每季度預測一次，請指定 "3M"。頻率必須大於或等於 TARGET\$1TIME\$1SERIES 資料集頻率。提供 RELATED\$1TIME\$1SERIES 資料集時，頻率必須等於 RELATED\$1TIME\$1SERIES 資料集頻率。類型：字串長度限制：長度下限為 1。長度上限為 5。模式：`^Y|M|W|D|H|30min|15min|10min|5min|1min$` 必要：否 ** [ForecastHorizon](#API_CreateAutoPredictor_RequestSyntax) ** 模型預測的時間步驟數目。預測期間也稱為預測長度。最大預測期間是 500 個時間步驟或 TARGET\$1TIME\$1SERIES 資料集長度的 1/4。如果您要重新訓練現有的 AutoPredictor，則最大預測期間為 500 個時間步驟或 TARGET\$1TIME\$1SERIES 資料集長度的 1/3。如果您要升級至 AutoPredictor 或重新訓練現有的 AutoPredictor，則無法更新預測期間參數。您可以在資料集中提供較長的時間序列，以滿足此要求。類型：整數必要：否 ** [ForecastTypes](#API_CreateAutoPredictor_RequestSyntax) ** 用來訓練預測器的預測類型。您最多可以指定五種預測類型。預測類型可以是 0.01 到 0.99 之間的分位數，增量單位為 0.01 或更高。您也可以使用指定平均預測`mean`。類型：字串陣列陣列成員：項目數下限為 1。項目數上限為 20。長度限制：長度下限為 2。長度上限為 4。模式：`(^0?\.\d\d?$|^mean$)` 必要：否 ** [MonitorConfig](#API_CreateAutoPredictor_RequestSyntax) ** 預測器監控的組態詳細資訊。提供監視器資源的名稱，以啟用預測器監控。預測器監控可讓您查看預測器的效能如何隨時間變化。如需詳細資訊，請參閱[預測器監控](https://docs.aws.amazon.com/forecast/latest/dg/predictor-monitoring.html)。類型：[MonitorConfig](API_MonitorConfig.md) 物件必要：否 ** [OptimizationMetric](#API_CreateAutoPredictor_RequestSyntax) ** 用於最佳化預測器的準確度指標。類型：字串有效值:`WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE` 必要：否 ** [PredictorName](#API_CreateAutoPredictor_RequestSyntax) ** 預測器的唯一名稱類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` 必要：是 ** [ReferencePredictorArn](#API_CreateAutoPredictor_RequestSyntax) ** 要重新訓練或升級之預測器的 ARN。只有在重新訓練或升級預測器時，才會使用此參數。建立新的預測器時，請勿為此參數指定值。升級或重新訓練預測器時，請僅指定 `ReferencePredictorArn`和的值`PredictorName`。的值`PredictorName`必須是唯一的預測器名稱。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：否 ** [Tags](#API_CreateAutoPredictor_RequestSyntax) ** 選用中繼資料，可協助您分類和整理預測器。每個標籤皆包含由您定義的一個金鑰與一個選用值。標籤鍵與值皆區分大小寫。以下限制適用於標籤： + 對於每個資源，每個標籤索引鍵必須是唯一的，而且每個標籤索引鍵都必須有一個值。 + 每個資源的標籤數量上限：50。 + 金鑰長度上限：UTF-8 128 個 Unicode 字元。 + 最大值長度：UTF-8 256 個 Unicode 字元。 + 接受的字元：所有字母和數字、以 UTF-8 表示的空格，以及 \$1 - = 。\$1 ：/ @。如果您的標記結構描述用於其他服務和資源，則這些服務的角色限制也適用。 + 金鑰字首不能包含或的任何大寫`aws:`或小寫組合`AWS:`。值可以有此字首。如果標籤值具有 `aws` 作為其字首，但索引鍵沒有，則預測會將其視為使用者標籤，並計入 50 個標籤的限制。只有金鑰字首的標籤`aws`不會計入每個資源限制的標籤。您無法使用此字首編輯或刪除標籤索引鍵。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：否 ** [TimeAlignmentBoundary](#API_CreateAutoPredictor_RequestSyntax) ** 時間界限 Forecast 使用來對齊和彙總任何不符合預測頻率的資料。以鍵值對形式提供時間和時間界限的單位。如需指定時間界限的詳細資訊，請參閱[指定時間界限](https://docs.aws.amazon.com/forecast/latest/dg/data-aggregation.html#specifying-time-boundary)。如果您未提供時間界限，預測會使用一組[預設時間界限](https://docs.aws.amazon.com/forecast/latest/dg/data-aggregation.html#default-time-boundaries)。類型：[TimeAlignmentBoundary](API_TimeAlignmentBoundary.md) 物件必要：否 ## 回應語法 ``` { "PredictorArn": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [PredictorArn](#API_CreateAutoPredictor_ResponseSyntax) ** 預測器的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceAlreadyExistsException ** 已有具有此名稱的資源。請用不同的名稱再試一次。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateAutoPredictor) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateAutoPredictor) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateAutoPredictor) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateAutoPredictor) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateAutoPredictor) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateAutoPredictor) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateAutoPredictor) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateAutoPredictor) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateAutoPredictor) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateAutoPredictor) # CreateDataset 建立 Amazon Forecast 資料集。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 您提供的資料集相關資訊有助於 Forecast 了解如何使用資料進行模型訓練。這包含下列項目： + * `DataFrequency` * – 收集歷史時間序列資料的頻率。 + * `Domain` * 和 * `DatasetType` * – 每個資料集都有網域內相關聯的資料集網域和類型。Amazon Forecast 提供每個網域內預先定義的網域和類型的清單。針對網域內每個唯一的資料集網域和類型，Amazon Forecast 要求資料包含最基本的一組預先定義欄位。 + * `Schema` * – 結構描述指定資料集中的欄位，包括欄位名稱和資料類型。建立資料集之後，您將訓練資料匯入至其中並將資料集新增至資料集群組。您可以使用資料集群組來建立預測器。如需詳細資訊，請參閱[匯入資料集](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html)。若要取得您所有資料集的清單，請使用 [ListDatasets](https://docs.aws.amazon.com/forecast/latest/dg/API_ListDatasets.html) 操作。如需 Forecast 資料集範例，請參閱 [Amazon Forecast 範例 GitHub 儲存庫](https://github.com/aws-samples/amazon-forecast-samples)。 **注意** 資料集 `Status` 的必須是 `ACTIVE`，然後您才能匯入訓練資料。若要取得狀態，請使用 [DescribeDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDataset.html) 操作。 ## 請求語法 ``` { "DataFrequency": "string", "DatasetName": "string", "DatasetType": "string", "Domain": "string", "EncryptionConfig": { "KMSKeyArn": "string", "RoleArn": "string" }, "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] }, "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [DataFrequency](#API_CreateDataset_RequestSyntax) ** 資料收集的頻率。RELATED\$1TIME\$1SERIES 資料集需要此參數。有效間隔為整數，後跟 Y (年)、M (月)、W (週)、D (天)、H (小時) 和 min (分鐘)。例如，"1D" 表示每隔一天，"15min" 表示每隔 15 分鐘。您無法指定會與下一個較大頻率重疊的值。例如，這意味著您不能指定頻率為 60 分鐘，因為這相當於 1 小時。每個頻率的有效值如下： + 分鐘–1-59 + 小時–1-23 + 天–1-6 + 週–1-4 + 月–1-11 + 年 – 1 因此，如果您希望每兩週預測一次，請指定 "2W"。或者，如果您希望每季度預測一次，請指定 "3M"。類型：字串長度限制：長度下限為 1。長度上限為 5。模式：`^Y|M|W|D|H|30min|15min|10min|5min|1min$` 必要：否 ** [DatasetName](#API_CreateDataset_RequestSyntax) ** 資料集的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` 必要：是 ** [DatasetType](#API_CreateDataset_RequestSyntax) ** 資料集類型。有效值取決於選擇的 `Domain`。類型：字串有效值:`TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA` 必要：是 ** [Domain](#API_CreateDataset_RequestSyntax) ** 與資料集相關聯的網域。當您將資料集新增至資料集群組時，此值和為 [CreateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetGroup.html) 操作的 `Domain` 參數指定的值必須相符。 `DatasetType` 您選擇的 `Domain`和會決定您匯入資料集的訓練資料中必須存在的欄位。例如，如果您選擇`RETAIL`網域和 `TARGET_TIME_SERIES`作為 `DatasetType`，Amazon Forecast 需要 `item_id`、 `timestamp`和 `demand` 欄位存在於您的資料中。如需詳細資訊，請參閱[匯入資料集](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html)。類型：字串有效值:`RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS` 必要：是 ** [EncryptionConfig](#API_CreateDataset_RequestSyntax) ** Amazon Forecast 可以擔任的 AWS Key Management Service (KMS) 金鑰和 AWS Identity and Access Management (IAM) 角色來存取金鑰。類型：[EncryptionConfig](API_EncryptionConfig.md) 物件必要：否 ** [Schema](#API_CreateDataset_RequestSyntax) ** 資料集的結構描述。結構描述屬性及其順序必須與資料中的欄位相符。您所選的資料集 `Domain` 和 `DatasetType` 決定了訓練資料中最基本的必要欄位。如需有關特定資料集網域和類型的必要欄位的資訊，請參閱[資料集網域和資料集類型](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-domains-ds-types.html)。類型：[Schema](API_Schema.md) 物件必要：是 ** [Tags](#API_CreateDataset_RequestSyntax) ** 您套用至資料集的選用中繼資料，可協助您分類和組織這些中繼資料。每個標籤皆包含由您定義的一個金鑰與一個選用值。以下基本限制適用於標籤： + 每個資源的標籤數量上限 - 50。 + 針對每一個資源，每個標籤鍵必須是唯一的，且每個標籤鍵只能有一個值。 + 金鑰長度上限 - UTF-8 中的 128 個 Unicode 字元。 + 最大值長度 - UTF-8 256 個 Unicode 字元。 + 如果您的標記結構描述是跨多項服務和資源使用，請記得其他服務可能會有字元使用限制。通常允許的字元為：以 UTF-8 表示的字母、數字和空格，以及下列字元：\$1 - = . \$1 ： / @。 + 標籤鍵與值皆區分大小寫。 + 請勿使用 `aws:`、 `AWS:`或任何大寫或小寫的組合，例如金鑰的字首，因為其保留供 AWS 使用。您無法使用此字首編輯或刪除標籤索引鍵。值可以有此字首。如果標籤值具有 `aws` 作為其字首，但金鑰沒有，則預測會將其視為使用者標籤，並計入 50 個標籤的限制。只有金鑰字首的標籤`aws`不會計入每個資源限制的標籤。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：否 ## 回應語法 ``` { "DatasetArn": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [DatasetArn](#API_CreateDataset_ResponseSyntax) ** 資料集的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceAlreadyExistsException ** 已有具有此名稱的資源。請用不同的名稱再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateDataset) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateDataset) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateDataset) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateDataset) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateDataset) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateDataset) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateDataset) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateDataset) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateDataset) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateDataset) # CreateDatasetGroup 建立資料集群組，其中包含一組相關資料集。在建立資料集群組時或稍後透過使用 [UpdateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_UpdateDatasetGroup.html) 操作，您可以將資料集新增至資料集群組。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 建立資料集群組並為其新增資料集後，您可以在建立預測器的時候使用資料集群組。如需詳細資訊，請參閱[資料集群組](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html)。若要取得您所有資料集群組的清單，請使用 [ListDatasetGroups](https://docs.aws.amazon.com/forecast/latest/dg/API_ListDatasetGroups.html) 操作。 **注意** 如需使用資料集群組建立預測器，資料集群組的 `Status` 必須為 `ACTIVE`。若要取得狀態，請使用 [DescribeDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDatasetGroup.html) 操作。 ## 請求語法 ``` { "DatasetArns": [ "string" ], "DatasetGroupName": "string", "Domain": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [DatasetArns](#API_CreateDatasetGroup_RequestSyntax) ** 您要包含在資料集群組中的資料集的 Amazon Resource Name (ARN) 陣列。類型：字串陣列長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：否 ** [DatasetGroupName](#API_CreateDatasetGroup_RequestSyntax) ** 資料集群組的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` 必要：是 ** [Domain](#API_CreateDatasetGroup_RequestSyntax) ** 與資料集群組相關聯的網域。將資料集新增至資料集群組時，此值必須與為 [CreateDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDataset.html) 操作的 `Domain` 參數指定的值相符。您所選的 `Domain` 和 `DatasetType` 決定了哪些欄位必須存在於您匯入至資料集的訓練資料中。例如，如果您選擇 `RETAIL` 網域和 `TARGET_TIME_SERIES` 作為 `DatasetType`，Amazon Forecast 要求 `item_id`、`timestamp` 以及 `demand` 欄位存在於您的資料中。如需詳細資訊，請參閱[資料集群組](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html)。類型：字串有效值:`RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS` 必要：是 ** [Tags](#API_CreateDatasetGroup_RequestSyntax) ** 您套用至資料集群組的選用中繼資料，可協助您分類和組織這些中繼資料。每個標籤皆包含由您定義的一個金鑰與一個選用值。以下基本限制適用於標籤： + 每個資源的標籤數量上限 - 50。 + 針對每一個資源，每個標籤鍵必須是唯一的，且每個標籤鍵只能有一個值。 + 金鑰長度上限 - UTF-8 中的 128 個 Unicode 字元。 + 最大值長度 - UTF-8 256 個 Unicode 字元。 + 如果您的標記結構描述是跨多項服務和資源使用，請記得其他服務可能會有字元使用限制。通常允許的字元為：以 UTF-8 表示的字母、數字和空格，以及下列字元：\$1 - = . \$1 ： / @。 + 標籤鍵與值皆區分大小寫。 + 請勿使用 `aws:`、 `AWS:`或任何大寫或小寫的組合，例如金鑰的字首，因為其保留供 AWS 使用。您無法使用此字首編輯或刪除標籤索引鍵。值可以有此字首。如果標籤值具有 `aws` 作為其字首，但金鑰沒有，則預測會將其視為使用者標籤，並計入 50 個標籤的限制。只有金鑰字首的標籤`aws`不會計入每個資源限制的標籤。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：否 ## 回應語法 ``` { "DatasetGroupArn": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [DatasetGroupArn](#API_CreateDatasetGroup_ResponseSyntax) ** 資料集群組的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceAlreadyExistsException ** 已有具有此名稱的資源。請用不同的名稱再試一次。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateDatasetGroup) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateDatasetGroup) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateDatasetGroup) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateDatasetGroup) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateDatasetGroup) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateDatasetGroup) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateDatasetGroup) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateDatasetGroup) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateDatasetGroup) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateDatasetGroup) # CreateDatasetImportJob 將您的訓練資料匯入 Amazon Forecast 資料集。您可以在 Amazon Simple Storage Service (Amazon S3) 儲存貯體中提供訓練資料的位置，以及您要匯入資料的資料集的 Amazon Resource Name (ARN)。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 您必須指定 [DataSource](https://docs.aws.amazon.com/forecast/latest/dg/API_DataSource.html) 物件，其中包含 Amazon Forecast 可以擔任的 AWS Identity and Access Management (IAM) 角色來存取資料，因為 Amazon Forecast 會複製您的資料並在內部 AWS 系統中處理資料。如需詳細資訊，請參閱[設定許可](https://docs.aws.amazon.com/forecast/latest/dg/aws-forecast-iam-roles.html)。訓練資料必須是 CSV 或 Parquet 格式。分隔符號必須是逗號 (，)。您可以指定特定檔案、S3 儲存貯體或 S3 儲存貯體中資料夾的路徑。對於後兩種情況，Amazon Forecast 會匯入所有檔案，上限為 10，000 個檔案。由於資料集匯入不會彙總，因此您最近的資料集匯入是在訓練預測器或產生預測時使用的資料集匯入。請確定您最近的資料集匯入包含您想要建模的所有資料，而不只是自上次匯入以來所收集的新資料。若要取得依指定條件篩選的所有資料集匯入任務清單，請使用 [ListDatasetImportJobs](https://docs.aws.amazon.com/forecast/latest/dg/API_ListDatasetImportJobs.html) 操作。 ## 請求語法 ``` { "DatasetArn": "string", "DatasetImportJobName": "string", "DataSource": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "Format": "string", "GeolocationFormat": "string", "ImportMode": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "TimestampFormat": "string", "TimeZone": "string", "UseGeolocationForTimeZone": boolean } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [DatasetArn](#API_CreateDatasetImportJob_RequestSyntax) ** 您要匯入資料的 Amazon Forecast 資料集的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ** [DatasetImportJobName](#API_CreateDatasetImportJob_RequestSyntax) ** 資料集匯入任務的名稱。我們建議您在名稱中包含目前的時間戳記，例如 `20190721DatasetImport`。這可協助您避免取得`ResourceAlreadyExistsException`例外狀況。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` 必要：是 ** [DataSource](#API_CreateDatasetImportJob_RequestSyntax) ** 要匯入的訓練資料位置和 AWS Identity and Access Management (IAM) 角色，Amazon Forecast 可以擔任該角色來存取資料。訓練資料必須存放在 Amazon S3 儲存貯體中。如果使用加密， `DataSource` 必須包含 AWS Key Management Service (KMS) 金鑰，且 IAM 角色必須允許 Amazon Forecast 許可存取金鑰。KMS 金鑰和 IAM 角色必須符合 [CreateDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDataset.html) 操作的 `EncryptionConfig` 參數中指定的金鑰和 IAM 角色。類型：[DataSource](API_DataSource.md) 物件必要：是 ** [Format](#API_CreateDatasetImportJob_RequestSyntax) ** 匯入資料的格式，CSV 或 PARQUET。預設值為 CSV。類型：字串長度限制：長度上限為 7。模式：`^CSV|PARQUET$` 必要：否 ** [GeolocationFormat](#API_CreateDatasetImportJob_RequestSyntax) ** 地理位置屬性的格式。地理位置屬性的格式有兩種： + `LAT_LONG` - 十進位格式的緯度和經度（範例：47.61\$1-122.33)。 + `CC_POSTALCODE` （僅限美國） - 國家/地區碼（美國），後面接著 5 位數郵遞區號（範例：US\$198121)。類型：字串長度限制：長度上限為 256。模式：`^[a-zA-Z0-9_]+$` 必要：否 ** [ImportMode](#API_CreateDatasetImportJob_RequestSyntax) ** 指定資料集匯入任務是 `FULL`還是 `INCREMENTAL`匯入。`FULL` 資料集匯入會將所有現有資料取代為新匯入的資料。`INCREMENTAL` 匯入會將匯入的資料附加至現有資料。類型：字串有效值:`FULL | INCREMENTAL` 必要：否 ** [Tags](#API_CreateDatasetImportJob_RequestSyntax) ** 您套用至資料集匯入任務的選用中繼資料，可協助您分類和組織這些中繼資料。每個標籤皆包含由您定義的一個金鑰與一個選用值。以下基本限制適用於標籤： + 每個資源的標籤數量上限 - 50。 + 針對每一個資源，每個標籤鍵必須是唯一的，且每個標籤鍵只能有一個值。 + 金鑰長度上限 - UTF-8 中的 128 個 Unicode 字元。 + 最大值長度 - UTF-8 256 個 Unicode 字元。 + 如果您的標記結構描述是跨多項服務和資源使用，請記得其他服務可能會有字元使用限制。通常允許的字元為：以 UTF-8 表示的字母、數字和空格，以及下列字元：\$1 - = . \$1 ： / @。 + 標籤鍵與值皆區分大小寫。 + 請勿使用 `aws:`、 `AWS:`或任何大寫或小寫的組合，例如金鑰的字首，因為其保留供 AWS 使用。您無法使用此字首編輯或刪除標籤索引鍵。值可以有此字首。如果標籤值具有 `aws` 作為其字首，但金鑰沒有，則預測會將其視為使用者標籤，並計入 50 個標籤的限制。只有金鑰字首的標籤`aws`不會計入每個資源限制的標籤。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：否 ** [TimestampFormat](#API_CreateDatasetImportJob_RequestSyntax) ** 資料集中的時間戳記格式。您指定的格式取決於建立資料集時`DataFrequency`指定的。支援下列格式 + "yyyy-MM-dd" 對於下列資料頻率：Y、M、W 和 D + "yyyy-MM-dd HH:mm:ss" 對於下列資料頻率：H、30 分鐘、15 分鐘和 1 分鐘；以及選擇性：Y、M、W 和 D 如果未指定格式，Amazon Forecast 預期格式為 "yyyy-MM-dd HH：mm：ss"。類型：字串長度限制：長度上限為 256。模式：`^[a-zA-Z0-9\-\:\.\,\'\s]+$` 必要：否 ** [TimeZone](#API_CreateDatasetImportJob_RequestSyntax) ** 資料集中每個項目的單一時區。此選項非常適合具有單一時區內所有時間戳記的資料集，或將所有時間戳記標準化為單一時區。如需有效時區名稱的完整清單，請參閱 [Joda-Time API](http://joda-time.sourceforge.net/timezones.html)。類型：字串長度限制：長度上限為 256。模式：`^[a-zA-Z0-9\/\+\-\_]+$` 必要：否 ** [UseGeolocationForTimeZone](#API_CreateDatasetImportJob_RequestSyntax) ** 從地理位置屬性自動衍生時區資訊。此選項適用於在多個時區包含時間戳記的資料集，這些時間戳記以本機時間表示。類型：布林值必要：否 ## 回應語法 ``` { "DatasetImportJobArn": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [DatasetImportJobArn](#API_CreateDatasetImportJob_ResponseSyntax) ** 資料集匯入任務的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceAlreadyExistsException ** 已有具有此名稱的資源。請用不同的名稱再試一次。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateDatasetImportJob) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateDatasetImportJob) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateDatasetImportJob) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateDatasetImportJob) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateDatasetImportJob) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateDatasetImportJob) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateDatasetImportJob) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateDatasetImportJob) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateDatasetImportJob) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateDatasetImportJob) # CreateExplainability **注意** 可解釋性僅適用於從 AutoPredictor 產生的預測和預測器 ([CreateAutoPredictor](API_CreateAutoPredictor.md)) 建立 Amazon Forecast 可解釋性。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 可解釋性可協助您更加了解資料集中的屬性如何影響預測。Amazon Forecast 使用稱為影響分數的指標來量化每個屬性的相對影響，並判斷它們是否增加或減少預測值。若要啟用預測可解釋性，您的預測器必須至少包含下列其中一項：相關時間序列、項目中繼資料或假日和天氣索引等其他資料集。 **注意** ARIMA (AutoRegressive移動平均值）、ETS （指數平滑狀態空間模型）和 NPTS （非參數時間序列）模型不包含外部時間序列資料。因此，即使您包含其他資料集，這些模型也不會建立可解釋性報告。 CreateExplainability 接受預測器 ARN 或預測 ARN。若要接收資料集中所有時間序列和時間點的彙總影響分數，請提供預測器 ARN。若要接收特定時間序列和時間點的影響分數，請提供預測 ARN。 **使用預測器 ARN CreateExplainability ** **注意** 每個預測器只能有一個可解釋性資源。如果您已`ExplainPredictor`在中啟用 [CreateAutoPredictor](API_CreateAutoPredictor.md)，則該預測器已有可解釋性資源。提供預測器 ARN 時，需要下列參數： + `ExplainabilityName` - 可解釋性的唯一名稱。 + `ResourceArn` - 預測器的 Arn。 + `TimePointGranularity` - 必須設定為「ALL」。 + `TimeSeriesGranularity` - 必須設定為「ALL」。請勿指定下列參數的值： + `DataSource` - 僅在 TimeSeriesGranularity 為「SPECIFIC」時才有效。 + `Schema` - 僅在 TimeSeriesGranularity 為「SPECIFIC」時才有效。 + `StartDateTime` - 僅在 TimePointGranularity 為「SPECIFIC」時才有效。 + `EndDateTime` - 僅在 TimePointGranularity 為「SPECIFIC」時才有效。 **CreateExplainability 與預測 ARN** **注意** 您最多可以指定 50 個時間序列和 500 個時間點。提供預測器 ARN 時，需要下列參數： + `ExplainabilityName` - 可解釋性的唯一名稱。 + `ResourceArn` - 預測的 Arn。 + `TimePointGranularity` -「ALL」或「指定」。 + `TimeSeriesGranularity` -「ALL」或「指定」。如果您將 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 主控台中檢視的可解釋性視覺化。類型：布林值必要：否 ** [EndDateTime](#API_CreateExplainability_RequestSyntax) ** 如果 `TimePointGranularity` 設定為 `SPECIFIC`，請定義可解釋性的最後時間點。使用以下時間戳記格式：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) ** 定義可解釋性之時間序列和時間點精細性的組態設定。類型：[ExplainabilityConfig](API_ExplainabilityConfig.md) 物件必要：是 ** [ExplainabilityName](#API_CreateExplainability_RequestSyntax) ** 可解釋性的唯一名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` 必要：是 ** [ResourceArn](#API_CreateExplainability_RequestSyntax) ** 用於建立可解釋性的預測器或預測的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ** [Schema](#API_CreateExplainability_RequestSyntax) ** 定義資料集的欄位。類型：[Schema](API_Schema.md) 物件必要：否 ** [StartDateTime](#API_CreateExplainability_RequestSyntax) ** 如果 `TimePointGranularity` 設定為 `SPECIFIC`，請定義可解釋性的第一個點。使用以下時間戳記格式：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) ** 選用中繼資料，協助您分類和整理資源。每個標籤皆包含由您定義的一個金鑰與一個選用值。標籤鍵與值皆區分大小寫。以下限制適用於標籤： + 對於每個資源，每個標籤索引鍵必須是唯一的，而且每個標籤索引鍵都必須有一個值。 + 每個資源的標籤數量上限：50。 + 金鑰長度上限：UTF-8 128 個 Unicode 字元。 + 最大值長度：UTF-8 256 個 Unicode 字元。 + 接受的字元：所有字母和數字、以 UTF-8 表示的空格，以及 \$1 - = 。\$1 ：/ @。如果您的標記結構描述用於其他服務和資源，則這些服務的角色限制也適用。 + 金鑰字首不能包含或的任何大寫`aws:`或小寫組合`AWS:`。值可以有此字首。如果標籤值具有 `aws` 作為其字首，但索引鍵沒有，則預測會將其視為使用者標籤，並計入 50 個標籤的限制。只有金鑰字首的標籤`aws`不會計入每個資源限制的標籤。您無法使用此字首編輯或刪除標籤索引鍵。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：否 ## 回應語法 ``` { "ExplainabilityArn": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [ExplainabilityArn](#API_CreateExplainability_ResponseSyntax) ** 可解釋性的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceAlreadyExistsException ** 已有具有此名稱的資源。請用不同的名稱再試一次。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateExplainability) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateExplainability) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateExplainability) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateExplainability) + [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateExplainability) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateExplainability) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateExplainability) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateExplainability) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateExplainability) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateExplainability) # CreateExplainabilityExport 匯出 [CreateExplainability](API_CreateExplainability.md)操作建立的可解釋性資源。匯出的檔案會匯出至 Amazon Simple Storage Service (Amazon S3) 儲存貯體。您必須指定包含 Amazon S3 儲存貯體和 AWS Identity and Access Management (IAM) 角色的[DataDestination](API_DataDestination.md)物件，Amazon Forecast 可以擔任該角色來存取 Amazon S3 儲存貯體。如需詳細資訊，請參閱[設定 Amazon Forecast 的許可](aws-forecast-iam-roles.md)。 **注意** 匯出任務`Status`的必須是 `ACTIVE`，您才能存取 Amazon S3 儲存貯體中的匯出。若要取得狀態，請使用 [DescribeExplainabilityExport](API_DescribeExplainabilityExport.md)操作。 ## 請求語法 ``` { "Destination": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "ExplainabilityArn": "string", "ExplainabilityExportName": "string", "Format": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [Destination](#API_CreateExplainabilityExport_RequestSyntax) ** 匯出任務的目的地。提供 S3 路徑、允許 Amazon Forecast 存取位置的 AWS Identity and Access Management (IAM) 角色，以及 AWS Key Management Service (KMS) 金鑰（選用）。類型：[DataDestination](API_DataDestination.md) 物件必要：是 ** [ExplainabilityArn](#API_CreateExplainabilityExport_RequestSyntax) ** 可匯出性解釋的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ** [ExplainabilityExportName](#API_CreateExplainabilityExport_RequestSyntax) ** 可解釋性匯出的唯一名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` 必要：是 ** [Format](#API_CreateExplainabilityExport_RequestSyntax) ** 匯出資料的格式，CSV 或 PARQUET。類型：字串長度限制：長度上限為 7。模式：`^CSV|PARQUET$` 必要：否 ** [Tags](#API_CreateExplainabilityExport_RequestSyntax) ** 選用中繼資料，協助您分類和整理資源。每個標籤皆包含由您定義的一個金鑰與一個選用值。標籤鍵與值皆區分大小寫。以下限制適用於標籤： + 對於每個資源，每個標籤索引鍵必須是唯一的，而且每個標籤索引鍵都必須有一個值。 + 每個資源的標籤數量上限：50。 + 金鑰長度上限：UTF-8 128 個 Unicode 字元。 + 最大值長度：UTF-8 256 個 Unicode 字元。 + 接受的字元：所有字母和數字、以 UTF-8 表示的空格，以及 \$1 - = 。\$1 ：/ @。如果您的標記結構描述用於其他服務和資源，則這些服務的角色限制也適用。 + 金鑰字首不能包含或的任何大寫`aws:`或小寫組合`AWS:`。值可以有此字首。如果標籤值具有 `aws` 作為其字首，但索引鍵沒有，則預測會將其視為使用者標籤，並計入 50 個標籤的限制。只有金鑰字首的標籤`aws`不會計入每個資源限制的標籤。您無法使用此字首編輯或刪除標籤索引鍵。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：否 ## 回應語法 ``` { "ExplainabilityExportArn": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [ExplainabilityExportArn](#API_CreateExplainabilityExport_ResponseSyntax) ** 匯出的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceAlreadyExistsException ** 已有具有此名稱的資源。請用不同的名稱再試一次。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateExplainabilityExport) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateExplainabilityExport) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateExplainabilityExport) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateExplainabilityExport) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateExplainabilityExport) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateExplainabilityExport) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateExplainabilityExport) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateExplainabilityExport) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateExplainabilityExport) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateExplainabilityExport) # CreateForecast 為用於訓練預測器的`TARGET_TIME_SERIES`資料集中的每個項目建立預測。這稱為推論。若要以低延遲擷取單一項目的預測，請使用 [QueryForecast](API_forecastquery_QueryForecast.md)操作。若要將完整預測匯出至 Amazon Simple Storage Service (Amazon S3) 儲存貯體，請使用 [CreateForecastExportJob](API_CreateForecastExportJob.md)操作。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 預測的範圍取決於您在[CreatePredictor](API_CreatePredictor.md)請求中指定的`ForecastHorizon`值。當您查詢預測時，您可以在預測中請求特定的日期範圍。若要取得所有預測的清單，請使用 [ListForecasts](API_ListForecasts.md)操作。 **注意** Amazon Forecast 產生的預測與用來建立預測器的資料集位於相同的時區。如需詳細資訊，請參閱[產生預測](howitworks-forecast.md)。 **注意** 預測`Status`的必須在您可以查詢或匯出預測`ACTIVE`之前。使用 [DescribeForecast](API_DescribeForecast.md) 操作來取得狀態。根據預設，預測包含用於訓練預測器之資料集群組中每個項目 (`item_id`) 的預測。不過，您可以使用 `TimeSeriesSelector` 物件來產生對時間序列子集的預測。對於您指定的不在輸入資料集中的任何時間序列，會略過預測建立。預測匯出檔案不會包含這些時間序列或其預測值。 ## 請求語法 ``` { "ForecastName": "string", "ForecastTypes": [ "string" ], "PredictorArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "TimeSeriesSelector": { "TimeSeriesIdentifiers": { "DataSource": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "Format": "string", "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] } } } } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [ForecastName](#API_CreateForecast_RequestSyntax) ** 預測的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` 必要：是 ** [ForecastTypes](#API_CreateForecast_RequestSyntax) ** 產生機率預測的分位數。**目前每個預測最多可以指定 5 個分位數**。接受的值包括 `0.01 to 0.99`（僅限 .01 的增量）和 `mean`。當分佈非對稱時（例如 Beta 和負二項式），平均預測與中位數 (0.50) 不同。預設分位數是您在預測器建立期間指定的分位數。如果您未指定分位數，預設值為 `["0.1", "0.5", "0.9"]`。類型：字串陣列陣列成員：項目數下限為 1。項目數上限為 20。長度限制：長度下限為 2。長度上限為 4。模式：`(^0?\.\d\d?$|^mean$)` 必要：否 ** [PredictorArn](#API_CreateForecast_RequestSyntax) ** 用來產生預測的預測器 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ** [Tags](#API_CreateForecast_RequestSyntax) ** 您套用至預測的選用中繼資料，可協助您分類和組織這些中繼資料。每個標籤皆包含由您定義的一個金鑰與一個選用值。以下基本限制適用於標籤： + 每個資源的標籤數量上限 - 50。 + 針對每一個資源，每個標籤鍵必須是唯一的，且每個標籤鍵只能有一個值。 + 金鑰長度上限 - UTF-8 中的 128 個 Unicode 字元。 + 最大值長度 - UTF-8 256 個 Unicode 字元。 + 如果您的標記結構描述是跨多項服務和資源使用，請記得其他服務可能會有字元使用限制。通常允許的字元為：以 UTF-8 表示的字母、數字和空格，以及下列字元：\$1 - = . \$1 ： / @。 + 標籤鍵與值皆區分大小寫。 + 請勿使用 `aws:`、 `AWS:`或任何大寫或小寫的組合，例如金鑰的字首，因為其保留供 AWS 使用。您無法使用此字首編輯或刪除標籤索引鍵。值可以有此字首。如果標籤值具有 `aws` 作為其字首，但金鑰沒有，則預測會將其視為使用者標籤，並計入 50 個標籤的限制。只有金鑰字首的標籤`aws`不會計入每個資源限制的標籤。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：否 ** [TimeSeriesSelector](#API_CreateForecast_RequestSyntax) ** 定義用來在`TimeSeriesIdentifiers`物件中建立預測的一組時間序列。 `TimeSeriesIdentifiers` 物件需要下列資訊： + `DataSource` + `Format` + `Schema` 類型：[TimeSeriesSelector](API_TimeSeriesSelector.md) 物件必要：否 ## 回應語法 ``` { "ForecastArn": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [ForecastArn](#API_CreateForecast_ResponseSyntax) ** 預測的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceAlreadyExistsException ** 已有具有此名稱的資源。請用不同的名稱再試一次。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateForecast) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateForecast) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateForecast) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateForecast) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateForecast) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateForecast) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateForecast) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateForecast) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateForecast) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateForecast) # CreateForecastExportJob 將 [CreateForecast](API_CreateForecast.md)操作建立的預測匯出至 Amazon Simple Storage Service (Amazon S3) 儲存貯體。預測檔案名稱將符合下列慣例： \$1\$1 其中元件位於 Java SimpleDateFormat (yyyy-MM-ddTHH-mm-ssZ) 中。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 您必須指定包含 (IAM) 角色的[DataDestination](API_DataDestination.md) AWS Identity and Access Management 物件，Amazon Forecast 可以擔任該角色來存取 Amazon S3 儲存貯體。如需詳細資訊，請參閱[設定 Amazon Forecast 的許可](aws-forecast-iam-roles.md)。如需詳細資訊，請參閱[產生預測](howitworks-forecast.md)。若要取得所有預測匯出任務的清單，請使用 [ListForecastExportJobs](API_ListForecastExportJobs.md)操作。 **注意** 預測匯出任務`Status`的必須是 `ACTIVE`，您才能存取 Amazon S3 儲存貯體中的預測。若要取得狀態，請使用 [DescribeForecastExportJob](API_DescribeForecastExportJob.md)操作。 ## 請求語法 ``` { "Destination": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "ForecastArn": "string", "ForecastExportJobName": "string", "Format": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [Destination](#API_CreateForecastExportJob_RequestSyntax) ** 您要儲存預測的位置，以及 Amazon Forecast 可以擔任以存取該位置的 AWS Identity and Access Management (IAM) 角色。預測必須匯出至 Amazon S3 儲存貯體。如果使用加密， `Destination` 必須包含 AWS Key Management Service (KMS) 金鑰。IAM 角色必須允許 Amazon Forecast 許可存取金鑰。類型：[DataDestination](API_DataDestination.md) 物件必要：是 ** [ForecastArn](#API_CreateForecastExportJob_RequestSyntax) ** 您要匯出之預測的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ** [ForecastExportJobName](#API_CreateForecastExportJob_RequestSyntax) ** 預測匯出任務的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` 必要：是 ** [Format](#API_CreateForecastExportJob_RequestSyntax) ** 匯出資料的格式，CSV 或 PARQUET。預設值為 CSV。類型：字串長度限制：長度上限為 7。模式：`^CSV|PARQUET$` 必要：否 ** [Tags](#API_CreateForecastExportJob_RequestSyntax) ** 您套用至預測匯出任務的選用中繼資料，可協助您分類和組織這些中繼資料。每個標籤皆包含由您定義的一個金鑰與一個選用值。以下基本限制適用於標籤： + 每個資源的標籤數量上限 - 50。 + 針對每一個資源，每個標籤鍵必須是唯一的，且每個標籤鍵只能有一個值。 + 金鑰長度上限 - UTF-8 中的 128 個 Unicode 字元。 + 最大值長度 - UTF-8 256 個 Unicode 字元。 + 如果您的標記結構描述是跨多項服務和資源使用，請記得其他服務可能會有字元使用限制。通常允許的字元為：以 UTF-8 表示的字母、數字和空格，以及下列字元：\$1 - = . \$1 ： / @。 + 標籤鍵與值皆區分大小寫。 + 請勿使用 `aws:`、 `AWS:`或任何大寫或小寫的組合，例如金鑰的字首，因為其保留供 AWS 使用。您無法使用此字首編輯或刪除標籤索引鍵。值可以有此字首。如果標籤值具有 `aws` 作為其字首，但金鑰沒有，則預測會將其視為使用者標籤，並計入 50 個標籤的限制。只有金鑰字首的標籤`aws`不會計入每個資源限制的標籤。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：否 ## 回應語法 ``` { "ForecastExportJobArn": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [ForecastExportJobArn](#API_CreateForecastExportJob_ResponseSyntax) ** 匯出任務的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceAlreadyExistsException ** 已有具有此名稱的資源。請用不同的名稱再試一次。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateForecastExportJob) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateForecastExportJob) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateForecastExportJob) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateForecastExportJob) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateForecastExportJob) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateForecastExportJob) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateForecastExportJob) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateForecastExportJob) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateForecastExportJob) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateForecastExportJob) # CreateMonitor 為現有的自動預測器建立預測器監控資源。預測器監控可讓您查看預測器的效能如何隨時間變化。如需詳細資訊，請參閱[預測器監控](https://docs.aws.amazon.com/forecast/latest/dg/predictor-monitoring.html)。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "MonitorName": "string", "ResourceArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [MonitorName](#API_CreateMonitor_RequestSyntax) ** 監控資源的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` 必要：是 ** [ResourceArn](#API_CreateMonitor_RequestSyntax) ** 要監控之預測器的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ** [Tags](#API_CreateMonitor_RequestSyntax) ** 要套用至監視器資源的[標籤](https://docs.aws.amazon.com/forecast/latest/dg/tagging-forecast-resources.html)清單。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：否 ## 回應語法 ``` { "MonitorArn": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [MonitorArn](#API_CreateMonitor_ResponseSyntax) ** 監控資源的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceAlreadyExistsException ** 已有具有此名稱的資源。請用不同的名稱再試一次。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateMonitor) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateMonitor) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateMonitor) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateMonitor) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateMonitor) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateMonitor) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateMonitor) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateMonitor) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateMonitor) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateMonitor) # CreatePredictor **注意** 此操作會建立舊版預測器，其中不包含 Amazon Forecast 提供的所有預測器功能。若要建立與 Forecast 所有層面相容的預測器，請使用 [CreateAutoPredictor](API_CreateAutoPredictor.md)。建立 Amazon Forecast 預測器。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 在請求中，提供資料集群組，並指定演算法，或讓 Amazon Forecast 使用 AutoML 為您選擇演算法。如果您指定演算法，也可以覆寫演算法特定的超參數。 Amazon Forecast 使用演算法，在指定的資料集群組中使用最新版本的資料集來訓練預測器。然後，您可以使用 [CreateForecast](API_CreateForecast.md)操作產生預測。若要查看評估指標，請使用 [GetAccuracyMetrics](API_GetAccuracyMetrics.md) 操作。您可以指定特徵化組態來填充和彙總`TARGET_TIME_SERIES`資料集中的資料欄位，以改善模型訓練。如需詳細資訊，請參閱[FeaturizationConfig](API_FeaturizationConfig.md)。對於 RELATED\$1TIME\$1SERIES 資料集， `CreatePredictor` 會驗證建立資料集時`DataFrequency`指定的是否與相符`ForecastFrequency`。TARGET\$1TIME\$1SERIES 資料集沒有此限制。Amazon Forecast 也會驗證分隔符號和時間戳記格式。如需詳細資訊，請參閱[匯入資料集](howitworks-datasets-groups.md)。根據預設，預測器會在 0.1 (P10)、0.5 (P50) 和 0.9 (P90) 分位數進行訓練和評估。您可以透過設定來選擇自訂預測類型來訓練和評估您的預測器`ForecastTypes`。 **AutoML** 如果您希望 Amazon Forecast 評估每個演算法，並選擇將最小化的演算法`objective function`，請將 `PerformAutoML`設定為 `true`。`objective function` 定義為預測類型加權損失的平均值。根據預設，這些是 p10、p50 和 p90 分位數損失。如需詳細資訊，請參閱[EvaluationResult](API_EvaluationResult.md)。啟用 AutoML 時，不允許下列屬性： + `AlgorithmArn` + `HPOConfig` + `PerformHPO` + `TrainingParameters` 若要取得所有預測器的清單，請使用 [ListPredictors](API_ListPredictors.md)操作。 **注意** 在您可以使用預測器建立預測之前，預測器`Status`的必須是 `ACTIVE`，表示訓練已完成。若要取得狀態，請使用 [DescribePredictor](API_DescribePredictor.md)操作。 ## 請求語法 ``` { "AlgorithmArn": "string", "AutoMLOverrideStrategy": "string", "EncryptionConfig": { "KMSKeyArn": "string", "RoleArn": "string" }, "EvaluationParameters": { "BackTestWindowOffset": number, "NumberOfBacktestWindows": number }, "FeaturizationConfig": { "Featurizations": [ { "AttributeName": "string", "FeaturizationPipeline": [ { "FeaturizationMethodName": "string", "FeaturizationMethodParameters": { "string" : "string" } } ] } ], "ForecastDimensions": [ "string" ], "ForecastFrequency": "string" }, "ForecastHorizon": number, "ForecastTypes": [ "string" ], "HPOConfig": { "ParameterRanges": { "CategoricalParameterRanges": [ { "Name": "string", "Values": [ "string" ] } ], "ContinuousParameterRanges": [ { "MaxValue": number, "MinValue": number, "Name": "string", "ScalingType": "string" } ], "IntegerParameterRanges": [ { "MaxValue": number, "MinValue": number, "Name": "string", "ScalingType": "string" } ] } }, "InputDataConfig": { "DatasetGroupArn": "string", "SupplementaryFeatures": [ { "Name": "string", "Value": "string" } ] }, "OptimizationMetric": "string", "PerformAutoML": boolean, "PerformHPO": boolean, "PredictorName": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "TrainingParameters": { "string" : "string" } } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [AlgorithmArn](#API_CreatePredictor_RequestSyntax) ** 用於模型訓練的演算法 Amazon Resource Name (ARN)。如果 `PerformAutoML` 未設定為，則為必要`true`。 **支援的演算法：** + `arn:aws:forecast:::algorithm/ARIMA` + `arn:aws:forecast:::algorithm/CNN-QR` + `arn:aws:forecast:::algorithm/Deep_AR_Plus` + `arn:aws:forecast:::algorithm/ETS` + `arn:aws:forecast:::algorithm/NPTS` + `arn:aws:forecast:::algorithm/Prophet` 類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：否 ** [AutoMLOverrideStrategy](#API_CreatePredictor_RequestSyntax) ** `LatencyOptimized` AutoML 覆寫策略僅適用於私有 Beta 版。請聯絡 AWS Support 或您的客戶經理，以進一步了解存取權限。用來覆寫預設 AutoML 策略，也就是最佳化預測器準確度。若要套用可將訓練時間降至最低的 AutoML 策略，請使用 `LatencyOptimized`。此參數僅適用於使用 AutoML 訓練的預測器。類型：字串有效值:`LatencyOptimized | AccuracyOptimized` 必要：否 ** [EncryptionConfig](#API_CreatePredictor_RequestSyntax) ** Amazon Forecast 可以擔任的 AWS Key Management Service (KMS) 金鑰和 AWS Identity and Access Management (IAM) 角色來存取金鑰。類型：[EncryptionConfig](API_EncryptionConfig.md) 物件必要：否 ** [EvaluationParameters](#API_CreatePredictor_RequestSyntax) ** 用來覆寫指定演算法的預設評估參數。Amazon Forecast 透過將資料集分割為訓練資料和測試資料來評估預測器。評估參數定義如何執行分割和反覆運算的數量。類型：[EvaluationParameters](API_EvaluationParameters.md) 物件必要：否 ** [FeaturizationConfig](#API_CreatePredictor_RequestSyntax) ** 特徵化組態。類型：[FeaturizationConfig](API_FeaturizationConfig.md) 物件必要：是 ** [ForecastHorizon](#API_CreatePredictor_RequestSyntax) ** 指定要訓練模型預測的時間步驟數目。預測期間也稱為預測長度。例如，如果您為每日資料收集設定資料集（使用 [CreateDataset](API_CreateDataset.md)操作的 `DataFrequency` 參數），並將預測期間設定為 10，則模型會傳回預測 10 天。最大預測期間是 500 個時間步驟或 TARGET\$1TIME\$1SERIES 資料集長度的 1/3。類型：整數必要：是 ** [ForecastTypes](#API_CreatePredictor_RequestSyntax) ** 指定用於訓練預測器的預測類型。您最多可以指定五種預測類型。預測類型可以是 0.01 到 0.99 之間的分位數，增量單位為 0.01 或更高。您也可以使用指定平均預測`mean`。預設值為 `["0.10", "0.50", "0.9"]`。類型：字串陣列陣列成員：項目數下限為 1。項目數上限為 20。長度限制：長度下限為 2。長度上限為 4。模式：`(^0?\.\d\d?$|^mean$)` 必要：否 ** [HPOConfig](#API_CreatePredictor_RequestSyntax) ** 提供演算法的超參數覆寫值。如果您未提供此參數，Amazon Forecast 會使用預設值。個別演算法會指定哪些超參數支援超參數最佳化 (HPO)。如需詳細資訊，請參閱[Amazon Forecast 演算法](aws-forecast-choosing-recipes.md)。如果您包含 `HPOConfig` 物件，則必須`PerformHPO`將設定為 true。類型：[HyperParameterTuningJobConfig](API_HyperParameterTuningJobConfig.md) 物件必要：否 ** [InputDataConfig](#API_CreatePredictor_RequestSyntax) ** 描述資料集群組，其中包含用於訓練預測器的資料。類型：[InputDataConfig](API_InputDataConfig.md) 物件必要：是 ** [OptimizationMetric](#API_CreatePredictor_RequestSyntax) ** 用於最佳化預測器的準確度指標。預設值為 `AverageWeightedQuantileLoss`。類型：字串有效值:`WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE` 必要：否 ** [PerformAutoML](#API_CreatePredictor_RequestSyntax) ** 是否執行 AutoML。當 Amazon Forecast 執行 AutoML 時，它會評估其提供的演算法，並為訓練資料集選擇最佳演算法和組態。預設值為 `false`。在這種情況下，您需要指定演算法。 `PerformAutoML` 設定為 `true`讓 Amazon Forecast 執行 AutoML。如果您不確定哪種演算法適合您的訓練資料，這是不錯的選擇。在此情況下， `PerformHPO` 必須為 false。類型：布林值必要：否 ** [PerformHPO](#API_CreatePredictor_RequestSyntax) ** 是否執行超參數最佳化 (HPO)。HPO 會為您的訓練資料尋找最佳超參數值。執行 HPO 的程序稱為執行超參數調校任務。預設值為 `false`。在此情況下，Amazon Forecast 會使用所選演算法的預設超參數值。若要覆寫預設值，請將 `PerformHPO` 設定為，`true`並選擇性地提供 [HyperParameterTuningJobConfig](API_HyperParameterTuningJobConfig.md) 物件。調校任務會指定要最佳化的指標、哪些超參數參與調校，以及每個可調校超參數的有效範圍。在此情況下，您必須指定演算法，且`PerformAutoML`必須為 false。下列演算法支援 HPO： + DeepAR\$1 + CNN-QR 類型：布林值必要：否 ** [PredictorName](#API_CreatePredictor_RequestSyntax) ** 預測器的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` 必要：是 ** [Tags](#API_CreatePredictor_RequestSyntax) ** 您套用至預測器的選用中繼資料，可協助您分類和整理這些中繼資料。每個標籤皆包含由您定義的一個金鑰與一個選用值。以下基本限制適用於標籤： + 每個資源的標籤數量上限 - 50。 + 針對每一個資源，每個標籤鍵必須是唯一的，且每個標籤鍵只能有一個值。 + 金鑰長度上限 - UTF-8 中的 128 個 Unicode 字元。 + 最大值長度 - UTF-8 256 個 Unicode 字元。 + 如果您的標記結構描述是跨多項服務和資源使用，請記得其他服務可能會有字元使用限制。通常允許的字元為：以 UTF-8 表示的字母、數字和空格，以及下列字元：\$1 - = . \$1 ： / @。 + 標籤鍵與值皆區分大小寫。 + 請勿使用 `aws:`、 `AWS:`或任何大寫或小寫的組合，例如金鑰的字首，因為其保留供 AWS 使用。您無法使用此字首編輯或刪除標籤索引鍵。值可以有此字首。如果標籤值具有 `aws` 作為其字首，但金鑰沒有，則預測會將其視為使用者標籤，並計入 50 個標籤的限制。只有金鑰字首的標籤`aws`不會計入每個資源限制的標籤。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：否 ** [TrainingParameters](#API_CreatePredictor_RequestSyntax) ** 模型訓練要覆寫的超參數。您可以覆寫的超參數會列在個別演算法中。如需支援的演算法清單，請參閱 [Amazon Forecast 演算法](aws-forecast-choosing-recipes.md)。類型：字串到字串映射映射項目：最少 0 個項目。項目數上限為 100。金鑰長度限制：長度上限為 256。金鑰模式：`^[a-zA-Z0-9\-\_\.\/\[\]\,\\]+$` 值長度限制：長度上限為 256。值模式：`^[a-zA-Z0-9\-\_\.\/\[\]\,\"\\\s]+$` 必要：否 ## 回應語法 ``` { "PredictorArn": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [PredictorArn](#API_CreatePredictor_ResponseSyntax) ** 預測器的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceAlreadyExistsException ** 已有具有此名稱的資源。請用不同的名稱再試一次。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreatePredictor) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreatePredictor) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreatePredictor) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreatePredictor) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreatePredictor) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreatePredictor) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreatePredictor) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreatePredictor) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreatePredictor) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreatePredictor) # CreatePredictorBacktestExportJob 匯出 [CreateAutoPredictor](API_CreateAutoPredictor.md)或 [CreatePredictor](API_CreatePredictor.md)操作所產生的回溯測試預測和準確性指標。包含 CSV 或 Parquet 檔案的兩個資料夾會匯出至您指定的 S3 儲存貯體。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 匯出檔案名稱將符合下列慣例： `__.csv` 元件採用 Java SimpleDate 格式 (yyyy-MM-ddTHH-mm-ssZ)。您必須指定包含 Amazon S3 儲存貯體和 AWS Identity and Access Management (IAM) 角色的[DataDestination](API_DataDestination.md)物件，Amazon Forecast 可以擔任該角色來存取 Amazon S3 儲存貯體。如需詳細資訊，請參閱[設定 Amazon Forecast 的許可](aws-forecast-iam-roles.md)。 **注意** 匯出任務`Status`的必須是 `ACTIVE`，您才能存取 Amazon S3 儲存貯體中的匯出。若要取得狀態，請使用 [DescribePredictorBacktestExportJob](API_DescribePredictorBacktestExportJob.md)操作。 ## 請求語法 ``` { "Destination": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "Format": "string", "PredictorArn": "string", "PredictorBacktestExportJobName": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [Destination](#API_CreatePredictorBacktestExportJob_RequestSyntax) ** 匯出任務的目的地。提供 S3 路徑、允許 Amazon Forecast 存取位置的 AWS Identity and Access Management (IAM) 角色，以及 AWS Key Management Service (KMS) 金鑰（選用）。類型：[DataDestination](API_DataDestination.md) 物件必要：是 ** [Format](#API_CreatePredictorBacktestExportJob_RequestSyntax) ** 匯出資料的格式，CSV 或 PARQUET。預設值為 CSV。類型：字串長度限制：長度上限為 7。模式：`^CSV|PARQUET$` 必要：否 ** [PredictorArn](#API_CreatePredictorBacktestExportJob_RequestSyntax) ** 您要匯出之預測器的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ** [PredictorBacktestExportJobName](#API_CreatePredictorBacktestExportJob_RequestSyntax) ** 回溯測試匯出任務的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` 必要：是 ** [Tags](#API_CreatePredictorBacktestExportJob_RequestSyntax) ** 選用中繼資料，可協助您分類和整理回溯測試。每個標籤皆包含由您定義的一個金鑰與一個選用值。標籤鍵與值皆區分大小寫。以下限制適用於標籤： + 對於每個資源，每個標籤索引鍵必須是唯一的，而且每個標籤索引鍵都必須有一個值。 + 每個資源的標籤數量上限：50。 + 金鑰長度上限：UTF-8 128 個 Unicode 字元。 + 最大值長度：UTF-8 256 個 Unicode 字元。 + 接受的字元：所有字母和數字、以 UTF-8 表示的空格，以及 \$1 - = 。\$1 ：/ @。如果您的標記結構描述用於其他服務和資源，則這些服務的角色限制也適用。 + 金鑰字首不能包含或的任何大寫`aws:`或小寫組合`AWS:`。值可以有此字首。如果標籤值具有 `aws` 作為其字首，但索引鍵沒有，則預測會將其視為使用者標籤，並計入 50 個標籤的限制。只有金鑰字首的標籤`aws`不會計入每個資源限制的標籤。您無法使用此字首編輯或刪除標籤索引鍵。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：否 ## 回應語法 ``` { "PredictorBacktestExportJobArn": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [PredictorBacktestExportJobArn](#API_CreatePredictorBacktestExportJob_ResponseSyntax) ** 您要匯出之預測器回溯測試匯出任務的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceAlreadyExistsException ** 已有具有此名稱的資源。請用不同的名稱再試一次。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreatePredictorBacktestExportJob) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreatePredictorBacktestExportJob) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreatePredictorBacktestExportJob) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreatePredictorBacktestExportJob) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreatePredictorBacktestExportJob) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreatePredictorBacktestExportJob) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreatePredictorBacktestExportJob) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreatePredictorBacktestExportJob) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreatePredictorBacktestExportJob) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreatePredictorBacktestExportJob) # CreateWhatIfAnalysis 如果分析是一種案例建模技術，您可以在其中對時間序列進行假設性變更，並將這些變更產生的預測與基準、不變的時間序列進行比較。請務必記住，假設分析的目的是了解預測如何根據對基準時間序列的不同修改而變更。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 例如，假設您是一個服裝零售商，他正在考慮季末促銷來清空新樣式的空間。建立基準預測之後，您可以使用假設分析來調查不同的銷售策略如何影響您的目標。您可以建立一個案例，其中所有項目都會獲得 25% 的降價，而另一個案例則會獲得固定金額的降價。您可以建立銷售持續一週的案例，以及另一個銷售持續一個月的案例。透過假設分析，您可以比較許多不同的案例。請注意，假設分析旨在顯示預測模型學到的內容，以及它在您評估的情境中的行為。不要盲目地使用假設分析的結果來做出業務決策。例如，對於沒有可用於判斷預測是否良好的參考的新案例，預測可能不準確。 [TimeSeriesSelector](API_TimeSeriesSelector.md) 物件會在假設分析中定義您想要的項目。 **注意** 您的資料必須是逗號分隔值 (CSV) 格式，才能建立假設分析。 ## 請求語法 ``` { "ForecastArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "TimeSeriesSelector": { "TimeSeriesIdentifiers": { "DataSource": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "Format": "string", "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] } } }, "WhatIfAnalysisName": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [ForecastArn](#API_CreateWhatIfAnalysis_RequestSyntax) ** 基準預測的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ** [Tags](#API_CreateWhatIfAnalysis_RequestSyntax) ** 要套用至預測內容的[標籤](https://docs.aws.amazon.com/forecast/latest/dg/tagging-forecast-resources.html)清單。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：否 ** [TimeSeriesSelector](#API_CreateWhatIfAnalysis_RequestSyntax) ** 定義一組時間序列，用於搭配`TimeSeriesIdentifiers`物件的假設分析。假設分析只會針對此物件中的時間序列執行。 `TimeSeriesIdentifiers` 物件需要下列資訊： + `DataSource` + `Format` + `Schema` 類型：[TimeSeriesSelector](API_TimeSeriesSelector.md) 物件必要：否 ** [WhatIfAnalysisName](#API_CreateWhatIfAnalysis_RequestSyntax) ** 假設分析的名稱。每個名稱必須是唯一的。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` 必要：是 ## 回應語法 ``` { "WhatIfAnalysisArn": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [WhatIfAnalysisArn](#API_CreateWhatIfAnalysis_ResponseSyntax) ** 假設分析的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceAlreadyExistsException ** 已有具有此名稱的資源。請用不同的名稱再試一次。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateWhatIfAnalysis) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateWhatIfAnalysis) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateWhatIfAnalysis) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateWhatIfAnalysis) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateWhatIfAnalysis) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateWhatIfAnalysis) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateWhatIfAnalysis) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateWhatIfAnalysis) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateWhatIfAnalysis) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateWhatIfAnalysis) # CreateWhatIfForecast 假設預測是從修改後的基準預測版本建立的預測。每個假設預測都會將替換資料集或一組轉換納入原始資料集。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "Tags": [ { "Key": "string", "Value": "string" } ], "TimeSeriesReplacementsDataSource": { "Format": "string", "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" }, "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] }, "TimestampFormat": "string" }, "TimeSeriesTransformations": [ { "Action": { "AttributeName": "string", "Operation": "string", "Value": number }, "TimeSeriesConditions": [ { "AttributeName": "string", "AttributeValue": "string", "Condition": "string" } ] } ], "WhatIfAnalysisArn": "string", "WhatIfForecastName": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [Tags](#API_CreateWhatIfForecast_RequestSyntax) ** 要套用至預測內容的[標籤](https://docs.aws.amazon.com/forecast/latest/dg/tagging-forecast-resources.html)清單。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：否 ** [TimeSeriesReplacementsDataSource](#API_CreateWhatIfForecast_RequestSyntax) ** 取代時間序列資料集，其中包含您要在相關時間序列資料集中變更的資料列。取代時間序列不需要包含基準相關時間序列中的所有資料列。僅包含您要包含在假設預測中的資料列（測量維度組合）。此資料集會與原始時間序列合併，以建立用於假設分析的轉換資料集。此資料集應包含要修改的項目（例如 item\$1id 或 workforce\$1type)、任何相關維度、時間戳記欄，以及至少一個相關時間序列欄。此檔案不應包含相同時間序列的重複時間戳記。此檔案必須是 CSV 格式。此資料集未包含的時間戳記和 item\$1ids 不包含在假設分析中。類型：[TimeSeriesReplacementsDataSource](API_TimeSeriesReplacementsDataSource.md) 物件必要：否 ** [TimeSeriesTransformations](#API_CreateWhatIfForecast_RequestSyntax) ** 套用至基準時間序列的轉換。每個轉換都包含動作和一組條件。只有在符合所有條件時，才會套用動作。如果未提供任何條件，則動作會套用至所有項目。類型：[TimeSeriesTransformation](API_TimeSeriesTransformation.md) 物件陣列陣列成員：項目數下限為 0。最多 30 個項目。必要：否 ** [WhatIfAnalysisArn](#API_CreateWhatIfForecast_RequestSyntax) ** 假設分析的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ** [WhatIfForecastName](#API_CreateWhatIfForecast_RequestSyntax) ** 假設預測的名稱。名稱在每個假設分析中必須是唯一的。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` 必要：是 ## 回應語法 ``` { "WhatIfForecastArn": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [WhatIfForecastArn](#API_CreateWhatIfForecast_ResponseSyntax) ** 假設預測的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 300。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceAlreadyExistsException ** 已有具有此名稱的資源。請用不同的名稱再試一次。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateWhatIfForecast) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateWhatIfForecast) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateWhatIfForecast) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateWhatIfForecast) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateWhatIfForecast) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateWhatIfForecast) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateWhatIfForecast) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateWhatIfForecast) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateWhatIfForecast) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateWhatIfForecast) # CreateWhatIfForecastExport 將 [CreateWhatIfForecast](API_CreateWhatIfForecast.md)操作建立的預測匯出至 Amazon Simple Storage Service (Amazon S3) 儲存貯體。預測檔案名稱將符合下列慣例： `≈__` 元件位於 Java SimpleDateFormat (yyyy-MM-ddTHH-mm-ssZ) 中。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 您必須指定包含 (IAM) 角色的[DataDestination](API_DataDestination.md) AWS Identity and Access Management 物件，Amazon Forecast 可以擔任該角色來存取 Amazon S3 儲存貯體。如需詳細資訊，請參閱[設定 Amazon Forecast 的許可](aws-forecast-iam-roles.md)。如需詳細資訊，請參閱[產生預測](howitworks-forecast.md)。若要取得所有預測匯出任務的清單，請使用 [ListWhatIfForecastExports](API_ListWhatIfForecastExports.md)操作。 **注意** 預測匯出任務`Status`的必須是 `ACTIVE`，您才能存取 Amazon S3 儲存貯體中的預測。若要取得狀態，請使用 [DescribeWhatIfForecastExport](API_DescribeWhatIfForecastExport.md)操作。 ## 請求語法 ``` { "Destination": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "Format": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "WhatIfForecastArns": [ "string" ], "WhatIfForecastExportName": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [Destination](#API_CreateWhatIfForecastExport_RequestSyntax) ** 您要儲存預測的位置，以及 Amazon Forecast 可以擔任以存取該位置的 AWS Identity and Access Management (IAM) 角色。預測必須匯出至 Amazon S3 儲存貯體。如果使用加密， `Destination` 必須包含 AWS Key Management Service (KMS) 金鑰。IAM 角色必須允許 Amazon Forecast 許可存取金鑰。類型：[DataDestination](API_DataDestination.md) 物件必要：是 ** [Format](#API_CreateWhatIfForecastExport_RequestSyntax) ** 匯出資料的格式，CSV 或 PARQUET。類型：字串長度限制：長度上限為 7。模式：`^CSV|PARQUET$` 必要：否 ** [Tags](#API_CreateWhatIfForecastExport_RequestSyntax) ** 要套用至預測內容的[標籤](https://docs.aws.amazon.com/forecast/latest/dg/tagging-forecast-resources.html)清單。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：否 ** [WhatIfForecastArns](#API_CreateWhatIfForecastExport_RequestSyntax) ** 要匯出的預測 Amazon Resource Name (ARNs清單。類型：字串陣列陣列成員：項目數下限為 1。項目數上限為 50。長度限制：長度上限為 300。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ** [WhatIfForecastExportName](#API_CreateWhatIfForecastExport_RequestSyntax) ** 要匯出之假設預測的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` 必要：是 ## 回應語法 ``` { "WhatIfForecastExportArn": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [WhatIfForecastExportArn](#API_CreateWhatIfForecastExport_ResponseSyntax) ** 假設預測的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 300。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceAlreadyExistsException ** 已有具有此名稱的資源。請用不同的名稱再試一次。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateWhatIfForecastExport) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateWhatIfForecastExport) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateWhatIfForecastExport) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateWhatIfForecastExport) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateWhatIfForecastExport) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateWhatIfForecastExport) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateWhatIfForecastExport) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateWhatIfForecastExport) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateWhatIfForecastExport) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateWhatIfForecastExport) # DeleteDataset 刪除使用 [CreateDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDataset.html) 操作建立的 Amazon Forecast 資料集。您只能刪除狀態為 `ACTIVE`或的資料集`CREATE_FAILED`。若要取得狀態，請使用 [DescribeDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDataset.html) 操作。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) **注意** 預測不會自動更新任何包含已刪除資料集的資料集群組。若要更新資料集群組，請使用 [UpdateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_UpdateDatasetGroup.html) 操作，省略已刪除資料集的 ARN。 ## 請求語法 ``` { "DatasetArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [DatasetArn](#API_DeleteDataset_RequestSyntax) ** 要刪除之資料集的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DeleteDataset) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DeleteDataset) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteDataset) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DeleteDataset) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DeleteDataset) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteDataset) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DeleteDataset) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DeleteDataset) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DeleteDataset) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteDataset) # DeleteDatasetGroup 刪除使用 [CreateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetGroup.html) 操作建立的資料集群組。您只能刪除狀態為 `ACTIVE`、 `CREATE_FAILED`或的資料集群組`UPDATE_FAILED`。若要取得狀態，請使用 [DescribeDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDatasetGroup.html) 操作。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 此操作只會刪除資料集群組，不會刪除群組中的資料集。 ## 請求語法 ``` { "DatasetGroupArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [DatasetGroupArn](#API_DeleteDatasetGroup_RequestSyntax) ** 要刪除之資料集群組的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DeleteDatasetGroup) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DeleteDatasetGroup) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteDatasetGroup) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DeleteDatasetGroup) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DeleteDatasetGroup) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteDatasetGroup) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DeleteDatasetGroup) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DeleteDatasetGroup) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DeleteDatasetGroup) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteDatasetGroup) # DeleteDatasetImportJob 刪除使用 [CreateDatasetImportJob](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetImportJob.html) 操作建立的資料集匯入任務。您只能刪除狀態為 `ACTIVE`或的資料集匯入任務`CREATE_FAILED`。若要取得狀態，請使用 [DescribeDatasetImportJob](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDatasetImportJob.html) 操作。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "DatasetImportJobArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [DatasetImportJobArn](#API_DeleteDatasetImportJob_RequestSyntax) ** 要刪除之資料集匯入任務的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DeleteDatasetImportJob) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DeleteDatasetImportJob) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteDatasetImportJob) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DeleteDatasetImportJob) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DeleteDatasetImportJob) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteDatasetImportJob) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DeleteDatasetImportJob) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DeleteDatasetImportJob) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DeleteDatasetImportJob) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteDatasetImportJob) # DeleteExplainability 刪除可解釋性資源。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 您只能刪除狀態為 `ACTIVE`或的預測器`CREATE_FAILED`。若要取得狀態，請使用 [DescribeExplainability](API_DescribeExplainability.md)操作。 ## 請求語法 ``` { "ExplainabilityArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [ExplainabilityArn](#API_DeleteExplainability_RequestSyntax) ** 要刪除之可解釋性資源的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DeleteExplainability) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DeleteExplainability) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteExplainability) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DeleteExplainability) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DeleteExplainability) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteExplainability) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DeleteExplainability) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DeleteExplainability) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DeleteExplainability) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteExplainability) # DeleteExplainabilityExport 刪除可解釋性匯出。 ## 請求語法 ``` { "ExplainabilityExportArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [ExplainabilityExportArn](#API_DeleteExplainabilityExport_RequestSyntax) ** 要刪除之可解釋性匯出的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DeleteExplainabilityExport) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DeleteExplainabilityExport) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteExplainabilityExport) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DeleteExplainabilityExport) + [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DeleteExplainabilityExport) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteExplainabilityExport) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DeleteExplainabilityExport) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DeleteExplainabilityExport) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DeleteExplainabilityExport) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteExplainabilityExport) # DeleteForecast 刪除使用 [CreateForecast](API_CreateForecast.md)操作建立的預測。您只能刪除狀態為 `ACTIVE`或的預測`CREATE_FAILED`。若要取得狀態，請使用 [DescribeForecast](API_DescribeForecast.md)操作。預測匯出時，您無法將其刪除。預測刪除後，您就無法再查詢預測。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "ForecastArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [ForecastArn](#API_DeleteForecast_RequestSyntax) ** 要刪除之預測的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DeleteForecast) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DeleteForecast) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteForecast) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DeleteForecast) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DeleteForecast) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteForecast) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DeleteForecast) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DeleteForecast) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DeleteForecast) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteForecast) # DeleteForecastExportJob 刪除使用 [CreateForecastExportJob](API_CreateForecastExportJob.md)操作建立的預測匯出任務。您只能刪除狀態為 `ACTIVE`或的匯出任務`CREATE_FAILED`。若要取得狀態，請使用 [DescribeForecastExportJob](API_DescribeForecastExportJob.md)操作。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "ForecastExportJobArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [ForecastExportJobArn](#API_DeleteForecastExportJob_RequestSyntax) ** 要刪除之預測匯出任務的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DeleteForecastExportJob) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DeleteForecastExportJob) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteForecastExportJob) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DeleteForecastExportJob) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DeleteForecastExportJob) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteForecastExportJob) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DeleteForecastExportJob) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DeleteForecastExportJob) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DeleteForecastExportJob) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteForecastExportJob) # DeleteMonitor 刪除監控資源。您只能刪除狀態為 `ACTIVE`、`CREATE_FAILED`、 `ACTIVE_STOPPED`或的監視器資源`CREATE_STOPPED`。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "MonitorArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [MonitorArn](#API_DeleteMonitor_RequestSyntax) ** 要刪除之監視器資源的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DeleteMonitor) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DeleteMonitor) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteMonitor) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DeleteMonitor) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DeleteMonitor) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteMonitor) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DeleteMonitor) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DeleteMonitor) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DeleteMonitor) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteMonitor) # DeletePredictor 刪除使用 [DescribePredictor](API_DescribePredictor.md)或 [CreatePredictor](API_CreatePredictor.md)操作建立的預測器。您只能刪除狀態為 `ACTIVE`或的預測器`CREATE_FAILED`。若要取得狀態，請使用 [DescribePredictor](API_DescribePredictor.md)操作。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "PredictorArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [PredictorArn](#API_DeletePredictor_RequestSyntax) ** 要刪除之預測器的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DeletePredictor) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DeletePredictor) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeletePredictor) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DeletePredictor) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DeletePredictor) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeletePredictor) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DeletePredictor) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DeletePredictor) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DeletePredictor) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeletePredictor) # DeletePredictorBacktestExportJob 刪除預測器回溯測試匯出任務。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "PredictorBacktestExportJobArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [PredictorBacktestExportJobArn](#API_DeletePredictorBacktestExportJob_RequestSyntax) ** 要刪除的預測器回溯測試匯出任務的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DeletePredictorBacktestExportJob) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DeletePredictorBacktestExportJob) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeletePredictorBacktestExportJob) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DeletePredictorBacktestExportJob) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DeletePredictorBacktestExportJob) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeletePredictorBacktestExportJob) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DeletePredictorBacktestExportJob) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DeletePredictorBacktestExportJob) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DeletePredictorBacktestExportJob) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeletePredictorBacktestExportJob) # DeleteResourceTree 刪除整個資源樹狀目錄。此操作將刪除父資源及其子資源。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 子資源是從另一個資源建立的資源。例如，當預測從預測器產生時，預測是子資源，而預測器是父資源。 Amazon Forecast 資源具有下列父子資源階層： + **資料集**：資料集匯入任務 + **資料集群組**：預測器、預測器回溯測試匯出任務、預測、預測匯出任務 + **預測器**：預測器回溯測試匯出任務、預測、預測匯出任務 + **預測**：預測匯出任務 **注意** `DeleteResourceTree` 只會刪除 Amazon Forecast 資源，而不會刪除存放在 Amazon S3 中的資料集或匯出的檔案。 ## 請求語法 ``` { "ResourceArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [ResourceArn](#API_DeleteResourceTree_RequestSyntax) ** 要刪除之父資源的 Amazon Resource Name (ARN)。也會刪除父資源的所有子資源。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DeleteResourceTree) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DeleteResourceTree) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteResourceTree) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DeleteResourceTree) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DeleteResourceTree) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteResourceTree) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DeleteResourceTree) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DeleteResourceTree) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DeleteResourceTree) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteResourceTree) # DeleteWhatIfAnalysis 刪除使用 [CreateWhatIfAnalysis](API_CreateWhatIfAnalysis.md)操作建立的假設分析。您只能刪除狀態為 `ACTIVE`或的假設分析`CREATE_FAILED`。若要取得狀態，請使用 [DescribeWhatIfAnalysis](API_DescribeWhatIfAnalysis.md)操作。匯出任何預測時，您無法刪除假設分析。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "WhatIfAnalysisArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [WhatIfAnalysisArn](#API_DeleteWhatIfAnalysis_RequestSyntax) ** 您要刪除之假設分析的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DeleteWhatIfAnalysis) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DeleteWhatIfAnalysis) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteWhatIfAnalysis) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DeleteWhatIfAnalysis) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DeleteWhatIfAnalysis) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteWhatIfAnalysis) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DeleteWhatIfAnalysis) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DeleteWhatIfAnalysis) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DeleteWhatIfAnalysis) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteWhatIfAnalysis) # DeleteWhatIfForecast 刪除使用 [CreateWhatIfForecast](API_CreateWhatIfForecast.md)操作建立的假設預測。您只能刪除狀態為 `ACTIVE`或的假設預測`CREATE_FAILED`。若要取得狀態，請使用 [DescribeWhatIfForecast](API_DescribeWhatIfForecast.md)操作。匯出預測時，您無法刪除該預測。刪除假設預測後，您無法再查詢假設分析。 ## 請求語法 ``` { "WhatIfForecastArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [WhatIfForecastArn](#API_DeleteWhatIfForecast_RequestSyntax) ** 您要刪除之假設預測的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 300。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DeleteWhatIfForecast) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DeleteWhatIfForecast) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteWhatIfForecast) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DeleteWhatIfForecast) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DeleteWhatIfForecast) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteWhatIfForecast) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DeleteWhatIfForecast) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DeleteWhatIfForecast) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DeleteWhatIfForecast) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteWhatIfForecast) # DeleteWhatIfForecastExport 刪除使用 [CreateWhatIfForecastExport](API_CreateWhatIfForecastExport.md)操作建立的預測匯出。您只能刪除狀態為 `ACTIVE`或的預測匯出`CREATE_FAILED`。若要取得狀態，請使用 [DescribeWhatIfForecastExport](API_DescribeWhatIfForecastExport.md)操作。 ## 請求語法 ``` { "WhatIfForecastExportArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [WhatIfForecastExportArn](#API_DeleteWhatIfForecastExport_RequestSyntax) ** 您要刪除之假設預測匯出的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 300。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DeleteWhatIfForecastExport) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DeleteWhatIfForecastExport) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteWhatIfForecastExport) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DeleteWhatIfForecastExport) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DeleteWhatIfForecastExport) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteWhatIfForecastExport) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DeleteWhatIfForecastExport) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DeleteWhatIfForecastExport) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DeleteWhatIfForecastExport) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteWhatIfForecastExport) # DescribeAutoPredictor 描述使用 CreateAutoPredictor 操作建立的預測器。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "PredictorArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [PredictorArn](#API_DescribeAutoPredictor_RequestSyntax) ** 預測器的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應語法 ``` { "CreationTime": number, "DataConfig": { "AdditionalDatasets": [ { "Configuration": { "string" : [ "string" ] }, "Name": "string" } ], "AttributeConfigs": [ { "AttributeName": "string", "Transformations": { "string" : "string" } } ], "DatasetGroupArn": "string" }, "DatasetImportJobArns": [ "string" ], "EncryptionConfig": { "KMSKeyArn": "string", "RoleArn": "string" }, "EstimatedTimeRemainingInMinutes": number, "ExplainabilityInfo": { "ExplainabilityArn": "string", "Status": "string" }, "ForecastDimensions": [ "string" ], "ForecastFrequency": "string", "ForecastHorizon": number, "ForecastTypes": [ "string" ], "LastModificationTime": number, "Message": "string", "MonitorInfo": { "MonitorArn": "string", "Status": "string" }, "OptimizationMetric": "string", "PredictorArn": "string", "PredictorName": "string", "ReferencePredictorSummary": { "Arn": "string", "State": "string" }, "Status": "string", "TimeAlignmentBoundary": { "DayOfMonth": number, "DayOfWeek": "string", "Hour": number, "Month": "string" } } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [CreationTime](#API_DescribeAutoPredictor_ResponseSyntax) ** CreateAutoPredictor 請求的時間戳記。類型：Timestamp ** [DataConfig](#API_DescribeAutoPredictor_ResponseSyntax) ** 資料集群組和任何其他資料集的資料組態。類型：[DataConfig](API_DataConfig.md) 物件 ** [DatasetImportJobArns](#API_DescribeAutoPredictor_ResponseSyntax) ** 資料集匯入任務的 ARNs 陣列，用於匯入預測器的訓練資料。類型：字串陣列長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [EncryptionConfig](#API_DescribeAutoPredictor_ResponseSyntax) ** Amazon Forecast 可以擔任的 AWS Key Management Service (KMS) 金鑰和 AWS Identity and Access Management (IAM) 角色，以存取金鑰。您可以在 [CreateDataset](API_CreateDataset.md)和 [CreatePredictor](API_CreatePredictor.md)請求中指定此選用物件。類型：[EncryptionConfig](API_EncryptionConfig.md) 物件 ** [EstimatedTimeRemainingInMinutes](#API_DescribeAutoPredictor_ResponseSyntax) ** 預測器訓練任務的預估剩餘分鐘數。類型：Long ** [ExplainabilityInfo](#API_DescribeAutoPredictor_ResponseSyntax) ** 提供預測器可解釋性的狀態和 ARN。類型：[ExplainabilityInfo](API_ExplainabilityInfo.md) 物件 ** [ForecastDimensions](#API_DescribeAutoPredictor_ResponseSyntax) ** 維度（欄位）名稱陣列，指定用於將時間序列分組的屬性。類型：字串陣列陣列成員：項目數下限為 1。項目數上限為 10。長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` ** [ForecastFrequency](#API_DescribeAutoPredictor_ResponseSyntax) ** 預測中的預測頻率。有效間隔為 Y (年)、M (月)、W (週)、D (天)、H (小時)、30min (30 分鐘)、15min (15 分鐘)、10min (10 分鐘)、5min (5 分鐘) 和 1min (1 分鐘)。例如，「Y」表示每年一次，「5 分鐘」表示每五分鐘一次。類型：字串長度限制：長度下限為 1。長度上限為 5。模式：`^Y|M|W|D|H|30min|15min|10min|5min|1min$` ** [ForecastHorizon](#API_DescribeAutoPredictor_ResponseSyntax) ** 模型預測的時間步驟數目。預測期間也稱為預測長度。類型：整數 ** [ForecastTypes](#API_DescribeAutoPredictor_ResponseSyntax) ** 預測器訓練期間使用的預測類型。預設值為【"0.1"、"0.5"、"0.9"】。類型：字串陣列陣列成員：項目數下限為 1。項目數上限為 20。長度限制：長度下限為 2。長度上限為 4。模式：`(^0?\.\d\d?$|^mean$)` ** [LastModificationTime](#API_DescribeAutoPredictor_ResponseSyntax) ** 上次修改資源的時間。時間戳記取決於任務的狀態： + `CREATE_PENDING` - `CreationTime`。 + `CREATE_IN_PROGRESS` - 目前的時間戳記。 + `CREATE_STOPPING` - 目前的時間戳記。 + `CREATE_STOPPED` - 任務停止時。 + `ACTIVE` 或 `CREATE_FAILED` - 任務完成或失敗時。類型：Timestamp ** [Message](#API_DescribeAutoPredictor_ResponseSyntax) ** 發生錯誤時，會出現詳細說明錯誤原因的訊息。類型：字串 ** [MonitorInfo](#API_DescribeAutoPredictor_ResponseSyntax) ** 具有 Amazon Resource Name (ARN) 和監視器資源狀態的[MonitorInfo](API_MonitorInfo.md)物件。類型：[MonitorInfo](API_MonitorInfo.md) 物件 ** [OptimizationMetric](#API_DescribeAutoPredictor_ResponseSyntax) ** 用於最佳化預測器的準確度指標。類型：字串有效值:`WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE` ** [PredictorArn](#API_DescribeAutoPredictor_ResponseSyntax) ** 預測器的 Amazon Resource Name (ARN) 類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [PredictorName](#API_DescribeAutoPredictor_ResponseSyntax) ** 預測器的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` ** [ReferencePredictorSummary](#API_DescribeAutoPredictor_ResponseSyntax) ** 參考預測器的 ARN 和狀態。此參數僅適用於重新訓練或升級的預測器。類型：[ReferencePredictorSummary](API_ReferencePredictorSummary.md) 物件 ** [Status](#API_DescribeAutoPredictor_ResponseSyntax) ** 預測器的狀態。狀態包括： + `ACTIVE` + `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` + `CREATE_STOPPING`, `CREATE_STOPPED` + `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 類型：字串長度限制：長度上限為 256。 ** [TimeAlignmentBoundary](#API_DescribeAutoPredictor_ResponseSyntax) ** 彙總資料時使用的時間界限預測。類型：[TimeAlignmentBoundary](API_TimeAlignmentBoundary.md) 物件 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DescribeAutoPredictor) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribeAutoPredictor) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeAutoPredictor) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribeAutoPredictor) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DescribeAutoPredictor) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeAutoPredictor) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DescribeAutoPredictor) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribeAutoPredictor) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribeAutoPredictor) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeAutoPredictor) # DescribeDataset 描述使用 [CreateDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDataset.html) 操作建立的 Amazon Forecast 資料集。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 除了列出`CreateDataset`請求中指定的參數之外，此操作還包含下列資料集屬性： + `CreationTime` + `LastModificationTime` + `Status` ## 請求語法 ``` { "DatasetArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [DatasetArn](#API_DescribeDataset_RequestSyntax) ** 資料集的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應語法 ``` { "CreationTime": number, "DataFrequency": "string", "DatasetArn": "string", "DatasetName": "string", "DatasetType": "string", "Domain": "string", "EncryptionConfig": { "KMSKeyArn": "string", "RoleArn": "string" }, "LastModificationTime": number, "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] }, "Status": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [CreationTime](#API_DescribeDataset_ResponseSyntax) ** 建立資料集時。類型：Timestamp ** [DataFrequency](#API_DescribeDataset_ResponseSyntax) ** 資料收集的頻率。有效間隔為 Y (年)、M (月)、W (週)、D (天)、H (小時)、30min (30 分鐘)、15min (15 分鐘)、10min (10 分鐘)、5min (5 分鐘) 和 1min (1 分鐘)。例如，"M" 表示每月，而 "30min" 表示每 30 分鐘。類型：字串長度限制：長度下限為 1。長度上限為 5。模式：`^Y|M|W|D|H|30min|15min|10min|5min|1min$` ** [DatasetArn](#API_DescribeDataset_ResponseSyntax) ** 資料集的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [DatasetName](#API_DescribeDataset_ResponseSyntax) ** 資料集的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` ** [DatasetType](#API_DescribeDataset_ResponseSyntax) ** 資料集類型。類型：字串有效值:`TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA` ** [Domain](#API_DescribeDataset_ResponseSyntax) ** 與資料集相關聯的網域。類型：字串有效值:`RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS` ** [EncryptionConfig](#API_DescribeDataset_ResponseSyntax) ** Amazon Forecast 可以擔任的 AWS Key Management Service (KMS) 金鑰和 AWS Identity and Access Management (IAM) 角色來存取金鑰。類型：[EncryptionConfig](API_EncryptionConfig.md) 物件 ** [LastModificationTime](#API_DescribeDataset_ResponseSyntax) ** 當您建立資料集時， `LastModificationTime` 與相同`CreationTime`。將資料匯入資料集時， `LastModificationTime`是`DescribeDataset`呼叫的目前時間。[CreateDatasetImportJob](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetImportJob.html) 操作完成後，即`LastModificationTime`為匯入任務完成或失敗的時間。類型：Timestamp ** [Schema](#API_DescribeDataset_ResponseSyntax) ** 指定資料集欄位的`SchemaAttribute`物件陣列。每個 `SchemaAttribute` 指定欄位的名稱和資料類型。類型：[Schema](API_Schema.md) 物件 ** [Status](#API_DescribeDataset_ResponseSyntax) ** 資料集的狀態。狀態包括： + `ACTIVE` + `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` + `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` + `UPDATE_PENDING`, `UPDATE_IN_PROGRESS`, `UPDATE_FAILED` 這些`UPDATE`狀態會在資料從呼叫 [CreateDatasetImportJob](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetImportJob.html) 操作匯入資料集時套用，並反映資料集匯入任務的狀態。例如，當匯入任務狀態為時`CREATE_IN_PROGRESS`，資料集的狀態為 `UPDATE_IN_PROGRESS`。資料集`Status`的必須是 `ACTIVE`，才能匯入訓練資料。類型：字串長度限制：長度上限為 256。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DescribeDataset) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribeDataset) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeDataset) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribeDataset) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DescribeDataset) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeDataset) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DescribeDataset) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribeDataset) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribeDataset) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeDataset) # DescribeDatasetGroup 描述使用 [CreateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetGroup.html) 操作建立的資料集群組。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 除了列出`CreateDatasetGroup`請求中提供的參數之外，此操作還包含下列屬性： + `DatasetArns` - 屬於群組的資料集。 + `CreationTime` + `LastModificationTime` + `Status` ## 請求語法 ``` { "DatasetGroupArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [DatasetGroupArn](#API_DescribeDatasetGroup_RequestSyntax) ** 資料集群組的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應語法 ``` { "CreationTime": number, "DatasetArns": [ "string" ], "DatasetGroupArn": "string", "DatasetGroupName": "string", "Domain": "string", "LastModificationTime": number, "Status": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [CreationTime](#API_DescribeDatasetGroup_ResponseSyntax) ** 建立資料集群組時。類型：Timestamp ** [DatasetArns](#API_DescribeDatasetGroup_ResponseSyntax) ** 包含在資料集群組中的資料集的 Amazon Resource Name (ARNs) 陣列。類型：字串陣列長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [DatasetGroupArn](#API_DescribeDatasetGroup_ResponseSyntax) ** 資料集群組的 ARN。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [DatasetGroupName](#API_DescribeDatasetGroup_ResponseSyntax) ** 資料集群組的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` ** [Domain](#API_DescribeDatasetGroup_ResponseSyntax) ** 與資料集群組相關聯的網域。類型：字串有效值:`RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS` ** [LastModificationTime](#API_DescribeDatasetGroup_ResponseSyntax) ** 資料集群組從呼叫 [UpdateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_UpdateDatasetGroup.html) 操作建立或上次更新時。正在更新資料集群組時， `LastModificationTime`是`DescribeDatasetGroup`呼叫的目前時間。類型：Timestamp ** [Status](#API_DescribeDatasetGroup_ResponseSyntax) ** 資料集群組的狀態。狀態包括： + `ACTIVE` + `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` + `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` + `UPDATE_PENDING`, `UPDATE_IN_PROGRESS`, `UPDATE_FAILED` 這些`UPDATE`狀態會在您呼叫 [UpdateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_UpdateDatasetGroup.html) 操作時套用。資料集群組`Status`的必須是 `ACTIVE`，才能使用資料集群組來建立預測器。類型：字串長度限制：長度上限為 256。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DescribeDatasetGroup) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribeDatasetGroup) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeDatasetGroup) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribeDatasetGroup) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DescribeDatasetGroup) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeDatasetGroup) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DescribeDatasetGroup) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribeDatasetGroup) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribeDatasetGroup) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeDatasetGroup) # DescribeDatasetImportJob 描述使用 [CreateDatasetImportJob](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetImportJob.html) 操作建立的資料集匯入任務。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 除了列出`CreateDatasetImportJob`請求中提供的參數之外，此操作還包含下列屬性： + `CreationTime` + `LastModificationTime` + `DataSize` + `FieldStatistics` + `Status` + `Message` - 如果發生錯誤，請提供錯誤的相關資訊。 ## 請求語法 ``` { "DatasetImportJobArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [DatasetImportJobArn](#API_DescribeDatasetImportJob_RequestSyntax) ** 資料集匯入任務的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`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 } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [CreationTime](#API_DescribeDatasetImportJob_ResponseSyntax) ** 資料集匯入任務建立時。類型：Timestamp ** [DatasetArn](#API_DescribeDatasetImportJob_ResponseSyntax) ** 訓練資料匯入目的地之資料集的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [DatasetImportJobArn](#API_DescribeDatasetImportJob_ResponseSyntax) ** 資料集匯入任務的 ARN。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [DatasetImportJobName](#API_DescribeDatasetImportJob_ResponseSyntax) ** 資料集匯入任務的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` ** [DataSize](#API_DescribeDatasetImportJob_ResponseSyntax) ** 匯入任務完成後，資料集的大小，以 GB (GB) 為單位。類型：Double ** [DataSource](#API_DescribeDatasetImportJob_ResponseSyntax) ** 要匯入的訓練資料位置和 AWS Identity and Access Management (IAM) 角色，Amazon Forecast 可以擔任該角色來存取資料。如果使用加密， `DataSource`會包含 AWS Key Management Service (KMS) 金鑰。類型：[DataSource](API_DataSource.md) 物件 ** [EstimatedTimeRemainingInMinutes](#API_DescribeDatasetImportJob_ResponseSyntax) ** 資料集匯入任務的估計剩餘分鐘數。類型：Long ** [FieldStatistics](#API_DescribeDatasetImportJob_ResponseSyntax) ** 輸入資料中每個欄位的統計資訊。類型：字串到[Statistics](API_Statistics.md)物件映射金鑰長度限制：長度上限為 256。金鑰模式：`^[a-zA-Z0-9\_]+$` ** [Format](#API_DescribeDatasetImportJob_ResponseSyntax) ** 匯入資料的格式，CSV 或 PARQUET。類型：字串長度限制：長度上限為 7。模式：`^CSV|PARQUET$` ** [GeolocationFormat](#API_DescribeDatasetImportJob_ResponseSyntax) ** 地理位置屬性的格式。有效值：`"LAT_LONG"` 和 `"CC_POSTALCODE"`。類型：字串長度限制：長度上限為 256。模式：`^[a-zA-Z0-9_]+$` ** [ImportMode](#API_DescribeDatasetImportJob_ResponseSyntax) ** 資料集匯入任務的匯入模式，FULL 或 INCREMENTAL。類型：字串有效值:`FULL | INCREMENTAL` ** [LastModificationTime](#API_DescribeDatasetImportJob_ResponseSyntax) ** 上次修改資源的時間。時間戳記取決於任務的狀態： + `CREATE_PENDING` - `CreationTime`。 + `CREATE_IN_PROGRESS` - 目前的時間戳記。 + `CREATE_STOPPING` - 目前的時間戳記。 + `CREATE_STOPPED` - 任務停止時。 + `ACTIVE` 或 `CREATE_FAILED` - 任務完成或失敗時。類型：Timestamp ** [Message](#API_DescribeDatasetImportJob_ResponseSyntax) ** 如果發生錯誤，則會顯示有關錯誤的資訊訊息。類型：字串 ** [Status](#API_DescribeDatasetImportJob_ResponseSyntax) ** 資料集匯入任務的狀態。狀態包括： + `ACTIVE` + `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` + `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` + `CREATE_STOPPING`, `CREATE_STOPPED` 類型：字串長度限制：長度上限為 256。 ** [TimestampFormat](#API_DescribeDatasetImportJob_ResponseSyntax) ** 資料集中的時間戳記格式。您指定的格式取決於建立資料集時`DataFrequency`指定的。支援下列格式 + "yyyy-MM-dd" 對於下列資料頻率：Y、M、W 和 D + "yyyy-MM-dd HH:mm:ss" 對於下列資料頻率：H、30 分鐘、15 分鐘和 1 分鐘；以及選擇性：Y、M、W 和 D 類型：字串長度限制：長度上限為 256。模式：`^[a-zA-Z0-9\-\:\.\,\'\s]+$` ** [TimeZone](#API_DescribeDatasetImportJob_ResponseSyntax) ** 套用至資料集中每個項目的單一時區類型：字串長度限制：長度上限為 256。模式：`^[a-zA-Z0-9\/\+\-\_]+$` ** [UseGeolocationForTimeZone](#API_DescribeDatasetImportJob_ResponseSyntax) ** `TimeZone` 是否自動衍生自地理位置屬性。類型：布林值 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DescribeDatasetImportJob) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribeDatasetImportJob) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeDatasetImportJob) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribeDatasetImportJob) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DescribeDatasetImportJob) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeDatasetImportJob) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DescribeDatasetImportJob) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribeDatasetImportJob) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribeDatasetImportJob) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeDatasetImportJob) # DescribeExplainability 描述使用 [CreateExplainability](API_CreateExplainability.md)操作建立的可解釋性資源。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "ExplainabilityArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [ExplainabilityArn](#API_DescribeExplainability_RequestSyntax) ** 可描述性的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應語法 ``` { "CreationTime": number, "DataSource": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "EnableVisualization": boolean, "EndDateTime": "string", "EstimatedTimeRemainingInMinutes": number, "ExplainabilityArn": "string", "ExplainabilityConfig": { "TimePointGranularity": "string", "TimeSeriesGranularity": "string" }, "ExplainabilityName": "string", "LastModificationTime": number, "Message": "string", "ResourceArn": "string", "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] }, "StartDateTime": "string", "Status": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [CreationTime](#API_DescribeExplainability_ResponseSyntax) ** 可解釋性資源建立的時間。類型：Timestamp ** [DataSource](#API_DescribeExplainability_ResponseSyntax) ** 資料來源，允許 Amazon Forecast 存取資料的 AWS Identity and Access Management (IAM) 角色，以及選擇性的 AWS Key Management Service (KMS) 金鑰。類型：[DataSource](API_DataSource.md) 物件 ** [EnableVisualization](#API_DescribeExplainability_ResponseSyntax) ** 是否已啟用可解釋性資源的視覺化。類型：布林值 ** [EndDateTime](#API_DescribeExplainability_ResponseSyntax) ** 如果 `TimePointGranularity` 設定為 `SPECIFIC`，則為解釋性中的最後一個時間點。類型：字串長度限制：長度上限為 19。模式：`^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$` ** [EstimatedTimeRemainingInMinutes](#API_DescribeExplainability_ResponseSyntax) ** [CreateExplainability](API_CreateExplainability.md) 工作完成的估計剩餘分鐘數。類型：Long ** [ExplainabilityArn](#API_DescribeExplainability_ResponseSyntax) ** 可解釋性的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [ExplainabilityConfig](#API_DescribeExplainability_ResponseSyntax) ** 定義可解釋性之時間序列和時間點精細性的組態設定。類型：[ExplainabilityConfig](API_ExplainabilityConfig.md) 物件 ** [ExplainabilityName](#API_DescribeExplainability_ResponseSyntax) ** 可解釋性的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` ** [LastModificationTime](#API_DescribeExplainability_ResponseSyntax) ** 上次修改資源的時間。時間戳記取決於任務的狀態： + `CREATE_PENDING` - `CreationTime`。 + `CREATE_IN_PROGRESS` - 目前的時間戳記。 + `CREATE_STOPPING` - 目前的時間戳記。 + `CREATE_STOPPED` - 任務停止時。 + `ACTIVE` 或 `CREATE_FAILED` - 任務完成或失敗時。類型：Timestamp ** [Message](#API_DescribeExplainability_ResponseSyntax) ** 如果發生錯誤，則會顯示有關錯誤的訊息。類型：字串 ** [ResourceArn](#API_DescribeExplainability_ResponseSyntax) ** 用於建立可解釋性資源的預測器或預測的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [Schema](#API_DescribeExplainability_ResponseSyntax) ** 定義資料集的欄位。類型：[Schema](API_Schema.md) 物件 ** [StartDateTime](#API_DescribeExplainability_ResponseSyntax) ** 如果 `TimePointGranularity` 設定為 `SPECIFIC`，則會在可解釋性中的第一個時間點。類型：字串長度限制：長度上限為 19。模式：`^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$` ** [Status](#API_DescribeExplainability_ResponseSyntax) ** Explainability 資源的狀態。狀態包括： + `ACTIVE` + `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` + `CREATE_STOPPING`, `CREATE_STOPPED` + `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 類型：字串長度限制：長度上限為 256。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DescribeExplainability) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribeExplainability) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeExplainability) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribeExplainability) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DescribeExplainability) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeExplainability) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DescribeExplainability) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribeExplainability) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribeExplainability) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeExplainability) # DescribeExplainabilityExport 描述使用 [CreateExplainabilityExport](API_CreateExplainabilityExport.md)操作建立的可解釋性匯出。 ## 請求語法 ``` { "ExplainabilityExportArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [ExplainabilityExportArn](#API_DescribeExplainabilityExport_RequestSyntax) ** 可解釋性匯出的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應語法 ``` { "CreationTime": number, "Destination": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "ExplainabilityArn": "string", "ExplainabilityExportArn": "string", "ExplainabilityExportName": "string", "Format": "string", "LastModificationTime": number, "Message": "string", "Status": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [CreationTime](#API_DescribeExplainabilityExport_ResponseSyntax) ** 可解釋性匯出建立時。類型：Timestamp ** [Destination](#API_DescribeExplainabilityExport_ResponseSyntax) ** 匯出任務的目的地。提供 S3 路徑、允許 Amazon Forecast 存取位置的 AWS Identity and Access Management (IAM) 角色，以及 AWS Key Management Service (KMS) 金鑰（選用）。類型：[DataDestination](API_DataDestination.md) 物件 ** [ExplainabilityArn](#API_DescribeExplainabilityExport_ResponseSyntax) ** 可解釋性匯出的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [ExplainabilityExportArn](#API_DescribeExplainabilityExport_ResponseSyntax) ** 可解釋性匯出的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [ExplainabilityExportName](#API_DescribeExplainabilityExport_ResponseSyntax) ** Explainability 匯出的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` ** [Format](#API_DescribeExplainabilityExport_ResponseSyntax) ** 匯出資料的格式，CSV 或 PARQUET。類型：字串長度限制：長度上限為 7。模式：`^CSV|PARQUET$` ** [LastModificationTime](#API_DescribeExplainabilityExport_ResponseSyntax) ** 上次修改資源的時間。時間戳記取決於任務的狀態： + `CREATE_PENDING` - `CreationTime`。 + `CREATE_IN_PROGRESS` - 目前的時間戳記。 + `CREATE_STOPPING` - 目前的時間戳記。 + `CREATE_STOPPED` - 任務停止時。 + `ACTIVE` 或 `CREATE_FAILED` - 任務完成或失敗時。類型：Timestamp ** [Message](#API_DescribeExplainabilityExport_ResponseSyntax) ** 匯出期間發生的任何錯誤的相關資訊。類型：字串 ** [Status](#API_DescribeExplainabilityExport_ResponseSyntax) ** 可解釋性匯出的狀態。狀態包括： + `ACTIVE` + `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` + `CREATE_STOPPING`, `CREATE_STOPPED` + `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 類型：字串長度限制：長度上限為 256。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DescribeExplainabilityExport) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribeExplainabilityExport) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeExplainabilityExport) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribeExplainabilityExport) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DescribeExplainabilityExport) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeExplainabilityExport) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DescribeExplainabilityExport) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribeExplainabilityExport) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribeExplainabilityExport) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeExplainabilityExport) # DescribeForecast 描述使用 [CreateForecast](API_CreateForecast.md)操作建立的預測。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 除了列出`CreateForecast`請求中提供的屬性之外，此操作還會列出下列屬性： + `DatasetGroupArn` - 提供訓練資料的資料集群組。 + `CreationTime` + `LastModificationTime` + `Status` + `Message` - 如果發生錯誤，請提供錯誤的相關資訊。 ## 請求語法 ``` { "ForecastArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [ForecastArn](#API_DescribeForecast_RequestSyntax) ** 預測的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應語法 ``` { "CreationTime": number, "DatasetGroupArn": "string", "EstimatedTimeRemainingInMinutes": number, "ForecastArn": "string", "ForecastName": "string", "ForecastTypes": [ "string" ], "LastModificationTime": number, "Message": "string", "PredictorArn": "string", "Status": "string", "TimeSeriesSelector": { "TimeSeriesIdentifiers": { "DataSource": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "Format": "string", "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] } } } } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [CreationTime](#API_DescribeForecast_ResponseSyntax) ** 建立預測建立任務時。類型：Timestamp ** [DatasetGroupArn](#API_DescribeForecast_ResponseSyntax) ** 資料集群組的 ARN，提供用於訓練預測器的資料。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [EstimatedTimeRemainingInMinutes](#API_DescribeForecast_ResponseSyntax) ** 預測任務完成的預估剩餘分鐘數。類型：Long ** [ForecastArn](#API_DescribeForecast_ResponseSyntax) ** 請求中指定的預測 ARN。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [ForecastName](#API_DescribeForecast_ResponseSyntax) ** 預測的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` ** [ForecastTypes](#API_DescribeForecast_ResponseSyntax) ** 產生機率預測的分位數。類型：字串陣列陣列成員：項目數下限為 1。項目數上限為 20。長度限制：長度下限為 2。長度上限為 4。模式：`(^0?\.\d\d?$|^mean$)` ** [LastModificationTime](#API_DescribeForecast_ResponseSyntax) ** 上次修改資源的時間。時間戳記取決於任務的狀態： + `CREATE_PENDING` - `CreationTime`。 + `CREATE_IN_PROGRESS` - 目前的時間戳記。 + `CREATE_STOPPING` - 目前的時間戳記。 + `CREATE_STOPPED` - 任務停止時。 + `ACTIVE` 或 `CREATE_FAILED` - 任務完成或失敗時。類型：Timestamp ** [Message](#API_DescribeForecast_ResponseSyntax) ** 如果發生錯誤，則會顯示有關錯誤的資訊訊息。類型：字串 ** [PredictorArn](#API_DescribeForecast_ResponseSyntax) ** 用來產生預測的預測器 ARN。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [Status](#API_DescribeForecast_ResponseSyntax) ** 預測的狀態。狀態包括： + `ACTIVE` + `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` + `CREATE_STOPPING`, `CREATE_STOPPED` + `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 預測`Status`的必須在您可以查詢或匯出預測`ACTIVE`之前。類型：字串長度限制：長度上限為 256。模式：`^[a-zA-Z0-9\_]+$` ** [TimeSeriesSelector](#API_DescribeForecast_ResponseSyntax) ** 要包含在預測中的時間序列。類型：[TimeSeriesSelector](API_TimeSeriesSelector.md) 物件 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DescribeForecast) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribeForecast) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeForecast) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribeForecast) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DescribeForecast) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeForecast) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DescribeForecast) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribeForecast) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribeForecast) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeForecast) # DescribeForecastExportJob 描述使用 [CreateForecastExportJob](API_CreateForecastExportJob.md)操作建立的預測匯出任務。除了列出使用者在`CreateForecastExportJob`請求中提供的屬性之外，此操作還會列出下列屬性： + `CreationTime` + `LastModificationTime` + `Status` + `Message` - 如果發生錯誤，請提供錯誤的相關資訊。 ## 請求語法 ``` { "ForecastExportJobArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [ForecastExportJobArn](#API_DescribeForecastExportJob_RequestSyntax) ** 預測匯出任務的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應語法 ``` { "CreationTime": number, "Destination": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "ForecastArn": "string", "ForecastExportJobArn": "string", "ForecastExportJobName": "string", "Format": "string", "LastModificationTime": number, "Message": "string", "Status": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [CreationTime](#API_DescribeForecastExportJob_ResponseSyntax) ** 建立預測匯出任務時。類型：Timestamp ** [Destination](#API_DescribeForecastExportJob_ResponseSyntax) ** 匯出預測的 Amazon Simple Storage Service (Amazon S3) 儲存貯體路徑。類型：[DataDestination](API_DataDestination.md) 物件 ** [ForecastArn](#API_DescribeForecastExportJob_ResponseSyntax) ** 匯出預測的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [ForecastExportJobArn](#API_DescribeForecastExportJob_ResponseSyntax) ** 預測匯出任務的 ARN。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [ForecastExportJobName](#API_DescribeForecastExportJob_ResponseSyntax) ** 預測匯出任務的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` ** [Format](#API_DescribeForecastExportJob_ResponseSyntax) ** 匯出資料的格式，CSV 或 PARQUET。類型：字串長度限制：長度上限為 7。模式：`^CSV|PARQUET$` ** [LastModificationTime](#API_DescribeForecastExportJob_ResponseSyntax) ** 上次修改資源的時間。時間戳記取決於任務的狀態： + `CREATE_PENDING` - `CreationTime`。 + `CREATE_IN_PROGRESS` - 目前的時間戳記。 + `CREATE_STOPPING` - 目前的時間戳記。 + `CREATE_STOPPED` - 任務停止時。 + `ACTIVE` 或 `CREATE_FAILED` - 任務完成或失敗時。類型：Timestamp ** [Message](#API_DescribeForecastExportJob_ResponseSyntax) ** 如果發生錯誤，則會顯示有關錯誤的資訊訊息。類型：字串 ** [Status](#API_DescribeForecastExportJob_ResponseSyntax) ** 預測匯出任務的狀態。狀態包括： + `ACTIVE` + `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` + `CREATE_STOPPING`, `CREATE_STOPPED` + `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 預測匯出任務`Status`的必須是 `ACTIVE`，您才能存取 S3 儲存貯體中的預測。類型：字串長度限制：長度上限為 256。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DescribeForecastExportJob) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribeForecastExportJob) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeForecastExportJob) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribeForecastExportJob) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DescribeForecastExportJob) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeForecastExportJob) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DescribeForecastExportJob) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribeForecastExportJob) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribeForecastExportJob) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeForecastExportJob) # DescribeMonitor 描述監視器資源。除了列出[CreateMonitor](API_CreateMonitor.md)請求中提供的屬性之外，此操作還會列出下列屬性： + `Baseline` + `CreationTime` + `LastEvaluationTime` + `LastEvaluationState` + `LastModificationTime` + `Message` + `Status` **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "MonitorArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [MonitorArn](#API_DescribeMonitor_RequestSyntax) ** 要描述之監視器資源的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應語法 ``` { "Baseline": { "PredictorBaseline": { "BaselineMetrics": [ { "Name": "string", "Value": number } ] } }, "CreationTime": number, "EstimatedEvaluationTimeRemainingInMinutes": number, "LastEvaluationState": "string", "LastEvaluationTime": number, "LastModificationTime": number, "Message": "string", "MonitorArn": "string", "MonitorName": "string", "ResourceArn": "string", "Status": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Baseline](#API_DescribeMonitor_ResponseSyntax) ** 您可以用來做為比較基準的指標。使用這些值來解譯自動預測器的監控結果。類型：[Baseline](API_Baseline.md) 物件 ** [CreationTime](#API_DescribeMonitor_ResponseSyntax) ** 建立監控資源時的時間戳記。類型：Timestamp ** [EstimatedEvaluationTimeRemainingInMinutes](#API_DescribeMonitor_ResponseSyntax) ** 監視器資源完成其目前評估之前剩餘的估計分鐘數。類型：Long ** [LastEvaluationState](#API_DescribeMonitor_ResponseSyntax) ** 監視器最新評估的狀態。類型：字串長度限制：長度上限為 256。 ** [LastEvaluationTime](#API_DescribeMonitor_ResponseSyntax) ** 監控器完成的最新評估時間戳記。類型：Timestamp ** [LastModificationTime](#API_DescribeMonitor_ResponseSyntax) ** 監視器最新修改的時間戳記。類型：Timestamp ** [Message](#API_DescribeMonitor_ResponseSyntax) ** 監視器的錯誤訊息，如果有的話。類型：字串 ** [MonitorArn](#API_DescribeMonitor_ResponseSyntax) ** 所述的監控資源的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [MonitorName](#API_DescribeMonitor_ResponseSyntax) ** 監控器的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` ** [ResourceArn](#API_DescribeMonitor_ResponseSyntax) ** 要監控之自動預測器的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [Status](#API_DescribeMonitor_ResponseSyntax) ** 監控資源的狀態。類型：字串長度限制：長度上限為 256。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DescribeMonitor) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribeMonitor) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeMonitor) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribeMonitor) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DescribeMonitor) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeMonitor) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DescribeMonitor) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribeMonitor) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribeMonitor) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeMonitor) # DescribePredictor **注意** 此操作僅適用於使用 CreatePredictor 建立的舊版預測器。如果您未使用舊版預測器，請使用 [DescribeAutoPredictor](API_DescribeAutoPredictor.md)。描述使用 [CreatePredictor](API_CreatePredictor.md)操作建立的預測器。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 除了列出`CreatePredictor`請求中提供的屬性之外，此操作還會列出下列屬性： + `DatasetImportJobArns` - 用來匯入訓練資料的資料集匯入任務。 + `AutoMLAlgorithmArns` - 如果執行 AutoML，則會評估演算法。 + `CreationTime` + `LastModificationTime` + `Status` + `Message` - 如果發生錯誤，請提供錯誤的相關資訊。 ## 請求語法 ``` { "PredictorArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [PredictorArn](#API_DescribePredictor_RequestSyntax) ** 您希望取得資訊的預測器 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應語法 ``` { "AlgorithmArn": "string", "AutoMLAlgorithmArns": [ "string" ], "AutoMLOverrideStrategy": "string", "CreationTime": number, "DatasetImportJobArns": [ "string" ], "EncryptionConfig": { "KMSKeyArn": "string", "RoleArn": "string" }, "EstimatedTimeRemainingInMinutes": number, "EvaluationParameters": { "BackTestWindowOffset": number, "NumberOfBacktestWindows": number }, "FeaturizationConfig": { "Featurizations": [ { "AttributeName": "string", "FeaturizationPipeline": [ { "FeaturizationMethodName": "string", "FeaturizationMethodParameters": { "string" : "string" } } ] } ], "ForecastDimensions": [ "string" ], "ForecastFrequency": "string" }, "ForecastHorizon": number, "ForecastTypes": [ "string" ], "HPOConfig": { "ParameterRanges": { "CategoricalParameterRanges": [ { "Name": "string", "Values": [ "string" ] } ], "ContinuousParameterRanges": [ { "MaxValue": number, "MinValue": number, "Name": "string", "ScalingType": "string" } ], "IntegerParameterRanges": [ { "MaxValue": number, "MinValue": number, "Name": "string", "ScalingType": "string" } ] } }, "InputDataConfig": { "DatasetGroupArn": "string", "SupplementaryFeatures": [ { "Name": "string", "Value": "string" } ] }, "IsAutoPredictor": boolean, "LastModificationTime": number, "Message": "string", "OptimizationMetric": "string", "PerformAutoML": boolean, "PerformHPO": boolean, "PredictorArn": "string", "PredictorExecutionDetails": { "PredictorExecutions": [ { "AlgorithmArn": "string", "TestWindows": [ { "Message": "string", "Status": "string", "TestWindowEnd": number, "TestWindowStart": number } ] } ] }, "PredictorName": "string", "Status": "string", "TrainingParameters": { "string" : "string" } } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [AlgorithmArn](#API_DescribePredictor_ResponseSyntax) ** 用於模型訓練之演算法的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [AutoMLAlgorithmArns](#API_DescribePredictor_ResponseSyntax) ** 指定 `PerformAutoML` 時，所選演算法的 ARN。類型：字串陣列長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [AutoMLOverrideStrategy](#API_DescribePredictor_ResponseSyntax) ** `LatencyOptimized` AutoML 覆寫策略僅適用於私有 Beta 版。請聯絡 AWS Support 或您的客戶經理，以進一步了解存取權限。用來訓練預測器的 AutoML 策略。除非指定 `LatencyOptimized` ，否則 AutoML 策略會最佳化預測器準確性。此參數僅適用於使用 AutoML 訓練的預測器。類型：字串有效值:`LatencyOptimized | AccuracyOptimized` ** [CreationTime](#API_DescribePredictor_ResponseSyntax) ** 建立模型訓練任務時。類型：Timestamp ** [DatasetImportJobArns](#API_DescribePredictor_ResponseSyntax) ** 資料集匯入任務的 ARNs 陣列，用於匯入預測器的訓練資料。類型：字串陣列長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [EncryptionConfig](#API_DescribePredictor_ResponseSyntax) ** Amazon Forecast 可以擔任的 AWS Key Management Service (KMS) 金鑰和 AWS Identity and Access Management (IAM) 角色來存取金鑰。類型：[EncryptionConfig](API_EncryptionConfig.md) 物件 ** [EstimatedTimeRemainingInMinutes](#API_DescribePredictor_ResponseSyntax) ** 預測器訓練任務的預估剩餘分鐘數。類型：Long ** [EvaluationParameters](#API_DescribePredictor_ResponseSyntax) ** 用來覆寫指定演算法的預設評估參數。Amazon Forecast 透過將資料集分割為訓練資料和測試資料來評估預測器。評估參數定義如何執行分割和反覆運算的數量。類型：[EvaluationParameters](API_EvaluationParameters.md) 物件 ** [FeaturizationConfig](#API_DescribePredictor_ResponseSyntax) ** 特徵化組態。類型：[FeaturizationConfig](API_FeaturizationConfig.md) 物件 ** [ForecastHorizon](#API_DescribePredictor_ResponseSyntax) ** 預測的時間步驟數目。預測期間也稱為預測長度。類型：整數 ** [ForecastTypes](#API_DescribePredictor_ResponseSyntax) ** 預測器訓練期間使用的預測類型。預設值為 `["0.1","0.5","0.9"]` 類型：字串陣列陣列成員：項目數下限為 1。項目數上限為 20。長度限制：長度下限為 2。長度上限為 4。模式：`(^0?\.\d\d?$|^mean$)` ** [HPOConfig](#API_DescribePredictor_ResponseSyntax) ** 演算法的超參數覆寫值。類型：[HyperParameterTuningJobConfig](API_HyperParameterTuningJobConfig.md) 物件 ** [InputDataConfig](#API_DescribePredictor_ResponseSyntax) ** 描述資料集群組，其中包含用於訓練預測器的資料。類型：[InputDataConfig](API_InputDataConfig.md) 物件 ** [IsAutoPredictor](#API_DescribePredictor_ResponseSyntax) ** 預測器是否使用建立[CreateAutoPredictor](API_CreateAutoPredictor.md)。類型：布林值 ** [LastModificationTime](#API_DescribePredictor_ResponseSyntax) ** 上次修改資源的時間。時間戳記取決於任務的狀態： + `CREATE_PENDING` - `CreationTime`。 + `CREATE_IN_PROGRESS` - 目前的時間戳記。 + `CREATE_STOPPING` - 目前的時間戳記。 + `CREATE_STOPPED` - 任務停止時。 + `ACTIVE` 或 `CREATE_FAILED` - 任務完成或失敗時。類型：Timestamp ** [Message](#API_DescribePredictor_ResponseSyntax) ** 如果發生錯誤，則會顯示有關錯誤的資訊訊息。類型：字串 ** [OptimizationMetric](#API_DescribePredictor_ResponseSyntax) ** 用於最佳化預測器的準確度指標。類型：字串有效值:`WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE` ** [PerformAutoML](#API_DescribePredictor_ResponseSyntax) ** 預測器是否設定為執行 AutoML。類型：布林值 ** [PerformHPO](#API_DescribePredictor_ResponseSyntax) ** 預測器是否設定為執行超參數最佳化 (HPO)。類型：布林值 ** [PredictorArn](#API_DescribePredictor_ResponseSyntax) ** 預測器的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` ** [PredictorExecutionDetails](#API_DescribePredictor_ResponseSyntax) ** 為評估預測器準確性而執行之回溯測試的狀態和結果的詳細資訊。您可以指定呼叫 [CreatePredictor](API_CreatePredictor.md)操作時要執行的回溯測試數目。類型：[PredictorExecutionDetails](API_PredictorExecutionDetails.md) 物件 ** [PredictorName](#API_DescribePredictor_ResponseSyntax) ** 預測器的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` ** [Status](#API_DescribePredictor_ResponseSyntax) ** 預測器的狀態。狀態包括： + `ACTIVE` + `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` + `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` + `CREATE_STOPPING`, `CREATE_STOPPED` 預測器`Status`的必須是 `ACTIVE`，才能使用預測器建立預測。類型：字串長度限制：長度上限為 256。 ** [TrainingParameters](#API_DescribePredictor_ResponseSyntax) ** 在模型訓練期間選取的預設訓練參數或覆寫。使用 CNN-QR 或 DeepAR\$1 執行 AutoML 或選擇 HPO 時，會傳回所選超參數的最佳化值。如需詳細資訊，請參閱[Amazon Forecast 演算法](aws-forecast-choosing-recipes.md)。類型：字串到字串映射映射項目：最少 0 個項目。項目數上限為 100。金鑰長度限制：長度上限為 256。金鑰模式：`^[a-zA-Z0-9\-\_\.\/\[\]\,\\]+$` 值長度限制：長度上限為 256。值模式：`^[a-zA-Z0-9\-\_\.\/\[\]\,\"\\\s]+$` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DescribePredictor) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribePredictor) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribePredictor) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribePredictor) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DescribePredictor) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribePredictor) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DescribePredictor) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribePredictor) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribePredictor) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribePredictor) # DescribePredictorBacktestExportJob 描述使用 [CreatePredictorBacktestExportJob](API_CreatePredictorBacktestExportJob.md)操作建立的預測器回溯測試匯出任務。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 除了列出使用者在`CreatePredictorBacktestExportJob`請求中提供的屬性之外，此操作還會列出下列屬性： + `CreationTime` + `LastModificationTime` + `Status` + `Message` （如果發生錯誤） ## 請求語法 ``` { "PredictorBacktestExportJobArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [PredictorBacktestExportJobArn](#API_DescribePredictorBacktestExportJob_RequestSyntax) ** 預測器回溯測試匯出任務的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應語法 ``` { "CreationTime": number, "Destination": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "Format": "string", "LastModificationTime": number, "Message": "string", "PredictorArn": "string", "PredictorBacktestExportJobArn": "string", "PredictorBacktestExportJobName": "string", "Status": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [CreationTime](#API_DescribePredictorBacktestExportJob_ResponseSyntax) ** 建立預測器回溯測試匯出任務時。類型：Timestamp ** [Destination](#API_DescribePredictorBacktestExportJob_ResponseSyntax) ** 匯出任務的目的地。提供 S3 路徑、允許 Amazon Forecast 存取位置的 AWS Identity and Access Management (IAM) 角色，以及 AWS Key Management Service (KMS) 金鑰（選用）。類型：[DataDestination](API_DataDestination.md) 物件 ** [Format](#API_DescribePredictorBacktestExportJob_ResponseSyntax) ** 匯出資料的格式，CSV 或 PARQUET。類型：字串長度限制：長度上限為 7。模式：`^CSV|PARQUET$` ** [LastModificationTime](#API_DescribePredictorBacktestExportJob_ResponseSyntax) ** 上次修改資源的時間。時間戳記取決於任務的狀態： + `CREATE_PENDING` - `CreationTime`。 + `CREATE_IN_PROGRESS` - 目前的時間戳記。 + `CREATE_STOPPING` - 目前的時間戳記。 + `CREATE_STOPPED` - 任務停止時。 + `ACTIVE` 或 `CREATE_FAILED` - 任務完成或失敗時。類型：Timestamp ** [Message](#API_DescribePredictorBacktestExportJob_ResponseSyntax) ** 有關在回溯測試匯出期間可能發生的任何錯誤的資訊。類型：字串 ** [PredictorArn](#API_DescribePredictorBacktestExportJob_ResponseSyntax) ** 預測器的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [PredictorBacktestExportJobArn](#API_DescribePredictorBacktestExportJob_ResponseSyntax) ** 預測器回溯測試匯出任務的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [PredictorBacktestExportJobName](#API_DescribePredictorBacktestExportJob_ResponseSyntax) ** 預測器回溯測試匯出任務的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` ** [Status](#API_DescribePredictorBacktestExportJob_ResponseSyntax) ** 預測器回溯測試匯出任務的狀態。狀態包括： + `ACTIVE` + `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` + `CREATE_STOPPING`, `CREATE_STOPPED` + `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 類型：字串長度限制：長度上限為 256。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DescribePredictorBacktestExportJob) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribePredictorBacktestExportJob) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribePredictorBacktestExportJob) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribePredictorBacktestExportJob) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DescribePredictorBacktestExportJob) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribePredictorBacktestExportJob) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DescribePredictorBacktestExportJob) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribePredictorBacktestExportJob) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribePredictorBacktestExportJob) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribePredictorBacktestExportJob) # DescribeWhatIfAnalysis 描述使用 [CreateWhatIfAnalysis](API_CreateWhatIfAnalysis.md)操作建立的假設分析。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 除了列出`CreateWhatIfAnalysis`請求中提供的屬性之外，此操作還會列出下列屬性： + `CreationTime` + `LastModificationTime` + `Message` - 如果發生錯誤，請提供錯誤的相關資訊。 + `Status` ## 請求語法 ``` { "WhatIfAnalysisArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [WhatIfAnalysisArn](#API_DescribeWhatIfAnalysis_RequestSyntax) ** 您感興趣的假設分析的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應語法 ``` { "CreationTime": number, "EstimatedTimeRemainingInMinutes": number, "ForecastArn": "string", "LastModificationTime": number, "Message": "string", "Status": "string", "TimeSeriesSelector": { "TimeSeriesIdentifiers": { "DataSource": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "Format": "string", "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] } } }, "WhatIfAnalysisArn": "string", "WhatIfAnalysisName": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [CreationTime](#API_DescribeWhatIfAnalysis_ResponseSyntax) ** 建立假設分析時。類型：Timestamp ** [EstimatedTimeRemainingInMinutes](#API_DescribeWhatIfAnalysis_ResponseSyntax) ** 完成假設分析的剩餘大約時間，以分鐘為單位。類型：Long ** [ForecastArn](#API_DescribeWhatIfAnalysis_ResponseSyntax) ** 假設預測的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [LastModificationTime](#API_DescribeWhatIfAnalysis_ResponseSyntax) ** 上次修改資源的時間。時間戳記取決於任務的狀態： + `CREATE_PENDING` - `CreationTime`。 + `CREATE_IN_PROGRESS` - 目前的時間戳記。 + `CREATE_STOPPING` - 目前的時間戳記。 + `CREATE_STOPPED` - 任務停止時。 + `ACTIVE` 或 `CREATE_FAILED` - 任務完成或失敗時。類型：Timestamp ** [Message](#API_DescribeWhatIfAnalysis_ResponseSyntax) ** 如果發生錯誤，則會顯示有關錯誤的資訊訊息。類型：字串 ** [Status](#API_DescribeWhatIfAnalysis_ResponseSyntax) ** 假設分析的狀態。狀態包括： + `ACTIVE` + `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` + `CREATE_STOPPING`, `CREATE_STOPPED` + `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 假設分析`Status`的必須是 `ACTIVE`，您才能存取分析。類型：字串長度限制：長度上限為 256。模式：`^[a-zA-Z0-9\_]+$` ** [TimeSeriesSelector](#API_DescribeWhatIfAnalysis_ResponseSyntax) ** 定義用來在`TimeSeriesIdentifiers`物件中建立預測的一組時間序列。 `TimeSeriesIdentifiers` 物件需要下列資訊： + `DataSource` + `Format` + `Schema` 類型：[TimeSeriesSelector](API_TimeSeriesSelector.md) 物件 ** [WhatIfAnalysisArn](#API_DescribeWhatIfAnalysis_ResponseSyntax) ** 假設分析的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [WhatIfAnalysisName](#API_DescribeWhatIfAnalysis_ResponseSyntax) ** 假設分析的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DescribeWhatIfAnalysis) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribeWhatIfAnalysis) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeWhatIfAnalysis) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribeWhatIfAnalysis) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DescribeWhatIfAnalysis) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeWhatIfAnalysis) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DescribeWhatIfAnalysis) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribeWhatIfAnalysis) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribeWhatIfAnalysis) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeWhatIfAnalysis) # DescribeWhatIfForecast 描述使用 [CreateWhatIfForecast](API_CreateWhatIfForecast.md)操作建立的假設預測。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 除了列出`CreateWhatIfForecast`請求中提供的屬性之外，此操作還會列出下列屬性： + `CreationTime` + `LastModificationTime` + `Message` - 如果發生錯誤，請提供錯誤的相關資訊。 + `Status` ## 請求語法 ``` { "WhatIfForecastArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [WhatIfForecastArn](#API_DescribeWhatIfForecast_RequestSyntax) ** 您感興趣的假設預測的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 300。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應語法 ``` { "CreationTime": number, "EstimatedTimeRemainingInMinutes": number, "ForecastTypes": [ "string" ], "LastModificationTime": number, "Message": "string", "Status": "string", "TimeSeriesReplacementsDataSource": { "Format": "string", "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" }, "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] }, "TimestampFormat": "string" }, "TimeSeriesTransformations": [ { "Action": { "AttributeName": "string", "Operation": "string", "Value": number }, "TimeSeriesConditions": [ { "AttributeName": "string", "AttributeValue": "string", "Condition": "string" } ] } ], "WhatIfAnalysisArn": "string", "WhatIfForecastArn": "string", "WhatIfForecastName": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [CreationTime](#API_DescribeWhatIfForecast_ResponseSyntax) ** 建立假設預測的時間。類型：Timestamp ** [EstimatedTimeRemainingInMinutes](#API_DescribeWhatIfForecast_ResponseSyntax) ** 完成假設預測的剩餘大約時間，以分鐘為單位。類型：Long ** [ForecastTypes](#API_DescribeWhatIfForecast_ResponseSyntax) ** 產生機率預測的分位數。您可以在 [CreateWhatIfForecast](API_CreateWhatIfForecast.md)操作中為每個假設預測指定最多五個分位數。如果您未指定分位數，預設值為 `["0.1", "0.5", "0.9"]`。類型：字串陣列陣列成員：項目數下限為 1。項目數上限為 20。長度限制：長度下限為 2。長度上限為 4。模式：`(^0?\.\d\d?$|^mean$)` ** [LastModificationTime](#API_DescribeWhatIfForecast_ResponseSyntax) ** 上次修改資源的時間。時間戳記取決於任務的狀態： + `CREATE_PENDING` - `CreationTime`。 + `CREATE_IN_PROGRESS` - 目前的時間戳記。 + `CREATE_STOPPING` - 目前的時間戳記。 + `CREATE_STOPPED` - 任務停止時。 + `ACTIVE` 或 `CREATE_FAILED` - 任務完成或失敗時。類型：Timestamp ** [Message](#API_DescribeWhatIfForecast_ResponseSyntax) ** 如果發生錯誤，則會顯示有關錯誤的資訊訊息。類型：字串 ** [Status](#API_DescribeWhatIfForecast_ResponseSyntax) ** 假設預測的狀態。狀態包括： + `ACTIVE` + `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` + `CREATE_STOPPING`, `CREATE_STOPPED` + `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 假設預測`Status`的必須是 `ACTIVE`，您才能存取預測。類型：字串長度限制：長度上限為 256。模式：`^[a-zA-Z0-9\_]+$` ** [TimeSeriesReplacementsDataSource](#API_DescribeWhatIfForecast_ResponseSyntax) ** 描述取代時間序列的 `Schema`、 `S3Config`和 `Format`元素陣列。類型：[TimeSeriesReplacementsDataSource](API_TimeSeriesReplacementsDataSource.md) 物件 ** [TimeSeriesTransformations](#API_DescribeWhatIfForecast_ResponseSyntax) ** `Action` 和 `TimeSeriesConditions`元素的陣列，描述要套用哪些轉換到哪個時間序列。類型：[TimeSeriesTransformation](API_TimeSeriesTransformation.md) 物件陣列陣列成員：項目數下限為 0。最多 30 個項目。 ** [WhatIfAnalysisArn](#API_DescribeWhatIfForecast_ResponseSyntax) ** 包含此預測之假設分析的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [WhatIfForecastArn](#API_DescribeWhatIfForecast_ResponseSyntax) ** 假設預測的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 300。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [WhatIfForecastName](#API_DescribeWhatIfForecast_ResponseSyntax) ** 假設預測的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DescribeWhatIfForecast) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribeWhatIfForecast) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeWhatIfForecast) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribeWhatIfForecast) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DescribeWhatIfForecast) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeWhatIfForecast) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DescribeWhatIfForecast) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribeWhatIfForecast) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribeWhatIfForecast) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeWhatIfForecast) # DescribeWhatIfForecastExport 描述使用 [CreateWhatIfForecastExport](API_CreateWhatIfForecastExport.md)操作建立的假設預測匯出。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 除了列出`CreateWhatIfForecastExport`請求中提供的屬性之外，此操作還會列出下列屬性： + `CreationTime` + `LastModificationTime` + `Message` - 如果發生錯誤，請提供錯誤的相關資訊。 + `Status` ## 請求語法 ``` { "WhatIfForecastExportArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [WhatIfForecastExportArn](#API_DescribeWhatIfForecastExport_RequestSyntax) ** 您感興趣的假設預測匯出的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 300。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應語法 ``` { "CreationTime": number, "Destination": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "EstimatedTimeRemainingInMinutes": number, "Format": "string", "LastModificationTime": number, "Message": "string", "Status": "string", "WhatIfForecastArns": [ "string" ], "WhatIfForecastExportArn": "string", "WhatIfForecastExportName": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [CreationTime](#API_DescribeWhatIfForecastExport_ResponseSyntax) ** 建立預測匯出時。類型：Timestamp ** [Destination](#API_DescribeWhatIfForecastExport_ResponseSyntax) ** 匯出任務的目的地。提供 S3 路徑、允許 Amazon Forecast 存取位置的 AWS Identity and Access Management (IAM) 角色，以及 AWS Key Management Service (KMS) 金鑰（選用）。類型：[DataDestination](API_DataDestination.md) 物件 ** [EstimatedTimeRemainingInMinutes](#API_DescribeWhatIfForecastExport_ResponseSyntax) ** 完成假設預測匯出的剩餘大約時間，以分鐘為單位。類型：Long ** [Format](#API_DescribeWhatIfForecastExport_ResponseSyntax) ** 匯出資料的格式，CSV 或 PARQUET。類型：字串長度限制：長度上限為 7。模式：`^CSV|PARQUET$` ** [LastModificationTime](#API_DescribeWhatIfForecastExport_ResponseSyntax) ** 上次修改資源的時間。時間戳記取決於任務的狀態： + `CREATE_PENDING` - `CreationTime`。 + `CREATE_IN_PROGRESS` - 目前的時間戳記。 + `CREATE_STOPPING` - 目前的時間戳記。 + `CREATE_STOPPED` - 任務停止時。 + `ACTIVE` 或 `CREATE_FAILED` - 任務完成或失敗時。類型：Timestamp ** [Message](#API_DescribeWhatIfForecastExport_ResponseSyntax) ** 如果發生錯誤，則會顯示有關錯誤的資訊訊息。類型：字串 ** [Status](#API_DescribeWhatIfForecastExport_ResponseSyntax) ** 假設預測的狀態。狀態包括： + `ACTIVE` + `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` + `CREATE_STOPPING`, `CREATE_STOPPED` + `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 預測匯出`Status`的必須是 `ACTIVE`，您才能存取預測匯出。類型：字串長度限制：長度上限為 256。 ** [WhatIfForecastArns](#API_DescribeWhatIfForecastExport_ResponseSyntax) ** Amazon Resource Name (ARNs) 陣列，代表此資源中匯出的所有假設預測。類型：字串陣列長度限制：長度上限為 300。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [WhatIfForecastExportArn](#API_DescribeWhatIfForecastExport_ResponseSyntax) ** 假設預測匯出的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 300。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ** [WhatIfForecastExportName](#API_DescribeWhatIfForecastExport_ResponseSyntax) ** 假設預測匯出的名稱。類型：字串長度限制：長度下限為 1。長度上限為 63。模式：`^[a-zA-Z][a-zA-Z0-9_]*` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DescribeWhatIfForecastExport) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribeWhatIfForecastExport) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeWhatIfForecastExport) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribeWhatIfForecastExport) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DescribeWhatIfForecastExport) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeWhatIfForecastExport) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DescribeWhatIfForecastExport) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribeWhatIfForecastExport) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribeWhatIfForecastExport) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeWhatIfForecastExport) # GetAccuracyMetrics 提供由 [CreatePredictor](API_CreatePredictor.md)操作訓練之模型準確性的指標。使用指標來查看模型執行的程度，並決定是否使用預測器產生預測。如需詳細資訊，請參閱[預測器指標](https://docs.aws.amazon.com/forecast/latest/dg/metrics.html)。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 此操作會為每個已評估的回溯測試時段產生指標。回溯測試時段 (`NumberOfBacktestWindows`) 的數量是使用物件指定，該[EvaluationParameters](API_EvaluationParameters.md)物件選擇性地包含在`CreatePredictor`請求中。如果`NumberOfBacktestWindows`未指定，則數字預設為 1。 `filling` 方法的參數會決定哪些項目有助於指標。如果您希望所有項目都貢獻，請指定 `zero`。如果您只想要在評估貢獻範圍內具有完整資料的項目，請指定 `nan`。如需詳細資訊，請參閱[FeaturizationMethod](API_FeaturizationMethod.md)。 **注意** 在取得準確性指標之前，預測器`Status`的必須是 `ACTIVE`，表示訓練已完成。若要取得狀態，請使用 [DescribePredictor](API_DescribePredictor.md)操作。 ## 請求語法 ``` { "PredictorArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [PredictorArn](#API_GetAccuracyMetrics_RequestSyntax) ** 要取得指標之預測器的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應語法 ``` { "AutoMLOverrideStrategy": "string", "IsAutoPredictor": boolean, "OptimizationMetric": "string", "PredictorEvaluationResults": [ { "AlgorithmArn": "string", "TestWindows": [ { "EvaluationType": "string", "ItemCount": number, "Metrics": { "AverageWeightedQuantileLoss": number, "ErrorMetrics": [ { "ForecastType": "string", "MAPE": number, "MASE": number, "RMSE": number, "WAPE": number } ], "RMSE": number, "WeightedQuantileLosses": [ { "LossValue": number, "Quantile": number } ] }, "TestWindowEnd": number, "TestWindowStart": number } ] } ] } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [AutoMLOverrideStrategy](#API_GetAccuracyMetrics_ResponseSyntax) ** `LatencyOptimized` AutoML 覆寫策略僅適用於私有 Beta 版。請聯絡 AWS Support 或您的客戶經理，以進一步了解存取權限。用來訓練預測器的 AutoML 策略。除非指定 `LatencyOptimized` ，否則 AutoML 策略會最佳化預測器準確性。此參數僅適用於使用 AutoML 訓練的預測器。類型：字串有效值:`LatencyOptimized | AccuracyOptimized` ** [IsAutoPredictor](#API_GetAccuracyMetrics_ResponseSyntax) ** 預測器是否使用建立[CreateAutoPredictor](API_CreateAutoPredictor.md)。類型：布林值 ** [OptimizationMetric](#API_GetAccuracyMetrics_ResponseSyntax) ** 用於最佳化預測器的準確度指標。類型：字串有效值:`WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE` ** [PredictorEvaluationResults](#API_GetAccuracyMetrics_ResponseSyntax) ** 評估預測器的結果陣列。類型：[EvaluationResult](API_EvaluationResult.md) 物件陣列 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/GetAccuracyMetrics) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/GetAccuracyMetrics) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/GetAccuracyMetrics) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/GetAccuracyMetrics) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/GetAccuracyMetrics) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/GetAccuracyMetrics) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/GetAccuracyMetrics) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/GetAccuracyMetrics) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/GetAccuracyMetrics) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/GetAccuracyMetrics) # ListDatasetGroups 傳回使用 [CreateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetGroup.html) 操作建立的資料集群組清單。對於每個資料集群組，此操作會傳回其屬性的摘要，包括其 Amazon Resource Name (ARN)。您可以透過使用資料集群組 ARN 搭配 [DescribeDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDatasetGroup.html) 操作來擷取完整的屬性集。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "MaxResults": number, "NextToken": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [MaxResults](#API_ListDatasetGroups_RequestSyntax) ** 回應中要傳回的項目數。類型：整數有效範圍：最小值為 1。最大值為 100。必要：否 ** [NextToken](#API_ListDatasetGroups_RequestSyntax) ** 如果先前請求的結果遭到截斷，回應會包含 `NextToken`。若要擷取下一組結果，請在下一個請求中使用字符。字符會在 24 小時後過期。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` 必要：否 ## 回應語法 ``` { "DatasetGroups": [ { "CreationTime": number, "DatasetGroupArn": "string", "DatasetGroupName": "string", "LastModificationTime": number } ], "NextToken": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [DatasetGroups](#API_ListDatasetGroups_ResponseSyntax) ** 摘要每個資料集群組屬性的物件陣列。類型：[DatasetGroupSummary](API_DatasetGroupSummary.md) 物件陣列 ** [NextToken](#API_ListDatasetGroups_ResponseSyntax) ** 如果回應被截斷，Amazon Forecast 會傳回此字符。若要擷取下一組結果，請在下一個請求中使用字符。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` ## 錯誤 ** InvalidNextTokenException ** 字符無效。字符會在 24 小時後過期。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListDatasetGroups) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListDatasetGroups) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListDatasetGroups) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListDatasetGroups) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListDatasetGroups) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListDatasetGroups) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListDatasetGroups) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListDatasetGroups) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListDatasetGroups) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListDatasetGroups) # ListDatasetImportJobs 傳回使用 [CreateDatasetImportJob](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetImportJob.html) 操作建立的資料集匯入任務清單。對於每個匯入任務，此操作會傳回其屬性的摘要，包括其 Amazon Resource Name (ARN)。您可以使用 ARN 搭配 [DescribeDatasetImportJob](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDatasetImportJob.html) 操作來擷取完整的屬性集。您可以提供篩選條件物件陣列來[篩選](https://docs.aws.amazon.com/forecast/latest/dg/API_Filter.html)清單。 ## 請求語法 ``` { "Filters": [ { "Condition": "string", "Key": "string", "Value": "string" } ], "MaxResults": number, "NextToken": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [Filters](#API_ListDatasetImportJobs_RequestSyntax) ** 篩選條件陣列。對於每個篩選條件，您提供條件和相符陳述式。條件為 `IS`或 `IS_NOT`，指定要分別包含或排除符合清單中陳述式的資料集。比對陳述式包含索引鍵和值。 **篩選條件屬性** + `Condition` - 要套用的條件。有效值為 `IS` 和 `IS_NOT`。若要包含符合陳述式的資料集，請指定 `IS`。若要排除相符的資料集，請指定 `IS_NOT`。 + `Key` - 要篩選的參數名稱。有效值為 `DatasetArn` 和 `Status`。 + `Value` - 要比對的值。例如，若要列出狀態為 ACTIVE 的所有資料集匯入任務，請指定下列篩選條件： `"Filters": [ { "Condition": "IS", "Key": "Status", "Value": "ACTIVE" } ]` 類型：[Filter](API_Filter.md) 物件陣列必要：否 ** [MaxResults](#API_ListDatasetImportJobs_RequestSyntax) ** 回應中要傳回的項目數。類型：整數有效範圍：最小值為 1。最大值為 100。必要：否 ** [NextToken](#API_ListDatasetImportJobs_RequestSyntax) ** 如果先前請求的結果遭到截斷，回應會包含 `NextToken`。若要擷取下一組結果，請在下一個請求中使用字符。字符會在 24 小時後過期。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` 必要：否 ## 回應語法 ``` { "DatasetImportJobs": [ { "CreationTime": number, "DatasetImportJobArn": "string", "DatasetImportJobName": "string", "DataSource": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "ImportMode": "string", "LastModificationTime": number, "Message": "string", "Status": "string" } ], "NextToken": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [DatasetImportJobs](#API_ListDatasetImportJobs_ResponseSyntax) ** 彙整每個資料集匯入任務屬性的物件陣列。類型：[DatasetImportJobSummary](API_DatasetImportJobSummary.md) 物件陣列 ** [NextToken](#API_ListDatasetImportJobs_ResponseSyntax) ** 如果回應被截斷，Amazon Forecast 會傳回此字符。若要擷取下一組結果，請在下一個請求中使用字符。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** InvalidNextTokenException ** 字符無效。字符會在 24 小時後過期。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListDatasetImportJobs) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListDatasetImportJobs) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListDatasetImportJobs) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListDatasetImportJobs) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListDatasetImportJobs) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListDatasetImportJobs) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListDatasetImportJobs) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListDatasetImportJobs) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListDatasetImportJobs) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListDatasetImportJobs) # ListDatasets 傳回使用 [CreateDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDataset.html) 操作建立的資料集清單。對於每個資料集，會傳回其屬性的摘要，包括其 Amazon Resource Name (ARN)。若要擷取完整的屬性集，請使用 ARN 搭配 [DescribeDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDataset.html) 操作。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "MaxResults": number, "NextToken": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [MaxResults](#API_ListDatasets_RequestSyntax) ** 回應中要傳回的項目數。類型：整數有效範圍：最小值為 1。最大值為 100。必要：否 ** [NextToken](#API_ListDatasets_RequestSyntax) ** 如果先前請求的結果遭到截斷，回應會包含 `NextToken`。若要擷取下一組結果，請在下一個請求中使用字符。字符會在 24 小時後過期。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` 必要：否 ## 回應語法 ``` { "Datasets": [ { "CreationTime": number, "DatasetArn": "string", "DatasetName": "string", "DatasetType": "string", "Domain": "string", "LastModificationTime": number } ], "NextToken": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Datasets](#API_ListDatasets_ResponseSyntax) ** 摘要每個資料集屬性的物件陣列。類型：[DatasetSummary](API_DatasetSummary.md) 物件陣列 ** [NextToken](#API_ListDatasets_ResponseSyntax) ** 如果回應被截斷，Amazon Forecast 會傳回此字符。若要擷取下一組結果，請在下一個請求中使用字符。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` ## 錯誤 ** InvalidNextTokenException ** 字符無效。字符會在 24 小時後過期。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListDatasets) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListDatasets) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListDatasets) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListDatasets) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListDatasets) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListDatasets) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListDatasets) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListDatasets) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListDatasets) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListDatasets) # ListExplainabilities 傳回使用 [CreateExplainability](API_CreateExplainability.md)操作建立的可解釋性資源清單。此操作會傳回每個可解釋性的摘要。您可以使用 [Filter](API_Filter.md) 物件陣列來篩選清單。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 若要擷取特定可解釋性資源的完整屬性集，請使用 ARN 搭配 [DescribeExplainability](API_DescribeExplainability.md)操作。 ## 請求語法 ``` { "Filters": [ { "Condition": "string", "Key": "string", "Value": "string" } ], "MaxResults": number, "NextToken": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [Filters](#API_ListExplainabilities_RequestSyntax) ** 篩選條件陣列。針對每個篩選條件，提供條件和相符陳述式。條件為 `IS`或 `IS_NOT`，指定要從清單中包含或排除符合陳述式的資源。比對陳述式包含索引鍵和值。 **篩選條件屬性** + `Condition` - 要套用的條件。有效值為 `IS` 和 `IS_NOT`。 + `Key` - 要篩選的參數名稱。有效值為 `ResourceArn` 和 `Status`。 + `Value` - 要比對的值。類型：[Filter](API_Filter.md) 物件陣列必要：否 ** [MaxResults](#API_ListExplainabilities_RequestSyntax) ** 回應中傳回的項目數。類型：整數有效範圍：最小值為 1。最大值為 100。必要：否 ** [NextToken](#API_ListExplainabilities_RequestSyntax) ** 如果先前請求的結果遭到截斷，回應會包含 NextToken。若要擷取下一組結果，請在下一個請求中使用字符。字符會在 24 小時後過期。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` 必要：否 ## 回應語法 ``` { "Explainabilities": [ { "CreationTime": number, "ExplainabilityArn": "string", "ExplainabilityConfig": { "TimePointGranularity": "string", "TimeSeriesGranularity": "string" }, "ExplainabilityName": "string", "LastModificationTime": number, "Message": "string", "ResourceArn": "string", "Status": "string" } ], "NextToken": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Explainabilities](#API_ListExplainabilities_ResponseSyntax) ** 彙整每個可解釋性資源屬性的物件陣列。類型：[ExplainabilitySummary](API_ExplainabilitySummary.md) 物件陣列 ** [NextToken](#API_ListExplainabilities_ResponseSyntax) ** 如果回應被截斷，則傳回此字符。若要擷取下一組結果，請在下一個請求中使用字符。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** InvalidNextTokenException ** 字符無效。字符會在 24 小時後過期。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListExplainabilities) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListExplainabilities) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListExplainabilities) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListExplainabilities) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListExplainabilities) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListExplainabilities) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListExplainabilities) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListExplainabilities) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListExplainabilities) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListExplainabilities) # ListExplainabilityExports 傳回使用 [CreateExplainabilityExport](API_CreateExplainabilityExport.md)操作建立的可解釋性匯出清單。此操作會傳回每個可解釋性匯出的摘要。您可以使用 [Filter](API_Filter.md) 物件陣列來篩選清單。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 若要擷取特定可解釋性匯出的完整屬性集，請使用 ARN 搭配 [DescribeExplainability](API_DescribeExplainability.md)操作。 ## 請求語法 ``` { "Filters": [ { "Condition": "string", "Key": "string", "Value": "string" } ], "MaxResults": number, "NextToken": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [Filters](#API_ListExplainabilityExports_RequestSyntax) ** 篩選條件陣列。針對每個篩選條件，提供條件和相符陳述式。條件為 `IS`或 `IS_NOT`，指定要包含或排除符合清單中陳述式的資源。比對陳述式包含索引鍵和值。 **篩選條件屬性** + `Condition` - 要套用的條件。有效值為 `IS` 和 `IS_NOT`。 + `Key` - 要篩選的參數名稱。有效值為 `ResourceArn` 和 `Status`。 + `Value` - 要比對的值。類型：[Filter](API_Filter.md) 物件陣列必要：否 ** [MaxResults](#API_ListExplainabilityExports_RequestSyntax) ** 回應中要傳回的項目數。類型：整數有效範圍：最小值為 1。最大值為 100。必要：否 ** [NextToken](#API_ListExplainabilityExports_RequestSyntax) ** 如果先前請求的結果遭到截斷，回應會包含 NextToken。若要擷取下一組結果，請在下一個請求中使用字符。字符會在 24 小時後過期。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` 必要：否 ## 回應語法 ``` { "ExplainabilityExports": [ { "CreationTime": number, "Destination": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "ExplainabilityExportArn": "string", "ExplainabilityExportName": "string", "LastModificationTime": number, "Message": "string", "Status": "string" } ], "NextToken": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [ExplainabilityExports](#API_ListExplainabilityExports_ResponseSyntax) ** 物件陣列，摘要每個可解釋性匯出的屬性。類型：[ExplainabilityExportSummary](API_ExplainabilityExportSummary.md) 物件陣列 ** [NextToken](#API_ListExplainabilityExports_ResponseSyntax) ** 如果回應被截斷，則傳回此字符。若要擷取下一組結果，請在下一個請求中使用字符。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** InvalidNextTokenException ** 字符無效。字符會在 24 小時後過期。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListExplainabilityExports) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListExplainabilityExports) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListExplainabilityExports) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListExplainabilityExports) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListExplainabilityExports) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListExplainabilityExports) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListExplainabilityExports) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListExplainabilityExports) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListExplainabilityExports) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListExplainabilityExports) # ListForecastExportJobs 傳回使用 [CreateForecastExportJob](API_CreateForecastExportJob.md)操作建立的預測匯出任務清單。對於每個預測匯出任務，此操作會傳回其屬性的摘要，包括其 Amazon Resource Name (ARN)。若要擷取完整的屬性集，請使用 ARN 搭配 [DescribeForecastExportJob](API_DescribeForecastExportJob.md)操作。您可以使用 [Filter](API_Filter.md) 物件陣列來篩選清單。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "Filters": [ { "Condition": "string", "Key": "string", "Value": "string" } ], "MaxResults": number, "NextToken": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [Filters](#API_ListForecastExportJobs_RequestSyntax) ** 篩選條件陣列。對於每個篩選條件，您提供條件和相符陳述式。條件為 `IS`或 `IS_NOT`，指定要分別包含或排除符合清單中陳述式的預測匯出任務。比對陳述式包含索引鍵和值。 **篩選條件屬性** + `Condition` - 要套用的條件。有效值為 `IS` 和 `IS_NOT`。若要包含符合陳述式的預測匯出任務，請指定 `IS`。若要排除相符的預測匯出任務，請指定 `IS_NOT`。 + `Key` - 要篩選的參數名稱。有效值為 `ForecastArn` 和 `Status`。 + `Value` - 要比對的值。例如，若要列出匯出名為 *electricityforecast* 之預測的所有任務，請指定下列篩選條件： `"Filters": [ { "Condition": "IS", "Key": "ForecastArn", "Value": "arn:aws:forecast:us-west-2::forecast/electricityforecast" } ]` 類型：[Filter](API_Filter.md) 物件陣列必要：否 ** [MaxResults](#API_ListForecastExportJobs_RequestSyntax) ** 回應中要傳回的項目數。類型：整數有效範圍：最小值為 1。最大值為 100。必要：否 ** [NextToken](#API_ListForecastExportJobs_RequestSyntax) ** 如果先前請求的結果遭到截斷，回應會包含 `NextToken`。若要擷取下一組結果，請在下一個請求中使用字符。字符會在 24 小時後過期。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` 必要：否 ## 回應語法 ``` { "ForecastExportJobs": [ { "CreationTime": number, "Destination": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "ForecastExportJobArn": "string", "ForecastExportJobName": "string", "LastModificationTime": number, "Message": "string", "Status": "string" } ], "NextToken": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [ForecastExportJobs](#API_ListForecastExportJobs_ResponseSyntax) ** 摘要每個匯出任務屬性的物件陣列。類型：[ForecastExportJobSummary](API_ForecastExportJobSummary.md) 物件陣列 ** [NextToken](#API_ListForecastExportJobs_ResponseSyntax) ** 如果回應被截斷，Amazon Forecast 會傳回此字符。若要擷取下一組結果，請在下一個請求中使用字符。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** InvalidNextTokenException ** 字符無效。字符會在 24 小時後過期。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListForecastExportJobs) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListForecastExportJobs) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListForecastExportJobs) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListForecastExportJobs) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListForecastExportJobs) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListForecastExportJobs) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListForecastExportJobs) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListForecastExportJobs) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListForecastExportJobs) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListForecastExportJobs) # ListForecasts 傳回使用 [CreateForecast](API_CreateForecast.md)操作建立的預測清單。對於每個預測，此操作會傳回其屬性的摘要，包括其 Amazon Resource Name (ARN)。若要擷取完整的屬性集，請使用 [DescribeForecast](API_DescribeForecast.md)操作指定 ARN。您可以使用 [Filter](API_Filter.md) 物件陣列來篩選清單。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "Filters": [ { "Condition": "string", "Key": "string", "Value": "string" } ], "MaxResults": number, "NextToken": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [Filters](#API_ListForecasts_RequestSyntax) ** 篩選條件陣列。對於每個篩選條件，您提供條件和相符陳述式。條件為 `IS`或 `IS_NOT`，指定要分別包含或排除符合清單中陳述式的預測。比對陳述式包含索引鍵和值。 **篩選條件屬性** + `Condition` - 要套用的條件。有效值為 `IS` 和 `IS_NOT`。若要包含符合陳述式的預測，請指定 `IS`。若要排除相符的預測，請指定 `IS_NOT`。 + `Key` - 要篩選的參數名稱。有效值為 `DatasetGroupArn`、`PredictorArn` 和 `Status`。 + `Value` - 要比對的值。例如，若要列出狀態不是 ACTIVE 的所有預測，您可以指定： `"Filters": [ { "Condition": "IS_NOT", "Key": "Status", "Value": "ACTIVE" } ]` 類型：[Filter](API_Filter.md) 物件陣列必要：否 ** [MaxResults](#API_ListForecasts_RequestSyntax) ** 回應中要傳回的項目數。類型：整數有效範圍：最小值為 1。最大值為 100。必要：否 ** [NextToken](#API_ListForecasts_RequestSyntax) ** 如果先前請求的結果遭到截斷，回應會包含 `NextToken`。若要擷取下一組結果，請在下一個請求中使用字符。字符會在 24 小時後過期。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` 必要：否 ## 回應語法 ``` { "Forecasts": [ { "CreatedUsingAutoPredictor": boolean, "CreationTime": number, "DatasetGroupArn": "string", "ForecastArn": "string", "ForecastName": "string", "LastModificationTime": number, "Message": "string", "PredictorArn": "string", "Status": "string" } ], "NextToken": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Forecasts](#API_ListForecasts_ResponseSyntax) ** 總結每個預測屬性的物件陣列。類型：[ForecastSummary](API_ForecastSummary.md) 物件陣列 ** [NextToken](#API_ListForecasts_ResponseSyntax) ** 如果回應被截斷，Amazon Forecast 會傳回此字符。若要擷取下一組結果，請在下一個請求中使用字符。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** InvalidNextTokenException ** 字符無效。字符會在 24 小時後過期。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListForecasts) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListForecasts) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListForecasts) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListForecasts) + [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListForecasts) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListForecasts) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListForecasts) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListForecasts) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListForecasts) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListForecasts) # ListMonitorEvaluations 傳回監控評估結果清單，以及監控資源在不同時段收集的預測器事件。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 如需監控的資訊，請參閱 [預測器監控](predictor-monitoring.md)。如需擷取監控結果的詳細資訊，請參閱[檢視監控結果](https://docs.aws.amazon.com/forecast/latest/dg/predictor-monitoring-results.html)。 ## 請求語法 ``` { "Filters": [ { "Condition": "string", "Key": "string", "Value": "string" } ], "MaxResults": number, "MonitorArn": "string", "NextToken": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [Filters](#API_ListMonitorEvaluations_RequestSyntax) ** 篩選條件陣列。針對每個篩選條件，提供條件和相符陳述式。條件為 `IS`或 `IS_NOT`，指定要從清單中包含或排除符合陳述式的資源。比對陳述式包含索引鍵和值。 **篩選條件屬性** + `Condition` - 要套用的條件。有效值為 `IS` 和 `IS_NOT`。 + `Key` - 要篩選的參數名稱。唯一有效的值為 `EvaluationState`。 + `Value` - 要比對的值。有效值僅為 `SUCCESS`或 `FAILURE`。例如，若要僅列出成功的監控評估，您可以指定： `"Filters": [ { "Condition": "IS", "Key": "EvaluationState", "Value": "SUCCESS" } ]` 類型：[Filter](API_Filter.md) 物件陣列必要：否 ** [MaxResults](#API_ListMonitorEvaluations_RequestSyntax) ** 要傳回的監控結果數目上限。類型：整數有效範圍：最小值為 1。最大值為 100。必要：否 ** [MonitorArn](#API_ListMonitorEvaluations_RequestSyntax) ** 要從中取得結果之監視器資源的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ** [NextToken](#API_ListMonitorEvaluations_RequestSyntax) ** 如果先前請求的結果遭到截斷，回應會包含 `NextToken`。若要擷取下一組結果，請在下一個請求中使用字符。字符會在 24 小時後過期。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` 必要：否 ## 回應語法 ``` { "NextToken": "string", "PredictorMonitorEvaluations": [ { "EvaluationState": "string", "EvaluationTime": number, "Message": "string", "MetricResults": [ { "MetricName": "string", "MetricValue": number } ], "MonitorArn": "string", "MonitorDataSource": { "DatasetImportJobArn": "string", "ForecastArn": "string", "PredictorArn": "string" }, "NumItemsEvaluated": number, "PredictorEvent": { "Datetime": number, "Detail": "string" }, "ResourceArn": "string", "WindowEndDatetime": number, "WindowStartDatetime": number } ] } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [NextToken](#API_ListMonitorEvaluations_ResponseSyntax) ** 如果回應被截斷，Amazon Forecast 會傳回此字符。若要擷取下一組結果，請在下一個請求中使用字符。字符會在 24 小時後過期。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` ** [PredictorMonitorEvaluations](#API_ListMonitorEvaluations_ResponseSyntax) ** 監控資源在不同時段收集的監控結果和預測器事件。如需監控的資訊，請參閱[檢視監控結果](https://docs.aws.amazon.com/forecast/latest/dg/predictor-monitoring-results.html)。如需擷取監控結果的詳細資訊，請參閱[檢視監控結果](https://docs.aws.amazon.com/forecast/latest/dg/predictor-monitoring-results.html)。類型：[PredictorMonitorEvaluation](API_PredictorMonitorEvaluation.md) 物件陣列 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** InvalidNextTokenException ** 字符無效。字符會在 24 小時後過期。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListMonitorEvaluations) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListMonitorEvaluations) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListMonitorEvaluations) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListMonitorEvaluations) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListMonitorEvaluations) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListMonitorEvaluations) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListMonitorEvaluations) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListMonitorEvaluations) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListMonitorEvaluations) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListMonitorEvaluations) # ListMonitors 傳回使用 [CreateMonitor](API_CreateMonitor.md)操作和 [CreateAutoPredictor](API_CreateAutoPredictor.md)操作建立的監視器清單。對於每個監視器資源，此操作會傳回其屬性的摘要，包括其 Amazon Resource Name (ARN)。您可以在 [DescribeMonitor](API_DescribeMonitor.md)操作中指定監視器的 ARN，以擷取監視器資源的完整屬性集。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "Filters": [ { "Condition": "string", "Key": "string", "Value": "string" } ], "MaxResults": number, "NextToken": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [Filters](#API_ListMonitors_RequestSyntax) ** 篩選條件陣列。針對每個篩選條件，提供條件和相符陳述式。條件為 `IS`或 `IS_NOT`，指定要從清單中包含或排除符合陳述式的資源。比對陳述式包含索引鍵和值。 **篩選條件屬性** + `Condition` - 要套用的條件。有效值為 `IS` 和 `IS_NOT`。 + `Key` - 要篩選的參數名稱。唯一有效的值為 `Status`。 + `Value` - 要比對的值。例如，若要列出狀態為 ACTIVE 的所有監視器，您可以指定： `"Filters": [ { "Condition": "IS", "Key": "Status", "Value": "ACTIVE" } ]` 類型：[Filter](API_Filter.md) 物件陣列必要：否 ** [MaxResults](#API_ListMonitors_RequestSyntax) ** 要包含在回應中的監視器數量上限。類型：整數有效範圍：最小值為 1。最大值為 100。必要：否 ** [NextToken](#API_ListMonitors_RequestSyntax) ** 如果先前請求的結果遭到截斷，回應會包含 `NextToken`。若要擷取下一組結果，請在下一個請求中使用字符。字符會在 24 小時後過期。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` 必要：否 ## 回應語法 ``` { "Monitors": [ { "CreationTime": number, "LastModificationTime": number, "MonitorArn": "string", "MonitorName": "string", "ResourceArn": "string", "Status": "string" } ], "NextToken": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Monitors](#API_ListMonitors_ResponseSyntax) ** 摘要每個監視器屬性的物件陣列。類型：[MonitorSummary](API_MonitorSummary.md) 物件陣列 ** [NextToken](#API_ListMonitors_ResponseSyntax) ** 如果回應被截斷，Amazon Forecast 會傳回此字符。若要擷取下一組結果，請在下一個請求中使用字符。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** InvalidNextTokenException ** 字符無效。字符會在 24 小時後過期。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListMonitors) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListMonitors) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListMonitors) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListMonitors) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListMonitors) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListMonitors) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListMonitors) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListMonitors) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListMonitors) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListMonitors) # ListPredictorBacktestExportJobs 傳回使用 [CreatePredictorBacktestExportJob](API_CreatePredictorBacktestExportJob.md)操作建立的預測器回溯測試匯出任務清單。此操作會傳回每個回溯測試匯出任務的摘要。您可以使用 [Filter](API_Filter.md) 物件陣列來篩選清單。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 若要擷取特定回溯測試匯出任務的完整屬性集，請使用 ARN 搭配 [DescribePredictorBacktestExportJob](API_DescribePredictorBacktestExportJob.md)操作。 ## 請求語法 ``` { "Filters": [ { "Condition": "string", "Key": "string", "Value": "string" } ], "MaxResults": number, "NextToken": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [Filters](#API_ListPredictorBacktestExportJobs_RequestSyntax) ** 篩選條件陣列。針對每個篩選條件，提供條件和相符陳述式。條件為 `IS`或 `IS_NOT`，指定是否要包含或排除符合清單中陳述式的預測器回溯測試匯出任務。比對陳述式包含索引鍵和值。 **篩選條件屬性** + `Condition` - 要套用的條件。有效值為 `IS` 和 `IS_NOT`。若要包含符合陳述式的預測器回溯測試匯出任務，請指定 `IS`。若要排除相符的預測器回溯測試匯出任務，請指定 `IS_NOT`。 + `Key` - 要篩選的參數名稱。有效值為 `PredictorArn` 和 `Status`。 + `Value` - 要比對的值。類型：[Filter](API_Filter.md) 物件陣列必要：否 ** [MaxResults](#API_ListPredictorBacktestExportJobs_RequestSyntax) ** 回應中要傳回的項目數。類型：整數有效範圍：最小值為 1。最大值為 100。必要：否 ** [NextToken](#API_ListPredictorBacktestExportJobs_RequestSyntax) ** 如果先前請求的結果遭到截斷，回應會包含 NextToken。若要擷取下一組結果，請在下一個請求中使用字符。字符會在 24 小時後過期。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` 必要：否 ## 回應語法 ``` { "NextToken": "string", "PredictorBacktestExportJobs": [ { "CreationTime": number, "Destination": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "LastModificationTime": number, "Message": "string", "PredictorBacktestExportJobArn": "string", "PredictorBacktestExportJobName": "string", "Status": "string" } ] } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [NextToken](#API_ListPredictorBacktestExportJobs_ResponseSyntax) ** 如果回應被截斷，則傳回此字符。若要擷取下一組結果，請在下一個請求中使用字符。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` ** [PredictorBacktestExportJobs](#API_ListPredictorBacktestExportJobs_ResponseSyntax) ** 物件陣列，摘要每個預測器回溯測試匯出任務的屬性。類型：[PredictorBacktestExportJobSummary](API_PredictorBacktestExportJobSummary.md) 物件陣列 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** InvalidNextTokenException ** 字符無效。字符會在 24 小時後過期。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListPredictorBacktestExportJobs) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListPredictorBacktestExportJobs) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListPredictorBacktestExportJobs) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListPredictorBacktestExportJobs) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListPredictorBacktestExportJobs) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListPredictorBacktestExportJobs) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListPredictorBacktestExportJobs) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListPredictorBacktestExportJobs) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListPredictorBacktestExportJobs) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListPredictorBacktestExportJobs) # ListPredictors 傳回使用 [CreateAutoPredictor](API_CreateAutoPredictor.md)或 [CreatePredictor](API_CreatePredictor.md)操作建立的預測器清單。對於每個預測器，此操作會傳回其屬性的摘要，包括其 Amazon Resource Name (ARN)。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 您可以使用 ARN 搭配 [DescribeAutoPredictor](API_DescribeAutoPredictor.md)和 [DescribePredictor](API_DescribePredictor.md)操作來擷取完整的屬性集。您可以使用 [Filter](API_Filter.md) 物件陣列來篩選清單。 ## 請求語法 ``` { "Filters": [ { "Condition": "string", "Key": "string", "Value": "string" } ], "MaxResults": number, "NextToken": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [Filters](#API_ListPredictors_RequestSyntax) ** 篩選條件陣列。對於每個篩選條件，您提供條件和相符陳述式。條件為 `IS`或 `IS_NOT`，指定要分別包含或排除符合清單中陳述式的預測器。比對陳述式包含索引鍵和值。 **篩選條件屬性** + `Condition` - 要套用的條件。有效值為 `IS` 和 `IS_NOT`。若要包含符合陳述式的預測器，請指定 `IS`。若要排除相符的預測器，請指定 `IS_NOT`。 + `Key` - 要篩選的參數名稱。有效值為 `DatasetGroupArn` 和 `Status`。 + `Value` - 要比對的值。例如，若要列出狀態為 ACTIVE 的所有預測器，您可以指定： `"Filters": [ { "Condition": "IS", "Key": "Status", "Value": "ACTIVE" } ]` 類型：[Filter](API_Filter.md) 物件陣列必要：否 ** [MaxResults](#API_ListPredictors_RequestSyntax) ** 回應中要傳回的項目數。類型：整數有效範圍：最小值為 1。最大值為 100。必要：否 ** [NextToken](#API_ListPredictors_RequestSyntax) ** 如果先前請求的結果遭到截斷，回應會包含 `NextToken`。若要擷取下一組結果，請在下一個請求中使用字符。字符會在 24 小時後過期。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` 必要：否 ## 回應語法 ``` { "NextToken": "string", "Predictors": [ { "CreationTime": number, "DatasetGroupArn": "string", "IsAutoPredictor": boolean, "LastModificationTime": number, "Message": "string", "PredictorArn": "string", "PredictorName": "string", "ReferencePredictorSummary": { "Arn": "string", "State": "string" }, "Status": "string" } ] } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [NextToken](#API_ListPredictors_ResponseSyntax) ** 如果回應被截斷，Amazon Forecast 會傳回此字符。若要擷取下一組結果，請在下一個請求中使用字符。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` ** [Predictors](#API_ListPredictors_ResponseSyntax) ** 摘要每個預測器屬性的物件陣列。類型：[PredictorSummary](API_PredictorSummary.md) 物件陣列 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** InvalidNextTokenException ** 字符無效。字符會在 24 小時後過期。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListPredictors) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListPredictors) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListPredictors) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListPredictors) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListPredictors) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListPredictors) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListPredictors) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListPredictors) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListPredictors) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListPredictors) # ListTagsForResource 列出 Amazon Forecast 資源的標籤。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "ResourceArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [ResourceArn](#API_ListTagsForResource_RequestSyntax) ** Amazon Resource Name (ARN)，可識別要列出標籤的資源。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應語法 ``` { "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Tags](#API_ListTagsForResource_ResponseSyntax) ** 資源的標籤。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListTagsForResource) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListTagsForResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListTagsForResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListTagsForResource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListTagsForResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListTagsForResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListTagsForResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListTagsForResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListTagsForResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListTagsForResource) # ListWhatIfAnalyses 傳回使用 [CreateWhatIfAnalysis](API_CreateWhatIfAnalysis.md)操作建立的假設分析清單。對於每個假設分析，此操作會傳回其屬性的摘要，包括其 Amazon Resource Name (ARN)。您可以使用 [DescribeWhatIfAnalysis](API_DescribeWhatIfAnalysis.md)操作的假設分析 ARN 來擷取完整的屬性集。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "Filters": [ { "Condition": "string", "Key": "string", "Value": "string" } ], "MaxResults": number, "NextToken": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [Filters](#API_ListWhatIfAnalyses_RequestSyntax) ** 篩選條件陣列。對於每個篩選條件，您提供條件和相符陳述式。條件為 `IS`或 `IS_NOT`，指定要分別包含或排除符合清單中陳述式的假設分析任務。比對陳述式包含索引鍵和值。 **篩選條件屬性** + `Condition` - 要套用的條件。有效值為 `IS` 和 `IS_NOT`。若要包含符合陳述式的假設分析任務，請指定 `IS`。若要排除相符的假設分析任務，請指定 `IS_NOT`。 + `Key` - 要篩選的參數名稱。有效值為 `WhatIfAnalysisArn` 和 `Status`。 + `Value` - 要比對的值。例如，若要列出匯出名為 *electricityWhatIf* 之預測的所有任務，請指定下列篩選條件： `"Filters": [ { "Condition": "IS", "Key": "WhatIfAnalysisArn", "Value": "arn:aws:forecast:us-west-2::forecast/electricityWhatIf" } ]` 類型：[Filter](API_Filter.md) 物件陣列必要：否 ** [MaxResults](#API_ListWhatIfAnalyses_RequestSyntax) ** 回應中要傳回的項目數。類型：整數有效範圍：最小值為 1。最大值為 100。必要：否 ** [NextToken](#API_ListWhatIfAnalyses_RequestSyntax) ** 如果先前請求的結果遭到截斷，回應會包含 `NextToken`。若要擷取下一組結果，請在下一個請求中使用字符。字符會在 24 小時後過期。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` 必要：否 ## 回應語法 ``` { "NextToken": "string", "WhatIfAnalyses": [ { "CreationTime": number, "ForecastArn": "string", "LastModificationTime": number, "Message": "string", "Status": "string", "WhatIfAnalysisArn": "string", "WhatIfAnalysisName": "string" } ] } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [NextToken](#API_ListWhatIfAnalyses_ResponseSyntax) ** 如果回應被截斷，預測會傳回此字符。若要擷取下一組結果，請在下一個請求中使用字符。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` ** [WhatIfAnalyses](#API_ListWhatIfAnalyses_ResponseSyntax) ** 描述相符分析的`WhatIfAnalysisSummary`物件陣列。類型：[WhatIfAnalysisSummary](API_WhatIfAnalysisSummary.md) 物件陣列 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** InvalidNextTokenException ** 字符無效。字符會在 24 小時後過期。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListWhatIfAnalyses) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListWhatIfAnalyses) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListWhatIfAnalyses) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListWhatIfAnalyses) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListWhatIfAnalyses) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListWhatIfAnalyses) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListWhatIfAnalyses) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListWhatIfAnalyses) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListWhatIfAnalyses) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListWhatIfAnalyses) # ListWhatIfForecastExports 傳回使用 [CreateWhatIfForecastExport](API_CreateWhatIfForecastExport.md)操作建立的預測匯出清單。對於每個假設預測匯出，此操作會傳回其屬性的摘要，包括其 Amazon Resource Name (ARN)。您可以使用預測匯出 ARN 搭配 [DescribeWhatIfForecastExport](API_DescribeWhatIfForecastExport.md)操作來擷取完整的屬性集。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "Filters": [ { "Condition": "string", "Key": "string", "Value": "string" } ], "MaxResults": number, "NextToken": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [Filters](#API_ListWhatIfForecastExports_RequestSyntax) ** 篩選條件陣列。對於每個篩選條件，您提供條件和相符陳述式。條件為 `IS`或 `IS_NOT`，指定要分別包含或排除符合清單中陳述式的假設預測匯出任務。比對陳述式包含索引鍵和值。 **篩選條件屬性** + `Condition` - 要套用的條件。有效值為 `IS` 和 `IS_NOT`。若要包含符合陳述式的預測匯出任務，請指定 `IS`。若要排除相符的預測匯出任務，請指定 `IS_NOT`。 + `Key` - 要篩選的參數名稱。有效值為 `WhatIfForecastExportArn` 和 `Status`。 + `Value` - 要比對的值。例如，若要列出匯出名為 *electricityWIFExport* 之預測的所有任務，請指定下列篩選條件： `"Filters": [ { "Condition": "IS", "Key": "WhatIfForecastExportArn", "Value": "arn:aws:forecast:us-west-2::forecast/electricityWIFExport" } ]` 類型：[Filter](API_Filter.md) 物件陣列必要：否 ** [MaxResults](#API_ListWhatIfForecastExports_RequestSyntax) ** 回應中要傳回的項目數。類型：整數有效範圍：最小值為 1。最大值為 100。必要：否 ** [NextToken](#API_ListWhatIfForecastExports_RequestSyntax) ** 如果先前請求的結果遭到截斷，回應會包含 `NextToken`。若要擷取下一組結果，請在下一個中使用字符  請求。字符會在 24 小時後過期。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` 必要：否 ## 回應語法 ``` { "NextToken": "string", "WhatIfForecastExports": [ { "CreationTime": number, "Destination": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "LastModificationTime": number, "Message": "string", "Status": "string", "WhatIfForecastArns": [ "string" ], "WhatIfForecastExportArn": "string", "WhatIfForecastExportName": "string" } ] } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [NextToken](#API_ListWhatIfForecastExports_ResponseSyntax) ** 如果回應被截斷，預測會傳回此字符。若要擷取下一組結果，請在下一個請求中使用字符。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` ** [WhatIfForecastExports](#API_ListWhatIfForecastExports_ResponseSyntax) ** 描述相符預測匯出的`WhatIfForecastExports`物件陣列。類型：[WhatIfForecastExportSummary](API_WhatIfForecastExportSummary.md) 物件陣列 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** InvalidNextTokenException ** 字符無效。字符會在 24 小時後過期。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListWhatIfForecastExports) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListWhatIfForecastExports) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListWhatIfForecastExports) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListWhatIfForecastExports) + [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListWhatIfForecastExports) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListWhatIfForecastExports) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListWhatIfForecastExports) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListWhatIfForecastExports) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListWhatIfForecastExports) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListWhatIfForecastExports) # ListWhatIfForecasts 傳回使用 [CreateWhatIfForecast](API_CreateWhatIfForecast.md)操作建立的假設預測清單。對於每個假設預測，此操作會傳回其屬性的摘要，包括其 Amazon Resource Name (ARN)。您可以使用 [DescribeWhatIfForecast](API_DescribeWhatIfForecast.md)操作的假設預測 ARN 來擷取完整的屬性集。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "Filters": [ { "Condition": "string", "Key": "string", "Value": "string" } ], "MaxResults": number, "NextToken": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [Filters](#API_ListWhatIfForecasts_RequestSyntax) ** 篩選條件陣列。對於每個篩選條件，您提供條件和相符陳述式。條件為 `IS`或 `IS_NOT`，指定要分別包含或排除符合清單中陳述式的假設預測匯出任務。比對陳述式包含索引鍵和值。 **篩選條件屬性** + `Condition` - 要套用的條件。有效值為 `IS` 和 `IS_NOT`。若要包含符合陳述式的預測匯出任務，請指定 `IS`。若要排除相符的預測匯出任務，請指定 `IS_NOT`。 + `Key` - 要篩選的參數名稱。有效值為 `WhatIfForecastArn` 和 `Status`。 + `Value` - 要比對的值。例如，若要列出匯出名為 *electricityWhatIfForecast* 之預測的所有任務，請指定下列篩選條件： `"Filters": [ { "Condition": "IS", "Key": "WhatIfForecastArn", "Value": "arn:aws:forecast:us-west-2::forecast/electricityWhatIfForecast" } ]` 類型：[Filter](API_Filter.md) 物件陣列必要：否 ** [MaxResults](#API_ListWhatIfForecasts_RequestSyntax) ** 回應中要傳回的項目數。類型：整數有效範圍：最小值為 1。最大值為 100。必要：否 ** [NextToken](#API_ListWhatIfForecasts_RequestSyntax) ** 如果先前請求的結果遭到截斷，回應會包含 `NextToken`。若要擷取下一組結果，請在下一個中使用字符  請求。字符會在 24 小時後過期。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` 必要：否 ## 回應語法 ``` { "NextToken": "string", "WhatIfForecasts": [ { "CreationTime": number, "LastModificationTime": number, "Message": "string", "Status": "string", "WhatIfAnalysisArn": "string", "WhatIfForecastArn": "string", "WhatIfForecastName": "string" } ] } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [NextToken](#API_ListWhatIfForecasts_ResponseSyntax) ** 如果先前請求的結果遭到截斷，回應會包含 `NextToken`。若要擷取下一組結果，請在下一個中使用字符  請求。字符會在 24 小時後過期。類型：字串長度限制：長度下限為 1。長度上限為 3000。模式：`.+` ** [WhatIfForecasts](#API_ListWhatIfForecasts_ResponseSyntax) ** 描述相符預測的`WhatIfForecasts`物件陣列。類型：[WhatIfForecastSummary](API_WhatIfForecastSummary.md) 物件陣列 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** InvalidNextTokenException ** 字符無效。字符會在 24 小時後過期。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListWhatIfForecasts) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListWhatIfForecasts) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListWhatIfForecasts) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListWhatIfForecasts) + [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListWhatIfForecasts) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListWhatIfForecasts) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListWhatIfForecasts) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListWhatIfForecasts) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListWhatIfForecasts) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListWhatIfForecasts) # ResumeResource 恢復已停止的監控資源。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "ResourceArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [ResourceArn](#API_ResumeResource_RequestSyntax) ** 要繼續之監控資源的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ResumeResource) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ResumeResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ResumeResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ResumeResource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ResumeResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ResumeResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ResumeResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ResumeResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ResumeResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ResumeResource) # StopResource 停止資源。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 資源會經歷下列狀態： `CREATE_STOPPING`和 `CREATE_STOPPED`。您無法在資源停止後繼續該資源。此操作可以套用至下列資源（及其對應的子資源）： + 資料集匯入任務 + 預測器任務 + 預測任務 + 預測匯出任務 + 預測器回溯測試匯出任務 + 可解釋性任務 + 可解釋性匯出任務 ## 請求語法 ``` { "ResourceArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [ResourceArn](#API_StopResource_RequestSyntax) ** 可識別要停止之資源的 Amazon Resource Name (ARN)。支援的 ARNs 為 `DatasetImportJobArn`、`PredictorArn`、`PredictorBacktestExportJobArn`、`ForecastArn`、`ExplainabilityArn`、 `ForecastExportJobArn`和 `ExplainabilityExportArn`。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/StopResource) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/StopResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/StopResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/StopResource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/StopResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/StopResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/StopResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/StopResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/StopResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/StopResource) # TagResource 將指定的標籤與指定的資源建立關聯`resourceArn`。如果未在請求參數中指定資源上的現有標籤，則不會變更這些標籤。刪除資源時，也會刪除與該資源相關聯的標籤。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "ResourceArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [ResourceArn](#API_TagResource_RequestSyntax) ** Amazon Resource Name (ARN)，可識別要列出標籤的資源。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ** [Tags](#API_TagResource_RequestSyntax) ** 要新增到資源的標籤。標籤是鍵/值對的陣列。以下基本限制適用於標籤： + 每個資源的標籤數量上限 - 50。 + 針對每一個資源，每個標籤鍵必須是唯一的，且每個標籤鍵只能有一個值。 + 金鑰長度上限 - UTF-8 中的 128 個 Unicode 字元。 + 最大值長度 - UTF-8 256 個 Unicode 字元。 + 如果您的標記結構描述是跨多項服務和資源使用，請記得其他服務可能會有字元使用限制。通常允許的字元為：以 UTF-8 表示的字母、數字和空格，以及下列字元：\$1 - = . \$1 ： / @。 + 標籤鍵與值皆區分大小寫。 + 請勿使用 `aws:`、 `AWS:`或任何大寫或小寫的組合，例如金鑰的字首，因為其保留供 AWS 使用。您無法使用此字首編輯或刪除標籤索引鍵。值可以有此字首。如果標籤值具有 `aws` 作為其字首，但金鑰沒有，則預測會將其視為使用者標籤，並計入 50 個標籤的限制。只有金鑰字首的標籤`aws`不會計入每個資源限制的標籤。類型：[Tag](API_Tag.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 200。必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/TagResource) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/TagResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/TagResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/TagResource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/TagResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/TagResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/TagResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/TagResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/TagResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/TagResource) # UntagResource 從資源刪除指定的標籤。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) ## 請求語法 ``` { "ResourceArn": "string", "TagKeys": [ "string" ] } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [ResourceArn](#API_UntagResource_RequestSyntax) ** Amazon Resource Name (ARN)，可識別要列出標籤的資源。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ** [TagKeys](#API_UntagResource_RequestSyntax) ** 要移除之標籤的索引鍵。類型：字串陣列陣列成員：項目數下限為 0。項目數上限為 200。長度限制：長度下限為 1。長度上限為 128。模式：`^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/UntagResource) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/UntagResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/UntagResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/UntagResource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/UntagResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/UntagResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/UntagResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/UntagResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/UntagResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/UntagResource) # UpdateDatasetGroup 將資料集群組中的資料集取代為指定的資料集。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) **注意** 資料集群組`Status`的必須是 `ACTIVE`，才能使用資料集群組來建立預測器。使用 [DescribeDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDatasetGroup.html) 操作來取得狀態。 ## 請求語法 ``` { "DatasetArns": [ "string" ], "DatasetGroupArn": "string" } ``` ## 請求參數請求接受採用 JSON 格式的下列資料。 ** [DatasetArns](#API_UpdateDatasetGroup_RequestSyntax) ** 要新增至資料集群組之資料集的 Amazon Resource Name (ARNs) 陣列。類型：字串陣列長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ** [DatasetGroupArn](#API_UpdateDatasetGroup_RequestSyntax) ** 資料集群組的 ARN。類型：字串長度限制：長度上限為 256。模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` 必要：是 ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** ResourceInUseException ** 指定的資源正在使用中。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 我們找不到具有該 Amazon Resource Name (ARN) 的資源。請檢查 ARN，然後再試一次。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/UpdateDatasetGroup) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/UpdateDatasetGroup) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/UpdateDatasetGroup) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/UpdateDatasetGroup) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/UpdateDatasetGroup) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/UpdateDatasetGroup) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/UpdateDatasetGroup) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/UpdateDatasetGroup) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/UpdateDatasetGroup) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/UpdateDatasetGroup)