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

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

# 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)