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

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

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

CreateExplainability

참고

설명 가능성은 () 에서 생성된 예측 및 예측 변수에만 사용할 수 있습니다. AutoPredictor CreateAutoPredictor

Amazon Forecast 설명 가능성을 생성합니다.

중요

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

설명 가능성은 데이터 세트의 속성이 예측에 미치는 영향을 더 잘 이해하는 데 도움이 됩니다. Amazon Forecast는 영향 점수라는 지표를 사용하여 각 속성의 상대적 영향을 정량화하고 예측 값을 증가시키는지 감소시키는지 결정합니다.

예측 설명 가능성을 활성화하려면 예측기에 관련 시계열, 항목 메타데이터 또는 공휴일과 날씨 지수 같은 추가 데이터 세트 중 하나 이상이 포함되어야 합니다.

참고

ARIMA(AutoRegressive 통합 이동 평균), ETS (지수 평활 상태 공간 모델) 및 NPTS (비모수 시계열) 모델은 외부 시계열 데이터를 통합하지 않습니다. 따라서 이러한 모델은 추가 데이터셋을 포함하더라도 설명 가능성 보고서를 만들지 않습니다.

CreateExplainability 예측 변수 ARN 또는 예측 ARN 변수 중 하나를 허용합니다. 데이터셋의 모든 시계열 및 시점의 영향 점수를 집계하여 받으려면 예측자를 제공하세요. ARN 특정 시계열 및 시점에 대한 영향 점수를 받으려면 Forecast를 제공하십시오ARN.

CreateExplainability 예측자와 함께 ARN

참고

설명 가능성 리소스는 예측기당 하나만 있을 수 있습니다. CreateAutoPredictor에서 ExplainPredictor를 이미 활성화한 경우 해당 예측기에는 이미 설명 가능성 리소스가 있습니다.

ARN예측자를 제공할 때는 다음 매개변수가 필요합니다.

  • ExplainabilityName - 설명 가능성의 고유한 이름.

  • ResourceArn - 예측기의 ARN.

  • TimePointGranularity- “ALL" 로 설정해야 합니다.

  • TimeSeriesGranularity- “ALL" 로 설정해야 합니다.

다음 파라미터는 값을 지정하지 마세요.

  • DataSource- “SPECIFIC" TimeSeriesGranularity 인 경우에만 유효합니다.

  • Schema- “SPECIFIC" TimeSeriesGranularity 인 경우에만 유효합니다.

  • StartDateTime- “SPECIFIC" TimePointGranularity 인 경우에만 유효합니다.

  • EndDateTime- “SPECIFIC" TimePointGranularity 인 경우에만 유효합니다.

CreateExplainability Forecast 포함 ARN

참고

최대 50개의 시계열과 500개의 시점을 지정할 수 있습니다.

예측자를 ARN 제공할 때는 다음 매개변수가 필요합니다.

  • ExplainabilityName - 설명 가능성의 고유한 이름.

  • ResourceArn - 예측의 ARN.

  • TimePointGranularity- “ALL” 또는 “SPECIFIC”

  • TimeSeriesGranularity- “ALL” 또는 “SPECIFIC”

“SPECIFIC" TimeSeriesGranularity 로 설정하는 경우 다음 사항도 제공해야 합니다.

  • DataSource- 시계열을 지정하는 CSV 파일의 S3 위치.

  • Schema - 스키마는 데이터 소스에 나열된 속성 및 속성 유형을 정의합니다.

“SPECIFIC" TimePointGranularity 로 설정하는 경우 다음 정보도 제공해야 합니다.

  • StartDateTime - 시점 범위의 첫 번째 타임스탬프.

  • EndDateTime - 시점 범위의 마지막 타임스탬프.

구문 요청

{
   "DataSource": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "EnableVisualization": boolean,
   "EndDateTime": "string",
   "ExplainabilityConfig": { 
      "TimePointGranularity": "string",
      "TimeSeriesGranularity": "string"
   },
   "ExplainabilityName": "string",
   "ResourceArn": "string",
   "Schema": { 
      "Attributes": [ 
         { 
            "AttributeName": "string",
            "AttributeType": "string"
         }
      ]
   },
   "StartDateTime": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

요청 파라미터

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

DataSource

데이터 소스, Amazon Forecast가 데이터에 액세스할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할 및 선택적으로 AWS Key Management Service (KMS) 키.

유형: DataSource 객체

필수 여부: 아니요

EnableVisualization

콘솔에서 볼 수 있는 설명 가능성 시각화를 생성하십시오. AWS

타입: 부울

필수 항목 여부: 아니요

EndDateTime

TimePointGranularity가 SPECIFIC으로 설정된 경우 설명 가능성의 마지막 시점을 정의합니다.

다음과 같은 타임스탬프 형식을 사용하세요. THH YYYY-MM-DD:mm:ss (예: 2015-01-01T20:00:00)

유형: 문자열

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

패턴: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$

Required: No

ExplainabilityConfig

설명 가능성의 시계열 및 시점 세분 수준을 정의하는 구성 설정입니다.

유형: ExplainabilityConfig 객체

필수 여부: 예

ExplainabilityName

설명 가능성의 고유한 이름.

유형: 문자열

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

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

필수 여부: 예

ResourceArn

설명 가능성을 생성하는 데 사용된 예측자 또는 예측의 Amazon 리소스 이름 (ARN).

유형: 문자열

길이 제약: 최대 길이 256.

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

필수 여부: 예

Schema

데이터 세트의 필드를 정의합니다.

유형: Schema 객체

필수 여부: 아니요

StartDateTime

TimePointGranularity가 SPECIFIC으로 설정된 경우 설명 가능성의 첫 번째 시점을 정의합니다.

다음과 같은 타임스탬프 형식을 사용하십시오. THH YYYY-MM-DD:mm:ss (예: 2015-01-01T20:00:00)

유형: 문자열

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

패턴: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$

Required: No

Tags

리소스를 분류하고 구성하는 데 도움이 되는 선택적 메타데이터입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다. 태그 키와 값은 대소문자를 구분합니다.

태그에 적용되는 제한은 다음과 같습니다.

  • 리소스마다 각 태그 키는 고유해야 하며 하나의 값만 가질 수 있습니다.

  • 리소스당 최대 태그 수: 50개.

  • 최대 키 길이: 유니코드 문자 128자 UTF (-8)

  • 최대 값 길이: 유니코드 문자 256자 (-8) UTF

  • 허용되는 문자: 모든 문자와 숫자, UTF -8로 표현할 수 있는 공백, + - = _ : / @. 태그 지정 스키마를 다른 서비스와 리소스에서 사용하는 경우 해당 서비스의 문자 제한도 적용됩니다.

  • 키 접두사는 aws: 또는 AWS:의 대문자 또는 소문자 조합을 포함할 수 없습니다. 값에 이 접두사가 포함될 수 있습니다. 태그 값에는 접두사로 aws가 있지만 키에는 없는 경우 Forecast는 해당 태그를 사용자 태그로 간주하여 50개 태그 한도에 포함합니다. aws 키 접두사만 있는 태그는 리소스당 태그 수 한도에 포함되지 않습니다. 이 접두사가 있는 태그 키는 편집하거나 삭제할 수 없습니다.

유형: Tag객체 어레이

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

필수 여부: 아니요

응답 구문

{
   "ExplainabilityArn": "string"
}

Response Elements

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

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

ExplainabilityArn

설명 가능성의 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