StartImport - 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á.

StartImport

Inicia um trabalho para importar um recurso para o Amazon Lex.

Sintaxe da Solicitação

POST /imports/ HTTP/1.1
Content-type: application/json

{
   "mergeStrategy": "string",
   "payload": blob,
   "resourceType": "string",
   "tags": [ 
      { 
         "key": "string",
         "value": "string"
      }
   ]
}

Parâmetros da solicitação de URI

A solicitação não usa nenhum parâmetro de URI.

Corpo da Solicitação

A solicitação aceita os dados a seguir no formato JSON.

mergeStrategy

Especifica a ação que a operação StartImport deve realizar quando há um recurso existente com o mesmo nome.

  • FAIL_ON_CONFLICT - A operação de importação é interrompida no primeiro conflito entre um atributo no arquivo de importação e um atributo existente. O nome do atributo que está causando o conflito está no campo failureReason da resposta à operação GetImport.

    OVERWRITE_LATEST - A operação de importação prossegue mesmo se houver um conflito com um atributo existente. A versão $LASTEST do atributo existente é substituída pelos dados do arquivo de importação.

Tipo: String

Valores Válidos: OVERWRITE_LATEST | FAIL_ON_CONFLICT

Obrigatório: Sim

payload

Um arquivo zip em formato binário. O arquivo deve conter um arquivo, um arquivo JSON que contém o atributo a ser importado. O atributo deve corresponder ao tipo especificado no campo resourceType.

Tipo: Objeto de dados binários codificado em Base64

Obrigatório: Sim

resourceType

Especifica o tipo de atributo a ser exportado. Cada atributo também exporta todos os atributos dos quais ele depende.

  • Um bot exporta intenções dependentes.

  • Uma intenção exporta os tipos de slots dependentes.

Tipo: String

Valores Válidos: BOT | INTENT | SLOT_TYPE

Obrigatório: Sim

tags

Uma lista de tags a serem adicionadas ao bot importado. Apenas é possível adicionar tags ao importar um bot. Não é possível adicionar tags a uma intenção ou tipo de slot.

Tipo: matriz de objetos Tag

Membros da Matriz: número mínimo de 0 itens. Número máximo de 200 itens.

Obrigatório: Não

Sintaxe da Resposta

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

Elementos de Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 201.

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

createdDate

Um carimbo de data e hora para a data e a hora em que a tarefa de importação foi solicitada.

Tipo: Timestamp

importId

O identificador para a tarefa de importação específica.

Tipo: String

importStatus

O status do trabalho de importação. Se o status for FAILED, você poderá obter o motivo da falha usando a operação GetImport.

Tipo: String

Valores Válidos: IN_PROGRESS | COMPLETE | FAILED

mergeStrategy

A ação a ser executada quando houver um conflito de fusão.

Tipo: String

Valores Válidos: OVERWRITE_LATEST | FAIL_ON_CONFLICT

name

O nome dado ao trabalho de importação.

Tipo: String

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 100.

Padrão: [a-zA-Z_]+

resourceType

O tipo do recurso a ser importado.

Tipo: String

Valores Válidos: BOT | INTENT | SLOT_TYPE

tags

Uma lista de tags a serem adicionadas ao bot importado.

Tipo: matriz de objetos Tag

Membros da Matriz: número mínimo de 0 itens. Número máximo de 200 itens.

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

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: