Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
CreateIngestion
Crea e avvia una nuova acquisizione SPICE per un set di dati. È possibile aggiornare manualmente i set di dati in un account Enterprise Edition 32 volte in un periodo di 24 ore. È possibile aggiornare manualmente i set di dati in un account dell'edizione Standard 8 volte in un periodo di 24 ore. Ogni periodo di 24 ore viene misurato a partire da 24 ore prima della data e dell'ora correnti.
Eventuali acquisizioni che operano su set di dati con tag ereditano automaticamente gli stessi tag per l'utilizzo nel controllo degli accessi. Per un esempio, consultaCome posso creare una policy IAM per il controllo dell'accesso alle risorse Amazon EC2 utilizzando i tag?
Sintassi della richiesta
PUT /accounts/AwsAccountId/data-sets/DataSetId/ingestions/IngestionId HTTP/1.1
Content-type: application/json
{
"IngestionType": "string"
}Parametri della richiesta URI:
La richiesta utilizza i seguenti parametri URI.
- AwsAccountId
-
ID dell'account AWS.
Vincoli di lunghezza: Lunghezza fissa di 12.
Modello:
^[0-9]{12}$Campo obbligatorio: Sì
- DataSetId
-
ID del set di dati utilizzato per l'inserimento.
Campo obbligatorio: Sì
- IngestionId
-
Un ID per l'inserimento.
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello:
^[a-zA-Z0-9-_]+$Campo obbligatorio: Sì
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- IngestionType
-
Il tipo di inserimento che deve essere creato da.
Type: Stringa
Valori validi:
INCREMENTAL_REFRESH | FULL_REFRESHCampo obbligatorio: No
Sintassi della risposta
HTTP/1.1 Status
Content-type: application/json
{
"Arn": "string",
"IngestionId": "string",
"IngestionStatus": "string",
"RequestId": "string"
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce la seguente risposta HTTP.
- Status
-
Lo stato HTTP della richiesta.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- Arn
-
L'Amazon Resource Name (ARN) per l'inserimento dei dati.
Type: Stringa
- IngestionId
-
Un ID per l'inserimento.
Type: Stringa
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello:
^[a-zA-Z0-9-_]+$ - IngestionStatus
-
Lo stato di inserimento.
Type: Stringa
Valori validi:
INITIALIZED | QUEUED | RUNNING | FAILED | COMPLETED | CANCELLED - RequestId
-
LaAWSID della richiesta per questa operazione.
Type: Stringa
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- AccessDeniedException
-
Non hai l'accesso. Le credenziali fornite non possono essere convalidate. È possibile che non sei autorizzato a effettuare la richiesta. Assicurati che il tuo account sia autorizzato a utilizzare Amazon QuickSight , che le policy abbiano le autorizzazioni corrette e che siano utilizzate le chiavi di accesso corrette.
Codice di stato HTTP: 401
- InternalFailureException
-
Si è verificato un errore interno.
Codice di stato HTTP: 500
- InvalidParameterValueException
-
Uno o più parametri hanno un valore non valido.
Codice di stato HTTP: 400
- LimitExceededException
-
È stato superato un limite.
Codice di stato HTTP: 409
- ResourceExistsException
-
La risorsa specificata esiste già.
Codice di stato HTTP: 409
- ResourceNotFoundException
-
Uno o più risorse non sono state trovate.
Codice di stato HTTP: 404
- ThrottlingException
-
L'accesso è limitato.
Codice di stato HTTP: 429
Esempi
Esempio
Questo esempio illustra un utilizzo di CreateIngestion.
Richiesta di esempio
PUT /accounts/*AwsAccountId*/data-sets/*DataSetID*/ingestions/*IngestionID* HTTP/1.1Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
