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

# CreateIngestion
<a name="API_CreateIngestion"></a>

データセットの新しい SPICE 取り込みを作成して開始します。Enterprise Edition アカウント内のデータセットは 24 時間内に手動で 32 回更新できます。Standard Edition アカウント内のデータセットは 24 時間内に手動で 8 回更新できます。24 時間は、現在の日時の 24 時間前から開始されます。

タグ付きデータセットで動作する取り込みは、アクセス制御で使用するために同じタグを自動的に継承します。例については、「」を参照してください。[タグを使用して Amazon EC2 リソースへのアクセスを制御するための IAM ポリシーを作成するにはどうすればよいですか?](https://aws.amazon.com/premiumsupport/knowledge-center/iam-ec2-resource-tags/)のAWSナレッジセンター。タグはタグ付きデータセットに表示されますが、取り込みリソースには表示されません。

## リクエストの構文
<a name="API_CreateIngestion_RequestSyntax"></a>

```
PUT /accounts/AwsAccountId/data-sets/DataSetId/ingestions/IngestionId HTTP/1.1
Content-type: application/json

{
   "IngestionType": "string"
}
```

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

リクエストでは、次の URI パラメータを使用します。

 ** [AwsAccountId](#API_CreateIngestion_RequestSyntax) **   <a name="QS-CreateIngestion-request-AwsAccountId"></a>
AWS アカウント ID。  
長さの制約: 固定長は 12 です。  
パターン: `^[0-9]{12}$`   
必須: はい

 ** [DataSetId](#API_CreateIngestion_RequestSyntax) **   <a name="QS-CreateIngestion-request-DataSetId"></a>
取り込みに使用されるデータセットの ID。  
必須: はい

 ** [IngestionId](#API_CreateIngestion_RequestSyntax) **   <a name="QS-CreateIngestion-request-IngestionId"></a>
取り込みの ID。  
長さの制約: 最小長は 1 です｡ 最大長は 128 です。  
パターン: `^[a-zA-Z0-9-_]+$`   
必須: はい

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

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

 ** [IngestionType](#API_CreateIngestion_RequestSyntax) **   <a name="QS-CreateIngestion-request-IngestionType"></a>
作成するインジェストのタイプ。  
Type: 文字列  
有効な値: ` INCREMENTAL_REFRESH | FULL_REFRESH`   
必須: いいえ

## レスポンスの構文
<a name="API_CreateIngestion_ResponseSyntax"></a>

```
HTTP/1.1 Status
Content-type: application/json

{
   "Arn": "string",
   "IngestionId": "string",
   "IngestionStatus": "string",
   "RequestId": "string"
}
```

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

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

 ** [Status](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-Status"></a>
リクエストの HTTP ステータス。

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

 ** [Arn](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-Arn"></a>
データインジェストの Amazon リソースネーム (ARN)。  
Type: 文字列

 ** [IngestionId](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-IngestionId"></a>
取り込みの ID。  
Type: 文字列  
長さの制約: 最小長は 1 です｡ 最大長は 128 です。  
パターン: `^[a-zA-Z0-9-_]+$` 

 ** [IngestionStatus](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-IngestionStatus"></a>
取り込みステータス。  
Type: 文字列  
有効な値: ` INITIALIZED | QUEUED | RUNNING | FAILED | COMPLETED | CANCELLED` 

 ** [RequestId](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-RequestId"></a>
-AWSこの処理のリクエスト ID。  
Type: 文字列

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

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** AccessDeniedException **   
このアイテムにはアクセスできません。提供された認証情報を検証できませんでした。リクエストを実行する権限がない可能性があります。アカウントがAmazonの使用を許可されていることを確認してください QuickSight サービスの利用を許可されていること、ポリシーに正しいアクセス許可があること、正しいアクセスキーを使っていることを確認してください。  
HTTP ステータスコード: 401

 ** InternalFailureException **   
内部エラーが発生しました。  
HTTP ステータスコード: 500

 ** InvalidParameterValueException **   
1 つ以上のパラメータに無効な値があります。  
HTTP ステータスコード: 400

 ** LimitExceededException **   
制限を超過しています。  
HTTP ステータスコード: 409

 ** ResourceExistsException **   
指定されたリソースは既に存在します。  
HTTP ステータスコード: 409

 ** ResourceNotFoundException **   
1 つ以上のリソースが見つかりません。  
HTTP ステータスコード: 404

 ** ThrottlingException **   
アクセスが調整済みです。  
HTTP ステータスコード: 429

## 例
<a name="API_CreateIngestion_Examples"></a>

### 例
<a name="API_CreateIngestion_Example_1"></a>

この例で示すのは CreateIngestion。

#### リクエスト例
<a name="API_CreateIngestion_Example_1_Request"></a>

```
PUT /accounts/*AwsAccountId*/data-sets/*DataSetID*/ingestions/*IngestionID* HTTP/1.1
```

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

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateIngestion) 
+  [AWS向け SDK JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateIngestion)