StartImport - Amazon Lex V1
Sintaxis de la solicitudParámetros de solicitud del URICuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

Si utiliza Amazon Lex V2, consulte la guía de Amazon Lex V2.

 

Si utiliza Amazon Lex V1, le recomendamos que actualice los bots a Amazon Lex V2. Hemos dejado de agregar nuevas características a V1, por lo que recomendamos encarecidamente utilizar V2 para todos los nuevos bots.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

StartImport

Comienza un trabajo para importar un recurso a Amazon Lex.

Sintaxis de la solicitud

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

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

Parámetros de solicitud del URI

La solicitud no utiliza ningún parámetro de URI.

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

mergeStrategy

Especifica la acción que debe llevar a cabo la operación StartImport cuando hay un recurso con el mismo nombre.

  • FAIL_ON_CONFLICT: la operación de importación se detiene al detectarse el primer conflicto entre un recurso del archivo de importación y un recurso existente. El nombre del recurso que provoca el conflicto se encuentra en el campo failureReason de la respuesta a la operación GetImport.

    OVERWRITE_LATEST: la operación de importación continua aunque haya un conflicto con un recurso existente. La versión $LASTEST del recurso existente se sobreescribe con los datos del archivo de importación.

Tipo: cadena

Valores válidos: OVERWRITE_LATEST | FAIL_ON_CONFLICT

Obligatorio: sí

payload

Un archivo ZIP en formato binario. El archivo debe contener un archivo JSON que incluya el recurso que se va a importar. El recurso debe coincidir con el tipo especificado en el campo resourceType.

Tipo: objeto de datos binarios codificados en Base64

Obligatorio: sí

resourceType

Especifica el tipo de recurso que se va a exportar. Cada recurso exporta a su vez los recursos de los que depende.

  • Un bot exporta intenciones dependientes.

  • Una intención exporta los tipos de ranura dependientes.

Tipo: cadena

Valores válidos: BOT | INTENT | SLOT_TYPE

Obligatorio: sí

tags

Una lista de las etiquetas que se agregarán al bot importado. Solo puede agregar etiquetas cuando importa un bot. No puede agregar etiquetas a una intención o un tipo de ranura.

Tipo: matriz de objetos Tag

Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.

Obligatorio: no

Sintaxis de la respuesta

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 respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 201.

El servicio devuelve los datos siguientes en formato JSON.

createdDate

Una marca de tiempo para la fecha y hora en la que se solicitó el trabajo de importación.

Tipo: marca temporal

importId

El identificador de un trabajo de importación específico.

Tipo: cadena

importStatus

El estado del trabajo de importación. Si el estado es FAILED, puede consultar el motivo del fallo con la operación GetImport.

Tipo: cadena

Valores válidos: IN_PROGRESS | COMPLETE | FAILED

mergeStrategy

La acción que se debe llevar a cabo cuando se produce un conflicto de fusión.

Tipo: cadena

Valores válidos: OVERWRITE_LATEST | FAIL_ON_CONFLICT

name

El nombre asignado al trabajo de importación.

Tipo: string

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.

Patrón: [a-zA-Z_]+

resourceType

El tipo de recurso que se va a importar.

Tipo: cadena

Valores válidos: BOT | INTENT | SLOT_TYPE

tags

Una lista de las etiquetas agregadas al bot importado.

Tipo: matriz de objetos Tag

Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.

Errores

BadRequestException

La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.

Código de estado HTTP: 400

InternalFailureException

Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.

Código de estado HTTP: 500

LimitExceededException

La solicitud ha superado un límite. Intente volver a realizar la solicitud.

Código de estado HTTP: 429

Véase también

Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente: