지원 종료 공지: 2025년 9월 15 AWS 일에는 Amazon Lex V1에 대한 지원을 중단합니다. 2025년 9월 15일 이후에는 Amazon Lex V1 콘솔 또는 Amazon Lex V1 리소스에 더 이상 액세스할 수 없습니다. Amazon Lex V2를 사용하는 경우 대신 Amazon Lex V2 가이드를 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
지정된 기준에 맞는 기본 제공 의도의 목록을 가져옵니다.
이 작업에는 lex:GetBuiltinIntents
작업에 대한 권한이 필요합니다.
Request Syntax
GET /builtins/intents/?locale=locale
&maxResults=maxResults
&nextToken=nextToken
&signatureContains=signatureContains
HTTP/1.1
URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
- locale
-
의도가 지원하는 로캘의 목록입니다.
유효 값:
de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR
- maxResults
-
응답에 반환되는 최대 의도 수입니다. 기본값은 10.
유효한 범위: 최소값은 1. 최대값은 50.
- nextToken
-
의도의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 API 직접 호출이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 의도의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.
- signatureContains
-
기본 제공 의도 서명과 일치하는 하위 문자열. 서명의 일부가 하위 문자열과 일치하면 의도가 반환됩니다. 예를 들어, "xyz"는 "xyzabc"와 "abcxyz"와 모두 일치합니다. 의도의 서명을 찾으려면 Alexa Skills Kit의 표준 기본 제공 의도
를 참조하십시오.
Request Body
해당 요청에는 본문이 없습니다.
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"intents": [
{
"signature": "string",
"supportedLocales": [ "string" ]
}
],
"nextToken": "string"
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- intents
-
응답의 각 의도에 대해 하나씩 있는
builtinIntentMetadata
객체의 배열입니다.유형: BuiltinIntentMetadata객체 어레이
- nextToken
-
의도의 다음 페이지를 가져오기 위한 페이지 매김 토큰입니다. 이 API 직접 호출에 대한 응답이 잘린 경우, Amazon Lex는 응답에서 페이지 매김 토큰을 반환합니다. 의도의 다음 페이지를 가져오려면 다음 요청에서 페이지 매김 토큰을 지정하십시오.
유형: 문자열
Errors
- BadRequestException
-
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.
HTTP 상태 코드: 400
- InternalFailureException
-
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.
HTTP 상태 코드: 500
- LimitExceededException
-
요청이 한도를 초과했습니다. 다시 요청해 보세요.
HTTP 상태 코드: 429
참고 항목
언어별 AWS SDKs