CreateIngestion -

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 incorporación de datos de SPICE en un conjunto de datos

Las ingestions que operan en datasets etiquetados heredan las mismas etiquetas automáticamente para utilizarlas en el control de acceso. Para ver un ejemplo, consulte .¿Cómo puedo crear una política de IAM para controlar el acceso a los recursos de Amazon EC2 mediante etiquetas?en el centro de conocimientos de AWS . Las etiquetas son visibles en el conjunto de datos etiquetado, pero no en el recurso de ingestión.

Sintaxis de la solicitud

PUT /accounts/AwsAccountId/data-sets/DataSetId/ingestions/IngestionId HTTP/1.1

Parámetros de solicitud URI

La solicitud utiliza los siguientes parámetros URI.

AwsAccountId

El ID de la cuenta de AWS.

Restricciones: Longitud fija de 12.

Patrón: ^[0-9]{12}$

: obligatorio Sí

DataStid

El ID del conjunto de datos utilizado en la ingestión.

: obligatorio Sí

IngestionID

Una identificación para la ingestión.

Restricciones: 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 no tiene un cuerpo de la solicitud.

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 respuesta siguiente HTTP.

Estado

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 ingestión de datos.

Tipo: Cadena

IngestionID

Una identificación para la ingestión.

Tipo: Cadena

Restricciones: Longitud mínima de 1. La longitud máxima es de 128 caracteres.

Patrón: ^[a-zA-Z0-9-_]+$

IngestionStatus

El estado de ingestión.

Tipo: Cadena

Valores válidos: INITIALIZED | QUEUED | RUNNING | FAILED | COMPLETED | CANCELLED

RequestId

ID de solicitud de AWS de esta operación.

Tipo: Cadena

Errors

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 tiene permiso para utilizar el servicio de Amazon QuickSight, que las 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

Examples

Example

En este ejemplo se ilustra un uso de CreateInestion.

Solicitud de muestra

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

Vé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: