Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
CreateIngestion
Crea e inicia una nueva ingesta de SPICE para un conjunto de datos. Puede actualizar manualmente los conjuntos de datos en una cuenta de la edición Enterprise Edition 32 veces en un periodo de 24 horas. Puede actualizar manualmente los conjuntos de datos en una cuenta de la edición Standard Edition 8 veces en un periodo de 24 horas. Cada período de 24 horas se mide a partir de 24 horas antes de la fecha y hora actuales.
Todas las ingestiones que operan en conjuntos de datos etiquetados heredan las mismas etiquetas automáticamente para usarlas en el control de acceso. Para ver un ejemplo, consulte .¿Cómo creo una política de IAM para controlar el acceso a los recursos de Amazon EC2 mediante etiquetas?
Sintaxis de la solicitud
PUT /accounts/AwsAccountId/data-sets/DataSetId/ingestions/IngestionId HTTP/1.1
Content-type: application/json
{
"IngestionType": "string"
}Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- AwsAccountId
-
El ID de la cuenta de AWS.
Limitaciones de longitud Longitud fija de 12.
Patrón:
^[0-9]{12}$Obligatorio: Sí
- DataSetId
-
El ID del conjunto de datos que se utilizó en la ingesta.
Obligatorio: Sí
- IngestionId
-
Una identificación para la ingestión.
Limitaciones de longitud Longitud mínima de 1. La longitud máxima es de 128 caracteres.
Patrón:
^[a-zA-Z0-9-_]+$Obligatorio: Sí
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- IngestionType
-
El tipo de ingesta que desea crear.
Type: Cadena
Valores válidos:
INCREMENTAL_REFRESH | FULL_REFRESHObligatorio: No
Sintaxis de la respuesta
HTTP/1.1 Status
Content-type: application/json
{
"Arn": "string",
"IngestionId": "string",
"IngestionStatus": "string",
"RequestId": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve la siguiente respuesta HTTP.
- Status
-
El estado HTTP de la solicitud.
El servicio devuelve los datos siguientes en formato JSON.
- Arn
-
El nombre de recurso de Amazon (ARN) para la ingesta de datos.
Type: Cadena
- IngestionId
-
Una identificación para la ingestión.
Type: Cadena
Limitaciones de longitud Longitud mínima de 1. La longitud máxima es de 128 caracteres.
Patrón:
^[a-zA-Z0-9-_]+$ - IngestionStatus
-
El estado de la ingestión.
Type: Cadena
Valores válidos:
INITIALIZED | QUEUED | RUNNING | FAILED | COMPLETED | CANCELLED - RequestId
-
LaAWSID de solicitud de esta operación.
Type: Cadena
Errores
Para obtener información sobre los errores que son comunes a todas las acciones, consulteErrores comunes.
- AccessDeniedException
-
No tiene permiso de acceso. La credenciales proporcionadas no se pudieron validar. Es posible que no tenga autorización para realizar la solicitud. Asegúrese de que su cuenta esté autorizada para usar Amazon QuickSight , que sus políticas tienen los permisos correctos y que está utilizando las claves de acceso correctas.
Código de estado HTTP: 401
- InternalFailureException
-
Se produjo un error interno.
Código de estado HTTP: 500
- InvalidParameterValueException
-
Uno o más parámetros tienen un valor que no es válido.
Código de estado HTTP: 400
- LimitExceededException
-
Se superó un límite.
Código de estado HTTP: 409
- ResourceExistsException
-
El recurso especificado ya existe.
Código de estado HTTP: 409
- ResourceNotFoundException
-
No se encontraron uno o varios recursos.
Código de estado HTTP: 404
- ThrottlingException
-
El acceso está limitado.
Código de estado HTTP: 429
Ejemplos
Ejemplo
Este ejemplo ilustra un uso de CreateIngestion.
Solicitud de muestra
PUT /accounts/*AwsAccountId*/data-sets/*DataSetID*/ingestions/*IngestionID* HTTP/1.1Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
