기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CreatePredictorBacktestExportJob
CreateAutoPredictor 또는 CreatePredictor 작업에서 생성된 백테스트 예측 및 정확도 지표를 내보냅니다. CSV 또는 Parquet 파일이 포함된 두 폴더를 지정된 S3 버킷으로 내보냅니다.
내보내기 파일 이름은 다음 규칙과 일치합니다.
<ExportJobName>_<ExportTimestamp>_<PartNumber>.csv
< ExportTimestamp > 구성 요소는 자바 SimpleDate 형식 (YYYY-MM-ddTHH-MM-SSZ) 입니다.
Amazon S3 버킷과 Amazon Forecast가 Amazon S3 버킷에 액세스하기 위해 맡을 수 있는 AWS Identity and Access Management (IAM) 역할을 포함하는 DataDestination 객체를 지정해야 합니다. 자세한 정보는 Amazon Forecast에 대한 권한 설정을 참조하세요.
참고
Amazon S3 버킷의 내보내기에 액세스하려면 내보내기 작업의 Status
가 ACTIVE
여야 합니다. 상태를 가져오려면 DescribePredictorBacktestExportJob 작업을 사용합니다.
구문 요청
{
"Destination": {
"S3Config": {
"KMSKeyArn": "string
",
"Path": "string
",
"RoleArn": "string
"
}
},
"Format": "string
",
"PredictorArn": "string
",
"PredictorBacktestExportJobName": "string
",
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
]
}
요청 파라미터
요청은 JSON 형식으로 다음 데이터를 받습니다.
- Destination
-
내보내기 작업의 대상입니다. S3 경로, Amazon Forecast가 위치에 액세스할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할 및 AWS Key Management Service (KMS) 키 (선택 사항) 를 제공합니다.
유형: DataDestination객체
필수 여부: 예
- Format
-
내보내는 데이터의 형식, CSV 또는 PARQUET. 기본값은 CSV입니다.
타입: 문자열
길이 제약 조건: 최대 길이는 7입니다.
패턴:
^CSV|PARQUET$
Required: No
- PredictorArn
-
내보내려는 예측기의 Amazon 리소스 이름(ARN)입니다.
타입: 문자열
길이 제약: 최대 길이 256.
패턴:
arn:([a-z\d-]+):forecast:.*:.*:.+
필수 사항 여부: Yes
- PredictorBacktestExportJobName
-
백테스트 내보내기 작업의 이름.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이 63.
패턴:
^[a-zA-Z][a-zA-Z0-9_]*
필수 사항 여부: Yes
- Tags
-
백테스트를 분류하고 구성하는 데 도움이 되는 선택적 메타데이터입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다. 태그 키와 값은 대소문자를 구분합니다.
태그에 적용되는 제한은 다음과 같습니다.
-
리소스마다 각 태그 키는 고유해야 하며 하나의 값만 가질 수 있습니다.
-
리소스당 최대 태그 수: 50개.
-
최대 키 길이: 유니코드 문자 128자(UTF-8).
-
최대 값 길이: 유니코드 문자 256자(UTF-8).
-
허용되는 문자: UTF-8로 표현할 수 있는 모든 문자와 숫자, 공백 및 + - =. _ : / @. 태그 지정 스키마를 다른 서비스와 리소스에서 사용하는 경우 해당 서비스의 문자 제한도 적용됩니다.
-
키 접두사는
aws:
또는AWS:
의 대문자 또는 소문자 조합을 포함할 수 없습니다. 값에 이 접두사가 포함될 수 있습니다. 태그 값에는 접두사로aws
가 있지만 키에는 없는 경우 Forecast는 해당 태그를 사용자 태그로 간주하여 50개 태그 한도에 포함합니다.aws
키 접두사만 있는 태그는 리소스당 태그 수 한도에 포함되지 않습니다. 이 접두사가 있는 태그 키는 편집하거나 삭제할 수 없습니다.
유형: Tag객체 어레이
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.
필수 여부: 아니요
-
응답 구문
{
"PredictorBacktestExportJobArn": "string"
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- PredictorBacktestExportJobArn
-
내보내려는 예측기 백테스트 내보내기 작업의 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 SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.