CreateWhatIfAnalysis - Amazon Forecast

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

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

CreateWhatIfAnalysis

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

중요

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

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

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

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

TimeSeriesSelector 객체는 what-if 분석에서 원하는 항목을 정의합니다.

참고

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

구문 요청

{ "ForecastArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "TimeSeriesSelector": { "TimeSeriesIdentifiers": { "DataSource": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "Format": "string", "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] } } }, "WhatIfAnalysisName": "string" }

요청 파라미터

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

ForecastArn

기준 예측의 Amazon 리소스 이름 (ARN).

유형: 문자열

길이 제약: 최대 길이 256.

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

필수 여부: 예

Tags

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

유형: Tag객체 어레이

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

필수 여부: 아니요

TimeSeriesSelector

TimeSeriesIdentifiers 객체가 있는 what-if 분석에 사용되는 시계열 세트를 정의합니다. what-if 분석은 이 객체의 시계열에 대해서만 수행됩니다.

TimeSeriesIdentifiers 객체에는 다음과 같은 정보가 있어야 합니다.

  • DataSource

  • Format

  • Schema

유형: TimeSeriesSelector 객체

필수 여부: 아니요

WhatIfAnalysisName

what-if 분석의 이름입니다. 각 이름은 고유해야 합니다.

유형: 문자열

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

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

필수 여부: 예

응답 구문

{ "WhatIfAnalysisArn": "string" }

Response Elements

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

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

WhatIfAnalysisArn

what-if 분석의 Amazon 리소스 이름 (ARN).

유형: 문자열

길이 제약: 최대 길이 256.

패턴: 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