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

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

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

ListPredictors

CreateAutoPredictor 또는 CreatePredictor 작업을 사용하여 생성한 예측기 목록을 반환합니다. 이 연산은 각 예측자에 대해 Amazon 리소스 이름 (ARN) 을 비롯한 해당 속성의 요약을 반환합니다.

중요

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

DescribeAutoPredictor및 DescribePredictor 연산과 ARN 함께 사용하면 전체 속성 세트를 검색할 수 있습니다. Filter 객체 배열을 사용하여 목록을 필터링할 수 있습니다.

구문 요청

{
   "Filters": [ 
      { 
         "Condition": "string",
         "Key": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}

요청 파라미터

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

Filters

필터 배열입니다. 각 필터마다 조건과 일치 문을 제공합니다. 조건은 문과 일치하는 예측기를 목록에 포함할지 제외할지 여부를 각각 지정하는 IS 또는 IS_NOT입니다. 일치 문은 키와 값으로 구성됩니다.

필터 속성

  • Condition - 적용할 조건입니다. 유효 값은 IS및 IS_NOT입니다. 문과 일치하는 예측기를 포함하려면 IS를 지정합니다. 일치하는 예측기를 제외하려면 IS_NOT을 지정합니다.

  • Key - 필터링할 파라미터의 이름입니다. 유효 값은 DatasetGroupArn및 Status입니다.

  • Value - 일치시킬 값입니다.

예를 들어 상태가 인 모든 예측자를 ACTIVE 나열하려면 다음과 같이 지정합니다.

"Filters": [ { "Condition": "IS", "Key": "Status", "Value": "ACTIVE" } ]

유형: Filter 객체 배열

필수 여부: 아니요

MaxResults

응답에서 반환할 총 항목 수입니다.

타입: 정수

유효 범위: 최소값 1. 최댓값은 100입니다.

필수 여부: 아니요

NextToken

이전 요청의 결과가 잘린 경우 응답에는 NextToken이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.

유형: 문자열

길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.

패턴: .+

필수 여부: 아니요

응답 구문

{
   "NextToken": "string",
   "Predictors": [ 
      { 
         "CreationTime": number,
         "DatasetGroupArn": "string",
         "IsAutoPredictor": boolean,
         "LastModificationTime": number,
         "Message": "string",
         "PredictorArn": "string",
         "PredictorName": "string",
         "ReferencePredictorSummary": { 
            "Arn": "string",
            "State": "string"
         },
         "Status": "string"
      }
   ]
}

Response Elements

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

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

NextToken

응답이 잘린 경우 Amazon Forecast는 이 토큰을 반환합니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요.

유형: 문자열

길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.

패턴: .+

Predictors

각 예측기의 속성을 요약하는 객체의 배열입니다.

타입: PredictorSummary 객체 배열

Errors

InvalidInputException

요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.

HTTP상태 코드: 400

InvalidNextTokenException

토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.

HTTP상태 코드: 400

참고

언어별 사용 방법에 대한 자세한 내용은 AWS SDKs 다음을 참조하십시오. API