ListBuiltInIntents - Amazon Lex
요청 구문URI 요청 파라미터요청 본문응답 구문응답 요소오류참고 항목

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

ListBuiltInIntents

봇에서 사용할 수 있는 Amazon Lex에서 제공하는 기본 제공 의도의 목록을 가져옵니다.

내장 의도를 기본 제공 의도의 기반으로 사용하려면 내장 의도의 서명을parentIntentSignature를 호출할 때 매개 변수CreateIntent작업. 자세한 내용은 단원을 참조하십시오.크리에이트인텐트.

요청 구문

POST /builtins/locales/localeId/intents/ HTTP/1.1
Content-type: application/json

{
   "maxResults": number,
   "nextToken": "string",
   "sortBy": { 
      "attribute": "string",
      "order": "string"
   }
}

URI 요청 파라미터

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

localeId

나열할 인텐트의 언어 및 로케일의 식별자입니다. 문자열은 지원되는 로케일 중 하나와 일치해야 합니다. 자세한 내용은 단원을 참조하십시오.지원되는 언어.

: 필수 예

요청 본문

요청은 JSON 형식의 다음 데이터를 받습니다.

maxResults

결과의 각 페이지에서 반환할 기본 제공 인텐트의 최대 수입니다. 최대 페이지 크기보다 결과가 적으면 실제 결과 수만 반환됩니다.

Type: 정수

유효 범위: 고정 값은 20입니다.

: 필수 아니요

nextToken

에서 응답하는 경우ListBuiltInIntents작업에 지정된 것보다 많은 결과가 포함되어 있습니다.maxResults매개 변수를 사용하면 토큰이 응답에서 반환됩니다. 에서 해당 토큰을 사용하십시오.nextToken매개 변수를 사용하여 결과의 다음 페이지를 반환합니다.

Type: 문자열

: 필수 아니요

sortBy

기본 제공 의도의 목록에 대한 정렬 매개 변수를 지정합니다. 목록을 기본 제공 인텐트 서명별로 오름차순 또는 내림차순으로 정렬하도록 지정할 수 있습니다.

유형: BuiltInIntentSortBy 객체

: 필수 아니요

응답 구문

HTTP/1.1 200
Content-type: application/json

{
   "builtInIntentSummaries": [ 
      { 
         "description": "string",
         "intentSignature": "string"
      }
   ],
   "localeId": "string",
   "nextToken": "string"
}

응답 요소

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

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

builtInIntentSummaries

요청에 지정된 필터 기준에 맞는 기본 제공 의도에 대한 요약 정보입니다. 목록의 길이는 에 지정됩니다.maxResults요청의 매개 변수입니다. 사용 가능한 인텐트가 더 많은 경우nextToken은 결과의 다음 페이지를 가져올 토큰이 포함되어 있습니다.

Type: 배열BuiltInIntentSummary사물

localeId

목록에 있는 인텐트의 언어와 로캘입니다.

Type: 문자열

nextToken

에 대한 응답으로 반환할 결과가 더 있는지 여부를 나타내는 토큰ListBuiltInIntents작업. 만약nextToken필드가 있으면 내용을 다음과 같이 보냅니다.nextTokena 매개 변수ListBotAliases결과의 다음 페이지를 가져오는 작업을 요청합니다.

Type: 문자열

오류

모든 작업에 공통적인 오류에 대한 자세한 내용은 단원을 참조하십시오.일반적인 오류.

InternalServerException

서비스에 예상치 못한 조건이 발생했습니다. 요청을 다시 시도하십시오.

HTTP 상태 코드: 500

ServiceQuotaExceededException

봇에 대한 할당량에 도달했습니다.

HTTP 상태 코드: 402

ThrottlingException

요청량이 너무 높습니다. 요청 횟수를 줄입니다.

HTTP 상태 코드: 429

ValidationException

요청의 입력 파라미터 중 하나가 잘못되었습니다. 파라미터를 확인하고 요청을 다시 시도하십시오.

HTTP 상태 코드: 400

참고 항목

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