StartImport - Amazon Lex V1

Amazon Lex V2를 사용하는 경우 Amazon Lex V2 가이드를 대신 참조하십시오.

 

Amazon Lex V1을 사용하는 경우 봇을 Amazon Lex V2로 업그레이드하는하는 것이 좋습니다. 더 이상 V1에 새로운 기능을 추가하지 않으므로 모든 새 봇에 V2를 사용할 것을 강력히 권장합니다.

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

StartImport

Amazon Lex로 리소스를 가져오는 작업을 시작합니다.

Request Syntax

POST /imports/ HTTP/1.1 Content-type: application/json { "mergeStrategy": "string", "payload": blob, "resourceType": "string", "tags": [ { "key": "string", "value": "string" } ] }

URI 요청 파라미터

요청은 URI 파라미터를 사용하지 않습니다.

요청 본문

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

mergeStrategy

이름이 같은 기존 리소스가 있는 경우 작업에서 수행해야 하는 StartImport 작업을 지정합니다.

  • FAIL_ON_CONFLICT - 가져오기 파일의 리소스와 기존 리소스 간의 첫 번째 충돌 시 가져오기 작업이 중지됩니다. 충돌을 일으키는 리소스 이름은 GetImport 작업에 대한 응답 failureReason 필드에 있습니다.

    OVERWRITE_LATEST - 기존 리소스와 충돌이 있더라도 가져오기 작업이 진행됩니다. 기존 리소스의 $LASTEST 버전을 가져오기 파일의 데이터로 덮어씁니다.

타입: 문자열

유효 값: OVERWRITE_LATEST | FAIL_ON_CONFLICT

필수 사항 여부: 예

payload

바이너리 포맷의 zip 아카이브입니다. 아카이브에는 가져올 리소스가 들어 있는 JSON 파일 한 개가 포함되어야 합니다. 리소스는 resourceType 필드에 지정된 유형과 일치해야 합니다.

타입: Base64로 인코딩된 이진 데이터 객체

필수 여부: 예

resourceType

내보내기 할 리소스 매핑의 유형을 지정합니다. 또한 각 리소스는 해당 리소스가 종속된 모든 리소스를 내보냅니다.

  • 봇은 종속 의도를 내보냅니다.

  • 의도는 종속 슬롯 유형을 내보냅니다.

타입: 문자열

유효 값: BOT | INTENT | SLOT_TYPE

필수 사항 여부: 예

tags

봇에 추가할 태그의 목록입니다. 봇을 가져올 때만 태그를 추가할 수 있으며 의도 또는 슬롯 유형에는 태그를 추가할 수 없습니다.

유형: Tag객체 어레이

어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.

필수 여부: 아니요

응답 구문

HTTP/1.1 201 Content-type: application/json { "createdDate": number, "importId": "string", "importStatus": "string", "mergeStrategy": "string", "name": "string", "resourceType": "string", "tags": [ { "key": "string", "value": "string" } ] }

응답 요소

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

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

createdDate

가져오기 작업이 요청된 날짜와 시간에 대한 타임스탬프입니다.

유형: 타임스탬프

importId

특정 가져오기 작업의 식별자입니다.

타입: 문자열

importStatus

가져오기 작업의 상태입니다. 상태가 FAILED 인 경우 GetImport 작업을 사용하여 실패 원인을 확인할 수 있습니다.

타입: 문자열

유효 값: IN_PROGRESS | COMPLETE | FAILED

mergeStrategy

병합 충돌 발생 시 실행할 작업입니다.

타입: 문자열

유효 값: OVERWRITE_LATEST | FAIL_ON_CONFLICT

name

가져오기 작업의 이름입니다.

유형: 문자열

길이 제약: 최소 길이는 1. 최대 길이는 100.

패턴: [a-zA-Z_]+

resourceType

가져올 리소스의 유형.

타입: 문자열

유효 값: BOT | INTENT | SLOT_TYPE

tags

가져온 봇에 추가된 태그의 목록입니다.

유형: Tag객체 어레이

어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.

Errors

BadRequestException

요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.

HTTP 상태 코드: 400

InternalFailureException

내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.

HTTP 상태 코드: 500

LimitExceededException

요청이 한도를 초과했습니다. 다시 요청해 보세요.

HTTP 상태 코드: 429

참고 항목

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