CreateIngestion - Amazon QuickSight

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

CreateIngestion

為資料集建立並啟動新的 SPICE 擷取。您可以在 24 小時期間。您可以在 24 小時期間。從目前日期和時間前 24 小時開始測量每個 24 小時的時段。

在標記資料集上操作的任何擷取都會自動繼承相同的標籤,以便在存取控制中使用。如需範例,請參閱如何建立 IAM 政策使用標籤控制 Amazon EC2 Resource 的存取?中的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

您希望建立之擷取的類型。

類型:字串

有效值: 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 Resource Name (ARN)。

類型:字串

IngestionId

擷取的 ID。

類型:字串

長度限制:長度下限為 1。長度上限為 128。

模式:^[a-zA-Z0-9-_]+$

IngestionStatus

擷取狀態。

類型:字串

有效值: INITIALIZED | QUEUED | RUNNING | FAILED | COMPLETED | CANCELLED

RequestId

所以此AWS此操作的請求。

類型:字串

錯誤

如需所有動作常見的錯誤相關資訊,請參閱常見錯誤

AccessDeniedException

您無法存取。提供的登入資料無法驗證。您可能無法取得授權以執行請求。確保您的帳戶已獲授權使用亞馬遜 QuickSight 服務,您的政策有正確的存取金鑰。

HTTP 狀態態態態態態態態 401

InternalFailureException

發生內部故障。

HTTP 狀態態態態態態態態 500

InvalidParameterValueException

一或多個參數具有無效的值。

HTTP 狀態態態態態態態態 400

LimitExceededException

已超過上限。

HTTP 狀態態態態態態態態 409

ResourceExistsException

指定的資源已存在。

HTTP 狀態態態態態態態態 409

ResourceNotFoundException

無法找到一個或多個資源。

HTTP 狀態態態態態態態態 404

ThrottlingException

存取已調節。

HTTP 狀態態態態態態態態 429

範例

範例

這個例子說明了一個用法 CreateIngestion。

請求範例

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

另請參閱

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊,請參閱下列說明: