StartImport - Amazon Lex V1
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

Si vous utilisez Amazon Lex V2, consultez plutôt le guide Amazon Lex V2.

 

Si vous utilisez Amazon Lex V1, nous vous recommandons de mettre à niveau vos robots vers Amazon Lex V2. Nous n'ajoutons plus de nouvelles fonctionnalités à la V1 et recommandons vivement d'utiliser la V2 pour tous les nouveaux robots.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

StartImport

Démarre une tâche pour importer une ressource dans Amazon Lex.

Syntaxe de la demande

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

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

Paramètres de demande URI

La demande n’utilise pas de paramètres URI.

Corps de la demande

Cette demande accepte les données suivantes au format JSON.

mergeStrategy

Spécifie l'action que l'StartImportopération doit effectuer lorsqu'il existe une ressource portant le même nom.

  • FAIL_ON_CONFLICT - L'opération d'importation est arrêtée lors du premier conflit entre une ressource du fichier d'importation et une ressource existante. Le nom de la ressource à l'origine du conflit figure dans le failureReason champ de réponse à l'GetImportopération.

    OVERWRITE_LATEST - L'opération d'importation se poursuit même en cas de conflit avec une ressource existante. La version $LASTEST de la ressource existante est remplacée par les données du fichier d'importation.

Type : chaîne

Valeurs valides : OVERWRITE_LATEST | FAIL_ON_CONFLICT

Obligatoire : oui

payload

Une archive zip au format binaire. L'archive doit contenir un fichier, un fichier JSON contenant la ressource à importer. La ressource doit correspondre au type indiqué dans le resourceType champ.

Type : objet de données binaires encodées en base64

Obligatoire : oui

resourceType

Spécifie le type de ressource à exporter. Chaque ressource exporte également les ressources dont elle dépend.

  • Un bot exporte des intentions dépendantes.

  • Une intention exporte les types d'emplacements dépendants.

Type : chaîne

Valeurs valides : BOT | INTENT | SLOT_TYPE

Obligatoire : oui

tags

Liste des balises à ajouter au bot importé. Vous ne pouvez ajouter des balises que lorsque vous importez un bot, vous ne pouvez pas ajouter de balises à une intention ou à un type d'emplacement.

Type : tableau d’objets Tag

Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.

Obligatoire : non

Syntaxe de la réponse

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

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 201.

Les données suivantes sont renvoyées au format JSON par le service.

createdDate

Horodatage de la date et de l'heure auxquelles la tâche d'importation a été demandée.

Type : Timestamp

importId

Identifiant de la tâche d'importation spécifique.

Type : chaîne

importStatus

État de la tâche d'importation. Si le statut est le casFAILED, vous pouvez obtenir la raison de l'échec à l'aide de l'GetImportopération.

Type : chaîne

Valeurs valides : IN_PROGRESS | COMPLETE | FAILED

mergeStrategy

Action à entreprendre en cas de conflit de fusion.

Type : chaîne

Valeurs valides : OVERWRITE_LATEST | FAIL_ON_CONFLICT

name

Nom attribué à la tâche d'importation.

Type : chaîne

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 100.

Modèle : [a-zA-Z_]+

resourceType

Type de ressource à importer.

Type : chaîne

Valeurs valides : BOT | INTENT | SLOT_TYPE

tags

Liste des balises ajoutées au bot importé.

Type : tableau d’objets Tag

Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.

Erreurs

BadRequestException

La demande n'est pas bien formulée. Par exemple, une valeur n'est pas valide ou un champ obligatoire est manquant. Vérifiez les valeurs des champs, puis réessayez.

Code d’état HTTP : 400

InternalFailureException

Une erreur interne Amazon Lex s'est produite. Réessayez votre demande.

Code d’état HTTP : 500

LimitExceededException

La demande a dépassé une limite. Réessayez votre demande.

Code d’état HTTP : 429

consultez aussi

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :