기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeBotLocale
봇이 특정 로케일에 대한 설정을 설명합니다.
요청 구문
GET /bots/botId/botversions/botVersion/botlocales/localeId/ HTTP/1.1
URI 요청 파라미터
요청은 다음의 URI 파라미터를 사용합니다.
- botId
-
로캘과 연결된 봇의 식별자입니다.
길이 제약: 고정 길이 10입니다.
Pattern:
^[0-9a-zA-Z]+$필수 사항: 예
- botVersion
-
로케일과 연결된 봇 버전의 식별자입니다.
길이 제약: 최소 길이는 1이고, 최대 길이는 5입니다.
Pattern:
^(DRAFT|[0-9]+)$필수 사항: 예
- localeId
-
설명할 로캘의 고유한 식별자입니다. 문자열은 지원되는 로케일 중 하나와 일치해야 합니다. 자세한 내용은 단원을 참조하십시오.지원되는 언어.
필수 사항: 예
요청 본문
요청에 요청 본문이 없습니다.
응답 구문
HTTP/1.1 200
Content-type: application/json
{
"botId": "string",
"botLocaleHistoryEvents": [
{
"event": "string",
"eventDate": number
}
],
"botLocaleStatus": "string",
"botVersion": "string",
"creationDateTime": number,
"description": "string",
"failureReasons": [ "string" ],
"intentsCount": number,
"lastBuildSubmittedDateTime": number,
"lastUpdatedDateTime": number,
"localeId": "string",
"localeName": "string",
"nluIntentConfidenceThreshold": number,
"recommendedActions": [ "string" ],
"slotTypesCount": number,
"voiceSettings": {
"engine": "string",
"voiceId": "string"
}
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- botId
-
로캘과 연결된 봇의 식별자입니다.
Type: 문자열
길이 제약: 고정 길이 10입니다.
Pattern:
^[0-9a-zA-Z]+$ - botLocaleHistoryEvents
-
로케일에 대해 발생한 로캘이 별칭에 사용되는 경우와 같이 변경 내역
Type: 배열 배열BotLocaleHistoryEvent사물
- botLocaleStatus
-
봇의 상태입니다. 상태가 인 경우
Failed실패의 이유는 다음과 같습니다.failureReasons필드.Type: 문자열
유효한 값:
Creating | Building | Built | ReadyExpressTesting | Failed | Deleting | NotBuilt | Importing | Processing - botVersion
-
로케일과 연결된 봇 버전의 식별자입니다.
Type: 문자열
길이 제약: 최소 길이는 1이고, 최대 길이는 5입니다.
Pattern:
^(DRAFT|[0-9]+)$ - creationDateTime
-
로캘이 생성된 날짜와 시간입니다.
Type: 타임스탬프
- description
-
로케일에 대한 설명입니다.
Type: 문자열
길이 제약: 최소 길이는 0입니다. 최대 길이는 200입니다.
- failureReasons
-
만약
botLocaleStatus입니다FailedAmazon Lex가 봇을 빌드하지 못한 이유를 설명합니다.Type: 문자열 배열
- intentsCount
-
로케일에 대해 정의된 인텐트 수입니다.
Type: 정수
- lastBuildSubmittedDateTime
-
구축을 위해 로캘을 마지막으로 제출한 날짜와 시간입니다.
Type: 타임스탬프
- lastUpdatedDateTime
-
로캘을 마지막으로 업데이트한 날짜와 시간입니다.
Type: 타임스탬프
- localeId
-
설명된 로캘의 고유한 식별자입니다.
Type: 문자열
- localeName
-
로케일의 이름입니다.
Type: 문자열
- nluIntentConfidenceThreshold
-
Amazon Lex가 다음 항목을 삽입하는 신뢰 임계값
AMAZON.FallbackIntent과AMAZON.KendraSearchIntent발언에 사용할 수 있는 인텐트 목록에 있는 의도가 있습니다.Type: Double
유효한 범위: 최소값 0. 최대값은 1입니다.
- recommendedActions
-
에서 오류를 해결하기 위해 취해야 할 권장 조치
failureReasons필드.Type: 문자열 배열
- slotTypesCount
-
로케일에 대해 정의된 슬롯 유형 수입니다.
Type: 정수
- voiceSettings
-
Amazon Polly 음성 Amazon Lex는 사용자와의 음성 상호 작용에 사용합니다.
유형: VoiceSettings 객체
오류
모든 작업에 공통적인 오류에 대한 자세한 내용은 단원을 참조하십시오.일반적인 오류.
- InternalServerException
-
서비스에 예상치 못한 조건이 발생했습니다. 요청을 다시 시도하십시오.
HTTP 상태 코드: 500
- ResourceNotFoundException
-
리소스를 설명하도록 요청했습니다. 요청하는 리소스를 확인하고 다시 시도하십시오.
HTTP 상태 코드: 404
- ServiceQuotaExceededException
-
봇에 대한 할당량에 도달했습니다.
HTTP 상태 코드: 402
- ThrottlingException
-
요청량이 너무 높습니다. 요청 횟수를 줄입니다.
HTTP 상태 코드: 429
- ValidationException
-
요청의 입력 매개 변수 중 하나가 잘못되었습니다. 파라미터를 확인하고 요청을 다시 시도하십시오.
HTTP 상태 코드: 400
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
