サポート終了通知: 2025 年 9 月 15 日、 AWS は Amazon Lex V1 のサポートを終了します。 V1 2025 年 9 月 15 日を過ぎると、Amazon Lex V1 コンソールまたは Amazon Lex V1 リソースにはアクセスできなくなります。Amazon Lex V2 を使用している場合は、代わりに [Amazon Lex V2 ガイド](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html)を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# StartImport
<a name="API_StartImport"></a>

リソースを Amazon Lex にインポートするジョブを開始します。

## リクエストの構文
<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"
      }
   ]
}
```

## URI リクエストパラメータ
<a name="API_StartImport_RequestParameters"></a>

リクエストでは URI パラメータを使用しません。

## リクエストボディ
<a name="API_StartImport_RequestBody"></a>

リクエストは以下の JSON 形式のデータを受け入れます。

 ** [mergeStrategy](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-mergeStrategy"></a>
同名の既存のリソースがある場合に、`StartImport` オペレーションが取るべきアクションを指定します。  
+ FAIL\$1ON\$1CONFLICT - インポートファイル内のリソースと既存のリソースが競合を起こした時点で、インポート作業を停止します。競合を起こしているリソース名は、`GetImport` オペレーションへのレスポンスの `failureReason` フィールドにあります。

  OVERWRITE\$1LATEST - 既存のリソースとの競合があっても、インポートオペレーションは続行されます。既存のリソースの \$1LASTEST バージョンは、インポートファイルのデータで上書きされます。
型: 文字列  
有効な値：`OVERWRITE_LATEST | FAIL_ON_CONFLICT`  
必須: はい

 ** [payload](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-payload"></a>
バイナリ形式の zip アーカイブ。アーカイブには、インポートするリソースを含む JSON ファイルが 1 つ含まれている必要があります。リソースは、`resourceType` フィールドで指定されたタイプと一致する必要があります。  
型: Base64 でエンコードされたバイナリデータオブジェクト  
必須: はい

 ** [resourceType](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-resourceType"></a>
エクスポートするリソースの種類を指定します。また、各リソースは、依存しているリソースもエクスポートします。  
+ ボットは、依存性を持つインテントをエクスポートします。
+ インテントは、依存するスロットタイプをエクスポートします。
型: 文字列  
有効な値：`BOT | INTENT | SLOT_TYPE`  
必須: はい

 ** [tags](#API_StartImport_RequestSyntax) **   <a name="lex-StartImport-request-tags"></a>
インポートされたボットに追加するタグのリスト。タグを追加できるのは、ボットをインポートするときだけです。インテントまたはスロットタイプにタグを追加することはできません。  
型: [Tag](API_Tag.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。  
必須: いいえ

## レスポンスの構文
<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"
      }
   ]
}
```

## レスポンス要素
<a name="API_StartImport_ResponseElements"></a>

アクションが成功すると、HTTP 201 レスポンスが返されます。

サービスから以下のデータが JSON 形式で返されます。

 ** [createdDate](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-createdDate"></a>
インポートジョブがリクエストされた日時のタイムスタンプ。  
型: タイムスタンプ

 ** [importId](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-importId"></a>
特定のインポートジョブの識別子。  
タイプ: 文字列

 ** [importStatus](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-importStatus"></a>
インポートジョブのステータス。ステータスが `FAILED` の場合は、`GetImport` オペレーションで故障の原因を知ることができます。  
型: 文字列  
有効な値：`IN_PROGRESS | COMPLETE | FAILED`

 ** [mergeStrategy](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-mergeStrategy"></a>
マージ競合が発生した場合に実行するアクション。  
型: 文字列  
有効な値：`OVERWRITE_LATEST | FAIL_ON_CONFLICT`

 ** [name](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-name"></a>
インポートジョブに付けられた名前。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 100 です。  
パターン: `[a-zA-Z_]+` 

 ** [resourceType](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-resourceType"></a>
インポートするリソースのタイプ。  
型: 文字列  
有効な値：`BOT | INTENT | SLOT_TYPE`

 ** [tags](#API_StartImport_ResponseSyntax) **   <a name="lex-StartImport-response-tags"></a>
インポートされたボットに追加されたタグのリスト。  
型: [Tag](API_Tag.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。

## エラー
<a name="API_StartImport_Errors"></a>

 ** BadRequestException **   
リクエストが適切にフォーマットされていません。例えば、値が無効であったり、必須項目が設定されていない場合です。フィールドの値を確認して、再度お試しください。  
HTTP ステータスコード: 400

 ** InternalFailureException **   
Amazon Lex 内部エラーが発生しました。リクエストを再試行してください。  
HTTP ステータスコード: 500

 ** LimitExceededException **   
リクエストが制限を超えました。リクエストを再試行してください。  
HTTP ステータスコード: 429

## 以下も参照してください。
<a name="API_StartImport_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/StartImport) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/StartImport) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/StartImport) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/StartImport) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/StartImport) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/StartImport) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/StartImport) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/StartImport)