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

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"
                        }
                     }
                  ]
               }
            ]
         }
      }
   ]
}