GetIntentVersions - Amazon Lex V1
Request SyntaxURI 요청 파라미터Request BodyResponse Syntax응답 요소Errors참고

Amazon Lex V2를 사용하는 경우 Amazon Lex V2 가이드를 대신 참조하십시오.

 

Amazon Lex V1을 사용하는 경우 봇을 Amazon Lex V2로 업그레이드하는하는 것이 좋습니다. 더 이상 V1에 새로운 기능을 추가하지 않으므로 모든 새 봇에 V2를 사용할 것을 강력히 권장합니다.

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

GetIntentVersions

의도의 모든 버전에 대한 정보를 반환합니다.

이 GetIntentVersions 작업은 의도의 각 버전에 대한 IntentMetadata 객체를 반환합니다. 예를 들어 의도에 번호가 매겨진 버전이 3개 있는 경우, GetIntentVersions 작업은 번호가 매겨진 버전마다 하나씩 및 $LATEST 버전에 한 개, 총 4개의 IntentMetadata 객체를 응답으로 반환합니다.

GetIntentVersions 작업은 항상 하나 이상의 버전, 즉 $LATEST 버전을 반환합니다.

이 작업에는 lex:GetIntentVersions 액션에 대한 권한이 필요합니다.

Request Syntax

GET /intents/name/versions/?maxResults=maxResults&nextToken=nextToken HTTP/1.1

URI 요청 파라미터

요청은 다음 URI 파라미터를 사용합니다.

maxResults

응답으로 반환할 최대 의도 버전 수입니다. 기본값은 10.

유효한 범위: 최소값은 1. 최대값은 50.

name

버전을 반환해야 할 의도의 이름.

길이 제약: 최소 길이는 1. 최대 길이는 100.

패턴: ^([A-Za-z]_?)+$

필수 사항 여부: Yes

nextToken

의도 버전의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 호출에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 버전의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.

Request Body

해당 요청에는 본문이 없습니다.

Response Syntax

HTTP/1.1 200
Content-type: application/json

{
   "intents": [ 
      { 
         "createdDate": number,
         "description": "string",
         "lastUpdatedDate": number,
         "name": "string",
         "version": "string"
      }
   ],
   "nextToken": "string"
}

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

intents

번호가 매겨진 각 버전의 의도에 대해 하나씩 및 $LATEST 버전에 대한 하나에 해당하는 IntentMetadata 객체 배열입니다.

유형: IntentMetadata객체 어레이

nextToken

의도 버전의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 호출에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 버전의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.

타입: 문자열

Errors

BadRequestException

요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.

HTTP 상태 코드: 400

InternalFailureException

내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.

HTTP 상태 코드: 500

LimitExceededException

요청이 한도를 초과했습니다. 다시 요청해 보세요.

HTTP 상태 코드: 429

NotFoundException

요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.

HTTP 상태 코드: 404

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.