Tras considerarlo detenidamente, hemos decidido interrumpir Amazon Kinesis Data Analytics SQL para aplicaciones en dos pasos:
1. A partir del 15 de octubre de 2025, no podrá crear nuevos Kinesis Data Analytics SQL para aplicaciones.
2. Eliminaremos sus aplicaciones a partir del 27 de enero de 2026. No podrá iniciar ni utilizar Amazon Kinesis Data Analytics SQL para aplicaciones. A partir de ese momento, el soporte para Amazon Kinesis Data Analytics dejará SQL de estar disponible. Para obtener más información, consulte Suspensión de Amazon Kinesis Data Analytics SQL for Applications.
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.
AddApplicationOutput
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 destino externo a su aplicación de Amazon Kinesis Analytics.
Si desea que Amazon Kinesis Analytics entregue datos de un flujo en la aplicación dentro de su aplicación a un destino externo (como un flujo de Amazon Kinesis, un flujo de entrega de Amazon Kinesis Firehose o una función de AWS Lambda), debe añadir la configuración pertinente a la aplicación a través de esta operación. Puede configurar una o más salidas para su aplicación. Cada configuración de salida asigna un flujo en la aplicación y un destino externo.
Puede utilizar una de las configuraciones de salida para entregar datos desde su flujo de errores en la aplicación a un destino externo para poder analizar los errores. Para obtener más información, consulte la sección sobre Descripción de salida de la aplicación (destino).
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 operación DescribeApplication para buscar la versión actual de la aplicación.
Para conocer los límites en relación con el número de entradas y salidas de la aplicación que puede configurar, consulte Límites.
Esto operación requiere permisos para realizar la acción kinesisanalytics:AddApplicationOutput.
Sintaxis de la solicitud
{
"ApplicationName": "string",
"CurrentApplicationVersionId": number,
"Output": {
"DestinationSchema": {
"RecordFormatType": "string"
},
"KinesisFirehoseOutput": {
"ResourceARN": "string",
"RoleARN": "string"
},
"KinesisStreamsOutput": {
"ResourceARN": "string",
"RoleARN": "string"
},
"LambdaOutput": {
"ResourceARN": "string",
"RoleARN": "string"
},
"Name": "string"
}
}Parámetros de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- ApplicationName
-
Nombre de la aplicación a la que desea añadir la configuración de salida.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón:
[a-zA-Z0-9_.-]+Obligatorio: sí
- CurrentApplicationVersionId
-
Versión de la aplicación a la que desea añadir la configuración de salida. Puede utilizar la operación DescribeApplication para buscar la versión actual de la aplicación. Si la versión especificada no es la versión actual, se devuelve
ConcurrentModificationException.Tipo: largo
Rango válido: valor mínimo de 1. Valor máximo de 999999999.
Obligatorio: sí
- Output
-
Una gama de objetos, cada una describe una configuración de salida. En la configuración de salida, debe especificar el nombre de un flujo en la aplicación, un destino (es decir, un flujo de Amazon Kinesis, un flujo de entrega de Amazon Kinesis Firehose o una función de AWS Lambda) y registrar la formación que se usará a la hora de escribir en el destino.
Tipo: objeto Output
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
- 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 un SDK de AWS de un idioma específico, consulte:
