CreateIngestion - Amazon QuickSight
リクエストの構文URI リクエストパラメータリクエストボディレスポンスの構文レスポンス要素エラー例以下の資料も参照してください。

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

CreateIngestion

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

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

リクエストの構文

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

{
   "IngestionType": "string"
}

URI リクエストパラメータ

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

AwsAccountId

AWS アカウント ID。

長さの制約: 固定長は 12 です。

パターン: ^[0-9]{12}$

必須: はい

DataSetId

取り込みに使用されるデータセットの ID。

必須: はい

IngestionId

取り込みの ID。

長さの制約: 最小長は 1 です｡ 最大長は 128 です。

パターン: ^[a-zA-Z0-9-_]+$

必須: はい

リクエストボディ

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

IngestionType

作成するインジェストのタイプ。

Type: 文字列

有効な値: INCREMENTAL_REFRESH | FULL_REFRESH

必須: いいえ

レスポンスの構文

HTTP/1.1 Status
Content-type: application/json

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

レスポンス要素

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

Status

リクエストの HTTP ステータス。

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

Arn

データインジェストの Amazon リソースネーム (ARN)。

Type: 文字列

IngestionId

取り込みの ID。

Type: 文字列

長さの制約: 最小長は 1 です｡ 最大長は 128 です。

パターン: ^[a-zA-Z0-9-_]+$

IngestionStatus

取り込みステータス。

Type: 文字列

有効な値: INITIALIZED | QUEUED | RUNNING | FAILED | COMPLETED | CANCELLED

RequestId

-AWSこの処理のリクエスト ID。

Type: 文字列

エラー

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

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

例

例

この例で示すのは CreateIngestion。

リクエスト例

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

以下の資料も参照してください。

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。