기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.