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