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
Añade un destino externo a la aplicación Kinesis Data Analytics basada en SQL.
Si desea que Kinesis Data Analytics entregue datos de una secuencia en la aplicación dentro de su aplicación a un destino externo (como un flujo de datos de Kinesis, un flujo de entrega de Kinesis Data Firehose o una función de Amazon Lambda), debe agregar 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.
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.
Sintaxis de la solicitud
{
"ApplicationName": "string",
"CurrentApplicationVersionId": number,
"Output": {
"DestinationSchema": {
"RecordFormatType": "string"
},
"KinesisFirehoseOutput": {
"ResourceARN": "string"
},
"KinesisStreamsOutput": {
"ResourceARN": "string"
},
"LambdaOutput": {
"ResourceARN": "string"
},
"Name": "string"
}
}Parámetros de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- ApplicationName
-
El nombre de la aplicación a la que desea añadir la configuración de salida.
Tipo: string
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón:
[a-zA-Z0-9_.-]+Obligatorio: sí
- CurrentApplicationVersionId
-
La versión de la aplicación a la que desea añadir la configuración de salida. Puede utilizar la operación DescribeApplication para obtener la versión actual de la aplicación. Si la versión especificada no es la actual, se devuelve la
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 datos de Amazon Kinesis, un flujo de entrega de Amazon Kinesis Firehose o una función de Lambda de Amazon) y el formato que se usará a la hora de escribir en el destino.
Tipo: objeto Output
Obligatorio: sí
Sintaxis de la respuesta
{
"ApplicationARN": "string",
"ApplicationVersionId": number,
"OutputDescriptions": [
{
"DestinationSchema": {
"RecordFormatType": "string"
},
"KinesisFirehoseOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"KinesisStreamsOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"LambdaOutputDescription": {
"ResourceARN": "string",
"RoleARN": "string"
},
"Name": "string",
"OutputId": "string"
}
]
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- ApplicationARN
-
El nombre de recurso de Amazon (ARN) de la aplicación.
Tipo: string
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.
Patrón:
arn:.* - ApplicationVersionId
-
El ID de la versión actualizada de la aplicación. Kinesis Data Analytics incrementa este ID cuando se actualiza la aplicación.
Tipo: largo
Rango válido: valor mínimo de 1. Valor máximo de 999 999 999.
- OutputDescriptions
-
Describe la configuración de salida de la aplicación. Para obtener más información, consulte Configuración de salida de la aplicación.
Tipo: matriz de objetos OutputDescription
Errores
- ConcurrentModificationException
-
Excepción que se produce como resultado de modificaciones simultáneas en una aplicación. El error puede deberse a un intento de modificar una aplicación sin utilizar el ID de la aplicación actual.
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
- InvalidRequestException
-
El JSON de la solicitud no es válido para la operación.
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
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, consulte lo siguiente:
