

 신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 서비스를 정상적으로 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 작업
<a name="API_Operations"></a>

Amazon Forecast 서비스가 지원하는 작업은 다음과 같습니다.
+  [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) 

Amazon Forecast 쿼리 서비스가 지원하는 작업은 다음과 같습니다.
+  [QueryForecast](API_forecastquery_QueryForecast.md) 
+  [QueryWhatIfForecast](API_forecastquery_QueryWhatIfForecast.md) 

# Amazon Forecast 서비스
<a name="API_Operations_Amazon_Forecast_Service"></a>

Amazon Forecast 서비스가 지원하는 작업은 다음과 같습니다.
+  [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
<a name="API_CreateAutoPredictor"></a>

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` 값만 지정하세요.

## 구문 요청
<a name="API_CreateAutoPredictor_RequestSyntax"></a>

```
{
   "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"
   }
}
```

## 요청 파라미터
<a name="API_CreateAutoPredictor_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [DataConfig](#API_CreateAutoPredictor_RequestSyntax) **   <a name="forecast-CreateAutoPredictor-request-DataConfig"></a>
데이터 세트 그룹 및 추가 데이터 세트의 데이터 구성입니다.  
유형: [DataConfig](API_DataConfig.md)객체  
필수 여부: 아니요

 ** [EncryptionConfig](#API_CreateAutoPredictor_RequestSyntax) **   <a name="forecast-CreateAutoPredictor-request-EncryptionConfig"></a>
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) **   <a name="forecast-CreateAutoPredictor-request-ExplainPredictor"></a>
예측기의 설명 가능성 리소스를 생성합니다.  
유형: 부울  
필수 항목 여부: 아니요

 ** [ForecastDimensions](#API_CreateAutoPredictor_RequestSyntax) **   <a name="forecast-CreateAutoPredictor-request-ForecastDimensions"></a>
생성된 예측을 그룹화하는 방법을 지정하는 차원(필드) 이름의 배열입니다.  
예를 들어 모든 매장의 항목 판매 예측을 생성하고 데이터 세트에 `store_id` 필드가 포함된 경우, 각 매장의 판매 예측을 그룹화하는 차원으로 `store_id`를 지정할 수 있습니다.  
타입: 문자열 배열  
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 10개입니다.  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*`   
필수 여부: 아니요

 ** [ForecastFrequency](#API_CreateAutoPredictor_RequestSyntax) **   <a name="forecast-CreateAutoPredictor-request-ForecastFrequency"></a>
예측의 예측 빈도입니다.  
유효한 간격은 정수와 그 뒤에 붙은 Y(년), M(월), W(주), D(일), H(시) 및 min(분)입니다. 예를 들어 “1D”는 매일을 나타내고 “15min”은 15분마다를 나타냅니다. 한 단계 위로 큰 빈도와 겹치는 값은 지정할 수 없습니다. 예를 들어 60분은 1시간에 해당하므로 지정할 수 없습니다. 각 빈도의 유효한 값은 다음과 같습니다.  
+ 분 – 1\$159
+ 시 – 1\$123
+ 일 – 1\$16
+ 주 – 1\$14
+ 월 – 1\$111
+ 년 - 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) **   <a name="forecast-CreateAutoPredictor-request-ForecastHorizon"></a>
모델이 예측하는 시간 단계의 수입니다. 이 예상 구간은 또한 예측 길이라고도 합니다.  
최대 예측 기간은 500 시간 단계 또는 TARGET\$1TIME\$1SERIES 데이터 세트 길이의 1/4 중 작은 값입니다. 기존 AutoPredictor를 재훈련하는 경우 최대 예측 기간은 500 시간 단계 또는 TARGET\$1TIME\$1SERIES 데이터 세트 길이의 1/3 중 작은 값입니다.  
AutoPredictor로 업그레이드하거나 기존 AutoPredictor를 재훈련하는 경우에는 예측 기간 파라미터를 업데이트할 수 없습니다. 데이터 세트에 더 긴 시계열을 제공하면 이 요구 사항을 충족할 수 있습니다.  
유형: 정수  
필수 항목 여부: 아니요

 ** [ForecastTypes](#API_CreateAutoPredictor_RequestSyntax) **   <a name="forecast-CreateAutoPredictor-request-ForecastTypes"></a>
예측기 훈련에 사용되는 예측 유형입니다. 최대 5개의 예측 유형을 지정할 수 있습니다. 예측 유형은 0.01에서 0.99까지의 사분위수(0.01 이상 증분)일 수 있습니다. `mean`을 사용하여 평균 예측을 지정할 수도 있습니다.  
타입: 문자열 배열  
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 20개입니다.  
길이 제약: 최소 길이는 2입니다. 최대 길이는 4입니다.  
패턴: `(^0?\.\d\d?$|^mean$)`   
필수 여부: 아니요

 ** [MonitorConfig](#API_CreateAutoPredictor_RequestSyntax) **   <a name="forecast-CreateAutoPredictor-request-MonitorConfig"></a>
예측기 모니터링의 구성 세부 정보입니다. 예측기 모니터링을 활성화하려면 모니터 리소스의 이름을 제공하세요.  
예측기 모니터링을 사용하면 시간 경과에 따라 예측기의 성능이 어떻게 변하는지 볼 수 있습니다. 자세한 내용은 [예측기 모니터링](https://docs.aws.amazon.com/forecast/latest/dg/predictor-monitoring.html)을 참조하세요.  
유형: [MonitorConfig](API_MonitorConfig.md)객체  
필수 여부: 아니요

 ** [OptimizationMetric](#API_CreateAutoPredictor_RequestSyntax) **   <a name="forecast-CreateAutoPredictor-request-OptimizationMetric"></a>
예측기를 최적화하는 데 사용되는 정확도 지표입니다.  
타입: 문자열  
유효 값: `WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE`   
필수 여부: 아니요

 ** [PredictorName](#API_CreateAutoPredictor_RequestSyntax) **   <a name="forecast-CreateAutoPredictor-request-PredictorName"></a>
예측기의 고유한 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*`   
필수 여부: 예

 ** [ReferencePredictorArn](#API_CreateAutoPredictor_RequestSyntax) **   <a name="forecast-CreateAutoPredictor-request-ReferencePredictorArn"></a>
재훈련 또는 업그레이드할 예측기의 ARN입니다. 이 파라미터는 예측기를 재훈련하거나 업그레이드할 때만 사용됩니다. 새 예측기를 생성할 때는 이 파라미터의 값을 지정하지 마세요.  
예측기를 업그레이드하거나 재훈련할 때는 `ReferencePredictorArn` 및 `PredictorName` 값만 지정하세요. `PredictorName`의 값은 고유한 예측기 이름이어야 합니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 아니요

 ** [Tags](#API_CreateAutoPredictor_RequestSyntax) **   <a name="forecast-CreateAutoPredictor-request-Tags"></a>
예측기를 분류하고 구성하는 데 도움이 되는 선택적 메타데이터입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다. 태그 키와 값은 대소문자를 구분합니다.  
태그에 적용되는 제한은 다음과 같습니다.  
+ 리소스마다 각 태그 키는 고유해야 하며 하나의 값만 가질 수 있습니다.
+ 리소스당 최대 태그 수: 50개.
+ 최대 키 길이: 유니코드 문자 128자(UTF-8).
+ 최대 값 길이: 유니코드 문자 256자(UTF-8).
+ 허용되는 문자: UTF-8로 표현할 수 있는 모든 문자와 숫자, 공백 및 \$1 - =. \$1 : / @. 태그 지정 스키마를 다른 서비스와 리소스에서 사용하는 경우 해당 서비스의 문자 제한도 적용됩니다.
+ 키 접두사는 `aws:` 또는 `AWS:`의 대문자 또는 소문자 조합을 포함할 수 없습니다. 값에 이 접두사가 포함될 수 있습니다. 태그 값에는 접두사로 `aws`가 있지만 키에는 없는 경우 Forecast는 해당 태그를 사용자 태그로 간주하여 50개 태그 한도에 포함합니다. `aws` 키 접두사만 있는 태그는 리소스당 태그 수 한도에 포함되지 않습니다. 이 접두사가 있는 태그 키는 편집하거나 삭제할 수 없습니다.
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

 ** [TimeAlignmentBoundary](#API_CreateAutoPredictor_RequestSyntax) **   <a name="forecast-CreateAutoPredictor-request-TimeAlignmentBoundary"></a>
예측 빈도와 일치하지 않는 데이터를 정렬하고 집계하는 데 Forecast가 사용하는 시간 경계입니다. 시간 단위와 시간 경계를 키 값 페어로 제공하세요. 시간 경계 지정에 대한 자세한 내용은 [시간 경계 지정](https://docs.aws.amazon.com/forecast/latest/dg/data-aggregation.html#specifying-time-boundary)을 참조하세요. 시간 경계를 제공하지 않으면 Forecast는 [기본 시간 경계](https://docs.aws.amazon.com/forecast/latest/dg/data-aggregation.html#default-time-boundaries) 세트를 사용합니다.  
유형: [TimeAlignmentBoundary](API_TimeAlignmentBoundary.md)객체  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_CreateAutoPredictor_ResponseSyntax"></a>

```
{
   "PredictorArn": "string"
}
```

## 응답 요소
<a name="API_CreateAutoPredictor_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [PredictorArn](#API_CreateAutoPredictor_ResponseSyntax) **   <a name="forecast-CreateAutoPredictor-response-PredictorArn"></a>
예측기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## 오류
<a name="API_CreateAutoPredictor_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
계정당 리소스 수 제한을 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceAlreadyExistsException **   
이 이름을 가진 리소스가 이미 있습니다. 다른 이름으로 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_CreateAutoPredictor_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateAutoPredictor) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateAutoPredictor) 

# CreateDataset
<a name="API_CreateDataset"></a>

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) 작업을 사용합니다.

## 구문 요청
<a name="API_CreateDataset_RequestSyntax"></a>

```
{
   "DataFrequency": "string",
   "DatasetName": "string",
   "DatasetType": "string",
   "Domain": "string",
   "EncryptionConfig": { 
      "KMSKeyArn": "string",
      "RoleArn": "string"
   },
   "Schema": { 
      "Attributes": [ 
         { 
            "AttributeName": "string",
            "AttributeType": "string"
         }
      ]
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## 요청 파라미터
<a name="API_CreateDataset_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [DataFrequency](#API_CreateDataset_RequestSyntax) **   <a name="forecast-CreateDataset-request-DataFrequency"></a>
데이터 수집 빈도입니다. 이 파라미터는 RELATED\$1TIME\$1SERIES 데이터 세트에 필요합니다.  
유효한 간격은 정수와 그 뒤에 붙은 Y(년), M(월), W(주), D(일), H(시) 및 min(분)입니다. 예를 들어 “1D”는 매일을 나타내고 “15min”은 15분마다를 나타냅니다. 한 단계 위로 큰 빈도와 겹치는 값은 지정할 수 없습니다. 예를 들어 60분은 1시간에 해당하므로 지정할 수 없습니다. 각 빈도의 유효한 값은 다음과 같습니다.  
+ 분 – 1\$159
+ 시 – 1\$123
+ 일 – 1\$16
+ 주 – 1\$14
+ 월 – 1\$111
+ 년 - 1
따라서 격주로 예측하려면 “2W”를 지정합니다. 또는 분기별 예측을 원하는 경우 “3M”을 지정합니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 5입니다.  
패턴: `^Y|M|W|D|H|30min|15min|10min|5min|1min$`   
필수 여부: 아니요

 ** [DatasetName](#API_CreateDataset_RequestSyntax) **   <a name="forecast-CreateDataset-request-DatasetName"></a>
데이터 세트의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*`   
필수 여부: 예

 ** [DatasetType](#API_CreateDataset_RequestSyntax) **   <a name="forecast-CreateDataset-request-DatasetType"></a>
데이터세트 유형. 유효한 값은 선택한 `Domain`에 따라 다릅니다.  
타입: 문자열  
유효 값: `TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA`   
필수 사항 여부: 예

 ** [Domain](#API_CreateDataset_RequestSyntax) **   <a name="forecast-CreateDataset-request-Domain"></a>
데이터 세트와 연결된 도메인입니다. 데이터 세트를 데이터 세트 그룹에 추가할 때 이 값과 [CreateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetGroup.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`   
필수 사항 여부: 예

 ** [EncryptionConfig](#API_CreateDataset_RequestSyntax) **   <a name="forecast-CreateDataset-request-EncryptionConfig"></a>
 AWS Key Management Service Amazon Forecast가 키에 액세스하기 위해 맡을 수 있는 (KMS) 키 및 AWS Identity and Access Management (IAM) 역할입니다.  
유형: [EncryptionConfig](API_EncryptionConfig.md)객체  
필수 여부: 아니요

 ** [Schema](#API_CreateDataset_RequestSyntax) **   <a name="forecast-CreateDataset-request-Schema"></a>
데이터 세트의 스키마입니다. 스키마 속성과 순서는 데이터의 필드와 일치해야 합니다. 선택한 데이터 세트 `Domain` 및 `DatasetType`은 훈련 데이터의 최소 필수 필드를 결정합니다. 특정 데이터 세트 도메인과 유형의 필수 필드에 대한 자세한 내용을 알아보려면 [데이터 세트 도메인 및 데이터 세트 유형](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-domains-ds-types.html)을 참조하세요.  
타입: [Schema](API_Schema.md)객체  
필수 항목 여부: 예

 ** [Tags](#API_CreateDataset_RequestSyntax) **   <a name="forecast-CreateDataset-request-Tags"></a>
데이터 세트를 분류하고 구성하는 데 도움이 되도록 데이터 세트에 적용하는 선택적 메타데이터입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다.  
 태그에 적용되는 기본 제한 사항은 다음과 같습니다.  
+ 리소스당 최대 태그 수 - 50개.
+ 각 리소스에 대해 각 태그 키는 고유해야 하며 각 태그 키는 하나의 값만 가질 수 있습니다.
+ 최대 키 길이 - 유니코드 문자 128자(UTF-8).
+ 최대 값 길이 - 유니코드 문자 256자(UTF-8).
+ 태깅 스키마를 여러 서비스와 리소스에서 사용하는 경우 다른 서비스 또한 허용되는 문자에 대한 제한이 있을 수 있음을 유의합니다. 일반적으로 허용되는 문자는 UTF-8로 표현할 수 있는 문자, 숫자 및 공백과 \$1 - = . \$1 : / @입니다.
+ 태그 키와 값은 대소문자를 구분합니다.
+ 키는 AWS 사용을 위해 예약되어 있으므로 `aws:`, `AWS:`또는 키의 접두사와 같은의 대문자 또는 소문자 조합을 사용하지 마십시오. 이 접두사가 있는 태그 키는 편집하거나 삭제할 수 없습니다. 값에 이 접두사가 포함될 수 있습니다. 태그 값에는 접두사로 `aws`가 있지만 키에는 없는 경우 Forecast는 해당 태그를 사용자 태그로 간주하여 50개 태그 한도에 포함합니다. `aws` 키 접두사만 있는 태그는 리소스당 태그 수 한도에 포함되지 않습니다.
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

## 응답 구문
<a name="API_CreateDataset_ResponseSyntax"></a>

```
{
   "DatasetArn": "string"
}
```

## 응답 요소
<a name="API_CreateDataset_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [DatasetArn](#API_CreateDataset_ResponseSyntax) **   <a name="forecast-CreateDataset-response-DatasetArn"></a>
데이터세트의 리소스 이름(ARN).  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## 오류
<a name="API_CreateDataset_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
계정당 리소스 수 제한을 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceAlreadyExistsException **   
이 이름을 가진 리소스가 이미 있습니다. 다른 이름으로 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_CreateDataset_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateDataset) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateDataset) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateDataset) 

# CreateDatasetGroup
<a name="API_CreateDatasetGroup"></a>

관련 데이터 세트 모음을 보유하는 데이터 세트 그룹을 생성합니다. 데이터 세트 그룹을 생성할 때 또는 나중에 [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) 작업을 사용합니다.

## 구문 요청
<a name="API_CreateDatasetGroup_RequestSyntax"></a>

```
{
   "DatasetArns": [ "string" ],
   "DatasetGroupName": "string",
   "Domain": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## 요청 파라미터
<a name="API_CreateDatasetGroup_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [DatasetArns](#API_CreateDatasetGroup_RequestSyntax) **   <a name="forecast-CreateDatasetGroup-request-DatasetArns"></a>
데이터 세트 그룹에 포함시키려는 데이터 세트의 Amazon 리소스 이름(ARN) 배열입니다.  
유형: 문자열 배열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 아니요

 ** [DatasetGroupName](#API_CreateDatasetGroup_RequestSyntax) **   <a name="forecast-CreateDatasetGroup-request-DatasetGroupName"></a>
데이터 세트 그룹의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*`   
필수 여부: 예

 ** [Domain](#API_CreateDatasetGroup_RequestSyntax) **   <a name="forecast-CreateDatasetGroup-request-Domain"></a>
데이터 세트 그룹과 연결된 도메인입니다. 데이터 세트를 데이터 세트 그룹에 추가할 때 이 값과 [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) **   <a name="forecast-CreateDatasetGroup-request-Tags"></a>
데이터 세트 그룹을 분류하고 구성하는 데 도움이 되도록 데이터 세트에 적용하는 선택적 메타데이터입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다.  
 태그에 적용되는 기본 제한 사항은 다음과 같습니다.  
+ 리소스당 최대 태그 수 - 50개.
+ 각 리소스에 대해 각 태그 키는 고유해야 하며 각 태그 키는 하나의 값만 가질 수 있습니다.
+ 최대 키 길이 - 유니코드 문자 128자(UTF-8).
+ 최대 값 길이 - 유니코드 문자 256자(UTF-8).
+ 태깅 스키마를 여러 서비스와 리소스에서 사용하는 경우 다른 서비스 또한 허용되는 문자에 대한 제한이 있을 수 있음을 유의합니다. 일반적으로 허용되는 문자는 UTF-8로 표현할 수 있는 문자, 숫자 및 공백과 \$1 - = . \$1 : / @입니다.
+ 태그 키와 값은 대소문자를 구분합니다.
+ 키는 AWS 사용을 위해 예약되어 있으므로 `aws:`, `AWS:`또는 키의 접두사와 같은의 대문자 또는 소문자 조합을 사용하지 마십시오. 이 접두사가 있는 태그 키는 편집하거나 삭제할 수 없습니다. 값에 이 접두사가 포함될 수 있습니다. 태그 값에는 접두사로 `aws`가 있지만 키에는 없는 경우 Forecast는 해당 태그를 사용자 태그로 간주하여 50개 태그 한도에 포함합니다. `aws` 키 접두사만 있는 태그는 리소스당 태그 수 한도에 포함되지 않습니다.
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

## 응답 구문
<a name="API_CreateDatasetGroup_ResponseSyntax"></a>

```
{
   "DatasetGroupArn": "string"
}
```

## 응답 요소
<a name="API_CreateDatasetGroup_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [DatasetGroupArn](#API_CreateDatasetGroup_ResponseSyntax) **   <a name="forecast-CreateDatasetGroup-response-DatasetGroupArn"></a>
데이터세트 그룹의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## 오류
<a name="API_CreateDatasetGroup_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
계정당 리소스 수 제한을 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceAlreadyExistsException **   
이 이름을 가진 리소스가 이미 있습니다. 다른 이름으로 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_CreateDatasetGroup_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateDatasetGroup) 

# CreateDatasetImportJob
<a name="API_CreateDatasetImportJob"></a>

Amazon Forecast 데이터 세트로 훈련 데이터를 가져옵니다. Amazon Simple Storage Service(S3) 버킷의 훈련 데이터 위치와 데이터를 가져올 데이터 세트의 Amazon 리소스 이름(ARN)을 제공합니다.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

Amazon Forecast는 데이터 사본을 만들어 내부 시스템에서 처리하기 때문에 Amazon Forecast가 데이터에 액세스하기 위해 수임할 수 있는 (IAM) 역할이 포함된 [DataSource](https://docs.aws.amazon.com/forecast/latest/dg/API_DataSource.html) 객체를 지정해야 합니다. AWS Identity and Access Management 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) 작업을 사용하세요.

## 구문 요청
<a name="API_CreateDatasetImportJob_RequestSyntax"></a>

```
{
   "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
}
```

## 요청 파라미터
<a name="API_CreateDatasetImportJob_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [DatasetArn](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="forecast-CreateDatasetImportJob-request-DatasetArn"></a>
데이터를 가져올 Amazon Forecast 데이터 세트의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

 ** [DatasetImportJobName](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="forecast-CreateDatasetImportJob-request-DatasetImportJobName"></a>
데이터세트 가져오기 작업의 이름. 이름에 현재 타임스탬프를 포함하는 것이 좋습니다(예: `20190721DatasetImport`). 이렇게 하면 `ResourceAlreadyExistsException` 예외가 발생하지 않도록 할 수 있습니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*`   
필수 여부: 예

 ** [DataSource](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="forecast-CreateDatasetImportJob-request-DataSource"></a>
가져올 훈련 데이터의 위치와 Amazon Forecast가 데이터에 액세스하기 위해 수임할 수 있는 AWS Identity and Access Management (IAM) 역할입니다. 훈련 데이터는 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` 파라미터에 지정된 것과 일치해야 합니다.  
타입: [DataSource](API_DataSource.md)객체  
필수 항목 여부: 예

 ** [Format](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="forecast-CreateDatasetImportJob-request-Format"></a>
가져온 데이터의 형식, CSV 또는 PARQUET. 기본값은 CSV입니다.  
유형: 문자열  
길이 제약 조건: 최대 길이는 7입니다.  
패턴: `^CSV|PARQUET$`   
필수 여부: 아니요

 ** [GeolocationFormat](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="forecast-CreateDatasetImportJob-request-GeolocationFormat"></a>
지리적 위치 속성의 형식입니다. 다음 두 가지 방법 중 하나로 지리적 위치 속성의 형식을 지정할 수 있습니다.  
+  `LAT_LONG` - 10진수 형식의 위도 및 경도(예: 47.61\$1-122.33).
+  `CC_POSTALCODE`(미국만 해당) - 국가 코드(US)와 5자리 우편번호가 차례로 표시됩니다(예: US\$198121).
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `^[a-zA-Z0-9_]+$`   
필수 여부: 아니요

 ** [ImportMode](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="forecast-CreateDatasetImportJob-request-ImportMode"></a>
데이터 세트 가져오기 작업이 `FULL` 가져오기인지 `INCREMENTAL` 가져오기인지 지정합니다. `FULL` 데이터 세트 가져오기는 기존 데이터를 모두 새로 가져온 데이터로 대체합니다. `INCREMENTAL` 가져오기는 가져온 데이터를 기존 데이터에 추가합니다.  
타입: 문자열  
유효 값: `FULL | INCREMENTAL`   
필수 여부: 아니요

 ** [Tags](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="forecast-CreateDatasetImportJob-request-Tags"></a>
데이터 세트 가져오기 작업을 분류하고 구성하는 데 도움이 되도록 데이터 세트 가져오기 작업에 적용하는 선택적 메타데이터입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다.  
 태그에 적용되는 기본 제한 사항은 다음과 같습니다.  
+ 리소스당 최대 태그 수 - 50개.
+ 각 리소스에 대해 각 태그 키는 고유해야 하며 각 태그 키는 하나의 값만 가질 수 있습니다.
+ 최대 키 길이 - 유니코드 문자 128자(UTF-8).
+ 최대 값 길이 - 유니코드 문자 256자(UTF-8).
+ 태깅 스키마를 여러 서비스와 리소스에서 사용하는 경우 다른 서비스 또한 허용되는 문자에 대한 제한이 있을 수 있음을 유의합니다. 일반적으로 허용되는 문자는 UTF-8로 표현할 수 있는 문자, 숫자 및 공백과 \$1 - = . \$1 : / @입니다.
+ 태그 키와 값은 대소문자를 구분합니다.
+ 키는 AWS 사용을 위해 예약되어 있으므로 `aws:`, `AWS:`또는 키의 접두사와 같은의 대문자 또는 소문자 조합을 사용하지 마십시오. 이 접두사가 있는 태그 키는 편집하거나 삭제할 수 없습니다. 값에 이 접두사가 포함될 수 있습니다. 태그 값에는 접두사로 `aws`가 있지만 키에는 없는 경우 Forecast는 해당 태그를 사용자 태그로 간주하여 50개 태그 한도에 포함합니다. `aws` 키 접두사만 있는 태그는 리소스당 태그 수 한도에 포함되지 않습니다.
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

 ** [TimestampFormat](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="forecast-CreateDatasetImportJob-request-TimestampFormat"></a>
데이터 세트의 타임스탬프 형식입니다. 지정하는 형식은 데이터 세트가 생성될 때 지정한 `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) **   <a name="forecast-CreateDatasetImportJob-request-TimeZone"></a>
데이터 세트의 모든 항목의 단일 시간대. 이 옵션은 모든 타임스탬프가 단일 시간대 내에 있는 데이터 세트 또는 모든 타임스탬프가 단일 시간대로 정규화된 경우에 적합합니다.  
유효한 시간대 이름의 전체 목록은 [Joda-Time API](http://joda-time.sourceforge.net/timezones.html)를 참조하세요.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `^[a-zA-Z0-9\/\+\-\_]+$`   
필수 여부: 아니요

 ** [UseGeolocationForTimeZone](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="forecast-CreateDatasetImportJob-request-UseGeolocationForTimeZone"></a>
지리적 위치 속성에서 시간대 정보를 자동으로 추출합니다. 이 옵션은 여러 시간대의 타임스탬프가 포함되어 있고 이러한 타임스탬프가 현지 시간으로 표시되는 데이터 세트에 적합합니다.  
유형: 부울  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_CreateDatasetImportJob_ResponseSyntax"></a>

```
{
   "DatasetImportJobArn": "string"
}
```

## 응답 요소
<a name="API_CreateDatasetImportJob_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [DatasetImportJobArn](#API_CreateDatasetImportJob_ResponseSyntax) **   <a name="forecast-CreateDatasetImportJob-response-DatasetImportJobArn"></a>
데이터 세트 가져오기 작업의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## 오류
<a name="API_CreateDatasetImportJob_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
계정당 리소스 수 제한을 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceAlreadyExistsException **   
이 이름을 가진 리소스가 이미 있습니다. 다른 이름으로 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_CreateDatasetImportJob_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateDatasetImportJob) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateDatasetImportJob) 

# CreateExplainability
<a name="API_CreateExplainability"></a>

**참고**  
설명 가능성은 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 Integrated Moving Average), ETS(Exponential Smoothing State Space Model) 및 NPTS(Non-Parametric Time Series) 모델은 외부 시계열 데이터를 통합하지 않습니다. 따라서 이러한 모델은 추가 데이터 세트를 포함하더라도 설명 가능성 보고서를 생성하지 않습니다.

CreateExplainability는 예측기 ARN 또는 예측 ARN을 받습니다. 데이터 세트의 모든 시계열 및 시점에 대해 집계된 영향 점수를 받으려면 예측기 ARN을 제공하세요. 특정 시계열 및 시점의 영향 점수를 받으려면 예측 ARN을 제공하세요.

 **예측기 ARN을 사용하는 CreateExplainability** 

**참고**  
설명 가능성 리소스는 예측기당 하나만 있을 수 있습니다. [CreateAutoPredictor](API_CreateAutoPredictor.md)에서 `ExplainPredictor`를 이미 활성화한 경우 해당 예측기에는 이미 설명 가능성 리소스가 있습니다.

다음 파라미터는 예측기 ARN을 제공할 때 필수입니다.
+  `ExplainabilityName` - 설명 가능성의 고유한 이름.
+  `ResourceArn` - 예측기의 ARN.
+  `TimePointGranularity` - “ALL”로 설정해야 합니다.
+  `TimeSeriesGranularity` - “ALL”로 설정해야 합니다.

다음 파라미터는 값을 지정하지 마세요.
+  `DataSource` - TimeSeriesGranularity가 “SPECIFIC”인 경우에만 유효합니다.
+  `Schema` - TimeSeriesGranularity가 “SPECIFIC”인 경우에만 유효합니다.
+  `StartDateTime` - TimePointGranularity가 “SPECIFIC”인 경우에만 유효합니다.
+  `EndDateTime` - TimePointGranularity가 “SPECIFIC”인 경우에만 유효합니다.

 **예측 ARN을 사용하는 CreateExplainability** 

**참고**  
최대 50개의 시계열과 500개의 시점을 지정할 수 있습니다.

다음 파라미터는 예측기 ARN을 제공할 때 필수입니다.
+  `ExplainabilityName` - 설명 가능성의 고유한 이름.
+  `ResourceArn` - 예측의 ARN.
+  `TimePointGranularity` - “ALL” 또는 “SPECIFIC”.
+  `TimeSeriesGranularity` - “ALL” 또는 “SPECIFIC”.

TimeSeriesGranularity를 “SPECIFIC”로 설정하는 경우 다음 값도 제공해야 합니다.
+  `DataSource` - 시계열을 지정하는 CSV 파일의 S3 위치.
+  `Schema` - 스키마는 데이터 소스에 나열된 속성 및 속성 유형을 정의합니다.

TimePointGranularity를 “SPECIFIC”으로 설정하는 경우 다음 값도 제공해야 합니다.
+  `StartDateTime` - 시점 범위의 첫 번째 타임스탬프.
+  `EndDateTime` - 시점 범위의 마지막 타임스탬프.

## 구문 요청
<a name="API_CreateExplainability_RequestSyntax"></a>

```
{
   "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"
      }
   ]
}
```

## 요청 파라미터
<a name="API_CreateExplainability_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [DataSource](#API_CreateExplainability_RequestSyntax) **   <a name="forecast-CreateExplainability-request-DataSource"></a>
데이터의 소스, Amazon Forecast가 데이터에 액세스하고 선택적으로 AWS Identity and Access Management (KMS) 키에 액세스할 수 있는 AWS Key Management Service (IAM) 역할입니다.  
유형: [DataSource](API_DataSource.md)객체  
필수 여부: 아니요

 ** [EnableVisualization](#API_CreateExplainability_RequestSyntax) **   <a name="forecast-CreateExplainability-request-EnableVisualization"></a>
 AWS 콘솔 내에서 볼 수 있는 설명 가능성 시각화를 생성합니다.  
유형: 부울  
필수 항목 여부: 아니요

 ** [EndDateTime](#API_CreateExplainability_RequestSyntax) **   <a name="forecast-CreateExplainability-request-EndDateTime"></a>
`TimePointGranularity`가 `SPECIFIC`으로 설정된 경우 설명 가능성의 마지막 시점을 정의합니다.  
다음 타임스탬프 형식을 사용하세요. yyyy-MM-ddTHH:mm:ss (example: 2015-01-01T20:00:00)  
유형: 문자열  
길이 제약 조건: 최대 길이는 19입니다.  
패턴: `^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$`   
필수 여부: 아니요

 ** [ExplainabilityConfig](#API_CreateExplainability_RequestSyntax) **   <a name="forecast-CreateExplainability-request-ExplainabilityConfig"></a>
설명 가능성의 시계열 및 시점 세분 수준을 정의하는 구성 설정입니다.  
타입: [ExplainabilityConfig](API_ExplainabilityConfig.md)객체  
필수 항목 여부: 예

 ** [ExplainabilityName](#API_CreateExplainability_RequestSyntax) **   <a name="forecast-CreateExplainability-request-ExplainabilityName"></a>
설명 가능성의 고유한 이름.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*`   
필수 여부: 예

 ** [ResourceArn](#API_CreateExplainability_RequestSyntax) **   <a name="forecast-CreateExplainability-request-ResourceArn"></a>
설명 가능성 생성에 사용되는 예측기 또는 예측의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

 ** [Schema](#API_CreateExplainability_RequestSyntax) **   <a name="forecast-CreateExplainability-request-Schema"></a>
데이터 세트의 필드를 정의합니다.  
유형: [Schema](API_Schema.md)객체  
필수 여부: 아니요

 ** [StartDateTime](#API_CreateExplainability_RequestSyntax) **   <a name="forecast-CreateExplainability-request-StartDateTime"></a>
`TimePointGranularity`가 `SPECIFIC`으로 설정된 경우 설명 가능성의 첫 번째 시점을 정의합니다.  
다음 타임스탬프 형식을 사용하세요. yyyy-MM-ddTHH:mm:ss (example: 2015-01-01T20:00:00)  
유형: 문자열  
길이 제약 조건: 최대 길이는 19입니다.  
패턴: `^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$`   
필수 여부: 아니요

 ** [Tags](#API_CreateExplainability_RequestSyntax) **   <a name="forecast-CreateExplainability-request-Tags"></a>
리소스를 분류하고 구성하는 데 도움이 되는 선택적 메타데이터입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다. 태그 키와 값은 대소문자를 구분합니다.  
태그에 적용되는 제한은 다음과 같습니다.  
+ 리소스마다 각 태그 키는 고유해야 하며 하나의 값만 가질 수 있습니다.
+ 리소스당 최대 태그 수: 50개.
+ 최대 키 길이: 유니코드 문자 128자(UTF-8).
+ 최대 값 길이: 유니코드 문자 256자(UTF-8).
+ 허용되는 문자: UTF-8로 표현할 수 있는 모든 문자와 숫자, 공백 및 \$1 - =. \$1 : / @. 태그 지정 스키마를 다른 서비스와 리소스에서 사용하는 경우 해당 서비스의 문자 제한도 적용됩니다.
+ 키 접두사는 `aws:` 또는 `AWS:`의 대문자 또는 소문자 조합을 포함할 수 없습니다. 값에 이 접두사가 포함될 수 있습니다. 태그 값에는 접두사로 `aws`가 있지만 키에는 없는 경우 Forecast는 해당 태그를 사용자 태그로 간주하여 50개 태그 한도에 포함합니다. `aws` 키 접두사만 있는 태그는 리소스당 태그 수 한도에 포함되지 않습니다. 이 접두사가 있는 태그 키는 편집하거나 삭제할 수 없습니다.
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

## 응답 구문
<a name="API_CreateExplainability_ResponseSyntax"></a>

```
{
   "ExplainabilityArn": "string"
}
```

## 응답 요소
<a name="API_CreateExplainability_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [ExplainabilityArn](#API_CreateExplainability_ResponseSyntax) **   <a name="forecast-CreateExplainability-response-ExplainabilityArn"></a>
설명 가능성의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## 오류
<a name="API_CreateExplainability_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
계정당 리소스 수 제한을 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceAlreadyExistsException **   
이 이름을 가진 리소스가 이미 있습니다. 다른 이름으로 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_CreateExplainability_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](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용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateExplainability) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateExplainability) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateExplainability) 
+  [AWS 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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateExplainability) 

# CreateExplainabilityExport
<a name="API_CreateExplainabilityExport"></a>

[CreateExplainability](API_CreateExplainability.md) 작업에서 생성된 설명 가능성 리소스를 내보냅니다. 내보내는 파일은 Amazon Simple Storage Service(S3) 버킷으로 내보내집니다.

Amazon S3 버킷과 Amazon Forecast가 Amazon S3 버킷에 액세스하기 위해 수임할 수 있는 AWS Identity and Access Management (IAM) 역할이 포함된 [DataDestination](API_DataDestination.md) 객체를 지정해야 합니다. 자세한 내용은 [Amazon Forecast에 대한 권한 설정](aws-forecast-iam-roles.md) 단원을 참조하십시오.

**참고**  
Amazon S3 버킷의 내보내기에 액세스하려면 내보내기 작업의 `Status`가 `ACTIVE`여야 합니다. 상태를 가져오려면 [DescribeExplainabilityExport](API_DescribeExplainabilityExport.md) 작업을 사용합니다.

## 구문 요청
<a name="API_CreateExplainabilityExport_RequestSyntax"></a>

```
{
   "Destination": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "ExplainabilityArn": "string",
   "ExplainabilityExportName": "string",
   "Format": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## 요청 파라미터
<a name="API_CreateExplainabilityExport_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Destination](#API_CreateExplainabilityExport_RequestSyntax) **   <a name="forecast-CreateExplainabilityExport-request-Destination"></a>
내보내기 작업의 대상입니다. S3 경로, Amazon Forecast가 위치에 액세스할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할 및 AWS Key Management Service (KMS) 키(선택 사항)를 제공합니다.  
타입: [DataDestination](API_DataDestination.md)객체  
필수 항목 여부: 예

 ** [ExplainabilityArn](#API_CreateExplainabilityExport_RequestSyntax) **   <a name="forecast-CreateExplainabilityExport-request-ExplainabilityArn"></a>
내보낼 설명 가능성의 Amazon 리소스 이름(ARN).  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

 ** [ExplainabilityExportName](#API_CreateExplainabilityExport_RequestSyntax) **   <a name="forecast-CreateExplainabilityExport-request-ExplainabilityExportName"></a>
설명 가능성 내보내기의 고유한 이름.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*`   
필수 여부: 예

 ** [Format](#API_CreateExplainabilityExport_RequestSyntax) **   <a name="forecast-CreateExplainabilityExport-request-Format"></a>
내보내는 데이터의 형식, CSV 또는 PARQUET.  
유형: 문자열  
길이 제약 조건: 최대 길이는 7입니다.  
패턴: `^CSV|PARQUET$`   
필수 여부: 아니요

 ** [Tags](#API_CreateExplainabilityExport_RequestSyntax) **   <a name="forecast-CreateExplainabilityExport-request-Tags"></a>
리소스를 분류하고 구성하는 데 도움이 되는 선택적 메타데이터입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다. 태그 키와 값은 대소문자를 구분합니다.  
태그에 적용되는 제한은 다음과 같습니다.  
+ 리소스마다 각 태그 키는 고유해야 하며 하나의 값만 가질 수 있습니다.
+ 리소스당 최대 태그 수: 50개.
+ 최대 키 길이: 유니코드 문자 128자(UTF-8).
+ 최대 값 길이: 유니코드 문자 256자(UTF-8).
+ 허용되는 문자: UTF-8로 표현할 수 있는 모든 문자와 숫자, 공백 및 \$1 - =. \$1 : / @. 태그 지정 스키마를 다른 서비스와 리소스에서 사용하는 경우 해당 서비스의 문자 제한도 적용됩니다.
+ 키 접두사는 `aws:` 또는 `AWS:`의 대문자 또는 소문자 조합을 포함할 수 없습니다. 값에 이 접두사가 포함될 수 있습니다. 태그 값에는 접두사로 `aws`가 있지만 키에는 없는 경우 Forecast는 해당 태그를 사용자 태그로 간주하여 50개 태그 한도에 포함합니다. `aws` 키 접두사만 있는 태그는 리소스당 태그 수 한도에 포함되지 않습니다. 이 접두사가 있는 태그 키는 편집하거나 삭제할 수 없습니다.
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

## 응답 구문
<a name="API_CreateExplainabilityExport_ResponseSyntax"></a>

```
{
   "ExplainabilityExportArn": "string"
}
```

## 응답 요소
<a name="API_CreateExplainabilityExport_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [ExplainabilityExportArn](#API_CreateExplainabilityExport_ResponseSyntax) **   <a name="forecast-CreateExplainabilityExport-response-ExplainabilityExportArn"></a>
내보내기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## 오류
<a name="API_CreateExplainabilityExport_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
계정당 리소스 수 제한을 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceAlreadyExistsException **   
이 이름을 가진 리소스가 이미 있습니다. 다른 이름으로 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_CreateExplainabilityExport_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateExplainabilityExport) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateExplainabilityExport) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateExplainabilityExport) 

# CreateForecast
<a name="API_CreateForecast"></a>

예측기 훈련에 사용된 `TARGET_TIME_SERIES` 데이터 세트의 모든 항목에 대한 예측을 생성합니다. 이를 추론이라고 합니다. 짧은 지연 시간으로 단일 항목에 대한 예측을 검색하려면 [QueryForecast](API_forecastquery_QueryForecast.md) 작업을 사용하세요. 전체 예측을 Amazon Simple Storage Service(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` 객체를 사용하여 시계열의 하위 집합에 대한 예측을 생성할 수 있습니다. 지정한 시계열 중 입력 데이터 세트에 없는 시계열에 대해서는 예측 생성이 생략됩니다. 예측 내보내기 파일에는 이러한 시계열 또는 예측 값이 포함되지 않습니다.

## 구문 요청
<a name="API_CreateForecast_RequestSyntax"></a>

```
{
   "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"
               }
            ]
         }
      }
   }
}
```

## 요청 파라미터
<a name="API_CreateForecast_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ForecastName](#API_CreateForecast_RequestSyntax) **   <a name="forecast-CreateForecast-request-ForecastName"></a>
예측의 이름.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*`   
필수 여부: 예

 ** [ForecastTypes](#API_CreateForecast_RequestSyntax) **   <a name="forecast-CreateForecast-request-ForecastTypes"></a>
확률적 예측이 생성되는 분위수입니다. **현재 예측당 최대 5개의 분위수를 지정할 수 있습니다**. 허용되는 값에는 `0.01 to 0.99`(0.01씩만 증분) 및 `mean`이 포함됩니다. 분포가 대칭적이지 않은 경우(예: 베타 및 음이항) 평균 예측치는 중앙값(0.50)과 다릅니다.  
기본 분위수는 예측기 생성 중에 지정한 분위수입니다. 분위수를 지정하지 않은 경우 기본값은 `["0.1", "0.5", "0.9"]`입니다.  
타입: 문자열 배열  
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 20개입니다.  
길이 제약: 최소 길이는 2입니다. 최대 길이는 4입니다.  
패턴: `(^0?\.\d\d?$|^mean$)`   
필수 여부: 아니요

 ** [PredictorArn](#API_CreateForecast_RequestSyntax) **   <a name="forecast-CreateForecast-request-PredictorArn"></a>
예측 생성에 사용할 예측기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

 ** [Tags](#API_CreateForecast_RequestSyntax) **   <a name="forecast-CreateForecast-request-Tags"></a>
예측을 분류하고 구성하는 데 도움이 되도록 예측에 적용하는 선택적 메타데이터입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다.  
 태그에 적용되는 기본 제한 사항은 다음과 같습니다.  
+ 리소스당 최대 태그 수 - 50개.
+ 각 리소스에 대해 각 태그 키는 고유해야 하며 각 태그 키는 하나의 값만 가질 수 있습니다.
+ 최대 키 길이 - 유니코드 문자 128자(UTF-8).
+ 최대 값 길이 - 유니코드 문자 256자(UTF-8).
+ 태깅 스키마를 여러 서비스와 리소스에서 사용하는 경우 다른 서비스 또한 허용되는 문자에 대한 제한이 있을 수 있음을 유의합니다. 일반적으로 허용되는 문자는 UTF-8로 표현할 수 있는 문자, 숫자 및 공백과 \$1 - = . \$1 : / @입니다.
+ 태그 키와 값은 대소문자를 구분합니다.
+ 키는 AWS 사용을 위해 예약되어 있으므로 `aws:`, `AWS:`또는 키의 접두사와 같은의 대문자 또는 소문자 조합을 사용하지 마십시오. 이 접두사가 있는 태그 키는 편집하거나 삭제할 수 없습니다. 값에 이 접두사가 포함될 수 있습니다. 태그 값에는 접두사로 `aws`가 있지만 키에는 없는 경우 Forecast는 해당 태그를 사용자 태그로 간주하여 50개 태그 한도에 포함합니다. `aws` 키 접두사만 있는 태그는 리소스당 태그 수 한도에 포함되지 않습니다.
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

 ** [TimeSeriesSelector](#API_CreateForecast_RequestSyntax) **   <a name="forecast-CreateForecast-request-TimeSeriesSelector"></a>
`TimeSeriesIdentifiers` 객체에서 예측을 생성하는 데 사용되는 시계열 세트를 정의합니다.  
`TimeSeriesIdentifiers` 객체에는 다음과 같은 정보가 있어야 합니다.  
+  `DataSource` 
+  `Format` 
+  `Schema` 
유형: [TimeSeriesSelector](API_TimeSeriesSelector.md)객체  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_CreateForecast_ResponseSyntax"></a>

```
{
   "ForecastArn": "string"
}
```

## 응답 요소
<a name="API_CreateForecast_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [ForecastArn](#API_CreateForecast_ResponseSyntax) **   <a name="forecast-CreateForecast-response-ForecastArn"></a>
예측의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## 오류
<a name="API_CreateForecast_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
계정당 리소스 수 제한을 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceAlreadyExistsException **   
이 이름을 가진 리소스가 이미 있습니다. 다른 이름으로 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_CreateForecast_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateForecast) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateForecast) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateForecast) 

# CreateForecastExportJob
<a name="API_CreateForecastExportJob"></a>

[CreateForecast](API_CreateForecast.md) 작업을 통해 생성된 예측을 Amazon Simple Storage Service(S3) 버킷으로 내보냅니다. 예측 파일 이름은 다음 규칙과 일치합니다.

<ForecastExportJobName>\$1<ExportTimestamp>\$1<PartNumber>

여기에서 <ExportTimestamp> 구성 요소는 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/) 

Amazon Forecast가 Amazon S3 버킷에 액세스하기 위해 맡을 수 있는 AWS Identity and Access Management (IAM) 역할을 포함하는 [DataDestination](API_DataDestination.md) 객체를 지정해야 합니다. 자세한 내용은 [Amazon Forecast에 대한 권한 설정](aws-forecast-iam-roles.md) 단원을 참조하십시오.

자세한 내용은 [예측 생성](howitworks-forecast.md) 단원을 참조하십시오.

모든 예측 내보내기 작업 목록을 가져오려면 [ListForecastExportJobs](API_ListForecastExportJobs.md) 작업을 사용합니다.

**참고**  
Amazon S3 버킷의 예측에 액세스하려면 예측 내보내기 작업의 `Status`가 `ACTIVE`여야 합니다. 상태를 가져오려면 [DescribeForecastExportJob](API_DescribeForecastExportJob.md) 작업을 사용합니다.

## 구문 요청
<a name="API_CreateForecastExportJob_RequestSyntax"></a>

```
{
   "Destination": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "ForecastArn": "string",
   "ForecastExportJobName": "string",
   "Format": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## 요청 파라미터
<a name="API_CreateForecastExportJob_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Destination](#API_CreateForecastExportJob_RequestSyntax) **   <a name="forecast-CreateForecastExportJob-request-Destination"></a>
예측을 저장할 위치와 Amazon Forecast가 위치에 액세스하기 위해 수임할 수 있는 AWS Identity and Access Management (IAM) 역할입니다. 예측은 Amazon S3 버킷으로 내보내야 합니다.  
암호화를 사용하는 경우 ( AWS Key Management Service KMS) 키를 포함해야 `Destination` 합니다. IAM 역할은 키에 액세스할 수 있는 Amazon Forecast 권한을 허용해야 합니다.  
타입: [DataDestination](API_DataDestination.md)객체  
필수 항목 여부: 예

 ** [ForecastArn](#API_CreateForecastExportJob_RequestSyntax) **   <a name="forecast-CreateForecastExportJob-request-ForecastArn"></a>
내보내려는 예측의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

 ** [ForecastExportJobName](#API_CreateForecastExportJob_RequestSyntax) **   <a name="forecast-CreateForecastExportJob-request-ForecastExportJobName"></a>
예측 내보내기 작업의 이름.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*`   
필수 여부: 예

 ** [Format](#API_CreateForecastExportJob_RequestSyntax) **   <a name="forecast-CreateForecastExportJob-request-Format"></a>
내보내는 데이터의 형식, CSV 또는 PARQUET. 기본값은 CSV입니다.  
유형: 문자열  
길이 제약 조건: 최대 길이는 7입니다.  
패턴: `^CSV|PARQUET$`   
필수 여부: 아니요

 ** [Tags](#API_CreateForecastExportJob_RequestSyntax) **   <a name="forecast-CreateForecastExportJob-request-Tags"></a>
예측 내보내기 작업을 분류하고 구성하는 데 도움이 되도록 예측 내보내기 작업에 적용하는 선택적 메타데이터입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다.  
 태그에 적용되는 기본 제한 사항은 다음과 같습니다.  
+ 리소스당 최대 태그 수 - 50개.
+ 각 리소스에 대해 각 태그 키는 고유해야 하며 각 태그 키는 하나의 값만 가질 수 있습니다.
+ 최대 키 길이 - 유니코드 문자 128자(UTF-8).
+ 최대 값 길이 - 유니코드 문자 256자(UTF-8).
+ 태깅 스키마를 여러 서비스와 리소스에서 사용하는 경우 다른 서비스 또한 허용되는 문자에 대한 제한이 있을 수 있음을 유의합니다. 일반적으로 허용되는 문자는 UTF-8로 표현할 수 있는 문자, 숫자 및 공백과 \$1 - = . \$1 : / @입니다.
+ 태그 키와 값은 대소문자를 구분합니다.
+ 키는 AWS 사용을 위해 예약되어 있으므로 `aws:`, `AWS:`또는 키의 접두사와 같은의 대문자 또는 소문자 조합을 사용하지 마십시오. 이 접두사가 있는 태그 키는 편집하거나 삭제할 수 없습니다. 값에 이 접두사가 포함될 수 있습니다. 태그 값에는 접두사로 `aws`가 있지만 키에는 없는 경우 Forecast는 해당 태그를 사용자 태그로 간주하여 50개 태그 한도에 포함합니다. `aws` 키 접두사만 있는 태그는 리소스당 태그 수 한도에 포함되지 않습니다.
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

## 응답 구문
<a name="API_CreateForecastExportJob_ResponseSyntax"></a>

```
{
   "ForecastExportJobArn": "string"
}
```

## 응답 요소
<a name="API_CreateForecastExportJob_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [ForecastExportJobArn](#API_CreateForecastExportJob_ResponseSyntax) **   <a name="forecast-CreateForecastExportJob-response-ForecastExportJobArn"></a>
내보내기 작업의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## 오류
<a name="API_CreateForecastExportJob_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
계정당 리소스 수 제한을 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceAlreadyExistsException **   
이 이름을 가진 리소스가 이미 있습니다. 다른 이름으로 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_CreateForecastExportJob_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateForecastExportJob) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateForecastExportJob) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateForecastExportJob) 

# CreateMonitor
<a name="API_CreateMonitor"></a>

기존 자동 예측기의 예측기 모니터 리소스를 생성합니다. 예측기 모니터링을 사용하면 시간 경과에 따라 예측기의 성능이 어떻게 변하는지 볼 수 있습니다. 자세한 내용은 [예측기 모니터링](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/) 

## 구문 요청
<a name="API_CreateMonitor_RequestSyntax"></a>

```
{
   "MonitorName": "string",
   "ResourceArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## 요청 파라미터
<a name="API_CreateMonitor_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [MonitorName](#API_CreateMonitor_RequestSyntax) **   <a name="forecast-CreateMonitor-request-MonitorName"></a>
모니터 리소스의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*`   
필수 여부: 예

 ** [ResourceArn](#API_CreateMonitor_RequestSyntax) **   <a name="forecast-CreateMonitor-request-ResourceArn"></a>
모니터링할 예측기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

 ** [Tags](#API_CreateMonitor_RequestSyntax) **   <a name="forecast-CreateMonitor-request-Tags"></a>
모니터 리소스에 적용할 [태그](https://docs.aws.amazon.com/forecast/latest/dg/tagging-forecast-resources.html) 목록입니다.  
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

## 응답 구문
<a name="API_CreateMonitor_ResponseSyntax"></a>

```
{
   "MonitorArn": "string"
}
```

## 응답 요소
<a name="API_CreateMonitor_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [MonitorArn](#API_CreateMonitor_ResponseSyntax) **   <a name="forecast-CreateMonitor-response-MonitorArn"></a>
모니터 리소스의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## 오류
<a name="API_CreateMonitor_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
계정당 리소스 수 제한을 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceAlreadyExistsException **   
이 이름을 가진 리소스가 이미 있습니다. 다른 이름으로 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_CreateMonitor_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateMonitor) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateMonitor) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateMonitor) 

# CreatePredictor
<a name="API_CreatePredictor"></a>

**참고**  
 이 작업은 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) 작업을 사용합니다.

## 구문 요청
<a name="API_CreatePredictor_RequestSyntax"></a>

```
{
   "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" 
   }
}
```

## 요청 파라미터
<a name="API_CreatePredictor_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [AlgorithmArn](#API_CreatePredictor_RequestSyntax) **   <a name="forecast-CreatePredictor-request-AlgorithmArn"></a>
모델 훈련에 사용할 알고리즘의 Amazon 리소스 이름(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) **   <a name="forecast-CreatePredictor-request-AutoMLOverrideStrategy"></a>
 `LatencyOptimized` AutoML 재정의 전략은 비공개 베타에서만 사용할 수 있습니다. 액세스 권한에 대한 자세한 내용은 AWS Support 또는 계정 관리자에게 문의하세요.
예측기 정확도를 최적화하기 위한 기본 AutoML 전략을 재정의하는 데 사용됩니다. 훈련 시간을 최소화하는 AutoML 전략을 적용하려면 `LatencyOptimized`를 사용하세요.  
이 파라미터는 AutoML을 사용하여 훈련된 예측기에만 사용할 수 있습니다.  
타입: 문자열  
유효 값: `LatencyOptimized | AccuracyOptimized`   
필수 여부: 아니요

 ** [EncryptionConfig](#API_CreatePredictor_RequestSyntax) **   <a name="forecast-CreatePredictor-request-EncryptionConfig"></a>
 AWS Key Management Service Amazon Forecast가 키에 액세스하기 위해 맡을 수 있는 (KMS) 키 및 AWS Identity and Access Management (IAM) 역할입니다.  
유형: [EncryptionConfig](API_EncryptionConfig.md)객체  
필수 여부: 아니요

 ** [EvaluationParameters](#API_CreatePredictor_RequestSyntax) **   <a name="forecast-CreatePredictor-request-EvaluationParameters"></a>
지정된 알고리즘의 기본 평가 파라미터를 재정의하는 데 사용됩니다. Amazon Forecast는 데이터 세트를 훈련 데이터와 테스팅 데이터로 분할하여 예측기를 평가합니다. 평가 파라미터는 분할을 수행하는 방법과 반복 횟수를 정의합니다.  
유형: [EvaluationParameters](API_EvaluationParameters.md)객체  
필수 여부: 아니요

 ** [FeaturizationConfig](#API_CreatePredictor_RequestSyntax) **   <a name="forecast-CreatePredictor-request-FeaturizationConfig"></a>
특성화 구성입니다.  
타입: [FeaturizationConfig](API_FeaturizationConfig.md)객체  
필수 항목 여부: 예

 ** [ForecastHorizon](#API_CreatePredictor_RequestSyntax) **   <a name="forecast-CreatePredictor-request-ForecastHorizon"></a>
모델이 예측을 위해 훈련되는 시간 단계의 수를 지정합니다. 이 예상 구간은 또한 예측 길이라고도 합니다.  
예를 들어 [CreateDataset](API_CreateDataset.md) 작업의 `DataFrequency` 파라미터를 사용하여 일별 데이터 수집을 위한 데이터 세트를 구성하고 예측 기간을 10으로 설정하면 모델은 10일 동안의 예측을 반환합니다.  
최대 예측 기간은 500 시간 단계 또는 TARGET\$1TIME\$1SERIES 데이터 세트 길이의 1/3 중 작은 값입니다.  
유형: 정수  
필수 항목 여부: 예

 ** [ForecastTypes](#API_CreatePredictor_RequestSyntax) **   <a name="forecast-CreatePredictor-request-ForecastTypes"></a>
예측기 훈련에 사용되는 예측 유형을 지정합니다. 최대 5개의 예측 유형을 지정할 수 있습니다. 예측 유형은 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) **   <a name="forecast-CreatePredictor-request-HPOConfig"></a>
알고리즘의 하이퍼파라미터 재정의 값을 제공합니다. 이 파라미터를 제공하지 않으면 Amazon Forecast는 기본값을 사용합니다. 개별 알고리즘은 하이퍼파라미터 최적화(HPO)를 지원하는 하이퍼파라미터를 지정합니다. 자세한 내용은 [Amazon Forecast 알고리즘](aws-forecast-choosing-recipes.md) 단원을 참조하십시오.  
`HPOConfig` 객체를 포함한 경우 `PerformHPO`를 true로 설정해야 합니다.  
유형: [HyperParameterTuningJobConfig](API_HyperParameterTuningJobConfig.md)객체  
필수 여부: 아니요

 ** [InputDataConfig](#API_CreatePredictor_RequestSyntax) **   <a name="forecast-CreatePredictor-request-InputDataConfig"></a>
예측기를 훈련하는 데 사용할 데이터가 포함된 데이터 세트 그룹을 설명합니다.  
타입: [InputDataConfig](API_InputDataConfig.md)객체  
필수 항목 여부: 예

 ** [OptimizationMetric](#API_CreatePredictor_RequestSyntax) **   <a name="forecast-CreatePredictor-request-OptimizationMetric"></a>
예측기를 최적화하는 데 사용되는 정확도 지표입니다. 기본 값은 `AverageWeightedQuantileLoss`입니다.  
타입: 문자열  
유효 값: `WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE`   
필수 여부: 아니요

 ** [PerformAutoML](#API_CreatePredictor_RequestSyntax) **   <a name="forecast-CreatePredictor-request-PerformAutoML"></a>
AutoML을 수행할지 여부입니다. Amazon Forecast는 AutoML을 수행할 때 제공하는 알고리즘을 평가하고 훈련 데이터 세트에 가장 적합한 알고리즘과 구성을 선택합니다.  
기본값은 `false`입니다. 이 경우 알고리즘을 지정해야 합니다.  
Amazon Forecast가 AutoML을 수행하도록 하려면 `PerformAutoML`을 `true`로 설정합니다. 어떤 알고리즘이 훈련 데이터에 적합한지 잘 모를 경우 이 방법을 사용하는 것이 좋습니다. 이 경우 `PerformHPO`가 false여야 합니다.  
유형: 부울  
필수 항목 여부: 아니요

 ** [PerformHPO](#API_CreatePredictor_RequestSyntax) **   <a name="forecast-CreatePredictor-request-PerformHPO"></a>
하이퍼파라미터 최적화(HPO)를 수행할지 여부입니다. HPO는 훈련 데이터에 최적인 하이퍼파라미터 값을 찾습니다. HPO를 수행하는 프로세스를 하이퍼파라미터 튜닝 작업 실행이라고 합니다.  
기본값은 `false`입니다. 이 경우 Amazon Forecast는 선택한 알고리즘의 기본 하이퍼파라미터 값을 사용합니다.  
기본값을 재정의하려면 `PerformHPO`를 `true`로 설정하고, 선택적으로 [HyperParameterTuningJobConfig](API_HyperParameterTuningJobConfig.md) 객체를 제공합니다. 튜닝 작업은 최적화할 지표, 튜닝에 참여하는 하이퍼파라미터, 튜닝 가능한 각 하이퍼파라미터의 유효 범위를 지정합니다. 이 경우 알고리즘을 지정해야 하며, `PerformAutoML`은 false여야 합니다.  
다음 알고리즘은 HPO를 지원합니다.  
+ DeepAR\$1
+ CNN-QR
유형: 부울  
필수 항목 여부: 아니요

 ** [PredictorName](#API_CreatePredictor_RequestSyntax) **   <a name="forecast-CreatePredictor-request-PredictorName"></a>
예측기의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*`   
필수 여부: 예

 ** [Tags](#API_CreatePredictor_RequestSyntax) **   <a name="forecast-CreatePredictor-request-Tags"></a>
예측기를 분류하고 구성하는 데 도움이 되도록 예측기에 적용하는 선택적 메타데이터입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다.  
 태그에 적용되는 기본 제한 사항은 다음과 같습니다.  
+ 리소스당 최대 태그 수 - 50개.
+ 각 리소스에 대해 각 태그 키는 고유해야 하며 각 태그 키는 하나의 값만 가질 수 있습니다.
+ 최대 키 길이 - 유니코드 문자 128자(UTF-8).
+ 최대 값 길이 - 유니코드 문자 256자(UTF-8).
+ 태깅 스키마를 여러 서비스와 리소스에서 사용하는 경우 다른 서비스 또한 허용되는 문자에 대한 제한이 있을 수 있음을 유의합니다. 일반적으로 허용되는 문자는 UTF-8로 표현할 수 있는 문자, 숫자 및 공백과 \$1 - = . \$1 : / @입니다.
+ 태그 키와 값은 대소문자를 구분합니다.
+ 키는 AWS 사용을 위해 예약되어 있으므로 `aws:`, `AWS:`또는 키의 접두사와 같은의 대문자 또는 소문자 조합을 사용하지 마십시오. 이 접두사가 있는 태그 키는 편집하거나 삭제할 수 없습니다. 값에 이 접두사가 포함될 수 있습니다. 태그 값에는 접두사로 `aws`가 있지만 키에는 없는 경우 Forecast는 해당 태그를 사용자 태그로 간주하여 50개 태그 한도에 포함합니다. `aws` 키 접두사만 있는 태그는 리소스당 태그 수 한도에 포함되지 않습니다.
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

 ** [TrainingParameters](#API_CreatePredictor_RequestSyntax) **   <a name="forecast-CreatePredictor-request-TrainingParameters"></a>
모델 훈련을 위해 재정의해야 할 하이퍼파라미터입니다. 재정의할 수 있는 하이퍼파라미터는 개별 알고리즘에 나열되어 있습니다. 지원되는 키 알고리즘 목록은 [Amazon Forecast 알고리즘](aws-forecast-choosing-recipes.md) 섹션을 참조하세요.  
유형: 문자열 간 맵  
맵 항목: 최소 항목 수는 0개입니다. 최대수는 100개입니다.  
키 길이 제약: 최대 길이는 256입니다.  
키 패턴: `^[a-zA-Z0-9\-\_\.\/\[\]\,\\]+$`   
값 길이 제약: 최대 길이는 256입니다.  
값 패턴: `^[a-zA-Z0-9\-\_\.\/\[\]\,\"\\\s]+$`   
필수 항목 여부: 아니요

## 응답 구문
<a name="API_CreatePredictor_ResponseSyntax"></a>

```
{
   "PredictorArn": "string"
}
```

## 응답 요소
<a name="API_CreatePredictor_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [PredictorArn](#API_CreatePredictor_ResponseSyntax) **   <a name="forecast-CreatePredictor-response-PredictorArn"></a>
예측기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## 오류
<a name="API_CreatePredictor_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
계정당 리소스 수 제한을 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceAlreadyExistsException **   
이 이름을 가진 리소스가 이미 있습니다. 다른 이름으로 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_CreatePredictor_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreatePredictor) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreatePredictor) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreatePredictor) 

# CreatePredictorBacktestExportJob
<a name="API_CreatePredictorBacktestExportJob"></a>

[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/) 

 내보내기 파일 이름은 다음 규칙과 일치합니다.

 `<ExportJobName>_<ExportTimestamp>_<PartNumber>.csv` 

<ExportTimestamp> 구성 요소는 Java SimpleDate 형식 (yyyy-MM-ddTHH-mm-ssZ)입니다.

Amazon S3 버킷과 Amazon Forecast가 Amazon S3 버킷에 액세스하기 위해 수임할 수 있는 AWS Identity and Access Management (IAM) 역할이 포함된 [DataDestination](API_DataDestination.md) 객체를 지정해야 합니다. 자세한 내용은 [Amazon Forecast에 대한 권한 설정](aws-forecast-iam-roles.md) 단원을 참조하십시오.

**참고**  
Amazon S3 버킷의 내보내기에 액세스하려면 내보내기 작업의 `Status`가 `ACTIVE`여야 합니다. 상태를 가져오려면 [DescribePredictorBacktestExportJob](API_DescribePredictorBacktestExportJob.md) 작업을 사용합니다.

## 구문 요청
<a name="API_CreatePredictorBacktestExportJob_RequestSyntax"></a>

```
{
   "Destination": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "Format": "string",
   "PredictorArn": "string",
   "PredictorBacktestExportJobName": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## 요청 파라미터
<a name="API_CreatePredictorBacktestExportJob_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Destination](#API_CreatePredictorBacktestExportJob_RequestSyntax) **   <a name="forecast-CreatePredictorBacktestExportJob-request-Destination"></a>
내보내기 작업의 대상입니다. S3 경로, Amazon Forecast가 위치에 액세스할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할 및 AWS Key Management Service (KMS) 키(선택 사항)를 제공합니다.  
타입: [DataDestination](API_DataDestination.md)객체  
필수 항목 여부: 예

 ** [Format](#API_CreatePredictorBacktestExportJob_RequestSyntax) **   <a name="forecast-CreatePredictorBacktestExportJob-request-Format"></a>
내보내는 데이터의 형식, CSV 또는 PARQUET. 기본값은 CSV입니다.  
유형: 문자열  
길이 제약 조건: 최대 길이는 7입니다.  
패턴: `^CSV|PARQUET$`   
필수 여부: 아니요

 ** [PredictorArn](#API_CreatePredictorBacktestExportJob_RequestSyntax) **   <a name="forecast-CreatePredictorBacktestExportJob-request-PredictorArn"></a>
내보내려는 예측기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

 ** [PredictorBacktestExportJobName](#API_CreatePredictorBacktestExportJob_RequestSyntax) **   <a name="forecast-CreatePredictorBacktestExportJob-request-PredictorBacktestExportJobName"></a>
백테스트 내보내기 작업의 이름.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*`   
필수 여부: 예

 ** [Tags](#API_CreatePredictorBacktestExportJob_RequestSyntax) **   <a name="forecast-CreatePredictorBacktestExportJob-request-Tags"></a>
백테스트를 분류하고 구성하는 데 도움이 되는 선택적 메타데이터입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다. 태그 키와 값은 대소문자를 구분합니다.  
태그에 적용되는 제한은 다음과 같습니다.  
+ 리소스마다 각 태그 키는 고유해야 하며 하나의 값만 가질 수 있습니다.
+ 리소스당 최대 태그 수: 50개.
+ 최대 키 길이: 유니코드 문자 128자(UTF-8).
+ 최대 값 길이: 유니코드 문자 256자(UTF-8).
+ 허용되는 문자: UTF-8로 표현할 수 있는 모든 문자와 숫자, 공백 및 \$1 - =. \$1 : / @. 태그 지정 스키마를 다른 서비스와 리소스에서 사용하는 경우 해당 서비스의 문자 제한도 적용됩니다.
+ 키 접두사는 `aws:` 또는 `AWS:`의 대문자 또는 소문자 조합을 포함할 수 없습니다. 값에 이 접두사가 포함될 수 있습니다. 태그 값에는 접두사로 `aws`가 있지만 키에는 없는 경우 Forecast는 해당 태그를 사용자 태그로 간주하여 50개 태그 한도에 포함합니다. `aws` 키 접두사만 있는 태그는 리소스당 태그 수 한도에 포함되지 않습니다. 이 접두사가 있는 태그 키는 편집하거나 삭제할 수 없습니다.
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

## 응답 구문
<a name="API_CreatePredictorBacktestExportJob_ResponseSyntax"></a>

```
{
   "PredictorBacktestExportJobArn": "string"
}
```

## 응답 요소
<a name="API_CreatePredictorBacktestExportJob_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [PredictorBacktestExportJobArn](#API_CreatePredictorBacktestExportJob_ResponseSyntax) **   <a name="forecast-CreatePredictorBacktestExportJob-response-PredictorBacktestExportJobArn"></a>
내보내려는 예측기 백테스트 내보내기 작업의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## 오류
<a name="API_CreatePredictorBacktestExportJob_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
계정당 리소스 수 제한을 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceAlreadyExistsException **   
이 이름을 가진 리소스가 이미 있습니다. 다른 이름으로 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_CreatePredictorBacktestExportJob_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreatePredictorBacktestExportJob) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreatePredictorBacktestExportJob) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreatePredictorBacktestExportJob) 

# CreateWhatIfAnalysis
<a name="API_CreateWhatIfAnalysis"></a>

what-if 분석은 시계열을 가상으로 변경하고 이러한 변경으로 생성된 예측을 변경되지 않은 기준선 시계열과 비교하는 시나리오 모델링 기법입니다. what-if 분석의 목적은 기준선 시계열의 다양한 수정에 따라 예측이 어떻게 변할 수 있는지 이해하는 것임을 기억하는 것이 중요합니다.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

새로운 스타일을 위한 공간을 확보하기 위해 시즌 종료 세일을 고려하고 있는 의류 소매업체를 예로 들어 보겠습니다. 기준선 예측을 생성한 후에는 what-if 분석을 사용하여 다양한 판매 전략이 목표에 어떤 영향을 미칠지 조사할 수 있습니다.

모든 항목에 25% 가격 인하가 적용되는 시나리오와 모든 항목에 고정 금액 가격 인하가 적용되는 시나리오를 생성할 수 있습니다. 세일이 일주일 동안 지속되는 시나리오와 한 달 동안 지속되는 또 다른 시나리오를 생성할 수 있습니다. what-if 분석을 사용하여 다양한 시나리오를 서로 비교할 수 있습니다.

what-if 분석은 예측 모델이 무엇을 학습했고 평가 중인 시나리오에서 예측 모델이 어떻게 작동할지를 표시하기 위한 것입니다. what-if 분석 결과를 맹목적으로 사용하여 비즈니스 결정을 내리지 마세요. 예를 들어 예측이 좋은지 판단할 수 있는 참조가 없는 새로운 시나리오에서는 예측이 정확하지 않을 수 있습니다.

[TimeSeriesSelector](API_TimeSeriesSelector.md) 객체는 what-if 분석에서 원하는 항목을 정의합니다.

**참고**  
what-if 분석을 생성하려면 데이터가 쉼표로 구분된 값(CSV) 형식이어야 합니다.

## 구문 요청
<a name="API_CreateWhatIfAnalysis_RequestSyntax"></a>

```
{
   "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"
}
```

## 요청 파라미터
<a name="API_CreateWhatIfAnalysis_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ForecastArn](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-ForecastArn"></a>
기준선 예측의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

 ** [Tags](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-Tags"></a>
what-if 예측에 적용할 [태그](https://docs.aws.amazon.com/forecast/latest/dg/tagging-forecast-resources.html) 목록입니다.  
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

 ** [TimeSeriesSelector](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-TimeSeriesSelector"></a>
`TimeSeriesIdentifiers` 객체가 있는 what-if 분석에 사용되는 시계열 세트를 정의합니다. what-if 분석은 이 객체의 시계열에 대해서만 수행됩니다.  
`TimeSeriesIdentifiers` 객체에는 다음과 같은 정보가 있어야 합니다.  
+  `DataSource` 
+  `Format` 
+  `Schema` 
유형: [TimeSeriesSelector](API_TimeSeriesSelector.md)객체  
필수 여부: 아니요

 ** [WhatIfAnalysisName](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-WhatIfAnalysisName"></a>
what-if 분석의 이름입니다. 각 이름은 고유해야 합니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*`   
필수 여부: 예

## 응답 구문
<a name="API_CreateWhatIfAnalysis_ResponseSyntax"></a>

```
{
   "WhatIfAnalysisArn": "string"
}
```

## 응답 요소
<a name="API_CreateWhatIfAnalysis_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [WhatIfAnalysisArn](#API_CreateWhatIfAnalysis_ResponseSyntax) **   <a name="forecast-CreateWhatIfAnalysis-response-WhatIfAnalysisArn"></a>
what-if 분석의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## 오류
<a name="API_CreateWhatIfAnalysis_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
계정당 리소스 수 제한을 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceAlreadyExistsException **   
이 이름을 가진 리소스가 이미 있습니다. 다른 이름으로 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_CreateWhatIfAnalysis_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateWhatIfAnalysis) 

# CreateWhatIfForecast
<a name="API_CreateWhatIfForecast"></a>

what-if 예측은 기준선 예측의 수정된 버전에서 생성되는 예측입니다. 각 what-if 예측은 대체 데이터 세트 또는 원본 데이터 세트 변환 세트를 통합합니다.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

## 구문 요청
<a name="API_CreateWhatIfForecast_RequestSyntax"></a>

```
{
   "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"
}
```

## 요청 파라미터
<a name="API_CreateWhatIfForecast_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Tags](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-Tags"></a>
what-if 예측에 적용할 [태그](https://docs.aws.amazon.com/forecast/latest/dg/tagging-forecast-resources.html) 목록입니다.  
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

 ** [TimeSeriesReplacementsDataSource](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-TimeSeriesReplacementsDataSource"></a>
관련 시계열 데이터 세트에서 변경하려는 행이 포함되어 있는 대체 시계열 데이터 세트입니다. 대체 시계열에는 기준선 관련 시계열에 있는 모든 행이 포함될 필요는 없습니다. what-if 예측에 포함하려는 행(측정-차원 조합)만 포함하세요.  
이 데이터 세트는 원본 시계열과 병합되어 what-if 분석에 사용되는 변환된 데이터 세트를 생성합니다.  
이 데이터 세트에는 수정할 항목(예: item\$1id 또는 workforce\$1type), 관련 차원, 타임스탬프 열, 하나 이상의 관련 시계열 열이 포함되어야 합니다. 이 파일에는 동일한 시계열에 대한 중복된 타임스탬프가 포함되어서는 안 됩니다. 이 파일은 CSV 형식이어야 합니다.  
이 데이터 세트에 포함되지 않은 타임스탬프와 item\$1id는 what-if 분석에 포함되지 않습니다.  
유형: [TimeSeriesReplacementsDataSource](API_TimeSeriesReplacementsDataSource.md)객체  
필수 여부: 아니요

 ** [TimeSeriesTransformations](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-TimeSeriesTransformations"></a>
기준선 시계열에 적용되는 변환입니다. 각 변환에는 작업과 일련의 조건이 포함되어 있습니다. 모든 조건이 충족되는 경우에만 작업이 적용됩니다. 조건을 제공하지 않으면 모든 항목에 작업이 적용됩니다.  
타입: [TimeSeriesTransformation](API_TimeSeriesTransformation.md)객체 배열  
배열 구성원: 최소수는 0개입니다. 최대 항목 수는 30개입니다.  
필수 여부: 아니요

 ** [WhatIfAnalysisArn](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-WhatIfAnalysisArn"></a>
what-if 분석의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

 ** [WhatIfForecastName](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-WhatIfForecastName"></a>
what-if 예측의 이름입니다. 이름은 각 what-if 분석 내에서 고유해야 합니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*`   
필수 여부: 예

## 응답 구문
<a name="API_CreateWhatIfForecast_ResponseSyntax"></a>

```
{
   "WhatIfForecastArn": "string"
}
```

## 응답 요소
<a name="API_CreateWhatIfForecast_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [WhatIfForecastArn](#API_CreateWhatIfForecast_ResponseSyntax) **   <a name="forecast-CreateWhatIfForecast-response-WhatIfForecastArn"></a>
what-if 예측의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약 조건: 최대 길이는 300입니다.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## 오류
<a name="API_CreateWhatIfForecast_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
계정당 리소스 수 제한을 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceAlreadyExistsException **   
이 이름을 가진 리소스가 이미 있습니다. 다른 이름으로 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_CreateWhatIfForecast_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateWhatIfForecast) 

# CreateWhatIfForecastExport
<a name="API_CreateWhatIfForecastExport"></a>

[CreateWhatIfForecast](API_CreateWhatIfForecast.md) 작업을 통해 생성된 예측을 Amazon Simple Storage Service(S3) 버킷으로 내보냅니다. 예측 파일 이름은 다음 규칙과 일치합니다.

 `≈<ForecastExportJobName>_<ExportTimestamp>_<PartNumber>` 

<ExportTimestamp> 구성 요소는 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/) 

Amazon Forecast가 Amazon S3 버킷에 액세스하기 위해 맡을 수 있는 AWS Identity and Access Management (IAM) 역할을 포함하는 [DataDestination](API_DataDestination.md) 객체를 지정해야 합니다. 자세한 내용은 [Amazon Forecast에 대한 권한 설정](aws-forecast-iam-roles.md) 단원을 참조하십시오.

자세한 내용은 [예측 생성](howitworks-forecast.md) 단원을 참조하십시오.

모든 what-if 예측 내보내기 작업 목록을 가져오려면 [ListWhatIfForecastExports](API_ListWhatIfForecastExports.md) 작업을 사용합니다.

**참고**  
Amazon S3 버킷의 예측에 액세스하려면 예측 내보내기 작업의 `Status`가 `ACTIVE`여야 합니다. 상태를 가져오려면 [DescribeWhatIfForecastExport](API_DescribeWhatIfForecastExport.md) 작업을 사용합니다.

## 구문 요청
<a name="API_CreateWhatIfForecastExport_RequestSyntax"></a>

```
{
   "Destination": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "Format": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "WhatIfForecastArns": [ "string" ],
   "WhatIfForecastExportName": "string"
}
```

## 요청 파라미터
<a name="API_CreateWhatIfForecastExport_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Destination](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-Destination"></a>
예측을 저장할 위치와 Amazon Forecast가 위치에 액세스하기 위해 수임할 수 있는 AWS Identity and Access Management (IAM) 역할입니다. 예측은 Amazon S3 버킷으로 내보내야 합니다.  
암호화를 사용하는 경우 ( AWS Key Management Service KMS) 키를 포함해야 `Destination` 합니다. IAM 역할은 키에 액세스할 수 있는 Amazon Forecast 권한을 허용해야 합니다.  
타입: [DataDestination](API_DataDestination.md)객체  
필수 항목 여부: 예

 ** [Format](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-Format"></a>
내보내는 데이터의 형식, CSV 또는 PARQUET.  
유형: 문자열  
길이 제약 조건: 최대 길이는 7입니다.  
패턴: `^CSV|PARQUET$`   
필수 여부: 아니요

 ** [Tags](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-Tags"></a>
what-if 예측에 적용할 [태그](https://docs.aws.amazon.com/forecast/latest/dg/tagging-forecast-resources.html) 목록입니다.  
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

 ** [WhatIfForecastArns](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-WhatIfForecastArns"></a>
내보낼 what-if 예측 Amazon 리소스 이름(ARN) 목록입니다.  
타입: 문자열 배열  
배열 멤버: 최소수는 1개입니다. 최대 항목 수는 50개입니다.  
길이 제약 조건: 최대 길이는 300입니다.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

 ** [WhatIfForecastExportName](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-WhatIfForecastExportName"></a>
내보낼 what-if 예측의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*`   
필수 여부: 예

## 응답 구문
<a name="API_CreateWhatIfForecastExport_ResponseSyntax"></a>

```
{
   "WhatIfForecastExportArn": "string"
}
```

## 응답 요소
<a name="API_CreateWhatIfForecastExport_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [WhatIfForecastExportArn](#API_CreateWhatIfForecastExport_ResponseSyntax) **   <a name="forecast-CreateWhatIfForecastExport-response-WhatIfForecastExportArn"></a>
what-if 예측의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약 조건: 최대 길이는 300입니다.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## 오류
<a name="API_CreateWhatIfForecastExport_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
계정당 리소스 수 제한을 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceAlreadyExistsException **   
이 이름을 가진 리소스가 이미 있습니다. 다른 이름으로 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_CreateWhatIfForecastExport_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateWhatIfForecastExport) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateWhatIfForecastExport) 

# DeleteDataset
<a name="API_DeleteDataset"></a>

[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/) 

**참고**  
Forecast는 삭제된 데이터 세트를 포함하는 데이터 세트 그룹을 자동으로 업데이트하지 않습니다. 데이터 세트 그룹을 업데이트하려면 삭제된 데이터 세트의 ARN을 생략하고 [UpdateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_UpdateDatasetGroup.html) 작업을 사용하세요.

## 구문 요청
<a name="API_DeleteDataset_RequestSyntax"></a>

```
{
   "DatasetArn": "string"
}
```

## 요청 파라미터
<a name="API_DeleteDataset_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [DatasetArn](#API_DeleteDataset_RequestSyntax) **   <a name="forecast-DeleteDataset-request-DatasetArn"></a>
삭제할 데이터세트의 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 요소
<a name="API_DeleteDataset_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeleteDataset_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DeleteDataset_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteDataset) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteDataset) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteDataset) 

# DeleteDatasetGroup
<a name="API_DeleteDatasetGroup"></a>

[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/) 

이 작업을 수행하면 데이터 세트 그룹만 삭제되고 그룹의 데이터 세트는 삭제되지 않습니다.

## 구문 요청
<a name="API_DeleteDatasetGroup_RequestSyntax"></a>

```
{
   "DatasetGroupArn": "string"
}
```

## 요청 파라미터
<a name="API_DeleteDatasetGroup_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [DatasetGroupArn](#API_DeleteDatasetGroup_RequestSyntax) **   <a name="forecast-DeleteDatasetGroup-request-DatasetGroupArn"></a>
삭제할 데이터 세트 그룹의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 요소
<a name="API_DeleteDatasetGroup_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeleteDatasetGroup_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DeleteDatasetGroup_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteDatasetGroup) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteDatasetGroup) 

# DeleteDatasetImportJob
<a name="API_DeleteDatasetImportJob"></a>

[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/) 

## 구문 요청
<a name="API_DeleteDatasetImportJob_RequestSyntax"></a>

```
{
   "DatasetImportJobArn": "string"
}
```

## 요청 파라미터
<a name="API_DeleteDatasetImportJob_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [DatasetImportJobArn](#API_DeleteDatasetImportJob_RequestSyntax) **   <a name="forecast-DeleteDatasetImportJob-request-DatasetImportJobArn"></a>
삭제할 데이터 세트 가져오기 작업의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 요소
<a name="API_DeleteDatasetImportJob_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeleteDatasetImportJob_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DeleteDatasetImportJob_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteDatasetImportJob) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteDatasetImportJob) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteDatasetImportJob) 

# DeleteExplainability
<a name="API_DeleteExplainability"></a>

설명 가능성 리소스를 삭제합니다.

**중요**  
신규 고객은 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) 작업을 사용합니다.

## 구문 요청
<a name="API_DeleteExplainability_RequestSyntax"></a>

```
{
   "ExplainabilityArn": "string"
}
```

## 요청 파라미터
<a name="API_DeleteExplainability_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ExplainabilityArn](#API_DeleteExplainability_RequestSyntax) **   <a name="forecast-DeleteExplainability-request-ExplainabilityArn"></a>
삭제할 설명 가능성 리소스의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 요소
<a name="API_DeleteExplainability_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeleteExplainability_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DeleteExplainability_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteExplainability) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteExplainability) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteExplainability) 

# DeleteExplainabilityExport
<a name="API_DeleteExplainabilityExport"></a>

설명 가능성 내보내기를 삭제합니다.

## 구문 요청
<a name="API_DeleteExplainabilityExport_RequestSyntax"></a>

```
{
   "ExplainabilityExportArn": "string"
}
```

## 요청 파라미터
<a name="API_DeleteExplainabilityExport_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ExplainabilityExportArn](#API_DeleteExplainabilityExport_RequestSyntax) **   <a name="forecast-DeleteExplainabilityExport-request-ExplainabilityExportArn"></a>
삭제할 설명 가능성 내보내기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 요소
<a name="API_DeleteExplainabilityExport_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeleteExplainabilityExport_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DeleteExplainabilityExport_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteExplainabilityExport) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DeleteExplainabilityExport) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DeleteExplainabilityExport) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteExplainabilityExport) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteExplainabilityExport) 

# DeleteForecast
<a name="API_DeleteForecast"></a>

[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/) 

## 구문 요청
<a name="API_DeleteForecast_RequestSyntax"></a>

```
{
   "ForecastArn": "string"
}
```

## 요청 파라미터
<a name="API_DeleteForecast_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ForecastArn](#API_DeleteForecast_RequestSyntax) **   <a name="forecast-DeleteForecast-request-ForecastArn"></a>
삭제할 예측의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 요소
<a name="API_DeleteForecast_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeleteForecast_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DeleteForecast_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteForecast) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteForecast) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteForecast) 

# DeleteForecastExportJob
<a name="API_DeleteForecastExportJob"></a>

[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/) 

## 구문 요청
<a name="API_DeleteForecastExportJob_RequestSyntax"></a>

```
{
   "ForecastExportJobArn": "string"
}
```

## 요청 파라미터
<a name="API_DeleteForecastExportJob_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ForecastExportJobArn](#API_DeleteForecastExportJob_RequestSyntax) **   <a name="forecast-DeleteForecastExportJob-request-ForecastExportJobArn"></a>
삭제할 예측 내보내기 작업의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 요소
<a name="API_DeleteForecastExportJob_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeleteForecastExportJob_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DeleteForecastExportJob_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteForecastExportJob) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteForecastExportJob) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteForecastExportJob) 

# DeleteMonitor
<a name="API_DeleteMonitor"></a>

모니터 리소스를 삭제합니다. `ACTIVE`, `ACTIVE_STOPPED`, `CREATE_FAILED` 또는 `CREATE_STOPPED` 상태인 모니터 리소스만 삭제할 수 있습니다.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

## 구문 요청
<a name="API_DeleteMonitor_RequestSyntax"></a>

```
{
   "MonitorArn": "string"
}
```

## 요청 파라미터
<a name="API_DeleteMonitor_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [MonitorArn](#API_DeleteMonitor_RequestSyntax) **   <a name="forecast-DeleteMonitor-request-MonitorArn"></a>
삭제할 모니터 리소스의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 요소
<a name="API_DeleteMonitor_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeleteMonitor_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DeleteMonitor_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteMonitor) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteMonitor) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteMonitor) 

# DeletePredictor
<a name="API_DeletePredictor"></a>

[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/) 

## 구문 요청
<a name="API_DeletePredictor_RequestSyntax"></a>

```
{
   "PredictorArn": "string"
}
```

## 요청 파라미터
<a name="API_DeletePredictor_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [PredictorArn](#API_DeletePredictor_RequestSyntax) **   <a name="forecast-DeletePredictor-request-PredictorArn"></a>
삭제할 예측기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 요소
<a name="API_DeletePredictor_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeletePredictor_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DeletePredictor_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeletePredictor) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeletePredictor) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeletePredictor) 

# DeletePredictorBacktestExportJob
<a name="API_DeletePredictorBacktestExportJob"></a>

예측기 백테스트 내보내기 작업을 삭제합니다.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

## 구문 요청
<a name="API_DeletePredictorBacktestExportJob_RequestSyntax"></a>

```
{
   "PredictorBacktestExportJobArn": "string"
}
```

## 요청 파라미터
<a name="API_DeletePredictorBacktestExportJob_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [PredictorBacktestExportJobArn](#API_DeletePredictorBacktestExportJob_RequestSyntax) **   <a name="forecast-DeletePredictorBacktestExportJob-request-PredictorBacktestExportJobArn"></a>
삭제할 예측기 백테스트 내보내기 작업의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 요소
<a name="API_DeletePredictorBacktestExportJob_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeletePredictorBacktestExportJob_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DeletePredictorBacktestExportJob_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeletePredictorBacktestExportJob) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeletePredictorBacktestExportJob) 

# DeleteResourceTree
<a name="API_DeleteResourceTree"></a>

전체 리소스 트리를 삭제합니다. 이 작업을 수행하면 상위 리소스 및 해당 하위 리소스가 삭제됩니다.

**중요**  
신규 고객은 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에 저장된 데이터 세트나 내보낸 파일은 삭제하지 않습니다.

## 구문 요청
<a name="API_DeleteResourceTree_RequestSyntax"></a>

```
{
   "ResourceArn": "string"
}
```

## 요청 파라미터
<a name="API_DeleteResourceTree_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ResourceArn](#API_DeleteResourceTree_RequestSyntax) **   <a name="forecast-DeleteResourceTree-request-ResourceArn"></a>
삭제할 상위 리소스의 Amazon 리소스 이름(ARN)입니다. 상위 리소스의 모든 하위 리소스도 삭제됩니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 요소
<a name="API_DeleteResourceTree_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeleteResourceTree_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DeleteResourceTree_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteResourceTree) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteResourceTree) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteResourceTree) 

# DeleteWhatIfAnalysis
<a name="API_DeleteWhatIfAnalysis"></a>

[CreateWhatIfAnalysis](API_CreateWhatIfAnalysis.md) 작업을 사용하여 생성한 what-if 분석을 삭제합니다. `ACTIVE` 또는 `CREATE_FAILED` 상태인 what-if 분석만 삭제할 수 있습니다. 상태를 가져오려면 [DescribeWhatIfAnalysis](API_DescribeWhatIfAnalysis.md) 작업을 사용합니다.

예측을 내보내는 동안에는 what-if 분석을 삭제할 수 없습니다.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

## 구문 요청
<a name="API_DeleteWhatIfAnalysis_RequestSyntax"></a>

```
{
   "WhatIfAnalysisArn": "string"
}
```

## 요청 파라미터
<a name="API_DeleteWhatIfAnalysis_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [WhatIfAnalysisArn](#API_DeleteWhatIfAnalysis_RequestSyntax) **   <a name="forecast-DeleteWhatIfAnalysis-request-WhatIfAnalysisArn"></a>
삭제할 what-if 분석의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 요소
<a name="API_DeleteWhatIfAnalysis_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeleteWhatIfAnalysis_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DeleteWhatIfAnalysis_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteWhatIfAnalysis) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteWhatIfAnalysis) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteWhatIfAnalysis) 

# DeleteWhatIfForecast
<a name="API_DeleteWhatIfForecast"></a>

[CreateWhatIfForecast](API_CreateWhatIfForecast.md) 작업을 사용하여 생성한 what-if 예측을 삭제합니다. `ACTIVE` 또는 `CREATE_FAILED` 상태인 what-if 예측만 삭제할 수 있습니다. 상태를 가져오려면 [DescribeWhatIfForecast](API_DescribeWhatIfForecast.md) 작업을 사용합니다.

내보내는 동안에는 what-if 예측을 삭제할 수 없습니다. what-if 예측이 삭제된 후에는 what-if 분석을 더 이상 쿼리할 수 없습니다.

## 구문 요청
<a name="API_DeleteWhatIfForecast_RequestSyntax"></a>

```
{
   "WhatIfForecastArn": "string"
}
```

## 요청 파라미터
<a name="API_DeleteWhatIfForecast_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [WhatIfForecastArn](#API_DeleteWhatIfForecast_RequestSyntax) **   <a name="forecast-DeleteWhatIfForecast-request-WhatIfForecastArn"></a>
삭제할 what-if 예측의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약 조건: 최대 길이는 300입니다.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 요소
<a name="API_DeleteWhatIfForecast_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeleteWhatIfForecast_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DeleteWhatIfForecast_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteWhatIfForecast) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteWhatIfForecast) 

# DeleteWhatIfForecastExport
<a name="API_DeleteWhatIfForecastExport"></a>

[CreateWhatIfForecastExport](API_CreateWhatIfForecastExport.md) 작업을 사용하여 생성한 what-if 예측 내보내기를 삭제합니다. `ACTIVE` 또는 `CREATE_FAILED` 상태인 what-if 예측 내보내기만 삭제할 수 있습니다. 상태를 가져오려면 [DescribeWhatIfForecastExport](API_DescribeWhatIfForecastExport.md) 작업을 사용합니다.

## 구문 요청
<a name="API_DeleteWhatIfForecastExport_RequestSyntax"></a>

```
{
   "WhatIfForecastExportArn": "string"
}
```

## 요청 파라미터
<a name="API_DeleteWhatIfForecastExport_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [WhatIfForecastExportArn](#API_DeleteWhatIfForecastExport_RequestSyntax) **   <a name="forecast-DeleteWhatIfForecastExport-request-WhatIfForecastExportArn"></a>
삭제할 what-if 예측 내보내기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약 조건: 최대 길이는 300입니다.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 요소
<a name="API_DeleteWhatIfForecastExport_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeleteWhatIfForecastExport_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DeleteWhatIfForecastExport_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DeleteWhatIfForecastExport) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DeleteWhatIfForecastExport) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DeleteWhatIfForecastExport) 

# DescribeAutoPredictor
<a name="API_DescribeAutoPredictor"></a>

CreateAutoPredictor 작업을 사용하여 생성한 예측기를 설명합니다.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

## 구문 요청
<a name="API_DescribeAutoPredictor_RequestSyntax"></a>

```
{
   "PredictorArn": "string"
}
```

## 요청 파라미터
<a name="API_DescribeAutoPredictor_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [PredictorArn](#API_DescribeAutoPredictor_RequestSyntax) **   <a name="forecast-DescribeAutoPredictor-request-PredictorArn"></a>
예측기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 구문
<a name="API_DescribeAutoPredictor_ResponseSyntax"></a>

```
{
   "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"
   }
}
```

## 응답 요소
<a name="API_DescribeAutoPredictor_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationTime](#API_DescribeAutoPredictor_ResponseSyntax) **   <a name="forecast-DescribeAutoPredictor-response-CreationTime"></a>
CreateAutoPredictor 요청의 타임스탬프입니다.  
유형: 타임스탬프

 ** [DataConfig](#API_DescribeAutoPredictor_ResponseSyntax) **   <a name="forecast-DescribeAutoPredictor-response-DataConfig"></a>
데이터 세트 그룹 및 추가 데이터 세트의 데이터 구성입니다.  
유형: [DataConfig](API_DataConfig.md)객체

 ** [DatasetImportJobArns](#API_DescribeAutoPredictor_ResponseSyntax) **   <a name="forecast-DescribeAutoPredictor-response-DatasetImportJobArns"></a>
예측기의 훈련 데이터를 가져오는 데 사용되는 데이터 세트 가져오기 작업의 ARN 배열입니다.  
유형: 문자열 배열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [EncryptionConfig](#API_DescribeAutoPredictor_ResponseSyntax) **   <a name="forecast-DescribeAutoPredictor-response-EncryptionConfig"></a>
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) **   <a name="forecast-DescribeAutoPredictor-response-EstimatedTimeRemainingInMinutes"></a>
예측기 훈련 작업 완료까지 남은 예상 시간(분)입니다.  
타입: Long

 ** [ExplainabilityInfo](#API_DescribeAutoPredictor_ResponseSyntax) **   <a name="forecast-DescribeAutoPredictor-response-ExplainabilityInfo"></a>
예측기 설명 가능성의 상태 및 ARN을 제공합니다.  
유형: [ExplainabilityInfo](API_ExplainabilityInfo.md)객체

 ** [ForecastDimensions](#API_DescribeAutoPredictor_ResponseSyntax) **   <a name="forecast-DescribeAutoPredictor-response-ForecastDimensions"></a>
시계열을 그룹화하는 데 사용되는 속성을 지정하는 차원(필드) 이름의 배열입니다.  
타입: 문자열 배열  
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 10개입니다.  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*` 

 ** [ForecastFrequency](#API_DescribeAutoPredictor_ResponseSyntax) **   <a name="forecast-DescribeAutoPredictor-response-ForecastFrequency"></a>
예측에서의 예측 빈도.  
유효한 간격은 Y(년), M(월), W(주), D(일), H(시), 30min(30분), 15min(15분), 10min(10분), 5min(5분) 및 1min(1분)입니다. 예를 들어 “Y”는 매년을 나타내고 “5min”은 5분마다를 나타냅니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 5입니다.  
패턴: `^Y|M|W|D|H|30min|15min|10min|5min|1min$` 

 ** [ForecastHorizon](#API_DescribeAutoPredictor_ResponseSyntax) **   <a name="forecast-DescribeAutoPredictor-response-ForecastHorizon"></a>
모델이 예측하는 시간 단계의 수입니다. 이 예상 구간은 또한 예측 길이라고도 합니다.  
유형: 정수

 ** [ForecastTypes](#API_DescribeAutoPredictor_ResponseSyntax) **   <a name="forecast-DescribeAutoPredictor-response-ForecastTypes"></a>
예측기 훈련 중에 사용되는 예측 유형입니다. 기본값은 ["0.1","0.5","0.9"]입니다.  
타입: 문자열 배열  
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 20개입니다.  
길이 제약: 최소 길이는 2입니다. 최대 길이는 4입니다.  
패턴: `(^0?\.\d\d?$|^mean$)` 

 ** [LastModificationTime](#API_DescribeAutoPredictor_ResponseSyntax) **   <a name="forecast-DescribeAutoPredictor-response-LastModificationTime"></a>
리소스가 마지막으로 수정된 시간입니다. 타임스탬프는 작업 상태에 따라 달라집니다.  
+  `CREATE_PENDING`: `CreationTime`.
+  `CREATE_IN_PROGRESS` - 현재 타임스탬프.
+  `CREATE_STOPPING` - 현재 타임스탬프.
+  `CREATE_STOPPED` - 작업이 중지된 시점.
+  `ACTIVE` 또는 `CREATE_FAILED` - 작업이 완료되거나 실패한 경우.
유형: 타임스탬프

 ** [Message](#API_DescribeAutoPredictor_ResponseSyntax) **   <a name="forecast-DescribeAutoPredictor-response-Message"></a>
오류 발생 시 오류의 원인을 자세히 설명하는 메시지입니다.  
유형: 문자열

 ** [MonitorInfo](#API_DescribeAutoPredictor_ResponseSyntax) **   <a name="forecast-DescribeAutoPredictor-response-MonitorInfo"></a>
Amazon 리소스 이름(ARN)과 모니터 리소스 상태가 있는 [MonitorInfo](API_MonitorInfo.md) 객체입니다.  
유형: [MonitorInfo](API_MonitorInfo.md)객체

 ** [OptimizationMetric](#API_DescribeAutoPredictor_ResponseSyntax) **   <a name="forecast-DescribeAutoPredictor-response-OptimizationMetric"></a>
예측기를 최적화하는 데 사용되는 정확도 지표입니다.  
타입: 문자열  
유효 값: `WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE` 

 ** [PredictorArn](#API_DescribeAutoPredictor_ResponseSyntax) **   <a name="forecast-DescribeAutoPredictor-response-PredictorArn"></a>
예측기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [PredictorName](#API_DescribeAutoPredictor_ResponseSyntax) **   <a name="forecast-DescribeAutoPredictor-response-PredictorName"></a>
예측기의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*` 

 ** [ReferencePredictorSummary](#API_DescribeAutoPredictor_ResponseSyntax) **   <a name="forecast-DescribeAutoPredictor-response-ReferencePredictorSummary"></a>
참조 예측기의 ARN 및 상태입니다. 이 파라미터는 재훈련되거나 업그레이드된 예측기인 경우에만 유효합니다.  
유형: [ReferencePredictorSummary](API_ReferencePredictorSummary.md)객체

 ** [Status](#API_DescribeAutoPredictor_ResponseSyntax) **   <a name="forecast-DescribeAutoPredictor-response-Status"></a>
예측기의 상태입니다. 상태는 다음을 포함합니다.  
+  `ACTIVE` 
+  `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` 
+  `CREATE_STOPPING`, `CREATE_STOPPED` 
+  `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 
유형: 문자열  
길이 제약: 최대 길이 256.

 ** [TimeAlignmentBoundary](#API_DescribeAutoPredictor_ResponseSyntax) **   <a name="forecast-DescribeAutoPredictor-response-TimeAlignmentBoundary"></a>
Forecast가 데이터를 집계할 때 사용하는 시간 경계입니다.  
타입: [TimeAlignmentBoundary](API_TimeAlignmentBoundary.md) 객체

## 오류
<a name="API_DescribeAutoPredictor_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DescribeAutoPredictor_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeAutoPredictor) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeAutoPredictor) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeAutoPredictor) 

# DescribeDataset
<a name="API_DescribeDataset"></a>

[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` 

## 구문 요청
<a name="API_DescribeDataset_RequestSyntax"></a>

```
{
   "DatasetArn": "string"
}
```

## 요청 파라미터
<a name="API_DescribeDataset_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [DatasetArn](#API_DescribeDataset_RequestSyntax) **   <a name="forecast-DescribeDataset-request-DatasetArn"></a>
데이터세트의 리소스 이름(ARN).  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 구문
<a name="API_DescribeDataset_ResponseSyntax"></a>

```
{
   "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"
}
```

## 응답 요소
<a name="API_DescribeDataset_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationTime](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-CreationTime"></a>
데이터 세트를 생성한 시간입니다.  
유형: 타임스탬프

 ** [DataFrequency](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-DataFrequency"></a>
데이터 수집 빈도입니다.  
유효한 간격은 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) **   <a name="forecast-DescribeDataset-response-DatasetArn"></a>
데이터세트의 리소스 이름(ARN).  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [DatasetName](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-DatasetName"></a>
데이터세트의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*` 

 ** [DatasetType](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-DatasetType"></a>
데이터세트 유형.  
타입: 문자열  
유효 값: `TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA` 

 ** [Domain](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-Domain"></a>
데이터 세트와 연결된 도메인입니다.  
타입: 문자열  
유효 값: `RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS` 

 ** [EncryptionConfig](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-EncryptionConfig"></a>
 AWS Key Management Service Amazon Forecast가 키에 액세스하기 위해 수임할 수 있는 (KMS) 키 및 AWS Identity and Access Management (IAM) 역할입니다.  
유형: [EncryptionConfig](API_EncryptionConfig.md)객체

 ** [LastModificationTime](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-LastModificationTime"></a>
데이터 세트를 생성하는 경우 `LastModificationTime`은 `CreationTime`과 같습니다. 데이터를 데이터 세트로 가져오는 동안 `LastModificationTime`은 `DescribeDataset` 직접 호출의 현재 시간입니다. [CreateDatasetImportJob](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetImportJob.html) 작업이 완료된 후 `LastModificationTime`은 가져오기 작업이 완료되거나 실패한 때입니다.  
유형: 타임스탬프

 ** [Schema](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-Schema"></a>
데이터 세트 필드를 지정하는 `SchemaAttribute` 객체의 배열입니다. 각 `SchemaAttribute`는 필드의 이름과 데이터 형식을 지정합니다.  
유형: [Schema](API_Schema.md)객체

 ** [Status](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-Status"></a>
데이터세트의 상태입니다. 상태는 다음을 포함합니다.  
+  `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.

## 오류
<a name="API_DescribeDataset_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DescribeDataset_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeDataset) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeDataset) 

# DescribeDatasetGroup
<a name="API_DescribeDatasetGroup"></a>

[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` 

## 구문 요청
<a name="API_DescribeDatasetGroup_RequestSyntax"></a>

```
{
   "DatasetGroupArn": "string"
}
```

## 요청 파라미터
<a name="API_DescribeDatasetGroup_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [DatasetGroupArn](#API_DescribeDatasetGroup_RequestSyntax) **   <a name="forecast-DescribeDatasetGroup-request-DatasetGroupArn"></a>
데이터세트 그룹의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 구문
<a name="API_DescribeDatasetGroup_ResponseSyntax"></a>

```
{
   "CreationTime": number,
   "DatasetArns": [ "string" ],
   "DatasetGroupArn": "string",
   "DatasetGroupName": "string",
   "Domain": "string",
   "LastModificationTime": number,
   "Status": "string"
}
```

## 응답 요소
<a name="API_DescribeDatasetGroup_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationTime](#API_DescribeDatasetGroup_ResponseSyntax) **   <a name="forecast-DescribeDatasetGroup-response-CreationTime"></a>
데이터 세트 그룹이 생성된 시간입니다.  
유형: 타임스탬프

 ** [DatasetArns](#API_DescribeDatasetGroup_ResponseSyntax) **   <a name="forecast-DescribeDatasetGroup-response-DatasetArns"></a>
데이터 세트 그룹에 포함된 데이터 세트의 Amazon 리소스 이름(ARN) 배열입니다.  
유형: 문자열 배열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [DatasetGroupArn](#API_DescribeDatasetGroup_ResponseSyntax) **   <a name="forecast-DescribeDatasetGroup-response-DatasetGroupArn"></a>
데이터 세트 그룹의 ARN입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [DatasetGroupName](#API_DescribeDatasetGroup_ResponseSyntax) **   <a name="forecast-DescribeDatasetGroup-response-DatasetGroupName"></a>
데이터세트 그룹의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*` 

 ** [Domain](#API_DescribeDatasetGroup_ResponseSyntax) **   <a name="forecast-DescribeDatasetGroup-response-Domain"></a>
데이터 세트 그룹과 연결된 도메인입니다.  
타입: 문자열  
유효 값: `RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS` 

 ** [LastModificationTime](#API_DescribeDatasetGroup_ResponseSyntax) **   <a name="forecast-DescribeDatasetGroup-response-LastModificationTime"></a>
데이터 세트 그룹이 생성되거나 [UpdateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_UpdateDatasetGroup.html) 작업 직접 호출로부터 마지막으로 업데이트된 때입니다. 데이터 세트 그룹이 업데이트되는 동안 `LastModificationTime`은 `DescribeDatasetGroup` 직접 호출의 현재 시간입니다.  
유형: 타임스탬프

 ** [Status](#API_DescribeDatasetGroup_ResponseSyntax) **   <a name="forecast-DescribeDatasetGroup-response-Status"></a>
데이터세트 그룹의 상태입니다. 상태는 다음을 포함합니다.  
+  `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.

## 오류
<a name="API_DescribeDatasetGroup_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DescribeDatasetGroup_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeDatasetGroup) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeDatasetGroup) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeDatasetGroup) 

# DescribeDatasetImportJob
<a name="API_DescribeDatasetImportJob"></a>

[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` - 오류가 발생한 경우 오류에 대한 정보.

## 구문 요청
<a name="API_DescribeDatasetImportJob_RequestSyntax"></a>

```
{
   "DatasetImportJobArn": "string"
}
```

## 요청 파라미터
<a name="API_DescribeDatasetImportJob_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [DatasetImportJobArn](#API_DescribeDatasetImportJob_RequestSyntax) **   <a name="forecast-DescribeDatasetImportJob-request-DatasetImportJobArn"></a>
데이터세트 가져오기 작업의 리소스 이름(ARN).  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 구문
<a name="API_DescribeDatasetImportJob_ResponseSyntax"></a>

```
{
   "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
}
```

## 응답 요소
<a name="API_DescribeDatasetImportJob_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationTime](#API_DescribeDatasetImportJob_ResponseSyntax) **   <a name="forecast-DescribeDatasetImportJob-response-CreationTime"></a>
데이터 세트 가져오기 작업이 생성된 시간입니다.  
유형: 타임스탬프

 ** [DatasetArn](#API_DescribeDatasetImportJob_ResponseSyntax) **   <a name="forecast-DescribeDatasetImportJob-response-DatasetArn"></a>
훈련 데이터를 가져온 데이터 세트의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [DatasetImportJobArn](#API_DescribeDatasetImportJob_ResponseSyntax) **   <a name="forecast-DescribeDatasetImportJob-response-DatasetImportJobArn"></a>
데이터세트 가져오기 작업의 ARN입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [DatasetImportJobName](#API_DescribeDatasetImportJob_ResponseSyntax) **   <a name="forecast-DescribeDatasetImportJob-response-DatasetImportJobName"></a>
데이터세트 가져오기 작업의 이름.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*` 

 ** [DataSize](#API_DescribeDatasetImportJob_ResponseSyntax) **   <a name="forecast-DescribeDatasetImportJob-response-DataSize"></a>
가져오기 작업이 완료된 후 데이터 세트 크기(GB)입니다.  
유형: Double

 ** [DataSource](#API_DescribeDatasetImportJob_ResponseSyntax) **   <a name="forecast-DescribeDatasetImportJob-response-DataSource"></a>
가져올 훈련 데이터의 위치와 Amazon Forecast가 데이터에 액세스하기 위해 수임할 수 있는 AWS Identity and Access Management (IAM) 역할입니다.  
암호화를 사용하는 경우 에는 AWS Key Management Service (KMS) 키가 `DataSource` 포함됩니다.  
유형: [DataSource](API_DataSource.md)객체

 ** [EstimatedTimeRemainingInMinutes](#API_DescribeDatasetImportJob_ResponseSyntax) **   <a name="forecast-DescribeDatasetImportJob-response-EstimatedTimeRemainingInMinutes"></a>
데이터 세트 가져오기 작업 완료까지 남은 예상 시간(분)입니다.  
타입: Long

 ** [FieldStatistics](#API_DescribeDatasetImportJob_ResponseSyntax) **   <a name="forecast-DescribeDatasetImportJob-response-FieldStatistics"></a>
입력 데이터의 각 필드에 대한 통계 정보입니다.  
유형: 문자열-[Statistics](API_Statistics.md) 객체 맵  
키 길이 제약: 최대 길이는 256입니다.  
키 패턴: `^[a-zA-Z0-9\_]+$` 

 ** [Format](#API_DescribeDatasetImportJob_ResponseSyntax) **   <a name="forecast-DescribeDatasetImportJob-response-Format"></a>
가져온 데이터의 형식, CSV 또는 PARQUET.  
유형: 문자열  
길이 제약 조건: 최대 길이는 7입니다.  
패턴: `^CSV|PARQUET$` 

 ** [GeolocationFormat](#API_DescribeDatasetImportJob_ResponseSyntax) **   <a name="forecast-DescribeDatasetImportJob-response-GeolocationFormat"></a>
지리적 위치 속성의 형식입니다. 유효한 값: `"LAT_LONG"` 및 `"CC_POSTALCODE"`  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `^[a-zA-Z0-9_]+$` 

 ** [ImportMode](#API_DescribeDatasetImportJob_ResponseSyntax) **   <a name="forecast-DescribeDatasetImportJob-response-ImportMode"></a>
데이터 세트 가져오기 작업의 가져오기 모드, FULL 또는 INCREMENTAL.  
타입: 문자열  
유효 값: `FULL | INCREMENTAL` 

 ** [LastModificationTime](#API_DescribeDatasetImportJob_ResponseSyntax) **   <a name="forecast-DescribeDatasetImportJob-response-LastModificationTime"></a>
리소스가 마지막으로 수정된 시간입니다. 타임스탬프는 작업 상태에 따라 달라집니다.  
+  `CREATE_PENDING`: `CreationTime`.
+  `CREATE_IN_PROGRESS` - 현재 타임스탬프.
+  `CREATE_STOPPING` - 현재 타임스탬프.
+  `CREATE_STOPPED` - 작업이 중지된 시점.
+  `ACTIVE` 또는 `CREATE_FAILED` - 작업이 완료되거나 실패한 경우.
유형: 타임스탬프

 ** [Message](#API_DescribeDatasetImportJob_ResponseSyntax) **   <a name="forecast-DescribeDatasetImportJob-response-Message"></a>
오류가 발생한 경우 오류에 대한 정보 메시지.  
유형: 문자열

 ** [Status](#API_DescribeDatasetImportJob_ResponseSyntax) **   <a name="forecast-DescribeDatasetImportJob-response-Status"></a>
데이터 세트 가져오기 작업의 상태. 상태는 다음을 포함합니다.  
+  `ACTIVE` 
+  `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` 
+  `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 
+  `CREATE_STOPPING`, `CREATE_STOPPED` 
유형: 문자열  
길이 제약: 최대 길이 256.

 ** [TimestampFormat](#API_DescribeDatasetImportJob_ResponseSyntax) **   <a name="forecast-DescribeDatasetImportJob-response-TimestampFormat"></a>
데이터 세트의 타임스탬프 형식입니다. 지정하는 형식은 데이터 세트가 생성될 때 지정한 `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) **   <a name="forecast-DescribeDatasetImportJob-response-TimeZone"></a>
데이터 세트의 모든 항목에 적용되는 단일 시간대입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `^[a-zA-Z0-9\/\+\-\_]+$` 

 ** [UseGeolocationForTimeZone](#API_DescribeDatasetImportJob_ResponseSyntax) **   <a name="forecast-DescribeDatasetImportJob-response-UseGeolocationForTimeZone"></a>
`TimeZone`이 지리적 위치 속성에서 자동으로 파생되는지 여부입니다.  
유형: Boolean

## 오류
<a name="API_DescribeDatasetImportJob_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DescribeDatasetImportJob_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeDatasetImportJob) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeDatasetImportJob) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeDatasetImportJob) 

# DescribeExplainability
<a name="API_DescribeExplainability"></a>

[CreateExplainability](API_CreateExplainability.md) 작업을 사용하여 생성한 설명 가능성 리소스를 설명합니다.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

## 구문 요청
<a name="API_DescribeExplainability_RequestSyntax"></a>

```
{
   "ExplainabilityArn": "string"
}
```

## 요청 파라미터
<a name="API_DescribeExplainability_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ExplainabilityArn](#API_DescribeExplainability_RequestSyntax) **   <a name="forecast-DescribeExplainability-request-ExplainabilityArn"></a>
설명할 설명 가능성의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 구문
<a name="API_DescribeExplainability_ResponseSyntax"></a>

```
{
   "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"
}
```

## 응답 요소
<a name="API_DescribeExplainability_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationTime](#API_DescribeExplainability_ResponseSyntax) **   <a name="forecast-DescribeExplainability-response-CreationTime"></a>
설명 가능성 리소스가 생성된 때입니다.  
유형: 타임스탬프

 ** [DataSource](#API_DescribeExplainability_ResponseSyntax) **   <a name="forecast-DescribeExplainability-response-DataSource"></a>
데이터의 소스, Amazon Forecast가 데이터에 액세스하고 선택적으로 AWS Identity and Access Management (KMS) 키에 액세스할 수 있는 AWS Key Management Service (IAM) 역할입니다.  
유형: [DataSource](API_DataSource.md)객체

 ** [EnableVisualization](#API_DescribeExplainability_ResponseSyntax) **   <a name="forecast-DescribeExplainability-response-EnableVisualization"></a>
설명 가능성 리소스에 대한 시각화가 활성화되었는지 여부입니다.  
유형: Boolean

 ** [EndDateTime](#API_DescribeExplainability_ResponseSyntax) **   <a name="forecast-DescribeExplainability-response-EndDateTime"></a>
`TimePointGranularity`가 `SPECIFIC`으로 설정된 경우 설명 가능성의 마지막 시점입니다.  
유형: 문자열  
길이 제약 조건: 최대 길이는 19입니다.  
패턴: `^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$` 

 ** [EstimatedTimeRemainingInMinutes](#API_DescribeExplainability_ResponseSyntax) **   <a name="forecast-DescribeExplainability-response-EstimatedTimeRemainingInMinutes"></a>
[CreateExplainability](API_CreateExplainability.md) 작업 완료까지 남은 예상 시간(분)입니다.  
타입: Long

 ** [ExplainabilityArn](#API_DescribeExplainability_ResponseSyntax) **   <a name="forecast-DescribeExplainability-response-ExplainabilityArn"></a>
설명 가능성의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [ExplainabilityConfig](#API_DescribeExplainability_ResponseSyntax) **   <a name="forecast-DescribeExplainability-response-ExplainabilityConfig"></a>
설명 가능성의 시계열 및 시점 세분 수준을 정의하는 구성 설정입니다.  
유형: [ExplainabilityConfig](API_ExplainabilityConfig.md)객체

 ** [ExplainabilityName](#API_DescribeExplainability_ResponseSyntax) **   <a name="forecast-DescribeExplainability-response-ExplainabilityName"></a>
설명 가능성의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*` 

 ** [LastModificationTime](#API_DescribeExplainability_ResponseSyntax) **   <a name="forecast-DescribeExplainability-response-LastModificationTime"></a>
리소스가 마지막으로 수정된 시간입니다. 타임스탬프는 작업 상태에 따라 달라집니다.  
+  `CREATE_PENDING`: `CreationTime`.
+  `CREATE_IN_PROGRESS` - 현재 타임스탬프.
+  `CREATE_STOPPING` - 현재 타임스탬프.
+  `CREATE_STOPPED` - 작업이 중지된 시점.
+  `ACTIVE` 또는 `CREATE_FAILED` - 작업이 완료되거나 실패한 경우.
유형: 타임스탬프

 ** [Message](#API_DescribeExplainability_ResponseSyntax) **   <a name="forecast-DescribeExplainability-response-Message"></a>
오류가 발생한 경우 해당 오류에 대한 메시지입니다.  
유형: 문자열

 ** [ResourceArn](#API_DescribeExplainability_ResponseSyntax) **   <a name="forecast-DescribeExplainability-response-ResourceArn"></a>
설명 가능성 리소스 생성에 사용되는 예측기 또는 예측의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [Schema](#API_DescribeExplainability_ResponseSyntax) **   <a name="forecast-DescribeExplainability-response-Schema"></a>
데이터 세트의 필드를 정의합니다.  
유형: [Schema](API_Schema.md)객체

 ** [StartDateTime](#API_DescribeExplainability_ResponseSyntax) **   <a name="forecast-DescribeExplainability-response-StartDateTime"></a>
`TimePointGranularity`가 `SPECIFIC`으로 설정된 경우 설명 가능성의 첫 번째 시점입니다.  
유형: 문자열  
길이 제약 조건: 최대 길이는 19입니다.  
패턴: `^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$` 

 ** [Status](#API_DescribeExplainability_ResponseSyntax) **   <a name="forecast-DescribeExplainability-response-Status"></a>
설명 가능성 리소스의 상태입니다. 상태는 다음을 포함합니다.  
+  `ACTIVE` 
+  `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` 
+  `CREATE_STOPPING`, `CREATE_STOPPED` 
+  `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 
유형: 문자열  
길이 제약: 최대 길이 256.

## 오류
<a name="API_DescribeExplainability_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DescribeExplainability_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeExplainability) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeExplainability) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeExplainability) 

# DescribeExplainabilityExport
<a name="API_DescribeExplainabilityExport"></a>

[CreateExplainabilityExport](API_CreateExplainabilityExport.md) 작업을 사용하여 생성한 설명 가능성 내보내기를 설명합니다.

## 구문 요청
<a name="API_DescribeExplainabilityExport_RequestSyntax"></a>

```
{
   "ExplainabilityExportArn": "string"
}
```

## 요청 파라미터
<a name="API_DescribeExplainabilityExport_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ExplainabilityExportArn](#API_DescribeExplainabilityExport_RequestSyntax) **   <a name="forecast-DescribeExplainabilityExport-request-ExplainabilityExportArn"></a>
설명 가능성 내보내기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 구문
<a name="API_DescribeExplainabilityExport_ResponseSyntax"></a>

```
{
   "CreationTime": number,
   "Destination": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "ExplainabilityArn": "string",
   "ExplainabilityExportArn": "string",
   "ExplainabilityExportName": "string",
   "Format": "string",
   "LastModificationTime": number,
   "Message": "string",
   "Status": "string"
}
```

## 응답 요소
<a name="API_DescribeExplainabilityExport_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationTime](#API_DescribeExplainabilityExport_ResponseSyntax) **   <a name="forecast-DescribeExplainabilityExport-response-CreationTime"></a>
설명 가능성 내보내기가 생성된 때입니다.  
유형: 타임스탬프

 ** [Destination](#API_DescribeExplainabilityExport_ResponseSyntax) **   <a name="forecast-DescribeExplainabilityExport-response-Destination"></a>
내보내기 작업의 대상입니다. S3 경로, Amazon Forecast가 위치에 액세스할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할 및 AWS Key Management Service (KMS) 키(선택 사항)를 제공합니다.  
유형: [DataDestination](API_DataDestination.md)객체

 ** [ExplainabilityArn](#API_DescribeExplainabilityExport_ResponseSyntax) **   <a name="forecast-DescribeExplainabilityExport-response-ExplainabilityArn"></a>
설명 가능성 내보내기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [ExplainabilityExportArn](#API_DescribeExplainabilityExport_ResponseSyntax) **   <a name="forecast-DescribeExplainabilityExport-response-ExplainabilityExportArn"></a>
설명 가능성 내보내기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [ExplainabilityExportName](#API_DescribeExplainabilityExport_ResponseSyntax) **   <a name="forecast-DescribeExplainabilityExport-response-ExplainabilityExportName"></a>
설명 가능성 내보내기의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*` 

 ** [Format](#API_DescribeExplainabilityExport_ResponseSyntax) **   <a name="forecast-DescribeExplainabilityExport-response-Format"></a>
내보내는 데이터의 형식, CSV 또는 PARQUET.  
유형: 문자열  
길이 제약 조건: 최대 길이는 7입니다.  
패턴: `^CSV|PARQUET$` 

 ** [LastModificationTime](#API_DescribeExplainabilityExport_ResponseSyntax) **   <a name="forecast-DescribeExplainabilityExport-response-LastModificationTime"></a>
리소스가 마지막으로 수정된 시간입니다. 타임스탬프는 작업 상태에 따라 달라집니다.  
+  `CREATE_PENDING`: `CreationTime`.
+  `CREATE_IN_PROGRESS` - 현재 타임스탬프.
+  `CREATE_STOPPING` - 현재 타임스탬프.
+  `CREATE_STOPPED` - 작업이 중지된 시점.
+  `ACTIVE` 또는 `CREATE_FAILED` - 작업이 완료되거나 실패한 경우.
유형: 타임스탬프

 ** [Message](#API_DescribeExplainabilityExport_ResponseSyntax) **   <a name="forecast-DescribeExplainabilityExport-response-Message"></a>
내보내기 중에 발생한 모든 오류에 대한 정보입니다.  
유형: 문자열

 ** [Status](#API_DescribeExplainabilityExport_ResponseSyntax) **   <a name="forecast-DescribeExplainabilityExport-response-Status"></a>
설명 가능성 내보내기의 상태입니다. 상태는 다음을 포함합니다.  
+  `ACTIVE` 
+  `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` 
+  `CREATE_STOPPING`, `CREATE_STOPPED` 
+  `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 
유형: 문자열  
길이 제약: 최대 길이 256.

## 오류
<a name="API_DescribeExplainabilityExport_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DescribeExplainabilityExport_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeExplainabilityExport) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeExplainabilityExport) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeExplainabilityExport) 

# DescribeForecast
<a name="API_DescribeForecast"></a>

[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` - 오류가 발생한 경우 오류에 대한 정보.

## 구문 요청
<a name="API_DescribeForecast_RequestSyntax"></a>

```
{
   "ForecastArn": "string"
}
```

## 요청 파라미터
<a name="API_DescribeForecast_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ForecastArn](#API_DescribeForecast_RequestSyntax) **   <a name="forecast-DescribeForecast-request-ForecastArn"></a>
예측의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 구문
<a name="API_DescribeForecast_ResponseSyntax"></a>

```
{
   "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"
               }
            ]
         }
      }
   }
}
```

## 응답 요소
<a name="API_DescribeForecast_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationTime](#API_DescribeForecast_ResponseSyntax) **   <a name="forecast-DescribeForecast-response-CreationTime"></a>
예측 생성 작업이 생성된 때입니다.  
유형: 타임스탬프

 ** [DatasetGroupArn](#API_DescribeForecast_ResponseSyntax) **   <a name="forecast-DescribeForecast-response-DatasetGroupArn"></a>
예측기 훈련에 사용되는 데이터를 제공한 데이터 세트 그룹의 ARN입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [EstimatedTimeRemainingInMinutes](#API_DescribeForecast_ResponseSyntax) **   <a name="forecast-DescribeForecast-response-EstimatedTimeRemainingInMinutes"></a>
예측 작업 완료까지 남은 예상 시간(분)입니다.  
타입: Long

 ** [ForecastArn](#API_DescribeForecast_ResponseSyntax) **   <a name="forecast-DescribeForecast-response-ForecastArn"></a>
요청에 지정된 예측 ARN입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [ForecastName](#API_DescribeForecast_ResponseSyntax) **   <a name="forecast-DescribeForecast-response-ForecastName"></a>
예측의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*` 

 ** [ForecastTypes](#API_DescribeForecast_ResponseSyntax) **   <a name="forecast-DescribeForecast-response-ForecastTypes"></a>
확률적 예측이 생성된 시점의 분위수입니다.  
타입: 문자열 배열  
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 20개입니다.  
길이 제약: 최소 길이는 2입니다. 최대 길이는 4입니다.  
패턴: `(^0?\.\d\d?$|^mean$)` 

 ** [LastModificationTime](#API_DescribeForecast_ResponseSyntax) **   <a name="forecast-DescribeForecast-response-LastModificationTime"></a>
리소스가 마지막으로 수정된 시간입니다. 타임스탬프는 작업 상태에 따라 달라집니다.  
+  `CREATE_PENDING`: `CreationTime`.
+  `CREATE_IN_PROGRESS` - 현재 타임스탬프.
+  `CREATE_STOPPING` - 현재 타임스탬프.
+  `CREATE_STOPPED` - 작업이 중지된 시점.
+  `ACTIVE` 또는 `CREATE_FAILED` - 작업이 완료되거나 실패한 경우.
유형: 타임스탬프

 ** [Message](#API_DescribeForecast_ResponseSyntax) **   <a name="forecast-DescribeForecast-response-Message"></a>
오류가 발생한 경우 오류에 대한 정보 메시지.  
유형: 문자열

 ** [PredictorArn](#API_DescribeForecast_ResponseSyntax) **   <a name="forecast-DescribeForecast-response-PredictorArn"></a>
예측 생성에 사용된 예측기의 ARN입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [Status](#API_DescribeForecast_ResponseSyntax) **   <a name="forecast-DescribeForecast-response-Status"></a>
예측의 상태입니다. 상태는 다음을 포함합니다.  
+  `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) **   <a name="forecast-DescribeForecast-response-TimeSeriesSelector"></a>
예측에 포함할 시계열입니다.  
타입: [TimeSeriesSelector](API_TimeSeriesSelector.md) 객체

## 오류
<a name="API_DescribeForecast_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DescribeForecast_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeForecast) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeForecast) 

# DescribeForecastExportJob
<a name="API_DescribeForecastExportJob"></a>

[CreateForecastExportJob](API_CreateForecastExportJob.md) 작업을 사용하여 생성된 예측 내보내기 작업을 설명합니다.

이 작업은 `CreateForecastExportJob` 요청에서 사용자가 제공한 속성을 나열하는 것 외에도 다음 속성을 나열합니다.
+  `CreationTime` 
+  `LastModificationTime` 
+  `Status` 
+  `Message` - 오류가 발생한 경우 오류에 대한 정보.

## 구문 요청
<a name="API_DescribeForecastExportJob_RequestSyntax"></a>

```
{
   "ForecastExportJobArn": "string"
}
```

## 요청 파라미터
<a name="API_DescribeForecastExportJob_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ForecastExportJobArn](#API_DescribeForecastExportJob_RequestSyntax) **   <a name="forecast-DescribeForecastExportJob-request-ForecastExportJobArn"></a>
예측 내보내기 작업의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 구문
<a name="API_DescribeForecastExportJob_ResponseSyntax"></a>

```
{
   "CreationTime": number,
   "Destination": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "ForecastArn": "string",
   "ForecastExportJobArn": "string",
   "ForecastExportJobName": "string",
   "Format": "string",
   "LastModificationTime": number,
   "Message": "string",
   "Status": "string"
}
```

## 응답 요소
<a name="API_DescribeForecastExportJob_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationTime](#API_DescribeForecastExportJob_ResponseSyntax) **   <a name="forecast-DescribeForecastExportJob-response-CreationTime"></a>
예측 내보내기 작업이 생성된 때입니다.  
유형: 타임스탬프

 ** [Destination](#API_DescribeForecastExportJob_ResponseSyntax) **   <a name="forecast-DescribeForecastExportJob-response-Destination"></a>
예측을 내보내는 Amazon Simple Storage Service(S3) 버킷의 경로입니다.  
유형: [DataDestination](API_DataDestination.md)객체

 ** [ForecastArn](#API_DescribeForecastExportJob_ResponseSyntax) **   <a name="forecast-DescribeForecastExportJob-response-ForecastArn"></a>
내보낸 예측의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [ForecastExportJobArn](#API_DescribeForecastExportJob_ResponseSyntax) **   <a name="forecast-DescribeForecastExportJob-response-ForecastExportJobArn"></a>
예측 내보내기 작업의 ARN입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [ForecastExportJobName](#API_DescribeForecastExportJob_ResponseSyntax) **   <a name="forecast-DescribeForecastExportJob-response-ForecastExportJobName"></a>
예측 내보내기 작업의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*` 

 ** [Format](#API_DescribeForecastExportJob_ResponseSyntax) **   <a name="forecast-DescribeForecastExportJob-response-Format"></a>
내보내는 데이터의 형식, CSV 또는 PARQUET.  
유형: 문자열  
길이 제약 조건: 최대 길이는 7입니다.  
패턴: `^CSV|PARQUET$` 

 ** [LastModificationTime](#API_DescribeForecastExportJob_ResponseSyntax) **   <a name="forecast-DescribeForecastExportJob-response-LastModificationTime"></a>
리소스가 마지막으로 수정된 시간입니다. 타임스탬프는 작업 상태에 따라 달라집니다.  
+  `CREATE_PENDING`: `CreationTime`.
+  `CREATE_IN_PROGRESS` - 현재 타임스탬프.
+  `CREATE_STOPPING` - 현재 타임스탬프.
+  `CREATE_STOPPED` - 작업이 중지된 시점.
+  `ACTIVE` 또는 `CREATE_FAILED` - 작업이 완료되거나 실패한 경우.
유형: 타임스탬프

 ** [Message](#API_DescribeForecastExportJob_ResponseSyntax) **   <a name="forecast-DescribeForecastExportJob-response-Message"></a>
오류가 발생한 경우 오류에 대한 정보 메시지.  
유형: 문자열

 ** [Status](#API_DescribeForecastExportJob_ResponseSyntax) **   <a name="forecast-DescribeForecastExportJob-response-Status"></a>
예측 내보내기 작업 상태입니다. 상태는 다음을 포함합니다.  
+  `ACTIVE` 
+  `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` 
+  `CREATE_STOPPING`, `CREATE_STOPPED` 
+  `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 
S3 버킷의 예측에 액세스하려면 예측 내보내기 작업의 `Status`가 `ACTIVE`여야 합니다.
유형: 문자열  
길이 제약: 최대 길이 256.

## 오류
<a name="API_DescribeForecastExportJob_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DescribeForecastExportJob_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeForecastExportJob) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeForecastExportJob) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeForecastExportJob) 

# DescribeMonitor
<a name="API_DescribeMonitor"></a>

모니터 리소스를 설명합니다. 이 작업은 [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/) 

## 구문 요청
<a name="API_DescribeMonitor_RequestSyntax"></a>

```
{
   "MonitorArn": "string"
}
```

## 요청 파라미터
<a name="API_DescribeMonitor_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [MonitorArn](#API_DescribeMonitor_RequestSyntax) **   <a name="forecast-DescribeMonitor-request-MonitorArn"></a>
설명할 모니터 리소스의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 구문
<a name="API_DescribeMonitor_ResponseSyntax"></a>

```
{
   "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"
}
```

## 응답 요소
<a name="API_DescribeMonitor_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Baseline](#API_DescribeMonitor_ResponseSyntax) **   <a name="forecast-DescribeMonitor-response-Baseline"></a>
비교 기준선으로 사용할 수 있는 지표입니다. 자동 예측기 모니터링 결과를 해석할 때 다음 값을 사용하세요.  
유형: [Baseline](API_Baseline.md)객체

 ** [CreationTime](#API_DescribeMonitor_ResponseSyntax) **   <a name="forecast-DescribeMonitor-response-CreationTime"></a>
모니터 리소스가 생성된 시간의 타임스탬프입니다.  
유형: 타임스탬프

 ** [EstimatedEvaluationTimeRemainingInMinutes](#API_DescribeMonitor_ResponseSyntax) **   <a name="forecast-DescribeMonitor-response-EstimatedEvaluationTimeRemainingInMinutes"></a>
모니터 리소스가 현재 평가를 마칠 때까지 남은 예상 시간(분)입니다.  
타입: Long

 ** [LastEvaluationState](#API_DescribeMonitor_ResponseSyntax) **   <a name="forecast-DescribeMonitor-response-LastEvaluationState"></a>
모니터의 최근 평가 상태입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.

 ** [LastEvaluationTime](#API_DescribeMonitor_ResponseSyntax) **   <a name="forecast-DescribeMonitor-response-LastEvaluationTime"></a>
모니터가 완료한 최근 평가의 타임스탬프입니다.  
유형: 타임스탬프

 ** [LastModificationTime](#API_DescribeMonitor_ResponseSyntax) **   <a name="forecast-DescribeMonitor-response-LastModificationTime"></a>
모니터에 대한 최신 수정의 타임스탬프입니다.  
유형: 타임스탬프

 ** [Message](#API_DescribeMonitor_ResponseSyntax) **   <a name="forecast-DescribeMonitor-response-Message"></a>
모니터에 대한 오류 메시지입니다(있는 경우).  
유형: 문자열

 ** [MonitorArn](#API_DescribeMonitor_ResponseSyntax) **   <a name="forecast-DescribeMonitor-response-MonitorArn"></a>
설명된 모니터 리소스의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [MonitorName](#API_DescribeMonitor_ResponseSyntax) **   <a name="forecast-DescribeMonitor-response-MonitorName"></a>
모니터의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*` 

 ** [ResourceArn](#API_DescribeMonitor_ResponseSyntax) **   <a name="forecast-DescribeMonitor-response-ResourceArn"></a>
모니터링 중인 자동 예측기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [Status](#API_DescribeMonitor_ResponseSyntax) **   <a name="forecast-DescribeMonitor-response-Status"></a>
모니터 리소스의 상태입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.

## 오류
<a name="API_DescribeMonitor_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DescribeMonitor_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeMonitor) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeMonitor) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeMonitor) 

# DescribePredictor
<a name="API_DescribePredictor"></a>

**참고**  
 이 작업은 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` - 오류가 발생한 경우 오류에 대한 정보.

## 구문 요청
<a name="API_DescribePredictor_RequestSyntax"></a>

```
{
   "PredictorArn": "string"
}
```

## 요청 파라미터
<a name="API_DescribePredictor_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [PredictorArn](#API_DescribePredictor_RequestSyntax) **   <a name="forecast-DescribePredictor-request-PredictorArn"></a>
정보를 원하는 예측기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 구문
<a name="API_DescribePredictor_ResponseSyntax"></a>

```
{
   "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" 
   }
}
```

## 응답 요소
<a name="API_DescribePredictor_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [AlgorithmArn](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-AlgorithmArn"></a>
모델 훈련에 사용되는 알고리즘의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [AutoMLAlgorithmArns](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-AutoMLAlgorithmArns"></a>
`PerformAutoML`이 지정된 경우 선택한 알고리즘의 ARN입니다.  
유형: 문자열 배열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [AutoMLOverrideStrategy](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-AutoMLOverrideStrategy"></a>
 `LatencyOptimized` AutoML 재정의 전략은 비공개 베타에서만 사용할 수 있습니다. 액세스 권한에 대한 자세한 내용은 AWS Support 또는 계정 관리자에게 문의하세요.
예측기 훈련에 사용된 AutoML 전략입니다. `LatencyOptimized`가 지정되지 않으면 AutoML 전략이 예측기 정확도를 최적화합니다.  
이 파라미터는 AutoML을 사용하여 훈련된 예측기에만 사용할 수 있습니다.  
타입: 문자열  
유효 값: `LatencyOptimized | AccuracyOptimized` 

 ** [CreationTime](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-CreationTime"></a>
모델 훈련 작업이 생성된 때입니다.  
유형: 타임스탬프

 ** [DatasetImportJobArns](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-DatasetImportJobArns"></a>
예측기의 훈련 데이터를 가져오는 데 사용되는 데이터 세트 가져오기 작업의 ARN 배열입니다.  
유형: 문자열 배열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [EncryptionConfig](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-EncryptionConfig"></a>
 AWS Key Management Service Amazon Forecast가 키에 액세스하기 위해 맡을 수 있는 (KMS) 키 및 AWS Identity and Access Management (IAM) 역할입니다.  
유형: [EncryptionConfig](API_EncryptionConfig.md)객체

 ** [EstimatedTimeRemainingInMinutes](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-EstimatedTimeRemainingInMinutes"></a>
예측기 훈련 작업 완료까지 남은 예상 시간(분)입니다.  
타입: Long

 ** [EvaluationParameters](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-EvaluationParameters"></a>
지정된 알고리즘의 기본 평가 파라미터를 재정의하는 데 사용됩니다. Amazon Forecast는 데이터 세트를 훈련 데이터와 테스팅 데이터로 분할하여 예측기를 평가합니다. 평가 파라미터는 분할을 수행하는 방법과 반복 횟수를 정의합니다.  
유형: [EvaluationParameters](API_EvaluationParameters.md)객체

 ** [FeaturizationConfig](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-FeaturizationConfig"></a>
특성화 구성입니다.  
유형: [FeaturizationConfig](API_FeaturizationConfig.md)객체

 ** [ForecastHorizon](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-ForecastHorizon"></a>
예측의 시간 단계 수입니다. 이 예상 구간은 또한 예측 길이라고도 합니다.  
유형: 정수

 ** [ForecastTypes](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-ForecastTypes"></a>
예측기 훈련 중에 사용되는 예측 유형입니다. 기본값은 `["0.1","0.5","0.9"]`입니다.  
타입: 문자열 배열  
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 20개입니다.  
길이 제약: 최소 길이는 2입니다. 최대 길이는 4입니다.  
패턴: `(^0?\.\d\d?$|^mean$)` 

 ** [HPOConfig](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-HPOConfig"></a>
알고리즘의 하이퍼파라미터 재정의 값입니다.  
유형: [HyperParameterTuningJobConfig](API_HyperParameterTuningJobConfig.md)객체

 ** [InputDataConfig](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-InputDataConfig"></a>
예측기를 훈련하는 데 사용할 데이터가 포함된 데이터 세트 그룹을 설명합니다.  
유형: [InputDataConfig](API_InputDataConfig.md)객체

 ** [IsAutoPredictor](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-IsAutoPredictor"></a>
[CreateAutoPredictor](API_CreateAutoPredictor.md)를 사용하여 예측기를 생성했는지 여부입니다.  
유형: Boolean

 ** [LastModificationTime](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-LastModificationTime"></a>
리소스가 마지막으로 수정된 시간입니다. 타임스탬프는 작업 상태에 따라 달라집니다.  
+  `CREATE_PENDING`: `CreationTime`.
+  `CREATE_IN_PROGRESS` - 현재 타임스탬프.
+  `CREATE_STOPPING` - 현재 타임스탬프.
+  `CREATE_STOPPED` - 작업이 중지된 시점.
+  `ACTIVE` 또는 `CREATE_FAILED` - 작업이 완료되거나 실패한 경우.
유형: 타임스탬프

 ** [Message](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-Message"></a>
오류가 발생한 경우 오류에 대한 정보 메시지.  
유형: 문자열

 ** [OptimizationMetric](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-OptimizationMetric"></a>
예측기를 최적화하는 데 사용되는 정확도 지표입니다.  
타입: 문자열  
유효 값: `WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE` 

 ** [PerformAutoML](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PerformAutoML"></a>
예측기가 AutoML을 수행하도록 설정되었는지 여부입니다.  
유형: Boolean

 ** [PerformHPO](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PerformHPO"></a>
예측기가 하이퍼파라미터 최적화(HPO)를 수행하도록 설정되었는지 여부입니다.  
유형: Boolean

 ** [PredictorArn](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PredictorArn"></a>
예측기의 ARN입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*` 

 ** [PredictorExecutionDetails](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PredictorExecutionDetails"></a>
예측기의 정확도를 평가하기 위해 수행한 백테스트의 상태 및 결과에 대한 세부 정보입니다. [CreatePredictor](API_CreatePredictor.md) 작업을 직접적으로 호출할 때 수행할 백테스트 수를 지정합니다.  
유형: [PredictorExecutionDetails](API_PredictorExecutionDetails.md)객체

 ** [PredictorName](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-PredictorName"></a>
예측기의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*` 

 ** [Status](#API_DescribePredictor_ResponseSyntax) **   <a name="forecast-DescribePredictor-response-Status"></a>
예측기의 상태입니다. 상태는 다음을 포함합니다.  
+  `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) **   <a name="forecast-DescribePredictor-response-TrainingParameters"></a>
모델 훈련 중에 선택한 기본 훈련 파라미터 또는 재정의입니다. AutoML을 실행하거나 CNN-QR 또는 DeepAR\$1를 사용하여 HPO를 선택하면 선택한 하이퍼파라미터에 대해 최적화된 값이 반환됩니다. 자세한 내용은 [Amazon Forecast 알고리즘](aws-forecast-choosing-recipes.md) 단원을 참조하십시오.  
유형: 문자열 간 맵  
맵 항목: 최소 항목 수는 0개입니다. 최대수는 100개입니다.  
키 길이 제약: 최대 길이는 256입니다.  
키 패턴: `^[a-zA-Z0-9\-\_\.\/\[\]\,\\]+$`   
값 길이 제약: 최대 길이는 256입니다.  
값 패턴: `^[a-zA-Z0-9\-\_\.\/\[\]\,\"\\\s]+$` 

## 오류
<a name="API_DescribePredictor_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DescribePredictor_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribePredictor) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribePredictor) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribePredictor) 

# DescribePredictorBacktestExportJob
<a name="API_DescribePredictorBacktestExportJob"></a>

[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`(오류가 발생한 경우)

## 구문 요청
<a name="API_DescribePredictorBacktestExportJob_RequestSyntax"></a>

```
{
   "PredictorBacktestExportJobArn": "string"
}
```

## 요청 파라미터
<a name="API_DescribePredictorBacktestExportJob_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [PredictorBacktestExportJobArn](#API_DescribePredictorBacktestExportJob_RequestSyntax) **   <a name="forecast-DescribePredictorBacktestExportJob-request-PredictorBacktestExportJobArn"></a>
예측기 백테스트 내보내기 작업의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 구문
<a name="API_DescribePredictorBacktestExportJob_ResponseSyntax"></a>

```
{
   "CreationTime": number,
   "Destination": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "Format": "string",
   "LastModificationTime": number,
   "Message": "string",
   "PredictorArn": "string",
   "PredictorBacktestExportJobArn": "string",
   "PredictorBacktestExportJobName": "string",
   "Status": "string"
}
```

## 응답 요소
<a name="API_DescribePredictorBacktestExportJob_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationTime](#API_DescribePredictorBacktestExportJob_ResponseSyntax) **   <a name="forecast-DescribePredictorBacktestExportJob-response-CreationTime"></a>
예측기 백테스트 내보내기 작업이 생성된 시간입니다.  
유형: 타임스탬프

 ** [Destination](#API_DescribePredictorBacktestExportJob_ResponseSyntax) **   <a name="forecast-DescribePredictorBacktestExportJob-response-Destination"></a>
내보내기 작업의 대상입니다. S3 경로, Amazon Forecast가 위치에 액세스할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할 및 AWS Key Management Service (KMS) 키(선택 사항)를 제공합니다.  
유형: [DataDestination](API_DataDestination.md)객체

 ** [Format](#API_DescribePredictorBacktestExportJob_ResponseSyntax) **   <a name="forecast-DescribePredictorBacktestExportJob-response-Format"></a>
내보내는 데이터의 형식, CSV 또는 PARQUET.  
유형: 문자열  
길이 제약 조건: 최대 길이는 7입니다.  
패턴: `^CSV|PARQUET$` 

 ** [LastModificationTime](#API_DescribePredictorBacktestExportJob_ResponseSyntax) **   <a name="forecast-DescribePredictorBacktestExportJob-response-LastModificationTime"></a>
리소스가 마지막으로 수정된 시간입니다. 타임스탬프는 작업 상태에 따라 달라집니다.  
+  `CREATE_PENDING`: `CreationTime`.
+  `CREATE_IN_PROGRESS` - 현재 타임스탬프.
+  `CREATE_STOPPING` - 현재 타임스탬프.
+  `CREATE_STOPPED` - 작업이 중지된 시점.
+  `ACTIVE` 또는 `CREATE_FAILED` - 작업이 완료되거나 실패한 경우.
유형: 타임스탬프

 ** [Message](#API_DescribePredictorBacktestExportJob_ResponseSyntax) **   <a name="forecast-DescribePredictorBacktestExportJob-response-Message"></a>
백테스트 내보내기 중에 발생했을 수 있는 모든 오류에 대한 정보.  
유형: 문자열

 ** [PredictorArn](#API_DescribePredictorBacktestExportJob_ResponseSyntax) **   <a name="forecast-DescribePredictorBacktestExportJob-response-PredictorArn"></a>
예측기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [PredictorBacktestExportJobArn](#API_DescribePredictorBacktestExportJob_ResponseSyntax) **   <a name="forecast-DescribePredictorBacktestExportJob-response-PredictorBacktestExportJobArn"></a>
예측기 백테스트 내보내기 작업의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [PredictorBacktestExportJobName](#API_DescribePredictorBacktestExportJob_ResponseSyntax) **   <a name="forecast-DescribePredictorBacktestExportJob-response-PredictorBacktestExportJobName"></a>
예측기 백테스트 내보내기 작업의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*` 

 ** [Status](#API_DescribePredictorBacktestExportJob_ResponseSyntax) **   <a name="forecast-DescribePredictorBacktestExportJob-response-Status"></a>
예측기 백테스트 내보내기 작업의 상태입니다. 상태는 다음을 포함합니다.  
+  `ACTIVE` 
+  `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` 
+  `CREATE_STOPPING`, `CREATE_STOPPED` 
+  `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 
유형: 문자열  
길이 제약: 최대 길이 256.

## 오류
<a name="API_DescribePredictorBacktestExportJob_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DescribePredictorBacktestExportJob_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribePredictorBacktestExportJob) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribePredictorBacktestExportJob) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribePredictorBacktestExportJob) 

# DescribeWhatIfAnalysis
<a name="API_DescribeWhatIfAnalysis"></a>

[CreateWhatIfAnalysis](API_CreateWhatIfAnalysis.md) 작업을 사용하여 생성한 what-if 분석을 설명합니다.

**중요**  
신규 고객은 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` 

## 구문 요청
<a name="API_DescribeWhatIfAnalysis_RequestSyntax"></a>

```
{
   "WhatIfAnalysisArn": "string"
}
```

## 요청 파라미터
<a name="API_DescribeWhatIfAnalysis_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [WhatIfAnalysisArn](#API_DescribeWhatIfAnalysis_RequestSyntax) **   <a name="forecast-DescribeWhatIfAnalysis-request-WhatIfAnalysisArn"></a>
관심 있는 what-if 분석의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 구문
<a name="API_DescribeWhatIfAnalysis_ResponseSyntax"></a>

```
{
   "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"
}
```

## 응답 요소
<a name="API_DescribeWhatIfAnalysis_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationTime](#API_DescribeWhatIfAnalysis_ResponseSyntax) **   <a name="forecast-DescribeWhatIfAnalysis-response-CreationTime"></a>
what-if 분석이 생성된 시점.  
유형: 타임스탬프

 ** [EstimatedTimeRemainingInMinutes](#API_DescribeWhatIfAnalysis_ResponseSyntax) **   <a name="forecast-DescribeWhatIfAnalysis-response-EstimatedTimeRemainingInMinutes"></a>
what-if 분석 완료까지 남은 대략적인 시간(분).  
타입: Long

 ** [ForecastArn](#API_DescribeWhatIfAnalysis_ResponseSyntax) **   <a name="forecast-DescribeWhatIfAnalysis-response-ForecastArn"></a>
what-if 예측의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [LastModificationTime](#API_DescribeWhatIfAnalysis_ResponseSyntax) **   <a name="forecast-DescribeWhatIfAnalysis-response-LastModificationTime"></a>
리소스가 마지막으로 수정된 시간입니다. 타임스탬프는 작업 상태에 따라 달라집니다.  
+  `CREATE_PENDING`: `CreationTime`.
+  `CREATE_IN_PROGRESS` - 현재 타임스탬프.
+  `CREATE_STOPPING` - 현재 타임스탬프.
+  `CREATE_STOPPED` - 작업이 중지된 시점.
+  `ACTIVE` 또는 `CREATE_FAILED` - 작업이 완료되거나 실패한 경우.
유형: 타임스탬프

 ** [Message](#API_DescribeWhatIfAnalysis_ResponseSyntax) **   <a name="forecast-DescribeWhatIfAnalysis-response-Message"></a>
오류가 발생한 경우 오류에 대한 정보 메시지.  
유형: 문자열

 ** [Status](#API_DescribeWhatIfAnalysis_ResponseSyntax) **   <a name="forecast-DescribeWhatIfAnalysis-response-Status"></a>
what-if 분석의 상태입니다. 상태는 다음을 포함합니다.  
+  `ACTIVE` 
+  `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` 
+  `CREATE_STOPPING`, `CREATE_STOPPED` 
+  `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 
what-if 분석에 액세스하려면 what-if 분석의 `Status`가 `ACTIVE`여야 합니다.
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `^[a-zA-Z0-9\_]+$` 

 ** [TimeSeriesSelector](#API_DescribeWhatIfAnalysis_ResponseSyntax) **   <a name="forecast-DescribeWhatIfAnalysis-response-TimeSeriesSelector"></a>
`TimeSeriesIdentifiers` 객체에서 예측을 생성하는 데 사용되는 시계열 세트를 정의합니다.  
`TimeSeriesIdentifiers` 객체에는 다음과 같은 정보가 있어야 합니다.  
+  `DataSource` 
+  `Format` 
+  `Schema` 
유형: [TimeSeriesSelector](API_TimeSeriesSelector.md)객체

 ** [WhatIfAnalysisArn](#API_DescribeWhatIfAnalysis_ResponseSyntax) **   <a name="forecast-DescribeWhatIfAnalysis-response-WhatIfAnalysisArn"></a>
what-if 분석의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [WhatIfAnalysisName](#API_DescribeWhatIfAnalysis_ResponseSyntax) **   <a name="forecast-DescribeWhatIfAnalysis-response-WhatIfAnalysisName"></a>
what-if 분석의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*` 

## 오류
<a name="API_DescribeWhatIfAnalysis_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DescribeWhatIfAnalysis_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeWhatIfAnalysis) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeWhatIfAnalysis) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeWhatIfAnalysis) 

# DescribeWhatIfForecast
<a name="API_DescribeWhatIfForecast"></a>

[CreateWhatIfForecast](API_CreateWhatIfForecast.md) 작업을 사용하여 생성한 what-if 예측을 설명합니다.

**중요**  
신규 고객은 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` 

## 구문 요청
<a name="API_DescribeWhatIfForecast_RequestSyntax"></a>

```
{
   "WhatIfForecastArn": "string"
}
```

## 요청 파라미터
<a name="API_DescribeWhatIfForecast_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [WhatIfForecastArn](#API_DescribeWhatIfForecast_RequestSyntax) **   <a name="forecast-DescribeWhatIfForecast-request-WhatIfForecastArn"></a>
관심 있는 what-if 예측의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약 조건: 최대 길이는 300입니다.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 구문
<a name="API_DescribeWhatIfForecast_ResponseSyntax"></a>

```
{
   "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"
}
```

## 응답 요소
<a name="API_DescribeWhatIfForecast_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationTime](#API_DescribeWhatIfForecast_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecast-response-CreationTime"></a>
what-if 예측이 생성된 시점.  
유형: 타임스탬프

 ** [EstimatedTimeRemainingInMinutes](#API_DescribeWhatIfForecast_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecast-response-EstimatedTimeRemainingInMinutes"></a>
what-if 예측 완료까지 남은 대략적인 시간(분).  
타입: Long

 ** [ForecastTypes](#API_DescribeWhatIfForecast_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecast-response-ForecastTypes"></a>
확률적 예측이 생성되는 분위수입니다. [CreateWhatIfForecast](API_CreateWhatIfForecast.md) 작업에서 what-if 예측당 최대 5개의 분위수를 지정할 수 있습니다. 분위수를 지정하지 않은 경우 기본값은 `["0.1", "0.5", "0.9"]`입니다.  
타입: 문자열 배열  
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 20개입니다.  
길이 제약: 최소 길이는 2입니다. 최대 길이는 4입니다.  
패턴: `(^0?\.\d\d?$|^mean$)` 

 ** [LastModificationTime](#API_DescribeWhatIfForecast_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecast-response-LastModificationTime"></a>
리소스가 마지막으로 수정된 시간입니다. 타임스탬프는 작업 상태에 따라 달라집니다.  
+  `CREATE_PENDING`: `CreationTime`.
+  `CREATE_IN_PROGRESS` - 현재 타임스탬프.
+  `CREATE_STOPPING` - 현재 타임스탬프.
+  `CREATE_STOPPED` - 작업이 중지된 시점.
+  `ACTIVE` 또는 `CREATE_FAILED` - 작업이 완료되거나 실패한 경우.
유형: 타임스탬프

 ** [Message](#API_DescribeWhatIfForecast_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecast-response-Message"></a>
오류가 발생한 경우 오류에 대한 정보 메시지.  
유형: 문자열

 ** [Status](#API_DescribeWhatIfForecast_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecast-response-Status"></a>
what-if 예측의 상태입니다. 상태는 다음을 포함합니다.  
+  `ACTIVE` 
+  `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` 
+  `CREATE_STOPPING`, `CREATE_STOPPED` 
+  `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 
what-if 예측에 액세스하려면 what-if 예측의 `Status`가 `ACTIVE`여야 합니다.
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `^[a-zA-Z0-9\_]+$` 

 ** [TimeSeriesReplacementsDataSource](#API_DescribeWhatIfForecast_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecast-response-TimeSeriesReplacementsDataSource"></a>
대체 시계열을 설명하는 `S3Config`, `Schema`, `Format` 요소의 배열입니다.  
유형: [TimeSeriesReplacementsDataSource](API_TimeSeriesReplacementsDataSource.md)객체

 ** [TimeSeriesTransformations](#API_DescribeWhatIfForecast_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecast-response-TimeSeriesTransformations"></a>
각 시계열에 어떤 변환이 적용되었는지 설명하는 `Action` 및 `TimeSeriesConditions` 요소로 구성된 배열입니다.  
타입: [TimeSeriesTransformation](API_TimeSeriesTransformation.md)객체 배열  
배열 구성원: 최소수는 0개입니다. 최대 항목 수는 30개입니다.

 ** [WhatIfAnalysisArn](#API_DescribeWhatIfForecast_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecast-response-WhatIfAnalysisArn"></a>
이 예측이 포함된 what-if 분석의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [WhatIfForecastArn](#API_DescribeWhatIfForecast_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecast-response-WhatIfForecastArn"></a>
what-if 예측의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약 조건: 최대 길이는 300입니다.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [WhatIfForecastName](#API_DescribeWhatIfForecast_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecast-response-WhatIfForecastName"></a>
what-if 예측의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*` 

## 오류
<a name="API_DescribeWhatIfForecast_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DescribeWhatIfForecast_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeWhatIfForecast) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeWhatIfForecast) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeWhatIfForecast) 

# DescribeWhatIfForecastExport
<a name="API_DescribeWhatIfForecastExport"></a>

[CreateWhatIfForecastExport](API_CreateWhatIfForecastExport.md) 작업을 사용하여 생성한 what-if 예측 내보내기를 설명합니다.

**중요**  
신규 고객은 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` 

## 구문 요청
<a name="API_DescribeWhatIfForecastExport_RequestSyntax"></a>

```
{
   "WhatIfForecastExportArn": "string"
}
```

## 요청 파라미터
<a name="API_DescribeWhatIfForecastExport_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [WhatIfForecastExportArn](#API_DescribeWhatIfForecastExport_RequestSyntax) **   <a name="forecast-DescribeWhatIfForecastExport-request-WhatIfForecastExportArn"></a>
관심 있는 what-if 예측 내보내기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약 조건: 최대 길이는 300입니다.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 구문
<a name="API_DescribeWhatIfForecastExport_ResponseSyntax"></a>

```
{
   "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"
}
```

## 응답 요소
<a name="API_DescribeWhatIfForecastExport_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationTime](#API_DescribeWhatIfForecastExport_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecastExport-response-CreationTime"></a>
what-if 예측 내보내기가 생성된 시점.  
유형: 타임스탬프

 ** [Destination](#API_DescribeWhatIfForecastExport_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecastExport-response-Destination"></a>
내보내기 작업의 대상입니다. S3 경로, Amazon Forecast가 위치에 액세스할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할 및 AWS Key Management Service (KMS) 키(선택 사항)를 제공합니다.  
유형: [DataDestination](API_DataDestination.md)객체

 ** [EstimatedTimeRemainingInMinutes](#API_DescribeWhatIfForecastExport_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecastExport-response-EstimatedTimeRemainingInMinutes"></a>
what-if 예측 내보내기 완료까지 남은 대략적인 시간(분).  
타입: Long

 ** [Format](#API_DescribeWhatIfForecastExport_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecastExport-response-Format"></a>
내보내는 데이터의 형식, CSV 또는 PARQUET.  
유형: 문자열  
길이 제약 조건: 최대 길이는 7입니다.  
패턴: `^CSV|PARQUET$` 

 ** [LastModificationTime](#API_DescribeWhatIfForecastExport_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecastExport-response-LastModificationTime"></a>
리소스가 마지막으로 수정된 시간입니다. 타임스탬프는 작업 상태에 따라 달라집니다.  
+  `CREATE_PENDING`: `CreationTime`.
+  `CREATE_IN_PROGRESS` - 현재 타임스탬프.
+  `CREATE_STOPPING` - 현재 타임스탬프.
+  `CREATE_STOPPED` - 작업이 중지된 시점.
+  `ACTIVE` 또는 `CREATE_FAILED` - 작업이 완료되거나 실패한 경우.
유형: 타임스탬프

 ** [Message](#API_DescribeWhatIfForecastExport_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecastExport-response-Message"></a>
오류가 발생한 경우 오류에 대한 정보 메시지.  
유형: 문자열

 ** [Status](#API_DescribeWhatIfForecastExport_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecastExport-response-Status"></a>
what-if 예측의 상태입니다. 상태는 다음을 포함합니다.  
+  `ACTIVE` 
+  `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` 
+  `CREATE_STOPPING`, `CREATE_STOPPED` 
+  `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 
what-if 예측 내보내기에 액세스하려면 what-if 예측 내보내기의 `Status`가 `ACTIVE`여야 합니다.
유형: 문자열  
길이 제약: 최대 길이 256.

 ** [WhatIfForecastArns](#API_DescribeWhatIfForecastExport_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecastExport-response-WhatIfForecastArns"></a>
이 리소스에서 내보내는 모든 what-if 예측을 나타내는 Amazon 리소스 이름(ARN)의 배열입니다.  
유형: 문자열 배열  
길이 제약 조건: 최대 길이는 300입니다.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [WhatIfForecastExportArn](#API_DescribeWhatIfForecastExport_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecastExport-response-WhatIfForecastExportArn"></a>
what-if 예측 내보내기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약 조건: 최대 길이는 300입니다.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [WhatIfForecastExportName](#API_DescribeWhatIfForecastExport_ResponseSyntax) **   <a name="forecast-DescribeWhatIfForecastExport-response-WhatIfForecastExportName"></a>
what-if 예측 내보내기의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*` 

## 오류
<a name="API_DescribeWhatIfForecastExport_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_DescribeWhatIfForecastExport_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeWhatIfForecastExport) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeWhatIfForecastExport) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeWhatIfForecastExport) 

# GetAccuracyMetrics
<a name="API_GetAccuracyMetrics"></a>

[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) 작업을 사용합니다.

## 구문 요청
<a name="API_GetAccuracyMetrics_RequestSyntax"></a>

```
{
   "PredictorArn": "string"
}
```

## 요청 파라미터
<a name="API_GetAccuracyMetrics_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [PredictorArn](#API_GetAccuracyMetrics_RequestSyntax) **   <a name="forecast-GetAccuracyMetrics-request-PredictorArn"></a>
지표를 가져올 예측기의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 구문
<a name="API_GetAccuracyMetrics_ResponseSyntax"></a>

```
{
   "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
            }
         ]
      }
   ]
}
```

## 응답 요소
<a name="API_GetAccuracyMetrics_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [AutoMLOverrideStrategy](#API_GetAccuracyMetrics_ResponseSyntax) **   <a name="forecast-GetAccuracyMetrics-response-AutoMLOverrideStrategy"></a>
 `LatencyOptimized` AutoML 재정의 전략은 비공개 베타에서만 사용할 수 있습니다. 액세스 권한에 대한 자세한 내용은 AWS Support 또는 계정 관리자에게 문의하세요.
예측기 훈련에 사용된 AutoML 전략입니다. `LatencyOptimized`가 지정되지 않으면 AutoML 전략이 예측기 정확도를 최적화합니다.  
이 파라미터는 AutoML을 사용하여 훈련된 예측기에만 사용할 수 있습니다.  
타입: 문자열  
유효 값: `LatencyOptimized | AccuracyOptimized` 

 ** [IsAutoPredictor](#API_GetAccuracyMetrics_ResponseSyntax) **   <a name="forecast-GetAccuracyMetrics-response-IsAutoPredictor"></a>
[CreateAutoPredictor](API_CreateAutoPredictor.md)를 사용하여 예측기를 생성했는지 여부입니다.  
유형: Boolean

 ** [OptimizationMetric](#API_GetAccuracyMetrics_ResponseSyntax) **   <a name="forecast-GetAccuracyMetrics-response-OptimizationMetric"></a>
예측기를 최적화하는 데 사용되는 정확도 지표입니다.  
타입: 문자열  
유효 값: `WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE` 

 ** [PredictorEvaluationResults](#API_GetAccuracyMetrics_ResponseSyntax) **   <a name="forecast-GetAccuracyMetrics-response-PredictorEvaluationResults"></a>
예측기 평가 결과의 배열입니다.  
타입: [EvaluationResult](API_EvaluationResult.md) 객체 배열

## 오류
<a name="API_GetAccuracyMetrics_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_GetAccuracyMetrics_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/GetAccuracyMetrics) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/GetAccuracyMetrics) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/GetAccuracyMetrics) 

# ListDatasetGroups
<a name="API_ListDatasetGroups"></a>

[CreateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetGroup.html) 작업을 사용하여 생성한 데이터 세트 그룹 목록을 반환합니다. 이 작업은 각 데이터 세트 그룹마다 Amazon 리소스 이름(ARN)을 포함하여 데이터 세트 그룹의 속성 요약을 반환합니다. [DescribeDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDatasetGroup.html) 작업과 함께 데이터 세트 그룹 ARN을 사용하여 전체 속성 세트를 검색할 수 있습니다.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

## 구문 요청
<a name="API_ListDatasetGroups_RequestSyntax"></a>

```
{
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_ListDatasetGroups_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [MaxResults](#API_ListDatasetGroups_RequestSyntax) **   <a name="forecast-ListDatasetGroups-request-MaxResults"></a>
응답에서 반환할 총 항목 수입니다.  
타입: 정수  
유효 범위: 최소값 1. 최댓값은 100입니다.  
필수 여부: 아니요

 ** [NextToken](#API_ListDatasetGroups_RequestSyntax) **   <a name="forecast-ListDatasetGroups-request-NextToken"></a>
이전 요청의 결과가 잘린 경우 응답에는 `NextToken`이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+`   
필수 여부: 아니요

## 응답 구문
<a name="API_ListDatasetGroups_ResponseSyntax"></a>

```
{
   "DatasetGroups": [ 
      { 
         "CreationTime": number,
         "DatasetGroupArn": "string",
         "DatasetGroupName": "string",
         "LastModificationTime": number
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_ListDatasetGroups_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [DatasetGroups](#API_ListDatasetGroups_ResponseSyntax) **   <a name="forecast-ListDatasetGroups-response-DatasetGroups"></a>
각 데이터 세트 그룹의 속성을 요약하는 객체의 배열입니다.  
타입: [DatasetGroupSummary](API_DatasetGroupSummary.md)객체 배열

 ** [NextToken](#API_ListDatasetGroups_ResponseSyntax) **   <a name="forecast-ListDatasetGroups-response-NextToken"></a>
응답이 잘린 경우 Amazon Forecast는 이 토큰을 반환합니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+` 

## 오류
<a name="API_ListDatasetGroups_Errors"></a>

 ** InvalidNextTokenException **   
토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_ListDatasetGroups_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListDatasetGroups) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListDatasetGroups) 

# ListDatasetImportJobs
<a name="API_ListDatasetImportJobs"></a>

[CreateDatasetImportJob](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetImportJob.html) 작업을 사용하여 생성한 데이터 세트 가져오기 작업 목록을 반환합니다. 이 작업은 각 내보내기 작업마다 Amazon 리소스 이름(ARN)을 포함하여 내보내기 작업의 속성 요약을 반환합니다. [DescribeDatasetImportJob](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDatasetImportJob.html) 작업과 함께 ARN을 사용하여 전체 속성 세트를 검색할 수 있습니다. [필터](https://docs.aws.amazon.com/forecast/latest/dg/API_Filter.html) 객체 배열을 제공하여 목록을 필터링할 수 있습니다.

## 구문 요청
<a name="API_ListDatasetImportJobs_RequestSyntax"></a>

```
{
   "Filters": [ 
      { 
         "Condition": "string",
         "Key": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_ListDatasetImportJobs_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Filters](#API_ListDatasetImportJobs_RequestSyntax) **   <a name="forecast-ListDatasetImportJobs-request-Filters"></a>
필터 배열입니다. 각 필터마다 조건과 일치 문을 제공합니다. 조건은 명령문과 일치하는 데이터 세트를 목록에 포함할지 제외할지 여부를 각각 지정하는 `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) **   <a name="forecast-ListDatasetImportJobs-request-MaxResults"></a>
응답에서 반환할 총 항목 수입니다.  
타입: 정수  
유효 범위: 최소값 1. 최댓값은 100입니다.  
필수 여부: 아니요

 ** [NextToken](#API_ListDatasetImportJobs_RequestSyntax) **   <a name="forecast-ListDatasetImportJobs-request-NextToken"></a>
이전 요청의 결과가 잘린 경우 응답에는 `NextToken`이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+`   
필수 여부: 아니요

## 응답 구문
<a name="API_ListDatasetImportJobs_ResponseSyntax"></a>

```
{
   "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"
}
```

## 응답 요소
<a name="API_ListDatasetImportJobs_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [DatasetImportJobs](#API_ListDatasetImportJobs_ResponseSyntax) **   <a name="forecast-ListDatasetImportJobs-response-DatasetImportJobs"></a>
각 데이터 세트 가져오기 작업의 속성을 요약하는 객체의 배열입니다.  
타입: [DatasetImportJobSummary](API_DatasetImportJobSummary.md)객체 배열

 ** [NextToken](#API_ListDatasetImportJobs_ResponseSyntax) **   <a name="forecast-ListDatasetImportJobs-response-NextToken"></a>
응답이 잘린 경우 Amazon Forecast는 이 토큰을 반환합니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+` 

## 오류
<a name="API_ListDatasetImportJobs_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** InvalidNextTokenException **   
토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_ListDatasetImportJobs_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListDatasetImportJobs) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListDatasetImportJobs) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListDatasetImportJobs) 

# ListDatasets
<a name="API_ListDatasets"></a>

[CreateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDataset.html) 작업을 사용하여 생성한 데이터 세트 목록을 반환합니다. 각 데이터 세트마다 Amazon 리소스 이름(ARN)을 포함하여 데이터 세트의 속성 요약이 반환됩니다. 전체 속성 세트를 검색하려면 [DescribeDatasetImportJob](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDataset.html) 작업과 함께 ARN을 사용하세요.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

## 구문 요청
<a name="API_ListDatasets_RequestSyntax"></a>

```
{
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_ListDatasets_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [MaxResults](#API_ListDatasets_RequestSyntax) **   <a name="forecast-ListDatasets-request-MaxResults"></a>
응답에서 반환할 총 항목 수입니다.  
타입: 정수  
유효 범위: 최소값 1. 최댓값은 100입니다.  
필수 여부: 아니요

 ** [NextToken](#API_ListDatasets_RequestSyntax) **   <a name="forecast-ListDatasets-request-NextToken"></a>
이전 요청의 결과가 잘린 경우 응답에는 `NextToken`이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+`   
필수 여부: 아니요

## 응답 구문
<a name="API_ListDatasets_ResponseSyntax"></a>

```
{
   "Datasets": [ 
      { 
         "CreationTime": number,
         "DatasetArn": "string",
         "DatasetName": "string",
         "DatasetType": "string",
         "Domain": "string",
         "LastModificationTime": number
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_ListDatasets_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Datasets](#API_ListDatasets_ResponseSyntax) **   <a name="forecast-ListDatasets-response-Datasets"></a>
각 데이터 세트의 속성을 요약하는 객체의 배열입니다.  
타입: [DatasetSummary](API_DatasetSummary.md)객체 배열

 ** [NextToken](#API_ListDatasets_ResponseSyntax) **   <a name="forecast-ListDatasets-response-NextToken"></a>
응답이 잘린 경우 Amazon Forecast는 이 토큰을 반환합니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+` 

## 오류
<a name="API_ListDatasets_Errors"></a>

 ** InvalidNextTokenException **   
토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_ListDatasets_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListDatasets) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListDatasets) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListDatasets) 

# ListExplainabilities
<a name="API_ListExplainabilities"></a>

[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/) 

특정 설명 가능성 리소스의 전체 속성 세트를 검색하려면 [DescribeExplainability](API_DescribeExplainability.md) 작업과 함께 ARN을 사용하세요.

## 구문 요청
<a name="API_ListExplainabilities_RequestSyntax"></a>

```
{
   "Filters": [ 
      { 
         "Condition": "string",
         "Key": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_ListExplainabilities_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Filters](#API_ListExplainabilities_RequestSyntax) **   <a name="forecast-ListExplainabilities-request-Filters"></a>
필터 배열입니다. 각 필터마다 조건과 일치 문을 제공합니다. 조건은 문과 일치하는 리소스를 목록에 포함할지 제외할지 여부를 각각 지정하는 `IS` 또는 `IS_NOT`입니다. 일치 문은 키와 값으로 구성됩니다.  
 **필터 속성**   
+  `Condition` - 적용할 조건입니다. 유효 값은 `IS` 및 `IS_NOT`입니다.
+  `Key` - 필터링할 파라미터의 이름입니다. 유효 값은 `ResourceArn` 및 `Status`입니다.
+  `Value` - 일치시킬 값입니다.
타입: [Filter](API_Filter.md)객체 배열  
필수: 아니요

 ** [MaxResults](#API_ListExplainabilities_RequestSyntax) **   <a name="forecast-ListExplainabilities-request-MaxResults"></a>
응답에서 반환되는 항목 수입니다.  
타입: 정수  
유효 범위: 최소값 1. 최댓값은 100입니다.  
필수 여부: 아니요

 ** [NextToken](#API_ListExplainabilities_RequestSyntax) **   <a name="forecast-ListExplainabilities-request-NextToken"></a>
이전 요청의 결과가 잘린 경우 응답에는 NextToken이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+`   
필수 여부: 아니요

## 응답 구문
<a name="API_ListExplainabilities_ResponseSyntax"></a>

```
{
   "Explainabilities": [ 
      { 
         "CreationTime": number,
         "ExplainabilityArn": "string",
         "ExplainabilityConfig": { 
            "TimePointGranularity": "string",
            "TimeSeriesGranularity": "string"
         },
         "ExplainabilityName": "string",
         "LastModificationTime": number,
         "Message": "string",
         "ResourceArn": "string",
         "Status": "string"
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_ListExplainabilities_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Explainabilities](#API_ListExplainabilities_ResponseSyntax) **   <a name="forecast-ListExplainabilities-response-Explainabilities"></a>
각 설명 가능성 리소스의 속성을 요약하는 객체의 배열입니다.  
타입: [ExplainabilitySummary](API_ExplainabilitySummary.md)객체 배열

 ** [NextToken](#API_ListExplainabilities_ResponseSyntax) **   <a name="forecast-ListExplainabilities-response-NextToken"></a>
응답이 잘린 경우 이 토큰을 반환합니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+` 

## 오류
<a name="API_ListExplainabilities_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** InvalidNextTokenException **   
토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_ListExplainabilities_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListExplainabilities) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListExplainabilities) 

# ListExplainabilityExports
<a name="API_ListExplainabilityExports"></a>

[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/) 

특정 설명 가능성 내보내기의 전체 속성 세트를 검색하려면 [DescribeExplainability](API_DescribeExplainability.md) 작업과 함께 ARN을 사용하세요.

## 구문 요청
<a name="API_ListExplainabilityExports_RequestSyntax"></a>

```
{
   "Filters": [ 
      { 
         "Condition": "string",
         "Key": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_ListExplainabilityExports_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Filters](#API_ListExplainabilityExports_RequestSyntax) **   <a name="forecast-ListExplainabilityExports-request-Filters"></a>
필터 배열입니다. 각 필터마다 조건과 일치 문을 제공합니다. 조건은 문과 일치하는 리소스를 목록에 포함할지 제외할지 여부를 각각 지정하는 `IS` 또는 `IS_NOT`입니다. 일치 문은 키와 값으로 구성됩니다.  
 **필터 속성**   
+  `Condition` - 적용할 조건입니다. 유효 값은 `IS` 및 `IS_NOT`입니다.
+  `Key` - 필터링할 파라미터의 이름입니다. 유효 값은 `ResourceArn` 및 `Status`입니다.
+  `Value` - 일치시킬 값입니다.
타입: [Filter](API_Filter.md)객체 배열  
필수: 아니요

 ** [MaxResults](#API_ListExplainabilityExports_RequestSyntax) **   <a name="forecast-ListExplainabilityExports-request-MaxResults"></a>
응답에서 반환할 총 항목 수입니다.  
타입: 정수  
유효 범위: 최소값 1. 최댓값은 100입니다.  
필수 여부: 아니요

 ** [NextToken](#API_ListExplainabilityExports_RequestSyntax) **   <a name="forecast-ListExplainabilityExports-request-NextToken"></a>
이전 요청의 결과가 잘린 경우 응답에는 NextToken이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+`   
필수 여부: 아니요

## 응답 구문
<a name="API_ListExplainabilityExports_ResponseSyntax"></a>

```
{
   "ExplainabilityExports": [ 
      { 
         "CreationTime": number,
         "Destination": { 
            "S3Config": { 
               "KMSKeyArn": "string",
               "Path": "string",
               "RoleArn": "string"
            }
         },
         "ExplainabilityExportArn": "string",
         "ExplainabilityExportName": "string",
         "LastModificationTime": number,
         "Message": "string",
         "Status": "string"
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_ListExplainabilityExports_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [ExplainabilityExports](#API_ListExplainabilityExports_ResponseSyntax) **   <a name="forecast-ListExplainabilityExports-response-ExplainabilityExports"></a>
각 설명 가능성 내보내기의 속성을 요약하는 객체의 배열입니다.  
타입: [ExplainabilityExportSummary](API_ExplainabilityExportSummary.md)객체 배열

 ** [NextToken](#API_ListExplainabilityExports_ResponseSyntax) **   <a name="forecast-ListExplainabilityExports-response-NextToken"></a>
응답이 잘린 경우 이 토큰을 반환합니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+` 

## 오류
<a name="API_ListExplainabilityExports_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** InvalidNextTokenException **   
토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_ListExplainabilityExports_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListExplainabilityExports) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListExplainabilityExports) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListExplainabilityExports) 

# ListForecastExportJobs
<a name="API_ListForecastExportJobs"></a>

[CreateForecastExportJob](API_CreateForecastExportJob.md) 작업을 사용하여 생성한 설명 가능성 내보내기 작업 목록을 반환합니다. 이 작업은 각 예측 내보내기 작업마다 Amazon 리소스 이름(ARN)을 포함하여 예측 내보내기 작업의 속성 요약을 반환합니다. 전체 속성 세트를 검색하려면 [DescribeForecastExportJob](API_DescribeForecastExportJob.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/) 

## 구문 요청
<a name="API_ListForecastExportJobs_RequestSyntax"></a>

```
{
   "Filters": [ 
      { 
         "Condition": "string",
         "Key": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_ListForecastExportJobs_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Filters](#API_ListForecastExportJobs_RequestSyntax) **   <a name="forecast-ListForecastExportJobs-request-Filters"></a>
필터 배열입니다. 각 필터마다 조건과 일치 문을 제공합니다. 조건은 명령문과 일치하는 예측 내보내기 작업을 목록에 포함할지 제외할지 여부를 각각 지정하는 `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:<acct-id>:forecast/electricityforecast" } ]`   
타입: [Filter](API_Filter.md)객체 배열  
필수: 아니요

 ** [MaxResults](#API_ListForecastExportJobs_RequestSyntax) **   <a name="forecast-ListForecastExportJobs-request-MaxResults"></a>
응답에서 반환할 총 항목 수입니다.  
타입: 정수  
유효 범위: 최소값 1. 최댓값은 100입니다.  
필수 여부: 아니요

 ** [NextToken](#API_ListForecastExportJobs_RequestSyntax) **   <a name="forecast-ListForecastExportJobs-request-NextToken"></a>
이전 요청의 결과가 잘린 경우 응답에는 `NextToken`이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+`   
필수 여부: 아니요

## 응답 구문
<a name="API_ListForecastExportJobs_ResponseSyntax"></a>

```
{
   "ForecastExportJobs": [ 
      { 
         "CreationTime": number,
         "Destination": { 
            "S3Config": { 
               "KMSKeyArn": "string",
               "Path": "string",
               "RoleArn": "string"
            }
         },
         "ForecastExportJobArn": "string",
         "ForecastExportJobName": "string",
         "LastModificationTime": number,
         "Message": "string",
         "Status": "string"
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_ListForecastExportJobs_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [ForecastExportJobs](#API_ListForecastExportJobs_ResponseSyntax) **   <a name="forecast-ListForecastExportJobs-response-ForecastExportJobs"></a>
각 내보내기 작업의 속성을 요약하는 객체의 배열입니다.  
타입: [ForecastExportJobSummary](API_ForecastExportJobSummary.md)객체 배열

 ** [NextToken](#API_ListForecastExportJobs_ResponseSyntax) **   <a name="forecast-ListForecastExportJobs-response-NextToken"></a>
응답이 잘린 경우 Amazon Forecast는 이 토큰을 반환합니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+` 

## 오류
<a name="API_ListForecastExportJobs_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** InvalidNextTokenException **   
토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_ListForecastExportJobs_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListForecastExportJobs) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListForecastExportJobs) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListForecastExportJobs) 

# ListForecasts
<a name="API_ListForecasts"></a>

[CreateForecast](API_CreateForecast.md) 작업을 사용하여 생성한 예측의 목록을 반환합니다. 이 작업은 각 예측마다 Amazon 리소스 이름(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/) 

## 구문 요청
<a name="API_ListForecasts_RequestSyntax"></a>

```
{
   "Filters": [ 
      { 
         "Condition": "string",
         "Key": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_ListForecasts_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Filters](#API_ListForecasts_RequestSyntax) **   <a name="forecast-ListForecasts-request-Filters"></a>
필터 배열입니다. 각 필터마다 조건과 일치 문을 제공합니다. 조건은 명령문과 일치하는 예측을 목록에 포함할지 제외할지 여부를 각각 지정하는 `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) **   <a name="forecast-ListForecasts-request-MaxResults"></a>
응답에서 반환할 총 항목 수입니다.  
타입: 정수  
유효 범위: 최소값 1. 최댓값은 100입니다.  
필수 여부: 아니요

 ** [NextToken](#API_ListForecasts_RequestSyntax) **   <a name="forecast-ListForecasts-request-NextToken"></a>
이전 요청의 결과가 잘린 경우 응답에는 `NextToken`이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+`   
필수 여부: 아니요

## 응답 구문
<a name="API_ListForecasts_ResponseSyntax"></a>

```
{
   "Forecasts": [ 
      { 
         "CreatedUsingAutoPredictor": boolean,
         "CreationTime": number,
         "DatasetGroupArn": "string",
         "ForecastArn": "string",
         "ForecastName": "string",
         "LastModificationTime": number,
         "Message": "string",
         "PredictorArn": "string",
         "Status": "string"
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_ListForecasts_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Forecasts](#API_ListForecasts_ResponseSyntax) **   <a name="forecast-ListForecasts-response-Forecasts"></a>
각 예측의 속성을 요약하는 객체의 배열입니다.  
타입: [ForecastSummary](API_ForecastSummary.md)객체 배열

 ** [NextToken](#API_ListForecasts_ResponseSyntax) **   <a name="forecast-ListForecasts-response-NextToken"></a>
응답이 잘린 경우 Amazon Forecast는 이 토큰을 반환합니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+` 

## 오류
<a name="API_ListForecasts_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** InvalidNextTokenException **   
토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_ListForecasts_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListForecasts) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListForecasts) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListForecasts) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListForecasts) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListForecasts) 

# ListMonitorEvaluations
<a name="API_ListMonitorEvaluations"></a>

모니터 리소스가 서로 다른 기간 동안 수집한 모니터링 평가 결과 및 예측기 이벤트 목록을 반환합니다.

**중요**  
신규 고객은 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)를 참조하세요.

## 구문 요청
<a name="API_ListMonitorEvaluations_RequestSyntax"></a>

```
{
   "Filters": [ 
      { 
         "Condition": "string",
         "Key": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "MonitorArn": "string",
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_ListMonitorEvaluations_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Filters](#API_ListMonitorEvaluations_RequestSyntax) **   <a name="forecast-ListMonitorEvaluations-request-Filters"></a>
필터 배열입니다. 각 필터마다 조건과 일치 문을 제공합니다. 조건은 문과 일치하는 리소스를 목록에 포함할지 제외할지 여부를 각각 지정하는 `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) **   <a name="forecast-ListMonitorEvaluations-request-MaxResults"></a>
반환할 최대 모니터링 결과 수입니다.  
타입: 정수  
유효 범위: 최소값 1. 최댓값은 100입니다.  
필수 여부: 아니요

 ** [MonitorArn](#API_ListMonitorEvaluations_RequestSyntax) **   <a name="forecast-ListMonitorEvaluations-request-MonitorArn"></a>
결과를 가져올 모니터 리소스의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

 ** [NextToken](#API_ListMonitorEvaluations_RequestSyntax) **   <a name="forecast-ListMonitorEvaluations-request-NextToken"></a>
이전 요청의 결과가 잘린 경우 응답에는 `NextToken`이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+`   
필수 여부: 아니요

## 응답 구문
<a name="API_ListMonitorEvaluations_ResponseSyntax"></a>

```
{
   "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
      }
   ]
}
```

## 응답 요소
<a name="API_ListMonitorEvaluations_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListMonitorEvaluations_ResponseSyntax) **   <a name="forecast-ListMonitorEvaluations-response-NextToken"></a>
응답이 잘린 경우 Amazon Forecast는 이 토큰을 반환합니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+` 

 ** [PredictorMonitorEvaluations](#API_ListMonitorEvaluations_ResponseSyntax) **   <a name="forecast-ListMonitorEvaluations-response-PredictorMonitorEvaluations"></a>
모니터 리소스가 서로 다른 기간 동안 수집한 모니터링 결과 및 예측기 이벤트입니다.  
모니터링에 대한 자세한 내용은 [모니터링 결과 보기](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) 객체 배열

## 오류
<a name="API_ListMonitorEvaluations_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** InvalidNextTokenException **   
토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_ListMonitorEvaluations_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListMonitorEvaluations) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListMonitorEvaluations) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListMonitorEvaluations) 

# ListMonitors
<a name="API_ListMonitors"></a>

[CreateMonitor](API_CreateMonitor.md) 작업과 [CreateAutoPredictor](API_CreateAutoPredictor.md) 작업으로 생성한 모니터 목록을 반환합니다. 이 작업은 각 모니터 리소스마다 Amazon 리소스 이름(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/) 

## 구문 요청
<a name="API_ListMonitors_RequestSyntax"></a>

```
{
   "Filters": [ 
      { 
         "Condition": "string",
         "Key": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_ListMonitors_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Filters](#API_ListMonitors_RequestSyntax) **   <a name="forecast-ListMonitors-request-Filters"></a>
필터 배열입니다. 각 필터마다 조건과 일치 문을 제공합니다. 조건은 문과 일치하는 리소스를 목록에 포함할지 제외할지 여부를 각각 지정하는 `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) **   <a name="forecast-ListMonitors-request-MaxResults"></a>
응답에 포함되는 최대 모니터 수입니다.  
타입: 정수  
유효 범위: 최소값 1. 최댓값은 100입니다.  
필수 여부: 아니요

 ** [NextToken](#API_ListMonitors_RequestSyntax) **   <a name="forecast-ListMonitors-request-NextToken"></a>
이전 요청의 결과가 잘린 경우 응답에는 `NextToken`이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+`   
필수 여부: 아니요

## 응답 구문
<a name="API_ListMonitors_ResponseSyntax"></a>

```
{
   "Monitors": [ 
      { 
         "CreationTime": number,
         "LastModificationTime": number,
         "MonitorArn": "string",
         "MonitorName": "string",
         "ResourceArn": "string",
         "Status": "string"
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_ListMonitors_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Monitors](#API_ListMonitors_ResponseSyntax) **   <a name="forecast-ListMonitors-response-Monitors"></a>
각 모니터의 속성을 요약하는 객체의 배열입니다.  
타입: [MonitorSummary](API_MonitorSummary.md)객체 배열

 ** [NextToken](#API_ListMonitors_ResponseSyntax) **   <a name="forecast-ListMonitors-response-NextToken"></a>
응답이 잘린 경우 Amazon Forecast는 이 토큰을 반환합니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+` 

## 오류
<a name="API_ListMonitors_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** InvalidNextTokenException **   
토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_ListMonitors_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListMonitors) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListMonitors) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListMonitors) 

# ListPredictorBacktestExportJobs
<a name="API_ListPredictorBacktestExportJobs"></a>

[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/) 

특정 백테스트 내보내기 작업의 전체 속성 세트를 검색하려면 [DescribePredictorBacktestExportJob](API_DescribePredictorBacktestExportJob.md) 작업과 함께 ARN을 사용하세요.

## 구문 요청
<a name="API_ListPredictorBacktestExportJobs_RequestSyntax"></a>

```
{
   "Filters": [ 
      { 
         "Condition": "string",
         "Key": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_ListPredictorBacktestExportJobs_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Filters](#API_ListPredictorBacktestExportJobs_RequestSyntax) **   <a name="forecast-ListPredictorBacktestExportJobs-request-Filters"></a>
필터 배열입니다. 각 필터마다 조건과 일치 문을 제공합니다. 조건은 문과 일치하는 예측기 백테스트 내보내기 작업을 목록에 포함할지 제외할지 여부를 각각 지정하는 `IS` 또는 `IS_NOT`입니다. 일치 문은 키와 값으로 구성됩니다.  
 **필터 속성**   
+  `Condition` - 적용할 조건입니다. 유효 값은 `IS` 및 `IS_NOT`입니다. 문과 일치하는 예측기 백테스트 내보내기 작업을 포함하려면 `IS`를 지정합니다. 일치하는 예측기 백테스트 내보내기 작업을 제외하려면 `IS_NOT`을 지정합니다.
+  `Key` - 필터링할 파라미터의 이름입니다. 유효 값은 `PredictorArn` 및 `Status`입니다.
+  `Value` - 일치시킬 값입니다.
타입: [Filter](API_Filter.md)객체 배열  
필수: 아니요

 ** [MaxResults](#API_ListPredictorBacktestExportJobs_RequestSyntax) **   <a name="forecast-ListPredictorBacktestExportJobs-request-MaxResults"></a>
응답에서 반환할 총 항목 수입니다.  
타입: 정수  
유효 범위: 최소값 1. 최댓값은 100입니다.  
필수 여부: 아니요

 ** [NextToken](#API_ListPredictorBacktestExportJobs_RequestSyntax) **   <a name="forecast-ListPredictorBacktestExportJobs-request-NextToken"></a>
이전 요청의 결과가 잘린 경우 응답에는 NextToken이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+`   
필수 여부: 아니요

## 응답 구문
<a name="API_ListPredictorBacktestExportJobs_ResponseSyntax"></a>

```
{
   "NextToken": "string",
   "PredictorBacktestExportJobs": [ 
      { 
         "CreationTime": number,
         "Destination": { 
            "S3Config": { 
               "KMSKeyArn": "string",
               "Path": "string",
               "RoleArn": "string"
            }
         },
         "LastModificationTime": number,
         "Message": "string",
         "PredictorBacktestExportJobArn": "string",
         "PredictorBacktestExportJobName": "string",
         "Status": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListPredictorBacktestExportJobs_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListPredictorBacktestExportJobs_ResponseSyntax) **   <a name="forecast-ListPredictorBacktestExportJobs-response-NextToken"></a>
응답이 잘린 경우 이 토큰을 반환합니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+` 

 ** [PredictorBacktestExportJobs](#API_ListPredictorBacktestExportJobs_ResponseSyntax) **   <a name="forecast-ListPredictorBacktestExportJobs-response-PredictorBacktestExportJobs"></a>
각 예측기 백테스트 내보내기 작업의 속성을 요약하는 객체의 배열입니다.  
타입: [PredictorBacktestExportJobSummary](API_PredictorBacktestExportJobSummary.md) 객체 배열

## 오류
<a name="API_ListPredictorBacktestExportJobs_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** InvalidNextTokenException **   
토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_ListPredictorBacktestExportJobs_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListPredictorBacktestExportJobs) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListPredictorBacktestExportJobs) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListPredictorBacktestExportJobs) 

# ListPredictors
<a name="API_ListPredictors"></a>

[CreateAutoPredictor](API_CreateAutoPredictor.md) 또는 [CreatePredictor](API_CreatePredictor.md) 작업을 사용하여 생성한 예측기 목록을 반환합니다. 이 작업은 각 예측기마다 Amazon 리소스 이름(ARN)을 포함하여 예측기의 속성 요약을 반환합니다.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

[DescribeAutoPredictor](API_DescribeAutoPredictor.md) 및 [DescribePredictor](API_DescribePredictor.md) 작업과 함께 ARN을 사용하여 전체 속성 세트를 검색할 수 있습니다. [Filter](API_Filter.md) 객체 배열을 사용하여 목록을 필터링할 수 있습니다.

## 구문 요청
<a name="API_ListPredictors_RequestSyntax"></a>

```
{
   "Filters": [ 
      { 
         "Condition": "string",
         "Key": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_ListPredictors_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Filters](#API_ListPredictors_RequestSyntax) **   <a name="forecast-ListPredictors-request-Filters"></a>
필터 배열입니다. 각 필터마다 조건과 일치 문을 제공합니다. 조건은 문과 일치하는 예측기를 목록에 포함할지 제외할지 여부를 각각 지정하는 `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) **   <a name="forecast-ListPredictors-request-MaxResults"></a>
응답에서 반환할 총 항목 수입니다.  
타입: 정수  
유효 범위: 최소값 1. 최댓값은 100입니다.  
필수 여부: 아니요

 ** [NextToken](#API_ListPredictors_RequestSyntax) **   <a name="forecast-ListPredictors-request-NextToken"></a>
이전 요청의 결과가 잘린 경우 응답에는 `NextToken`이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+`   
필수 여부: 아니요

## 응답 구문
<a name="API_ListPredictors_ResponseSyntax"></a>

```
{
   "NextToken": "string",
   "Predictors": [ 
      { 
         "CreationTime": number,
         "DatasetGroupArn": "string",
         "IsAutoPredictor": boolean,
         "LastModificationTime": number,
         "Message": "string",
         "PredictorArn": "string",
         "PredictorName": "string",
         "ReferencePredictorSummary": { 
            "Arn": "string",
            "State": "string"
         },
         "Status": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListPredictors_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListPredictors_ResponseSyntax) **   <a name="forecast-ListPredictors-response-NextToken"></a>
응답이 잘린 경우 Amazon Forecast는 이 토큰을 반환합니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+` 

 ** [Predictors](#API_ListPredictors_ResponseSyntax) **   <a name="forecast-ListPredictors-response-Predictors"></a>
각 예측기의 속성을 요약하는 객체의 배열입니다.  
타입: [PredictorSummary](API_PredictorSummary.md) 객체 배열

## 오류
<a name="API_ListPredictors_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** InvalidNextTokenException **   
토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_ListPredictors_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListPredictors) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListPredictors) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListPredictors) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

Amazon Forecast 리소스의 태그를 나열합니다.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

## 구문 요청
<a name="API_ListTagsForResource_RequestSyntax"></a>

```
{
   "ResourceArn": "string"
}
```

## 요청 파라미터
<a name="API_ListTagsForResource_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ResourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="forecast-ListTagsForResource-request-ResourceArn"></a>
태그를 나열할 리소스를 식별하는 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 구문
<a name="API_ListTagsForResource_ResponseSyntax"></a>

```
{
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListTagsForResource_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="forecast-ListTagsForResource-response-Tags"></a>
리소스의 태그입니다.  
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.

## 오류
<a name="API_ListTagsForResource_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_ListTagsForResource_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListTagsForResource) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListTagsForResource) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListTagsForResource) 

# ListWhatIfAnalyses
<a name="API_ListWhatIfAnalyses"></a>

[CreateWhatIfAnalysis](API_CreateWhatIfAnalysis.md) 작업을 사용하여 생성한 what-if 분석의 목록을 반환합니다. 이 작업은 각 what-if 분석마다 Amazon 리소스 이름(ARN)을 포함하여 속성의 요약을 반환합니다. what-if 분석 ARN을 [DescribeWhatIfAnalysis](API_DescribeWhatIfAnalysis.md) 작업과 함께 사용하여 전체 속성 세트를 검색할 수 있습니다.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

## 구문 요청
<a name="API_ListWhatIfAnalyses_RequestSyntax"></a>

```
{
   "Filters": [ 
      { 
         "Condition": "string",
         "Key": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_ListWhatIfAnalyses_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Filters](#API_ListWhatIfAnalyses_RequestSyntax) **   <a name="forecast-ListWhatIfAnalyses-request-Filters"></a>
필터 배열입니다. 각 필터마다 조건과 일치 문을 제공합니다. 조건은 문과 일치하는 what-if 분석 작업을 목록에 포함할지 제외할지 여부를 각각 지정하는 `IS` 또는 `IS_NOT`입니다. 일치 문은 키와 값으로 구성됩니다.  
 **필터 속성**   
+  `Condition` - 적용할 조건입니다. 유효 값은 `IS` 및 `IS_NOT`입니다. 문과 일치하는 what-if 분석 작업을 포함하려면 `IS`를 지정합니다. 일치하는 what-if 분석 작업을 제외하려면 `IS_NOT`을 지정합니다.
+  `Key` - 필터링할 파라미터의 이름입니다. 유효 값은 `WhatIfAnalysisArn` 및 `Status`입니다.
+  `Value` - 일치시킬 값입니다.
예를 들어 *electricityWhatIf*라는 예측을 내보내는 모든 작업을 나열하려면 다음 필터를 지정합니다.  
 `"Filters": [ { "Condition": "IS", "Key": "WhatIfAnalysisArn", "Value": "arn:aws:forecast:us-west-2:<acct-id>:forecast/electricityWhatIf" } ]`   
타입: [Filter](API_Filter.md)객체 배열  
필수: 아니요

 ** [MaxResults](#API_ListWhatIfAnalyses_RequestSyntax) **   <a name="forecast-ListWhatIfAnalyses-request-MaxResults"></a>
응답에서 반환할 총 항목 수입니다.  
타입: 정수  
유효 범위: 최소값 1. 최댓값은 100입니다.  
필수 여부: 아니요

 ** [NextToken](#API_ListWhatIfAnalyses_RequestSyntax) **   <a name="forecast-ListWhatIfAnalyses-request-NextToken"></a>
이전 요청의 결과가 잘린 경우 응답에는 `NextToken`이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+`   
필수 여부: 아니요

## 응답 구문
<a name="API_ListWhatIfAnalyses_ResponseSyntax"></a>

```
{
   "NextToken": "string",
   "WhatIfAnalyses": [ 
      { 
         "CreationTime": number,
         "ForecastArn": "string",
         "LastModificationTime": number,
         "Message": "string",
         "Status": "string",
         "WhatIfAnalysisArn": "string",
         "WhatIfAnalysisName": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListWhatIfAnalyses_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListWhatIfAnalyses_ResponseSyntax) **   <a name="forecast-ListWhatIfAnalyses-response-NextToken"></a>
응답이 잘린 경우 Forecast는 이 토큰을 반환합니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+` 

 ** [WhatIfAnalyses](#API_ListWhatIfAnalyses_ResponseSyntax) **   <a name="forecast-ListWhatIfAnalyses-response-WhatIfAnalyses"></a>
일치하는 분석을 설명하는 `WhatIfAnalysisSummary` 객체의 배열입니다.  
타입: [WhatIfAnalysisSummary](API_WhatIfAnalysisSummary.md) 객체 배열

## 오류
<a name="API_ListWhatIfAnalyses_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** InvalidNextTokenException **   
토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_ListWhatIfAnalyses_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListWhatIfAnalyses) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListWhatIfAnalyses) 

# ListWhatIfForecastExports
<a name="API_ListWhatIfForecastExports"></a>

[CreateWhatIfForecastExport](API_CreateWhatIfForecastExport.md) 작업을 사용하여 생성한 what-if 예측 내보내기 목록을 반환합니다. 이 작업은 각 what-if 예측 내보내기마다 Amazon 리소스 이름(ARN)을 포함하여 what-if 예측 내보내기의 속성 요약을 반환합니다. what-if 예측 내보내기 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/) 

## 구문 요청
<a name="API_ListWhatIfForecastExports_RequestSyntax"></a>

```
{
   "Filters": [ 
      { 
         "Condition": "string",
         "Key": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_ListWhatIfForecastExports_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Filters](#API_ListWhatIfForecastExports_RequestSyntax) **   <a name="forecast-ListWhatIfForecastExports-request-Filters"></a>
필터 배열입니다. 각 필터마다 조건과 일치 문을 제공합니다. 조건은 문과 일치하는 what-if 예측 내보내기 작업을 목록에 포함할지 제외할지 여부를 각각 지정하는 `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:<acct-id>:forecast/electricityWIFExport" } ]`   
타입: [Filter](API_Filter.md)객체 배열  
필수: 아니요

 ** [MaxResults](#API_ListWhatIfForecastExports_RequestSyntax) **   <a name="forecast-ListWhatIfForecastExports-request-MaxResults"></a>
응답에서 반환할 총 항목 수입니다.  
타입: 정수  
유효 범위: 최소값 1. 최댓값은 100입니다.  
필수 여부: 아니요

 ** [NextToken](#API_ListWhatIfForecastExports_RequestSyntax) **   <a name="forecast-ListWhatIfForecastExports-request-NextToken"></a>
이전 요청의 결과가 잘린 경우 응답에는 `NextToken`이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+`   
필수 여부: 아니요

## 응답 구문
<a name="API_ListWhatIfForecastExports_ResponseSyntax"></a>

```
{
   "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"
      }
   ]
}
```

## 응답 요소
<a name="API_ListWhatIfForecastExports_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListWhatIfForecastExports_ResponseSyntax) **   <a name="forecast-ListWhatIfForecastExports-response-NextToken"></a>
응답이 잘린 경우 Forecast는 이 토큰을 반환합니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+` 

 ** [WhatIfForecastExports](#API_ListWhatIfForecastExports_ResponseSyntax) **   <a name="forecast-ListWhatIfForecastExports-response-WhatIfForecastExports"></a>
일치하는 예측 내보내기를 설명하는 `WhatIfForecastExports` 객체의 배열입니다.  
타입: [WhatIfForecastExportSummary](API_WhatIfForecastExportSummary.md) 객체 배열

## 오류
<a name="API_ListWhatIfForecastExports_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** InvalidNextTokenException **   
토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_ListWhatIfForecastExports_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListWhatIfForecastExports) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListWhatIfForecastExports) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListWhatIfForecastExports) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListWhatIfForecastExports) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListWhatIfForecastExports) 

# ListWhatIfForecasts
<a name="API_ListWhatIfForecasts"></a>

[CreateWhatIfForecast](API_CreateWhatIfForecast.md) 작업을 사용하여 생성한 what-if 예측 목록을 반환합니다. 이 작업은 각 what-if 예측마다 Amazon 리소스 이름(ARN)을 포함하여 what-if 예측의 속성 요약을 반환합니다. what-if 예측 ARN을 [DescribeWhatIfForecast](API_DescribeWhatIfForecast.md) 작업과 함께 사용하여 전체 속성 세트를 검색할 수 있습니다.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

## 구문 요청
<a name="API_ListWhatIfForecasts_RequestSyntax"></a>

```
{
   "Filters": [ 
      { 
         "Condition": "string",
         "Key": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_ListWhatIfForecasts_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Filters](#API_ListWhatIfForecasts_RequestSyntax) **   <a name="forecast-ListWhatIfForecasts-request-Filters"></a>
필터 배열입니다. 각 필터마다 조건과 일치 문을 제공합니다. 조건은 문과 일치하는 what-if 예측 내보내기 작업을 목록에 포함할지 제외할지 여부를 각각 지정하는 `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:<acct-id>:forecast/electricityWhatIfForecast" } ]`   
타입: [Filter](API_Filter.md)객체 배열  
필수: 아니요

 ** [MaxResults](#API_ListWhatIfForecasts_RequestSyntax) **   <a name="forecast-ListWhatIfForecasts-request-MaxResults"></a>
응답에서 반환할 총 항목 수입니다.  
타입: 정수  
유효 범위: 최소값 1. 최댓값은 100입니다.  
필수 여부: 아니요

 ** [NextToken](#API_ListWhatIfForecasts_RequestSyntax) **   <a name="forecast-ListWhatIfForecasts-request-NextToken"></a>
이전 요청의 결과가 잘린 경우 응답에는 `NextToken`이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+`   
필수 여부: 아니요

## 응답 구문
<a name="API_ListWhatIfForecasts_ResponseSyntax"></a>

```
{
   "NextToken": "string",
   "WhatIfForecasts": [ 
      { 
         "CreationTime": number,
         "LastModificationTime": number,
         "Message": "string",
         "Status": "string",
         "WhatIfAnalysisArn": "string",
         "WhatIfForecastArn": "string",
         "WhatIfForecastName": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListWhatIfForecasts_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListWhatIfForecasts_ResponseSyntax) **   <a name="forecast-ListWhatIfForecasts-response-NextToken"></a>
이전 요청의 결과가 잘린 경우 응답에는 `NextToken`이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
패턴: `.+` 

 ** [WhatIfForecasts](#API_ListWhatIfForecasts_ResponseSyntax) **   <a name="forecast-ListWhatIfForecasts-response-WhatIfForecasts"></a>
일치하는 예측을 설명하는 `WhatIfForecasts` 객체의 배열입니다.  
타입: [WhatIfForecastSummary](API_WhatIfForecastSummary.md) 객체 배열

## 오류
<a name="API_ListWhatIfForecasts_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** InvalidNextTokenException **   
토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.  
HTTP 상태 코드: 400

## 참고
<a name="API_ListWhatIfForecasts_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](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용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListWhatIfForecasts) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListWhatIfForecasts) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListWhatIfForecasts) 

# ResumeResource
<a name="API_ResumeResource"></a>

중지된 모니터 리소스를 재개합니다.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

## 구문 요청
<a name="API_ResumeResource_RequestSyntax"></a>

```
{
   "ResourceArn": "string"
}
```

## 요청 파라미터
<a name="API_ResumeResource_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ResourceArn](#API_ResumeResource_RequestSyntax) **   <a name="forecast-ResumeResource-request-ResourceArn"></a>
재개할 모니터 리소스의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 요소
<a name="API_ResumeResource_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_ResumeResource_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
계정당 리소스 수 제한을 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_ResumeResource_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ResumeResource) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ResumeResource) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ResumeResource) 

# StopResource
<a name="API_StopResource"></a>

리소스를 중지합니다.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

리소스는 `CREATE_STOPPING` 상태와 `CREATE_STOPPED` 상태를 거칩니다. 리소스가 중지된 후에는 리소스를 재개할 수 없습니다.

이 작업은 다음 리소스(및 해당 하위 리소스)에 적용할 수 있습니다.
+ 데이터 세트 가져오기 작업
+ 예측기 작업
+ 예측 작업
+ 예측 내보내기 작업
+ 예측기 백테스트 내보내기 작업
+ 설명 가능성 작업
+ 설명 가능성 내보내기 작업

## 구문 요청
<a name="API_StopResource_RequestSyntax"></a>

```
{
   "ResourceArn": "string"
}
```

## 요청 파라미터
<a name="API_StopResource_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ResourceArn](#API_StopResource_RequestSyntax) **   <a name="forecast-StopResource-request-ResourceArn"></a>
중지할 리소스를 식별하는 Amazon 리소스 이름(ARN)입니다. 지원되는 ARN은 `DatasetImportJobArn`, `PredictorArn`, `PredictorBacktestExportJobArn`, `ForecastArn`, `ForecastExportJobArn`, `ExplainabilityArn`, `ExplainabilityExportArn`입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 요소
<a name="API_StopResource_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_StopResource_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
계정당 리소스 수 제한을 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_StopResource_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/StopResource) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/StopResource) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/StopResource) 

# TagResource
<a name="API_TagResource"></a>

지정된 태그를 `resourceArn`이 지정된 리소스에 연결합니다. 요청 파라미터에서 리소스에 기존 태그가 지정되지 않은 경우, 기존 태그는 변경되지 않습니다. 리소스를 삭제하면 해당 리소스와 연결된 태그도 삭제됩니다.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

## 구문 요청
<a name="API_TagResource_RequestSyntax"></a>

```
{
   "ResourceArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## 요청 파라미터
<a name="API_TagResource_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ResourceArn](#API_TagResource_RequestSyntax) **   <a name="forecast-TagResource-request-ResourceArn"></a>
태그를 나열할 리소스를 식별하는 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="forecast-TagResource-request-Tags"></a>
리소스에 추가할 태그입니다. 태그는 키-값 페어의 배열입니다.  
 태그에 적용되는 기본 제한 사항은 다음과 같습니다.  
+ 리소스당 최대 태그 수 - 50개.
+ 각 리소스에 대해 각 태그 키는 고유해야 하며 각 태그 키는 하나의 값만 가질 수 있습니다.
+ 최대 키 길이 - 유니코드 문자 128자(UTF-8).
+ 최대 값 길이 - 유니코드 문자 256자(UTF-8).
+ 태깅 스키마를 여러 서비스와 리소스에서 사용하는 경우 다른 서비스 또한 허용되는 문자에 대한 제한이 있을 수 있음을 유의합니다. 일반적으로 허용되는 문자는 UTF-8로 표현할 수 있는 문자, 숫자 및 공백과 \$1 - = . \$1 : / @입니다.
+ 태그 키와 값은 대소문자를 구분합니다.
+ 키는 AWS 사용을 위해 예약되어 있으므로 `aws:`, `AWS:`또는 키의 접두사와 같은의 대문자 또는 소문자 조합을 사용하지 마십시오. 이 접두사가 있는 태그 키는 편집하거나 삭제할 수 없습니다. 값에 이 접두사가 포함될 수 있습니다. 태그 값에는 접두사로 `aws`가 있지만 키에는 없는 경우 Forecast는 해당 태그를 사용자 태그로 간주하여 50개 태그 한도에 포함합니다. `aws` 키 접두사만 있는 태그는 리소스당 태그 수 한도에 포함되지 않습니다.
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 예

## 응답 요소
<a name="API_TagResource_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_TagResource_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
계정당 리소스 수 제한을 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_TagResource_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/TagResource) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/TagResource) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

지정된 태그를 리소스에서 삭제합니다.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

## 구문 요청
<a name="API_UntagResource_RequestSyntax"></a>

```
{
   "ResourceArn": "string",
   "TagKeys": [ "string" ]
}
```

## 요청 파라미터
<a name="API_UntagResource_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ResourceArn](#API_UntagResource_RequestSyntax) **   <a name="forecast-UntagResource-request-ResourceArn"></a>
태그를 나열할 리소스를 식별하는 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

 ** [TagKeys](#API_UntagResource_RequestSyntax) **   <a name="forecast-UntagResource-request-TagKeys"></a>
제거할 태그의 키입니다.  
유형: 문자열 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
길이 제약: 최소 길이 1. 최대 길이 128.  
패턴: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`   
필수 여부: 예

## 응답 요소
<a name="API_UntagResource_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_UntagResource_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_UntagResource_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/UntagResource) 
+  [AWS Go v2용 SDK](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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/UntagResource) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/UntagResource) 

# UpdateDatasetGroup
<a name="API_UpdateDatasetGroup"></a>

데이터 세트 그룹의 데이터 세트를 지정된 데이터 세트로 바꿉니다.

**중요**  
신규 고객은 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) 작업을 사용합니다.

## 구문 요청
<a name="API_UpdateDatasetGroup_RequestSyntax"></a>

```
{
   "DatasetArns": [ "string" ],
   "DatasetGroupArn": "string"
}
```

## 요청 파라미터
<a name="API_UpdateDatasetGroup_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [DatasetArns](#API_UpdateDatasetGroup_RequestSyntax) **   <a name="forecast-UpdateDatasetGroup-request-DatasetArns"></a>
데이터 세트 그룹에 추가할 데이터 세트의 Amazon 리소스 이름(ARN) 배열입니다.  
유형: 문자열 배열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

 ** [DatasetGroupArn](#API_UpdateDatasetGroup_RequestSyntax) **   <a name="forecast-UpdateDatasetGroup-request-DatasetGroupArn"></a>
데이터 세트 그룹의 ARN입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 요소
<a name="API_UpdateDatasetGroup_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_UpdateDatasetGroup_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_UpdateDatasetGroup_SeeAlso"></a>

언어별 AWS SDKs
+  [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 SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/UpdateDatasetGroup) 
+  [AWS SDK for Go 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 SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/UpdateDatasetGroup) 
+  [AWS SDK for Kotlin](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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/UpdateDatasetGroup) 

# Amazon Forecast 쿼리 서비스
<a name="API_Operations_Amazon_Forecast_Query_Service"></a>

Amazon Forecast 쿼리 서비스가 지원하는 작업은 다음과 같습니다.
+  [QueryForecast](API_forecastquery_QueryForecast.md) 
+  [QueryWhatIfForecast](API_forecastquery_QueryWhatIfForecast.md) 

# QueryForecast
<a name="API_forecastquery_QueryForecast"></a>

제공된 기준에 따라 필터링된 단일 항목에 대한 예측을 검색합니다.

기준은 키-값 페어입니다. 키는 `TARGET_TIME_SERIES` 데이터 세트의 `item_id`(또는 이에 상응하는 비타임스탬프, 비대상 필드)이거나 `FeaturizationConfig` 객체의 일부로 지정된 예측 차원 중 하나입니다.

기본적으로 `QueryForecast`는 필터링된 예측의 전체 날짜 범위를 반환합니다. 특정 날짜 범위를 요청할 수 있습니다.

전체 예측을 가져오려면 [CreateForecastExportJob](https://docs.aws.amazon.com/en_us/forecast/latest/dg/API_CreateForecastExportJob.html) 작업을 사용하세요.

**참고**  
Amazon Forecast에서 생성되는 예측은 예측기를 생성하는 데 사용된 데이터 세트와 시간대가 동일합니다.

## 구문 요청
<a name="API_forecastquery_QueryForecast_RequestSyntax"></a>

```
{
   "EndDate": "string",
   "Filters": { 
      "string" : "string" 
   },
   "ForecastArn": "string",
   "NextToken": "string",
   "StartDate": "string"
}
```

## 요청 파라미터
<a name="API_forecastquery_QueryForecast_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [EndDate](#API_forecastquery_QueryForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryForecast-request-EndDate"></a>
예측의 종료 날짜입니다. yyyy-MM-dd'T'HH:mm:ss(ISO 8601 형식) 형식을 사용하여 날짜를 지정합니다. 예: 2015-01-01T20:00:00.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [Filters](#API_forecastquery_QueryForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryForecast-request-Filters"></a>
예측을 검색할 때 적용할 필터링 기준입니다. 예를 들어 전기 사용량 데이터 세트에서 `client_21`에 대한 예측을 가져오려면 다음을 지정합니다.  
 `{"item_id" : "client_21"}`   
전체 예측을 가져오려면 [CreateForecastExportJob](https://docs.aws.amazon.com/en_us/forecast/latest/dg/API_CreateForecastExportJob.html) 작업을 사용하세요.  
유형: 문자열 간 맵  
맵 항목: 최대 항목 수는 50입니다.  
키 길이 제약: 최대 길이는 256입니다.  
키 패턴: `^[a-zA-Z0-9\_\-]+$`   
값 길이 제약: 최대 길이는 256입니다.  
필수 항목 여부: 예

 ** [ForecastArn](#API_forecastquery_QueryForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryForecast-request-ForecastArn"></a>
쿼리할 예측의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

 ** [NextToken](#API_forecastquery_QueryForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryForecast-request-NextToken"></a>
이전 요청의 결과가 잘린 경우 응답에는 `NextToken`이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
필수 여부: 아니요

 ** [StartDate](#API_forecastquery_QueryForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryForecast-request-StartDate"></a>
예측의 시작 날짜. yyyy-MM-dd'T'HH:mm:ss(ISO 8601 형식) 형식을 사용하여 날짜를 지정합니다. 예: 2015-01-01T08:00:00.  
유형: 문자열  
필수사항: 아니요

## 응답 구문
<a name="API_forecastquery_QueryForecast_ResponseSyntax"></a>

```
{
   "Forecast": { 
      "Predictions": { 
         "string" : [ 
            { 
               "Timestamp": "string",
               "Value": number
            }
         ]
      }
   }
}
```

## 응답 요소
<a name="API_forecastquery_QueryForecast_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Forecast](#API_forecastquery_QueryForecast_ResponseSyntax) **   <a name="forecast-forecastquery_QueryForecast-response-Forecast"></a>
예측.  
타입: [Forecast](API_forecastquery_Forecast.md) 객체

## 오류
<a name="API_forecastquery_QueryForecast_Errors"></a>

 ** InvalidInputException **   
값이 유효하지 않거나 너무 깁니다.  
HTTP 상태 코드: 400

 ** InvalidNextTokenException **   
토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
초당 요청 수 한도를 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 리소스를 찾을 수 없습니다. 제공한 정보를 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_forecastquery_QueryForecast_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/forecastquery-2018-06-26/QueryForecast) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecastquery-2018-06-26/QueryForecast) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/forecastquery-2018-06-26/QueryForecast) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecastquery-2018-06-26/QueryForecast) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecastquery-2018-06-26/QueryForecast) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecastquery-2018-06-26/QueryForecast) 

# QueryWhatIfForecast
<a name="API_forecastquery_QueryWhatIfForecast"></a>

what-if 예측을 검색합니다.

## 구문 요청
<a name="API_forecastquery_QueryWhatIfForecast_RequestSyntax"></a>

```
{
   "EndDate": "string",
   "Filters": { 
      "string" : "string" 
   },
   "NextToken": "string",
   "StartDate": "string",
   "WhatIfForecastArn": "string"
}
```

## 요청 파라미터
<a name="API_forecastquery_QueryWhatIfForecast_RequestParameters"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [EndDate](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-EndDate"></a>
what-if 예측의 종료 날짜입니다. yyyy-MM-dd'T'HH:mm:ss(ISO 8601 형식) 형식을 사용하여 날짜를 지정합니다. 예: 2015-01-01T20:00:00.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [Filters](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-Filters"></a>
예측을 검색할 때 적용할 필터링 기준입니다. 예를 들어 전기 사용량 데이터 세트에서 `client_21`에 대한 예측을 가져오려면 다음을 지정합니다.  
 `{"item_id" : "client_21"}`   
전체 what-if 예측을 가져오려면 [CreateForecastExportJob](https://docs.aws.amazon.com/en_us/forecast/latest/dg/API_CreateWhatIfForecastExport.html) 작업을 사용하세요.  
유형: 문자열 간 맵  
맵 항목: 최대 항목 수는 50입니다.  
키 길이 제약: 최대 길이는 256입니다.  
키 패턴: `^[a-zA-Z0-9\_\-]+$`   
값 길이 제약: 최대 길이는 256입니다.  
필수 항목 여부: 예

 ** [NextToken](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-NextToken"></a>
이전 요청의 결과가 잘린 경우 응답에는 `NextToken`이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.  
필수 여부: 아니요

 ** [StartDate](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-StartDate"></a>
what-if 예측의 시작 날짜입니다. yyyy-MM-dd'T'HH:mm:ss(ISO 8601 형식) 형식을 사용하여 날짜를 지정합니다. 예: 2015-01-01T08:00:00.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [WhatIfForecastArn](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-WhatIfForecastArn"></a>
쿼리할 what-if 예측의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약 조건: 최대 길이는 300입니다.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 예

## 응답 구문
<a name="API_forecastquery_QueryWhatIfForecast_ResponseSyntax"></a>

```
{
   "Forecast": { 
      "Predictions": { 
         "string" : [ 
            { 
               "Timestamp": "string",
               "Value": number
            }
         ]
      }
   }
}
```

## 응답 요소
<a name="API_forecastquery_QueryWhatIfForecast_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Forecast](#API_forecastquery_QueryWhatIfForecast_ResponseSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-response-Forecast"></a>
예측에 대한 정보를 제공합니다. [QueryForecast](API_forecastquery_QueryForecast.md) 응답의 일부로 반환됩니다.  
타입: [Forecast](API_forecastquery_Forecast.md) 객체

## 오류
<a name="API_forecastquery_QueryWhatIfForecast_Errors"></a>

 ** InvalidInputException **   
값이 유효하지 않거나 너무 깁니다.  
HTTP 상태 코드: 400

 ** InvalidNextTokenException **   
토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
초당 요청 수 한도를 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 리소스를 찾을 수 없습니다. 제공한 정보를 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_forecastquery_QueryWhatIfForecast_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecastquery-2018-06-26/QueryWhatIfForecast) 