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
필수 사항 여부: 예
-
-
봇에 추가할 태그의 목록입니다. 봇을 가져올 때만 태그를 추가할 수 있으며 의도 또는 슬롯 유형에는 태그를 추가할 수 없습니다.
유형: 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
-
가져온 봇에 추가된 태그의 목록입니다.
유형: Tag객체 어레이
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.
Errors
- BadRequestException
-
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.
HTTP 상태 코드: 400
- InternalFailureException
-
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.
HTTP 상태 코드: 500
- LimitExceededException
-
요청이 한도를 초과했습니다. 다시 요청해 보세요.
HTTP 상태 코드: 429
참고 항목
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.