[ aws . kinesisanalyticsv2 ]

add-application-input-processing-configuration

Description

Adds an InputProcessingConfiguration to an SQL-based Kinesis Data Analytics application. An input processor pre-processes records on the input stream before the application’s SQL code executes. Currently, the only input processor available is AWS Lambda .

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Synopsis

  add-application-input-processing-configuration
--application-name <value>
--current-application-version-id <value>
--input-id <value>
--input-processing-configuration <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--cli-auto-prompt <value>]

Options

--application-name (string)

The name of the application to which you want to add the input processing configuration.

--current-application-version-id (long)

The version of the application to which you want to add the input processing configuration. You can use the DescribeApplication operation to get the current application version. If the version specified is not the current version, the ConcurrentModificationException is returned.

--input-id (string)

The ID of the input configuration to add the input processing configuration to. You can get a list of the input IDs for an application using the DescribeApplication operation.

--input-processing-configuration (structure)

The InputProcessingConfiguration to add to the application.

InputLambdaProcessor -> (structure)

The InputLambdaProcessor that is used to preprocess the records in the stream before being processed by your application code.

ResourceARN -> (string)

The ARN of the AWS Lambda function that operates on records in the stream.

Note

To specify an earlier version of the Lambda function than the latest, include the Lambda function version in the Lambda function ARN. For more information about Lambda ARNs, see Example ARNs: AWS Lambda

Shorthand Syntax:

InputLambdaProcessor={ResourceARN=string}

JSON Syntax:

{
  "InputLambdaProcessor": {
    "ResourceARN": "string"
  }
}

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

--cli-auto-prompt (boolean) Automatically prompt for CLI input parameters.

See ‘aws help’ for descriptions of global parameters.

Output

ApplicationARN -> (string)

The Amazon Resource Name (ARN) of the application.

ApplicationVersionId -> (long)

Provides the current application version.

InputId -> (string)

The input ID that is associated with the application input. This is the ID that Amazon Kinesis Data Analytics assigns to each input configuration that you add to your application.

InputProcessingConfigurationDescription -> (structure)

The description of the preprocessor that executes on records in this input before the application’s code is run.

InputLambdaProcessorDescription -> (structure)

Provides configuration information about the associated InputLambdaProcessorDescription

ResourceARN -> (string)

The ARN of the AWS Lambda function that is used to preprocess the records in the stream.

Note

To specify an earlier version of the Lambda function than the latest, include the Lambda function version in the Lambda function ARN. For more information about Lambda ARNs, see Example ARNs: AWS Lambda

RoleARN -> (string)

The ARN of the IAM role that is used to access the AWS Lambda function.

Note

Provided for backward compatibility. Applications that are created with the current API version have an application-level service execution role rather than a resource-level role.