기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CreateExport
봇 또는 봇 로케일의 내용을 포함하는 zip 아카이브를 만듭니다. 아카이브에는 봇을 정의하는 JSON 파일이 들어 있는 디렉토리 구조가 포함되어 있습니다.
봇의 전체 정의를 포함하는 아카이브를 만들거나 아카이브에 단일 봇 로케일의 정의만 포함하도록 지정할 수 있습니다.
봇 내보내기에 대한 자세한 내용과 내보내기 아카이브의 구조에 대한 자세한 내용은 단원을 참조하세요.봇 가져오기 및 내보내기
요청 구문
PUT /exports/ HTTP/1.1
Content-type: application/json
{
"fileFormat": "string
",
"filePassword": "string
",
"resourceSpecification": {
"botExportSpecification": {
"botId": "string
",
"botVersion": "string
"
},
"botLocaleExportSpecification": {
"botId": "string
",
"botVersion": "string
",
"localeId": "string
"
},
"customVocabularyExportSpecification": {
"botId": "string
",
"botVersion": "string
",
"localeId": "string
"
}
}
}
URI 요청 파라미터
요청은 URI 파라미터를 사용하지 않습니다.
요청 본문
요청은 JSON 형식의 다음 데이터를 받습니다.
- fileFormat
-
봇 또는 봇 로캘 정의 파일의 파일 형식입니다.
Type: 문자열
유효한 값:
LexJson | TSV
: 필수 예
- filePassword
-
내보낸 아카이브를 암호화하는 데 사용할 암호입니다. 암호 사용은 선택 사항이지만 Amazon Lex와 로컬 컴퓨터 간에 전송되는 데이터를 보호하려면 아카이브를 암호화해야 합니다.
Type: 문자열
길이 제약 조건: 최소 길이는 1이고, 최대 길이는 1,024입니다.
: 필수 아니요
- resourceSpecification
-
내보낼 리소스 유형 (봇 또는 봇 로케일) 을 지정합니다. 내보내기를 1개씩만 지정할 수 있습니다.
유형: ExportResourceSpecification 객체
: 필수 예
응답 구문
HTTP/1.1 202
Content-type: application/json
{
"creationDateTime": number,
"exportId": "string",
"exportStatus": "string",
"fileFormat": "string",
"resourceSpecification": {
"botExportSpecification": {
"botId": "string",
"botVersion": "string"
},
"botLocaleExportSpecification": {
"botId": "string",
"botVersion": "string",
"localeId": "string"
},
"customVocabularyExportSpecification": {
"botId": "string",
"botVersion": "string",
"localeId": "string"
}
}
}
응답 요소
작업이 성공하면 서비스가 HTTP 202 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- creationDateTime
-
봇 내보내기 요청이 생성된 날짜와 시간입니다.
Type: 타임스탬프
- exportId
-
내보내기를 작성하기 위한 특정 요청에 대한 식별자입니다.
Type: 문자열
길이 제약 조건: 고정 길이 10입니다.
Pattern:
^[0-9a-zA-Z]+$
- exportStatus
-
내보내기의 상태입니다. 상태가 다음과 같을 때
Completed
의 경우 을 사용할 수 있습니다.설명내보내기내보낸 봇 또는 봇 로캘에 대한 사전 서명된 S3 URL 링크를 가져오는 작업입니다.Type: 문자열
유효한 값:
InProgress | Completed | Failed | Deleting
- fileFormat
-
봇 또는 봇 로캘 정의 파일에 사용되는 파일 형식입니다.
Type: 문자열
유효한 값:
LexJson | TSV
- resourceSpecification
-
내보낸 리소스 유형 (봇 또는 봇 로케일) 에 대한 설명입니다.
유형: ExportResourceSpecification 객체
오류
모든 작업에 공통적인 오류에 대한 자세한 내용은 단원을 참조하십시오.일반적인 오류.
- ConflictException
-
리소스가 충돌하는 상태이므로 수행하려고 시도한 작업을 완료할 수 없습니다. 예를 들어 CREATING 상태에 있는 봇을 삭제할 수 있습니다. 요청을 다시 시도하십시오.
HTTP 상태 코드: 409
- InternalServerException
-
서비스에 예상치 못한 조건이 발생했습니다. 요청을 다시 시도하십시오.
HTTP 상태 코드: 500
- ResourceNotFoundException
-
사용자가 존재하지 않는 리소스를 설명하도록 요청했습니다. 요청하는 리소스를 확인하고 다시 시도하십시오.
HTTP 상태 코드: 404
- ServiceQuotaExceededException
-
봇에 대한 할당량에 도달했습니다.
HTTP 상태 코드: 402
- ThrottlingException
-
요청량이 너무 높습니다. 요청 횟수를 줄입니다.
HTTP 상태 코드: 429
- ValidationException
-
요청의 입력 매개 변수 중 하나가 잘못되었습니다. 파라미터를 확인하고 요청을 다시 시도하십시오.
HTTP 상태 코드: 400
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.