기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CreateBotVersion
다음을 기반으로 새 버전의 봇을 생성합니다.DRAFT
버전입니다. 만약DRAFT
이 리소스의 버전은 마지막 버전을 생성한 이후 변경되지 않았습니다. Amazon Lex는 새 버전을 생성하지 않고 마지막으로 생성된 버전을 반환합니다.
봇의 첫 번째 버전을 생성할 때 Amazon Lex는 버전을 1로 설정합니다. 후속 버전은 1씩 증가합니다.
요청 구문
PUT /bots/botId
/botversions/ HTTP/1.1
Content-type: application/json
{
"botVersionLocaleSpecification": {
"string
" : {
"sourceBotVersion": "string
"
}
},
"description": "string
"
}
URI 요청 파라미터
요청은 다음의 URI 파라미터를 사용합니다.
- botId
-
버전을 생성할 봇의 식별자입니다.
길이 제약 조건: 고정 길이 10입니다.
Pattern:
^[0-9a-zA-Z]+$
: 필수 사항 예
요청 본문
요청은 JSON 형식의 다음 데이터를 받습니다.
- botVersionLocaleSpecification
-
Amazon Lex가 이 버전에 추가하는 로캘을 지정합니다. 선택 항목
Draft
버전 또는 각 로케일에 대해 이전에 게시된 다른 버전입니다. 소스 버전을 지정하면 로캘 데이터가 소스 버전에서 새 버전으로 복사됩니다.Type: 문자열BotVersionLocaleDetails오브젝트 맵
맵 항목: 최대 항목 수입니다.
: 필수 사항 예
- description
-
버전에 대한 설명입니다. 목록에서 버전을 식별하기 위해 설명을 사용합니다.
Type: 문자열
길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 200입니다.
: 필수 사항 아니요
응답 구문
HTTP/1.1 202
Content-type: application/json
{
"botId": "string",
"botStatus": "string",
"botVersion": "string",
"botVersionLocaleSpecification": {
"string" : {
"sourceBotVersion": "string"
}
},
"creationDateTime": number,
"description": "string"
}
응답 요소
작업이 성공하면 서비스가 HTTP 202 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- botId
-
요청에 지정된 봇 식별자입니다.
Type: 문자열
길이 제약 조건: 고정 길이 10입니다.
Pattern:
^[0-9a-zA-Z]+$
- botStatus
-
봇을 생성하거나 업데이트하라는 요청을 보내면 Amazon Lex는 상태 응답 요소를 다음으로 설정합니다.
Creating
. Amazon Lex가 봇을 빌드한 후 상태를 로 설정합니다.Available
. Amazon Lex가 봇을 빌드할 수 없으면 상태가 로 설정됩니다.Failed
.Type: 문자열
유효한 값:
Creating | Available | Inactive | Deleting | Failed | Versioning | Importing
- botVersion
-
버전에 할당된 버전 번호입니다.
Type: 문자열
길이 제약 조건: 최소 길이는 1이고, 최대 길이 5자입니다.
Pattern:
^[0-9]+$
- botVersionLocaleSpecification
-
새 버전의 각 로캘에 사용되는 소스 버전입니다.
Type: 문자열BotVersionLocaleDetails오브젝트 맵
맵 항목: 최대 항목 수입니다.
- creationDateTime
-
버전이 생성된 날짜와 시간의 타임스탬프입니다.
Type: 타임스탬프
- description
-
요청에 지정된 버전에 대한 설명입니다.
Type: 문자열
길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 200입니다.
오류
모든 작업에 공통적인 오류에 대한 자세한 내용은 단원을 참조하십시오.일반적인 오류.
- ConflictException
-
리소스가 충돌하는 상태이므로 수행하려고 시도한 작업을 완료할 수 없습니다. 예를 들어 CREATING 상태에 있는 봇을 삭제할 수 있습니다. 요청을 다시 시도하십시오.
HTTP 상태 코드: 409
- InternalServerException
-
서비스에 예상치 못한 조건이 발생했습니다. 요청을 다시 시도하십시오.
HTTP 상태 코드: 500
- PreconditionFailedException
-
하나 이상의 요청 필드가 유효하지 않기 때문에 요청을 완료할 수 없습니다. 요청의 필드를 확인하고 다시 시도하십시오.
HTTP 상태 코드: 412
- ServiceQuotaExceededException
-
봇에 대한 할당량에 도달했습니다.
HTTP 상태 코드: 402
- ThrottlingException
-
요청량이 너무 높습니다. 요청 횟수를 줄입니다.
HTTP 상태 코드: 429
- ValidationException
-
요청의 입력 매개 변수 중 하나가 잘못되었습니다. 파라미터를 확인하고 요청을 다시 시도하십시오.
HTTP 상태 코드: 400
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.