Amazon Lex V2를 사용하는 경우 Amazon Lex V2 가이드를 대신 참조하십시오.
Amazon Lex V1을 사용하는 경우 봇을 Amazon Lex V2로 업그레이드하는하는 것이 좋습니다. 더 이상 V1에 새로운 기능을 추가하지 않으므로 모든 새 봇에 V2를 사용할 것을 강력히 권장합니다.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
GetMigration
Amazon Lex V1 봇에서 Amazon Lex V2 봇으로의 진행 중인 또는 전체 마이그레이션에 대한 세부 정보를 제공합니다. 이 작업을 사용하면 마이그레이션과 관련된 마이그레이션 알림 및 경고를 볼 수 있습니다.
Request Syntax
GET /migrations/migrationId
HTTP/1.1
URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
- migrationId
-
조회할 마이그레이션의 고유 식별자입니다. StartMigration 작업에서
migrationID
가 반환됩니다.길이 제약 조건: 고정 길이는 10.
패턴:
^[0-9a-zA-Z]+$
필수 사항 여부: Yes
Request Body
해당 요청에는 본문이 없습니다.
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"alerts": [
{
"details": [ "string" ],
"message": "string",
"referenceURLs": [ "string" ],
"type": "string"
}
],
"migrationId": "string",
"migrationStatus": "string",
"migrationStrategy": "string",
"migrationTimestamp": number,
"v1BotLocale": "string",
"v1BotName": "string",
"v1BotVersion": "string",
"v2BotId": "string",
"v2BotRole": "string"
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- alerts
-
Amazon Lex V1 봇을 Amazon Lex V2로 마이그레이션할 때 발생하는 문제를 나타내는 경고 및 경고 목록입니다. Amazon Lex V2에서 Amazon Lex V1 기능이 다르게 구현되면 경고 메시지가 표시됩니다.
자세한 내용은 Amazon Lex V2 개발자 가이드의 봇 마이그레이션을 참조하십시오.
유형: MigrationAlert객체 어레이
- migrationId
-
마이그레이션의 고유 식별자입니다.
GetMigration
작업을 호출할 때 사용되는 식별자와 동일합니다.타입: 문자열
길이 제약 조건: 고정 길이는 10.
패턴:
^[0-9a-zA-Z]+$
- migrationStatus
-
마이그레이션 상태를 나타냅니다. 상태
COMPLETE
이 되면 마이그레이션이 완료되고 Amazon Lex V2에서 봇을 사용할 수 있게 됩니다. 마이그레이션을 완료하기 위해 해결해야 하는 알림 및 경고가 있을 수 있습니다.타입: 문자열
유효 값:
IN_PROGRESS | COMPLETED | FAILED
- migrationStrategy
-
마이그레이션을 수행하는 데 사용된 전략.
-
CREATE_NEW
- 새 Amazon Lex V2 봇을 만들고 Amazon Lex V1 봇을 새 봇으로 마이그레이션합니다. -
UPDATE_EXISTING
- 기존 Amazon Lex V2 봇 메타데이터와 마이그레이션 중인 로캘을 덮어씁니다. Amazon Lex V2 봇의 다른 로캘은 변경되지 않습니다. 로캘이 존재하지 않는 경우 Amazon Lex V2 봇에 새 로캘이 생성됩니다.
타입: 문자열
유효 값:
CREATE_NEW | UPDATE_EXISTING
-
- migrationTimestamp
-
마이그레이션이 시작된 날짜와 시간.
유형: 타임스탬프
- v1BotLocale
-
Amazon Lex V2로 마이그레이션하려는 아마존 Lex V1 로캘의 이름.
타입: 문자열
유효 값:
de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR
- v1BotName
-
Amazon Lex V2로 마이그레이션하려는 아마존 Lex V1의 이름.
타입: 문자열
길이 제한: 최소 길이는 2. 최대 길이는 50.
패턴:
^([A-Za-z]_?)+$
- v1BotVersion
-
Amazon Lex V2로 마이그레이션하려는 Amazon Lex V1 버전.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴:
\$LATEST|[0-9]+
- v2BotId
-
Amazon Lex V1이 마이그레이션되는 대상 Amazon Lex V2 봇의 고유 식별자입니다.
타입: 문자열
길이 제약 조건: 고정 길이는 10.
패턴:
^[0-9a-zA-Z]+$
- v2BotRole
-
Amazon Lex가 Amazon Lex V2 봇을 실행하는 데 사용하는 IAM 역할.
타입: 문자열
길이 제약: 최소 길이는 20. 최대 길이는 2,048.
패턴:
^arn:[\w\-]+:iam::[\d]{12}:role/.+$
Errors
- BadRequestException
-
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.
HTTP 상태 코드: 400
- InternalFailureException
-
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.
HTTP 상태 코드: 500
- LimitExceededException
-
요청이 한도를 초과했습니다. 다시 요청해 보세요.
HTTP 상태 코드: 429
- NotFoundException
-
요청에 지정된 리소스를 찾을 수 없습니다. 리소스를 확인한 후 다시 시도하세요.
HTTP 상태 코드: 404
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.