PUT

/accounts/{AwsAccountId}/data-sets/{DataSetId}/ingestions/{IngestionId}

http://quicksight.{region}.amazonaws.com/accounts/{AwsAccountId}/data-sets/{DataSetId}/ingestions/{IngestionId}

<p>Creates and starts a new SPICE ingestion for a dataset. You can manually refresh datasets in an Enterprise edition account 32 times in a 24-hour period. You can manually refresh datasets in a Standard edition account 8 times in a 24-hour period. Each 24-hour period is measured starting 24 hours before the current date and time.</p> <p>Any ingestions operating on tagged datasets inherit the same tags automatically for use in access control. For an example, see <a href="http://aws.amazon.com/premiumsupport/knowledge-center/iam-ec2-resource-tags/">How do I create an IAM policy to control access to Amazon EC2 resources using tags?</a> in the Amazon Web Services Knowledge Center. Tags are visible on the tagged dataset, but not on the ingestion resource.</p>

Access Token Required: API Key

Path Parameters

DataSetIdstringrequired

The ID of the dataset used in the ingestion.

IngestionIdstringrequired

An ID for the ingestion.

AwsAccountIdstringrequired

The Amazon Web Services account ID.

Body Params

IngestionTypestring

This defines the type of ingestion user wants to trigger. This is part of create ingestion request.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request PUT \
2     --url 'http://quicksight.{region}.amazonaws.com/accounts/{AwsAccountId}/data-sets/{DataSetId}/ingestions/{IngestionId}' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}