StartImport - Amazon Lex

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

StartImport

S3 버킷에 업로드한 zip 아카이브에서 봇, 봇 로캘 또는 사용자 지정 어휘 가져오기를 시작합니다.

요청 구문

PUT /imports/ HTTP/1.1 Content-type: application/json { "filePassword": "string", "importId": "string", "mergeStrategy": "string", "resourceSpecification": { "botImportSpecification": { "botName": "string", "botTags": { "string" : "string" }, "dataPrivacy": { "childDirected": boolean }, "idleSessionTTLInSeconds": number, "roleArn": "string", "testBotAliasTags": { "string" : "string" } }, "botLocaleImportSpecification": { "botId": "string", "botVersion": "string", "localeId": "string", "nluIntentConfidenceThreshold": number, "voiceSettings": { "engine": "string", "voiceId": "string" } }, "customVocabularyImportSpecification": { "botId": "string", "botVersion": "string", "localeId": "string" } } }

URI 요청 파라미터

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

요청 본문

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

filePassword

리소스 정의를 포함하는 zip 아카이브를 암호화하는 데 사용되는 암호입니다. 사이트와 Amazon Lex 간에 전송하는 동안 zip 아카이브를 보호하려면 항상 zip 아카이브를 암호화해야 합니다.

Type: 문자열

길이 제약 조건: 최소 길이는 1이고, 최대 길이는 1,024입니다.

: 필수 아니요

importId

가져오기의 고유 식별자입니다. 응답에 포함되어 있습니다.크리에이트플로어URL작업.

Type: 문자열

길이 제약 조건: 고정 길이 10입니다.

Pattern: ^[0-9a-zA-Z]+$

: 필수 예

mergeStrategy

가져온 리소스와 기존 리소스 간에 이름이 충돌할 때 사용할 전략입니다. 병합 전략이 다음과 같은 경우FailOnConflict기존 리소스를 덮어쓰지 않고 가져오기가 실패합니다.

Type: 문자열

유효한 값: Overwrite | FailOnConflict | Append

: 필수 예

resourceSpecification

봇, 봇 로캘 또는 사용자 지정 어휘를 만들기 위한 매개 변수입니다.

유형: ImportResourceSpecification 객체

: 필수 예

응답 구문

HTTP/1.1 202 Content-type: application/json { "creationDateTime": number, "importId": "string", "importStatus": "string", "mergeStrategy": "string", "resourceSpecification": { "botImportSpecification": { "botName": "string", "botTags": { "string" : "string" }, "dataPrivacy": { "childDirected": boolean }, "idleSessionTTLInSeconds": number, "roleArn": "string", "testBotAliasTags": { "string" : "string" } }, "botLocaleImportSpecification": { "botId": "string", "botVersion": "string", "localeId": "string", "nluIntentConfidenceThreshold": number, "voiceSettings": { "engine": "string", "voiceId": "string" } }, "customVocabularyImportSpecification": { "botId": "string", "botVersion": "string", "localeId": "string" } } }

응답 요소

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

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

creationDateTime

가져오기 요청이 생성된 날짜와 시간입니다.

Type: 타임스탬프

importId

가져오기의 고유 식별자입니다.

Type: 문자열

길이 제약 조건: 고정 길이 10입니다.

Pattern: ^[0-9a-zA-Z]+$

importStatus

가져오기의 현재 상태. 상태가 다음과 같을 때Complete봇, 봇 별칭 또는 사용자 지정 어휘를 사용할 준비가 되었습니다.

Type: 문자열

유효한 값: InProgress | Completed | Failed | Deleting

mergeStrategy

가져온 리소스와 기존 리소스 간에 이름이 충돌했을 때 사용되는 전략입니다. 병합 전략이 다음과 같은 경우FailOnConflict기존 리소스를 덮어쓰지 않고 가져오기가 실패합니다.

Type: 문자열

유효한 값: Overwrite | FailOnConflict | Append

resourceSpecification

리소스를 가져올 때 사용되는 매개 변수입니다.

유형: ImportResourceSpecification 객체

오류

모든 작업에 공통적인 오류에 대한 자세한 내용은 단원을 참조하십시오.일반적인 오류.

ConflictException

리소스가 충돌하는 상태이므로 수행하려고 시도한 작업을 완료할 수 없습니다. 예를 들어 CREATING 상태에 있는 봇을 삭제할 수 있습니다. 요청을 다시 시도하십시오.

HTTP 상태 코드: 409

InternalServerException

서비스에 예상치 못한 조건이 발생했습니다. 요청을 다시 시도하십시오.

HTTP 상태 코드: 500

ResourceNotFoundException

사용자가 존재하지 않는 리소스를 설명하도록 요청했습니다. 요청하는 리소스를 확인하고 다시 시도하십시오.

HTTP 상태 코드: 404

ServiceQuotaExceededException

봇에 대한 할당량에 도달했습니다.

HTTP 상태 코드: 402

ThrottlingException

요청량이 너무 높습니다. 요청 횟수를 줄입니다.

HTTP 상태 코드: 429

ValidationException

요청의 입력 매개 변수 중 하나가 잘못되었습니다. 파라미터를 확인하고 요청을 다시 시도하십시오.

HTTP 상태 코드: 400

참고 항목

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