CreateWhatIfForecastExport - Amazon Forecast
구문 요청요청 파라미터응답 구문Response ElementsErrors참고

Amazon Forecast는 더 이상 신규 고객에게 제공되지 않습니다. Amazon Forecast의 기존 고객은 서비스를 정상적으로 계속 사용할 수 있습니다. 자세히 알아보기

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

CreateWhatIfForecastExport

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

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

< ExportTimestamp > 컴포넌트는 자바 SimpleDateFormat (THHYYYY-MM-DD -mm-SSz) 로 되어 있습니다.

중요

신규 고객은 더 이상 Amazon Forecast를 사용할 수 없습니다. Amazon Forecast의 기존 고객은 서비스를 정상적으로 계속 사용할 수 있습니다. 자세히 알아보기

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

자세한 내용은 예측 생성 단원을 참조하십시오.

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

참고

Amazon S3 버킷의 예측에 액세스하려면 예측 내보내기 작업의 Status가 ACTIVE여야 합니다. 상태를 가져오려면 DescribeWhatIfForecastExport 작업을 사용합니다.

구문 요청

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

요청 파라미터

요청은 다음과 같은 JSON 형식의 데이터를 수락합니다.

Destination

예측을 저장하려는 위치와 Amazon Forecast가 해당 위치에 액세스하기 위해 맡을 수 있는 AWS Identity and Access Management (IAM) 역할 예측은 Amazon S3 버킷으로 내보내야 합니다.

암호화를 사용하는 경우 AWS Key Management Service (KMS) 키를 Destination 포함해야 합니다. IAM역할은 Amazon Forecast에서 키에 액세스할 수 있는 권한을 허용해야 합니다.

유형: DataDestination 객체

필수 여부: 예

Format

내보낸 데이터의 형식 CSV 또는PARQUET.

유형: 문자열

길이 제약 조건: 최대 길이는 7입니다.

패턴: ^CSV|PARQUET$

Required: No

Tags

what-if 예측에 적용할 태그 목록입니다.

유형: Tag객체 어레이

어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.

필수 여부: 아니요

WhatIfForecastArns

익스포트할 가상 예측 Amazon 리소스 이름 (ARNs) 목록.

타입: 문자열 배열

배열 멤버: 최소수는 1개입니다. 최대 항목 수는 50개입니다.

길이 제약 조건: 최대 길이는 300입니다.

Pattern: arn:([a-z\d-]+):forecast:.*:.*:.+

필수 여부: 예

WhatIfForecastExportName

내보낼 what-if 예측의 이름입니다.

유형: 문자열

길이 제약: 최소 길이 1. 최대 길이 63.

Pattern: ^[a-zA-Z][a-zA-Z0-9_]*

필수 여부: 예

응답 구문

{
   "WhatIfForecastExportArn": "string"
}

Response Elements

작업이 성공하면 서비스는 HTTP 200개의 응답을 다시 보냅니다.

서비스는 다음 데이터를 JSON 형식으로 반환합니다.

WhatIfForecastExportArn

가정 예측의 Amazon 리소스 이름 (ARN)

유형: 문자열

길이 제약 조건: 최대 길이는 300입니다.

패턴: arn:([a-z\d-]+):forecast:.*:.*:.+

Errors

InvalidInputException

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

HTTP상태 코드: 400

LimitExceededException

계정당 리소스 수 제한을 초과했습니다.

HTTP상태 코드: 400

ResourceAlreadyExistsException

이 이름을 가진 리소스가 이미 있습니다. 다른 이름으로 다시 시도하세요.

HTTP상태 코드: 400

ResourceInUseException

지정된 리소스가 이미 사용 중입니다.

HTTP상태 코드: 400

ResourceNotFoundException

해당 Amazon 리소스 이름 (ARN) 을 가진 리소스를 찾을 수 없습니다. 를 ARN 확인하고 다시 시도하십시오.

HTTP상태 코드: 400

참고

언어별 사용 방법에 대한 자세한 내용은 AWS SDKs 다음을 참조하십시오. API