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

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

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