GetMigration - Amazon Lex V1
Sintaxe da SolicitaçãoParâmetros da Solicitação de URICorpo da SolicitaçãoSintaxe da RespostaElementos de RespostaErrosConsulte Também

Se você estiver usando o Amazon Lex V2, consulte o Guia do Amazon Lex V2.

 

Se você estiver usando o Amazon Lex V1, recomendamos atualizar seus bots para o Amazon Lex V2. Não estamos mais adicionando novos atributos à V1 e recomendamos o uso da V2 para todos os novos bots.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

GetMigration

Fornece detalhes sobre uma migração contínua ou completa de um bot do Amazon Lex V1 para um bot do Amazon Lex V2. Use essa operação para visualizar os alertas e avisos de migração relacionados à migração.

Sintaxe da Solicitação

GET /migrations/migrationId HTTP/1.1

Parâmetros da Solicitação de URI

A solicitação usa os seguintes parâmetros de URI:

migrationId

O identificador exclusivo da migração a ser visualizada. O migrationID é retornado pela operação StartMigration.

Restrições de tamanho: tamanho fixo de 10.

Padrão: ^[0-9a-zA-Z]+$

Exigido: Sim

Corpo da Solicitação

Essa solicitação não tem corpo.

Sintaxe da Resposta

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"
}

Elementos de Resposta

Se a ação tiver êxito, o serviço enviará de volta uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

alerts

Uma lista de alertas e avisos que indicam problemas com a migração do bot do Amazon Lex V1 para o Amazon Lex V2. Você recebe um aviso quando um atributo do Amazon Lex V1 tem uma implementação diferente no Amazon Lex V2.

Para obter mais informações, consulte Migração de um bot no Guia do desenvolvedor do Amazon Lex V2.

Tipo: matriz de objetos MigrationAlert

migrationId

O identificador exclusivo da migração. É o mesmo identificador usado ao chamar a operação GetMigration.

Tipo: String

Restrições de tamanho: tamanho fixo de 10.

Padrão: ^[0-9a-zA-Z]+$

migrationStatus

Indica o status da migração. Quando o status é COMPLETE, a migração é concluída e o bot está disponível no Amazon Lex V2. Pode haver alertas e avisos que precisem ser resolvidos para concluir a migração.

Tipo: String

Valores Válidos: IN_PROGRESS | COMPLETED | FAILED

migrationStrategy

A estratégia usada para conduzir a migração.

  • CREATE_NEW - Cria um novo bot do Amazon Lex V2 e migra o bot do Amazon Lex V1 para o novo bot.

  • UPDATE_EXISTING - Substitui os metadados existentes do bot do Amazon Lex V2 e a localidade que está sendo migrada. Isso não altera nenhuma outra localidade no bot do Amazon Lex V2. Se a localidade não existir, uma nova localidade será criada no bot do Amazon Lex V2.

Tipo: String

Valores Válidos: CREATE_NEW | UPDATE_EXISTING

migrationTimestamp

A data e hora em que a migração foi iniciada.

Tipo: Carimbo de data/hora

v1BotLocale

A localidade do bot do Amazon Lex V1 foi migrada para o Amazon Lex V2.

Tipo: String

Valores Válidos: 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

O nome do bot do Amazon Lex V1 foi migrado para o Amazon Lex V2.

Tipo: String

Restrições de tamanho: tamanho mínimo 2. Tamanho máximo de 50.

Padrão: ^([A-Za-z]_?)+$

v1BotVersion

A versão do bot do Amazon Lex V1 foi migrado para o Amazon Lex V2.

Tipo: String

Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.

Padrão: \$LATEST|[0-9]+

v2BotId

O identificador exclusivo do bot do Amazon Lex V2 para o qual o Amazon Lex V1 está sendo migrado.

Tipo: String

Restrições de tamanho: tamanho fixo de 10.

Padrão: ^[0-9a-zA-Z]+$

v2BotRole

O perfil do IAM que o Amazon Lex usa para executar a versão do bot do Amazon Lex V2.

Tipo: String

Restrições de tamanho: tamanho mínimo 20. Tamanho máximo de 2.048.

Padrão: ^arn:[\w\-]+:iam::[\d]{12}:role/.+$

Erros

BadRequestException

A solicitação não está bem formada. Por exemplo, um valor é inválido ou um campo obrigatório está faltando. Verifique os valores dos campos e tente novamente.

Código de Status HTTP: 400

InternalFailureException

Ocorreu um erro interno do Amazon Lex. Tente sua solicitação novamente.

Código de Status HTTP: 500

LimitExceededException

A solicitação excedeu um limite. Tente sua solicitação novamente.

Código de Status HTTP: 429

NotFoundException

O atributo especificado na solicitação não foi encontrado. Verifique o atributo e tente novamente.

Código de Status HTTP: 404

Consulte Também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte: