翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
CreateIngestion
データセットの新しい SPICE 取り込みを作成して開始します。Enterprise Edition アカウント内のデータセットは 24 時間内に手動で 32 回更新できます。Standard Edition アカウント内のデータセットは 24 時間内に手動で 8 回更新できます。24 時間は、現在の日時の 24 時間前から開始されます。
タグ付きデータセットで動作する取り込みは、アクセス制御で使用するために同じタグを自動的に継承します。例については、「」を参照してください。タグを使用して Amazon EC2 リソースへのアクセスを制御するための IAM ポリシーを作成するにはどうすればよいですか?
リクエストの構文
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 を使用する方法の詳細については、以下を参照してください。
