CreateExplainability

참고

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

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

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

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

CreateExplainability 예측 ARN 또는 예측 ARN 중 하나를 수락합니다. 데이터 세트의 모든 시계열 및 시점에 대해 집계된 영향 점수를 받으려면 예측기 ARN을 제공하세요. 특정 시계열 및 시점의 영향 점수를 받으려면 예측 ARN을 제공하세요.

CreateExplainability 예측자 ARN 사용

참고

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

다음 파라미터는 예측기 ARN을 제공할 때 필수입니다.

ExplainabilityName - 설명 가능성의 고유한 이름.
ResourceArn - 예측기의 ARN.
TimePointGranularity - “ALL”로 설정해야 합니다.
TimeSeriesGranularity - “ALL”로 설정해야 합니다.

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

DataSource- “특정 TimeSeriesGranularity ”인 경우에만 유효합니다.
Schema- “특정 TimeSeriesGranularity ”인 경우에만 유효합니다.
StartDateTime- “특정 TimePointGranularity ”인 경우에만 유효합니다.
EndDateTime- “특정 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으로 설정된 경우 설명 가능성의 마지막 시점을 정의합니다.

다음 타임스탬프 형식을 사용하세요. yyyy-MM-ddTHH:mm:ss (example: 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.

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

필수 사항 여부: Yes

ResourceArn

설명 가능성 생성에 사용되는 예측기 또는 예측의 Amazon 리소스 이름(ARN)입니다.

타입: 문자열

길이 제약: 최대 길이 256.

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

필수 사항 여부: Yes

Schema

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

유형: Schema객체

필수 항목 여부: 아니요

StartDateTime

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

다음 타임스탬프 형식을 사용하세요. yyyy-MM-ddTHH:mm:ss (example: 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자(UTF-8).
허용되는 문자: UTF-8로 표현할 수 있는 모든 문자와 숫자, 공백 및 + - =. _ : / @. 태그 지정 스키마를 다른 서비스와 리소스에서 사용하는 경우 해당 서비스의 문자 제한도 적용됩니다.
키 접두사는 aws: 또는 AWS:의 대문자 또는 소문자 조합을 포함할 수 없습니다. 값에 이 접두사가 포함될 수 있습니다. 태그 값에는 접두사로 aws가 있지만 키에는 없는 경우 Forecast는 해당 태그를 사용자 태그로 간주하여 50개 태그 한도에 포함합니다. aws 키 접두사만 있는 태그는 리소스당 태그 수 한도에 포함되지 않습니다. 이 접두사가 있는 태그 키는 편집하거나 삭제할 수 없습니다.

유형: Tag객체 어레이

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

필수 여부: 아니요

응답 구문


{
   "ExplainabilityArn": "string"
}

응답 요소

작업이 성공하면 서비스가 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 SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

CreateDatasetImportJob

CreateExplainabilityExport