ListSlots - Amazon Lex

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

ListSlots

지정된 기준과 일치하는 슬롯 목록을 가져옵니다.

요청 구문

POST /bots/botId/botversions/botVersion/botlocales/localeId/intents/intentId/slots/ 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]+)$

: 필수 예

intentId

슬롯을 포함하는 인텐트의 고유 식별자입니다.

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

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

: 필수 예

localeId

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

: 필수 예

요청 본문

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

filters

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

Type: 배열SlotFilter사물

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

: 필수 아니요

maxResults

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

Type: 정수

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

: 필수 아니요

nextToken

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

Type: 문자열

: 필수 아니요

sortBy

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

유형: SlotSortBy 객체

: 필수 아니요

응답 구문

HTTP/1.1 200 Content-type: application/json { "botId": "string", "botVersion": "string", "intentId": "string", "localeId": "string", "nextToken": "string", "slotSummaries": [ { "description": "string", "lastUpdatedDateTime": number, "slotConstraint": "string", "slotId": "string", "slotName": "string", "slotTypeId": "string", "valueElicitationPromptSpecification": { "allowInterrupt": boolean, "maxRetries": number, "messageGroups": [ { "message": { "customPayload": { "value": "string" }, "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" }, "plainTextMessage": { "value": "string" }, "ssmlMessage": { "value": "string" } }, "variations": [ { "customPayload": { "value": "string" }, "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" }, "plainTextMessage": { "value": "string" }, "ssmlMessage": { "value": "string" } } ] } ] } } ] }

응답 요소

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

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

botId

슬롯이 포함된 봇의 식별자입니다.

Type: 문자열

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

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

botVersion

슬롯이 포함된 봇의 버전입니다.

Type: 문자열

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

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

intentId

슬롯을 포함하는 인텐트의 식별자입니다.

Type: 문자열

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

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

localeId

목록에 있는 슬롯의 언어 및 로캘입니다.

Type: 문자열

nextToken

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

Type: 문자열

slotSummaries

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

Type: 배열SlotSummary사물

오류

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

InternalServerException

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

HTTP 상태 코드: 500

ServiceQuotaExceededException

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

HTTP 상태 코드: 402

ThrottlingException

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

HTTP 상태 코드: 429

ValidationException

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

HTTP 상태 코드: 400

참고 항목

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