ListIntents - Amazon Lex

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

ListIntents

지정된 기준에 맞는 의도의 목록을 가져옵니다.

요청 구문

POST /bots/botId/botversions/botVersion/botlocales/localeId/intents/ HTTP/1.1 Content-type: application/json { "filters": [ { "name": "string", "operator": "string", "values": [ "string" ] } ], "maxResults": number, "nextToken": "string", "sortBy": { "attribute": "string", "order": "string" } }

URI 요청 파라미터

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

botId

인텐트가 포함된 봇의 고유 식별자입니다.

길이 제약 조건: 고정 길이 10입니다.

Pattern: ^[0-9a-zA-Z]+$

: 필수 예

botVersion

인텐트가 포함된 봇 버전입니다.

길이 제약 조건: 최소 길이는 1이고, 최대 길이는 5입니다.

Pattern: ^(DRAFT|[0-9]+)$

: 필수 예

localeId

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

: 필수 예

요청 본문

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

filters

응답의 인텐트를 필터 사양과 일치하는 인텐트로 제한하는 데 사용되는 필터의 사양을 제공합니다. 필터링할 필터와 하나의 문자열만 지정할 수 있습니다.

Type: 배열IntentFilter사물

배열 멤버: 항목 수는 1개입니다.

: 필수 아니요

maxResults

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

Type: 정수

유효한 범위: 최소값 1. 최대값 1000입니다.

: 필수 아니요

nextToken

에서 응답이 필요한 경우ListIntents작업에 지정된 것보다 많은 결과가 포함되어 있습니다.maxResults매개 변수를 사용하면 토큰이 응답에서 반환됩니다.

반환된 토큰을nextTokena 매개 변수ListIntents은 결과의 다음 페이지를 반환하도록 요청합니다. 전체 결과 집합을 보려면ListIntents까지 가동nextToken응답에서 반환되는 값은 null입니다.

Type: 문자열

: 필수 아니요

sortBy

에서 응답의 정렬 순서를 결정합니다.ListIntents작업을 사용합니다. 의도 이름 또는 마지막으로 업데이트된 날짜별로 오름차순 또는 내림차순으로 정렬하도록 선택할 수 있습니다.

유형: IntentSortBy 객체

: 필수 아니요

응답 구문

HTTP/1.1 200 Content-type: application/json { "botId": "string", "botVersion": "string", "intentSummaries": [ { "description": "string", "inputContexts": [ { "name": "string" } ], "intentId": "string", "intentName": "string", "lastUpdatedDateTime": number, "outputContexts": [ { "name": "string", "timeToLiveInSeconds": number, "turnsToLive": number } ], "parentIntentSignature": "string" } ], "localeId": "string", "nextToken": "string" }

응답 요소

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

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

botId

인텐트가 포함된 봇의 식별자입니다.

Type: 문자열

길이 제약 조건: 고정 길이 10입니다.

Pattern: ^[0-9a-zA-Z]+$

botVersion

인텐트가 포함된 봇 버전입니다.

Type: 문자열

길이 제약 조건: 최소 길이는 1이고, 최대 길이는 5입니다.

Pattern: ^(DRAFT|[0-9]+)$

intentSummaries

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

Type: 배열IntentSummary사물

localeId

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

Type: 문자열

nextToken

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

Type: 문자열

오류

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

InternalServerException

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

HTTP 상태 코드: 500

ServiceQuotaExceededException

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

HTTP 상태 코드: 402

ThrottlingException

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

HTTP 상태 코드: 429

ValidationException

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

HTTP 상태 코드: 400

참고 항목

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