v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1420158131.3 KB

<note> <p>This documentation is for version 1 of the Amazon Kinesis Data Analytics API, which only supports SQL applications. Version 2 of the API supports SQL and Java applications. For more information about version 2, see <a href="/kinesisanalytics/latest/apiv2/Welcome.html">Amazon Kinesis Data Analytics API V2 Documentation</a>.</p> </note> <p>Infers a schema by evaluating sample records on the specified streaming source (Amazon Kinesis stream or Amazon Kinesis Firehose delivery stream) or S3 object. In the response, the operation returns the inferred schema and also the sample records that the operation used to infer the schema.</p> <p> You can use the inferred schema when configuring a streaming source for your application. For conceptual information, see <a href="https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html">Configuring Application Input</a>. Note that when you create an application using the Amazon Kinesis Analytics console, the console uses this operation to infer a schema and show it in the console user interface. </p> <p> This operation requires permissions to perform the <code>kinesisanalytics:DiscoverInputSchema</code> action. </p>

post/#X-Amz-Target=KinesisAnalytics_20150814.DiscoverInputSchema

Headers

X-Amz-Target'KinesisAnalytics_20150814.DiscoverInputSchema' required

Request body

ResourceARNstring

Amazon Resource Name (ARN) of the streaming source.

RoleARNstring

ARN of the IAM role that Amazon Kinesis Analytics can assume to access the stream on your behalf.

Response

Success

ProcessedInputRecordsProcessedInputRecord[]

Stream data that was modified by the processor specified in the <code>InputProcessingConfiguration</code> parameter.

RawInputRecordsRawInputRecord[]

Raw stream data that was sampled to infer the schema.