StartImport - Amazon Lex V1

지원 종료 공지: 2025년 9월 15 AWS 일에는 Amazon Lex V1에 대한 지원을 중단합니다. 2025년 9월 15일 이후에는 Amazon Lex V1 콘솔 또는 Amazon Lex V1 리소스에 더 이상 액세스할 수 없습니다. Amazon Lex V2를 사용하는 경우 대신 Amazon Lex 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.

Pattern: [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 SDKs