Avis de fin de support : le 15 septembre 2025, le support pour Amazon Lex V1 AWS sera interrompu. Après le 15 septembre 2025, vous ne pourrez plus accéder à la console Amazon Lex V1 ni aux ressources Amazon Lex V1. Si vous utilisez Amazon Lex V2, consultez plutôt le [guide Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). 

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
<a name="API_StartImport"></a>

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

## Syntaxe de la demande
<a name="API_StartImport_RequestSyntax"></a>

```
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
<a name="API_StartImport_RequestParameters"></a>

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

## Corps de la demande
<a name="API_StartImport_RequestBody"></a>

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

 ** [mergeStrategy](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-mergeStrategy"></a>
Spécifie l'action que l'`StartImport`opération doit effectuer lorsqu'il existe une ressource portant le même nom.  
+ FAIL\$1ON\$1CONFLICT - 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 se trouve dans le `failureReason` champ de réponse à l'`GetImport`opération.

  OVERWRITE\$1LATEST - L'opération d'importation se poursuit même en cas de conflit avec une ressource existante. La version \$1LASTEST 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](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-payload"></a>
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](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-resourceType"></a>
Spécifie le type de ressource à exporter. Chaque ressource exporte également toutes 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](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-tags"></a>
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](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_StartImport_ResponseSyntax"></a>

```
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
<a name="API_StartImport_ResponseElements"></a>

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](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-createdDate"></a>
Horodatage de la date et de l'heure auxquelles la tâche d'importation a été demandée.  
Type : Timestamp

 ** [importId](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-importId"></a>
Identifiant de la tâche d'importation spécifique.  
Type : Chaîne

 ** [importStatus](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-importStatus"></a>
État de la tâche d'importation. Si le statut est le cas`FAILED`, vous pouvez obtenir la raison de l'échec à l'aide de l'`GetImport`opération.  
Type : Chaîne  
Valeurs valides : `IN_PROGRESS | COMPLETE | FAILED` 

 ** [mergeStrategy](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-mergeStrategy"></a>
L'action à entreprendre en cas de conflit de fusion.  
Type : Chaîne  
Valeurs valides : `OVERWRITE_LATEST | FAIL_ON_CONFLICT` 

 ** [name](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-name"></a>
Le nom donné à 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](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-resourceType"></a>
Type de ressource à importer.  
Type : Chaîne  
Valeurs valides : `BOT | INTENT | SLOT_TYPE` 

 ** [tags](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-tags"></a>
Liste des balises ajoutées au bot importé.  
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.

## Erreurs
<a name="API_StartImport_Errors"></a>

 ** 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

## Voir aussi
<a name="API_StartImport_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/StartImport) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/StartImport) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/StartImport) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/StartImport) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/StartImport) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/StartImport) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/StartImport)