Para proyectos nuevos, le recomendamos que utilice el nuevo servicio gestionado para Apache Flink Studio en lugar de aplicaciones de Kinesis Data Analytics para SQL. El servicio gestionado para Apache Flink Studio combina la facilidad de uso con capacidades analíticas avanzadas, lo que le permite crear aplicaciones sofisticadas de procesamiento de flujos en cuestión de minutos.
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.
AddApplicationInput
nota
Esta documentación es para la versión 1 de la API de Amazon Kinesis Data Analytics, que solo admite aplicaciones SQL. La versión 2 de la API admite aplicaciones SQL y Java. Para obtener más información acerca de la versión 2, consulte la documentación de la API V2 de Amazon Kinesis Data Analytics.
Añade un origen de flujo a la aplicación Amazon Kinesis. Para obtener información conceptual, consulte Configuración de entrada de la aplicación.
Puede agregar un origen de flujo al crear una aplicación o puede usar esta operación para agregar un origen de flujo después de crear una aplicación. Para obtener más información, consulte CreateApplication.
Cualquier actualización de la configuración, incluida la adición de un origen de transmisión con esta operación, da lugar a una nueva versión de la aplicación. Puede utilizar la DescribeApplicationoperación para buscar la versión actual de la aplicación.
Esto operación requiere permisos para realizar la acción kinesisanalytics:AddApplicationInput.
Sintaxis de la solicitud
{
"ApplicationName": "string",
"CurrentApplicationVersionId": number,
"Input": {
"InputParallelism": {
"Count": number
},
"InputProcessingConfiguration": {
"InputLambdaProcessor": {
"ResourceARN": "string",
"RoleARN": "string"
}
},
"InputSchema": {
"RecordColumns": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncoding": "string",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"KinesisFirehoseInput": {
"ResourceARN": "string",
"RoleARN": "string"
},
"KinesisStreamsInput": {
"ResourceARN": "string",
"RoleARN": "string"
},
"NamePrefix": "string"
}
}Parámetros de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- ApplicationName
-
Nombre de la aplicación Amazon Kinesis Analytics existente a la que desea añadir el origen de flujo.
Tipo: string
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón:
[a-zA-Z0-9_.-]+Obligatorio: sí
- CurrentApplicationVersionId
-
Versión actual de la aplicación Amazon Kinesis Analytics. Puede utilizar la DescribeApplicationoperación para buscar la versión actual de la aplicación.
Tipo: largo
Rango válido: valor mínimo de 1. Valor máximo de 999999999.
Obligatorio: sí
- Input
-
La entrada que se va a añadir.
Tipo: objeto Input
Obligatorio: sí
Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.
Errores
- CodeValidationException
-
El código de aplicación (consulta) proporcionado por el usuario no es válido. Puede tratarse de un simple error de sintaxis.
Código de estado HTTP: 400
- ConcurrentModificationException
-
Se produce una excepción como resultado de una modificación simultánea de una aplicación. Por ejemplo, dos personas que intentan editar la misma aplicación al mismo tiempo.
Código de estado HTTP: 400
- InvalidArgumentException
-
El valor del parámetro de entrada especificado no es válido.
Código de estado HTTP: 400
- ResourceInUseException
-
La aplicación no está disponible para esta operación.
Código de estado HTTP: 400
- ResourceNotFoundException
-
No se encuentra la aplicación especificada.
Código de estado HTTP: 400
- UnsupportedOperationException
-
La solicitud se rechazó porque no se admite un parámetro especificado o porque un recurso especificado no es válido para esta operación.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente:
