经过仔细考虑，我们决定停用适用于 SQL 应用程序的 Amazon Kinesis Data Analytics： 1. 从 **2025年9月1日起，**我们将不再为适用于SQL应用程序的Amazon Kinesis Data Analytics Data Analytics提供任何错误修复，因为鉴于即将停产，我们对其的支持将有限。 2. 从 **2025 年 10 月 15 日**起，您将无法为 SQL 应用程序创建新的 Kinesis Data Analytics。 3. 从 **2026 年 1 月 27 日**起，我们将删除您的应用程序。您将无法启动或操作 Amazon Kinesis Data Analytics for SQL 应用程序。从那时起，将不再提供对 Amazon Kinesis Data Analytics for SQL 的支持。有关更多信息，请参阅 [Amazon Kinesis Data Analytics for SQL 应用程序停用](discontinuation.md)。本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # API 参考 **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅[Amazon Managed Service for Apache Flink API 文件 (版本 2)](https://docs.aws.amazon.com//managed-flink/latest/apiv2/Welcome.html)。你可以使用 AWS CLI 来探索亚马逊 Kinesis Data Analytics API。本指南提供了使用 AWS CLI的 [Amazon Kinesis Data Analytics·for·SQL 应用程序入门](getting-started.md) 练习。 **主题** + [操作](API_Operations.md) + [数据类型](API_Types.md) # 操作支持以下操作： + [AddApplicationCloudWatchLoggingOption](API_AddApplicationCloudWatchLoggingOption.md) + [AddApplicationInput](API_AddApplicationInput.md) + [AddApplicationInputProcessingConfiguration](API_AddApplicationInputProcessingConfiguration.md) + [AddApplicationOutput](API_AddApplicationOutput.md) + [AddApplicationReferenceDataSource](API_AddApplicationReferenceDataSource.md) + [CreateApplication](API_CreateApplication.md) + [DeleteApplication](API_DeleteApplication.md) + [DeleteApplicationCloudWatchLoggingOption](API_DeleteApplicationCloudWatchLoggingOption.md) + [DeleteApplicationInputProcessingConfiguration](API_DeleteApplicationInputProcessingConfiguration.md) + [DeleteApplicationOutput](API_DeleteApplicationOutput.md) + [DeleteApplicationReferenceDataSource](API_DeleteApplicationReferenceDataSource.md) + [DescribeApplication](API_DescribeApplication.md) + [DiscoverInputSchema](API_DiscoverInputSchema.md) + [ListApplications](API_ListApplications.md) + [ListTagsForResource](API_ListTagsForResource.md) + [StartApplication](API_StartApplication.md) + [StopApplication](API_StopApplication.md) + [TagResource](API_TagResource.md) + [UntagResource](API_UntagResource.md) + [UpdateApplication](API_UpdateApplication.md) # AddApplicationCloudWatchLoggingOption **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。添加 CloudWatch 日志流以监控应用程序配置错误。有关在 Amazon Kinesis Analytics 应用程序中使用 CloudWatch 日志流的[更多信息，请参阅使用 CloudWatch 亚马逊](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/cloudwatch-logs.html)日志。 ## 请求语法 ``` { "ApplicationName": "string", "CloudWatchLoggingOption": { "LogStreamARN": "string", "RoleARN": "string" }, "CurrentApplicationVersionId": number } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ApplicationName](#API_AddApplicationCloudWatchLoggingOption_RequestSyntax) ** Kinesis Analytics 应用程序的名称。类型：字符串长度限制：最小长度为 1。最大长度为 128。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ** [CloudWatchLoggingOption](#API_AddApplicationCloudWatchLoggingOption_RequestSyntax) ** 提供 CloudWatch 日志流 Amazon 资源名称 (ARN) 和 IAM 角色 ARN。注意：要向写入应用程序消息 CloudWatch，所使用的 IAM 角色必须启用`PutLogEvents`策略操作。类型：[CloudWatchLoggingOption](API_CloudWatchLoggingOption.md) 对象是否必需：是 ** [CurrentApplicationVersionId](#API_AddApplicationCloudWatchLoggingOption_RequestSyntax) ** Kinesis Analytics 应用程序的版本 ID。类型：长整型有效范围：最小值为 1。最大值为 999999999。是否必需：是 ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误 ** ConcurrentModificationException ** 由于对应用程序进行并发修改而引发的异常。例如，两个人尝试同时编辑同一个应用程序。 ** message ** HTTP 状态代码：400 ** InvalidArgumentException ** 指定的输入参数值无效。 ** message ** HTTP 状态代码：400 ** ResourceInUseException ** 该应用程序不可用于此操作。 ** message ** HTTP 状态代码：400 ** ResourceNotFoundException ** 无法找到指定的应用程序。 ** message ** HTTP 状态代码：400 ** UnsupportedOperationException ** 由于不支持指定的参数或指定的资源对此操作无效，请求被拒绝。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationCloudWatchLoggingOption) # AddApplicationInput **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。向您的 Amazon Kinesis 应用程序添加流式传输源。有关概念信息，请参阅[配置应用程序输入](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)。可以在创建应用程序时添加流式传输源，也可以在创建应用程序后使用此操作添加流式传输源。有关更多信息，请参阅 [CreateApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_CreateApplication.html)。任何配置更新（包括使用此操作添加流式传输源）都会生成新版本的应用程序。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 操作来找到当前的应用程序版本。此操作需要执行 `kinesisanalytics:AddApplicationInput` 操作的权限。 ## 请求语法 ``` { "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" } } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ApplicationName](#API_AddApplicationInput_RequestSyntax) ** 您要向其添加流式传输源的现有 Amazon Kinesis Analytics 应用程序的名称。类型：字符串长度限制：最小长度为 1。最大长度为 128。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ** [CurrentApplicationVersionId](#API_AddApplicationInput_RequestSyntax) ** 您的 Amazon Kinesis Analytics 应用程序的当前版本。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 操作来找到当前的应用程序版本。类型：长整型有效范围：最小值为 1。最大值为 999999999。是否必需：是 ** [Input](#API_AddApplicationInput_RequestSyntax) ** 要添加的[输入](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_Input.html)。类型：[Input](API_Input.md) 对象是否必需：是 ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误 ** CodeValidationException ** 用户提供的应用程序代码（查询）无效。这可能是一个简单的语法错误。 ** message ** 测试 HTTP 状态代码：400 ** ConcurrentModificationException ** 由于对应用程序进行并发修改而引发的异常。例如，两个人尝试同时编辑同一个应用程序。 ** message ** HTTP 状态代码：400 ** InvalidArgumentException ** 指定的输入参数值无效。 ** message ** HTTP 状态代码：400 ** ResourceInUseException ** 该应用程序不可用于此操作。 ** message ** HTTP 状态代码：400 ** ResourceNotFoundException ** 无法找到指定的应用程序。 ** message ** HTTP 状态代码：400 ** UnsupportedOperationException ** 由于不支持指定的参数或指定的资源对此操作无效，请求被拒绝。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/AddApplicationInput) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/AddApplicationInput) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/AddApplicationInput) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/AddApplicationInput) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/AddApplicationInput) + [AWS JavaScript V3 版 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationInput) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/AddApplicationInput) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/AddApplicationInput) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/AddApplicationInput) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationInput) # AddApplicationInputProcessingConfiguration **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。向应用程序[InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html)中添加。在应用程序的 SQL 代码执行之前，输入处理器会预处理输入流上的记录。目前，唯一可用的输入处理器为 [AWS Lambda](https://docs.aws.amazon.com/lambda/)。 ## 请求语法 ``` { "ApplicationName": "string", "CurrentApplicationVersionId": number, "InputId": "string", "InputProcessingConfiguration": { "InputLambdaProcessor": { "ResourceARN": "string", "RoleARN": "string" } } } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ApplicationName](#API_AddApplicationInputProcessingConfiguration_RequestSyntax) ** 要将输出配置添加到的应用程序的名称。类型：字符串长度限制：最小长度为 1。最大长度为 128。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ** [CurrentApplicationVersionId](#API_AddApplicationInputProcessingConfiguration_RequestSyntax) ** 要将输出配置添加到的应用程序的名称。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 操作来获取当前的应用程序版本。如果指定的版本不是当前版本，则返回 `ConcurrentModificationException`。类型：长整型有效范围：最小值为 1。最大值为 999999999。是否必需：是 ** [InputId](#API_AddApplicationInputProcessingConfiguration_RequestSyntax) ** 要向其添加输入处理配置的输入配置的 ID。您可以使用该[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html)操作获取应用程序 IDs 的输入列表。类型：字符串长度限制：最小长度为 1。最大长度为 50。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ** [InputProcessingConfiguration](#API_AddApplicationInputProcessingConfiguration_RequestSyntax) ** 要添加到应用程序的 [InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html)。类型：[InputProcessingConfiguration](API_InputProcessingConfiguration.md) 对象是否必需：是 ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误 ** ConcurrentModificationException ** 由于对应用程序进行并发修改而引发的异常。例如，两个人尝试同时编辑同一个应用程序。 ** message ** HTTP 状态代码：400 ** InvalidArgumentException ** 指定的输入参数值无效。 ** message ** HTTP 状态代码：400 ** ResourceInUseException ** 该应用程序不可用于此操作。 ** message ** HTTP 状态代码：400 ** ResourceNotFoundException ** 无法找到指定的应用程序。 ** message ** HTTP 状态代码：400 ** UnsupportedOperationException ** 由于不支持指定的参数或指定的资源对此操作无效，请求被拒绝。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationInputProcessingConfiguration) # AddApplicationOutput **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。将外部目标添加到您的 Amazon Kinesis Analytics 应用程序。如果您希望 Amazon Kinesis Analytics 将应用程序内的应用程序内流中的数据传输到外部目标（例如亚马逊 Kinesis 流、亚马逊 Kinesis Firehose 传输流或 AWS Lambda 函数），则可以使用此操作向应用程序添加相关配置。您可以为您的应用程序配置一个或多个输出。每个输出配置都映射一个应用程序内部流和一个外部目标。您可以使用其中一个输出配置将数据从应用程序内的错误流传输到外部目标，以便您分析错误。有关更多信息，请参阅[了解应用程序输出（目标）](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-output.html)。任何配置更新（包括使用此操作添加流式传输源）都会生成新版本的应用程序。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 操作来找到当前的应用程序版本。有关可配置的应用程序输入和输出数量的限制，请参阅[限制](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/limits.html)。此操作需要执行 `kinesisanalytics:AddApplicationOutput` 操作的权限。 ## 请求语法 ``` { "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" } } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ApplicationName](#API_AddApplicationOutput_RequestSyntax) ** 要将输出配置添加到的应用程序的名称。类型：字符串长度限制：最小长度为 1。最大长度为 128。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ** [CurrentApplicationVersionId](#API_AddApplicationOutput_RequestSyntax) ** 要将输出配置添加到的应用程序的名称。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 操作来获取当前的应用程序版本。如果指定的版本不是当前版本，则返回 `ConcurrentModificationException`。类型：长整型有效范围：最小值为 1。最大值为 999999999。是否必需：是 ** [Output](#API_AddApplicationOutput_RequestSyntax) ** 对象的数组，每个对象描述一项输出配置。在输出配置中，您可以指定应用程序内流的名称、目标（即 Amazon Kinesis 流、Amazon Kinesis Firehose 传输流或 AWS Lambda 函数），并记录写入目标时要使用的格式。类型：[Output](API_Output.md) 对象是否必需：是 ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误 ** ConcurrentModificationException ** 由于对应用程序进行并发修改而引发的异常。例如，两个人尝试同时编辑同一个应用程序。 ** message ** HTTP 状态代码：400 ** InvalidArgumentException ** 指定的输入参数值无效。 ** message ** HTTP 状态代码：400 ** ResourceInUseException ** 该应用程序不可用于此操作。 ** message ** HTTP 状态代码：400 ** ResourceNotFoundException ** 无法找到指定的应用程序。 ** message ** HTTP 状态代码：400 ** UnsupportedOperationException ** 由于不支持指定的参数或指定的资源对此操作无效，请求被拒绝。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/AddApplicationOutput) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/AddApplicationOutput) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/AddApplicationOutput) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/AddApplicationOutput) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/AddApplicationOutput) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationOutput) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/AddApplicationOutput) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/AddApplicationOutput) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/AddApplicationOutput) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationOutput) # AddApplicationReferenceDataSource **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。将引用数据源添加到现有应用程序。 Amazon Kinesis Analytics 读取参考数据（即 Amazon S3 对象），并在应用程序中创建应用程序内部表。在请求中，您提供源（S3 存储桶名称和对象键名称），要创建的应用程序内部表的名称，以及描述 Amazon S3 对象中的数据如何映射到所生成应用程序内部表中的列的必要映射信息。有关概念信息，请参阅[配置应用程序输入](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)。有关您可以添加到应用程序的数据源的限制，请参阅[限制](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/limits.html)。此操作需要执行 `kinesisanalytics:AddApplicationOutput` 操作的权限。 ## 请求语法 ``` { "ApplicationName": "string", "CurrentApplicationVersionId": number, "ReferenceDataSource": { "ReferenceSchema": { "RecordColumns": [ { "Mapping": "string", "Name": "string", "SqlType": "string" } ], "RecordEncoding": "string", "RecordFormat": { "MappingParameters": { "CSVMappingParameters": { "RecordColumnDelimiter": "string", "RecordRowDelimiter": "string" }, "JSONMappingParameters": { "RecordRowPath": "string" } }, "RecordFormatType": "string" } }, "S3ReferenceDataSource": { "BucketARN": "string", "FileKey": "string", "ReferenceRoleARN": "string" }, "TableName": "string" } } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ApplicationName](#API_AddApplicationReferenceDataSource_RequestSyntax) ** 现有应用程序的名称。类型：字符串长度限制：最小长度为 1。最大长度为 128。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ** [CurrentApplicationVersionId](#API_AddApplicationReferenceDataSource_RequestSyntax) ** 要为其添加引用数据来源的应用程序的版本。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 操作来获取当前的应用程序版本。如果指定的版本不是当前版本，则返回 `ConcurrentModificationException`。类型：长整型有效范围：最小值为 1。最大值为 999999999。是否必需：是 ** [ReferenceDataSource](#API_AddApplicationReferenceDataSource_RequestSyntax) ** 参考数据源可以是 Amazon S3 存储桶中的对象。Amazon Kinesis Analytics 读取对象，并将数据复制到创建的应用程序内部表。您需要提供 S3 存储桶、对象键名称和创建的结果应用程序内部表。您还必须提供具有必要权限的 IAM 角色，Amazon Kinesis Analytics 可以代入该角色代表您从 S3 存储桶中读取对象。类型：[ReferenceDataSource](API_ReferenceDataSource.md) 对象是否必需：是 ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误 ** ConcurrentModificationException ** 由于对应用程序进行并发修改而引发的异常。例如，两个人尝试同时编辑同一个应用程序。 ** message ** HTTP 状态代码：400 ** InvalidArgumentException ** 指定的输入参数值无效。 ** message ** HTTP 状态代码：400 ** ResourceInUseException ** 该应用程序不可用于此操作。 ** message ** HTTP 状态代码：400 ** ResourceNotFoundException ** 无法找到指定的应用程序。 ** message ** HTTP 状态代码：400 ** UnsupportedOperationException ** 由于不支持指定的参数或指定的资源对此操作无效，请求被拒绝。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS JavaScript V3 版 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) # CreateApplication **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。创建 Amazon Kinesis Analytics 应用程序。您可以对每个应用程序进行配置，将流式传输源用作输入，配置处理输入的应用程序代码，以及您希望 Amazon Kinesis Analytics 写入应用程序输出数据的目的地 (最多 3 个)。有关概述，请参阅[工作原理](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works.html)。在输入配置过程中，您将流式传输源映射到应用程序内部流 (您可以将其视为连续更新表)。在映射过程中，您必须为应用程序内部流提供架构，并将应用程序内部流中的每个数据列与流式传输源中的数据元素一一映射。您的应用程序代码是一个或多个读取输入数据、转换数据并生成输出的 SQL 语句。您的应用程序代码可以创建一个或多个 SQL 构件，例如 SQL 流或泵。在输出配置中，您可以通过配置应用程序将应用程序中创建的应用程序内部流的数据写入目的地 (最多 3 个)。 Amazon Kinesis Analytics 需要获得您的许可，才可读取源流的数据或将数据写入目标流。您可以通过创建 IAM 角色授予这些权限。此操作需要执行 `kinesisanalytics:CreateApplication` 操作的权限。有关创建 Amazon Kinesis Analytics 应用程序的入门练习，请参阅[入门](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/getting-started.html)。 ## 请求语法 ``` { "ApplicationCode": "string", "ApplicationDescription": "string", "ApplicationName": "string", "CloudWatchLoggingOptions": [ { "LogStreamARN": "string", "RoleARN": "string" } ], "Inputs": [ { "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" } ], "Outputs": [ { "DestinationSchema": { "RecordFormatType": "string" }, "KinesisFirehoseOutput": { "ResourceARN": "string", "RoleARN": "string" }, "KinesisStreamsOutput": { "ResourceARN": "string", "RoleARN": "string" }, "LambdaOutput": { "ResourceARN": "string", "RoleARN": "string" }, "Name": "string" } ], "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ApplicationCode](#API_CreateApplication_RequestSyntax) ** 一个或多个读取输入数据、转换数据并生成输出的 SQL 语句。例如，您可以编写一条 SQL 语句，该语句从一个应用程序内部流中读取数据，生成供应商广告点击次数的运行平均值，并使用泵将结果行插入另一个应用程序内部流中。有关典型模式的更多信息，请参阅[应用程序代码](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-app-code.html)。您可以提供这样的一系列 SQL 语句，其中一条语句的输出可以用作下一条语句的输入。您可以通过创建应用程序内部流和泵来存储中间结果。请注意，应用程序代码必须使用在 `Outputs` 中指定的名称创建流。例如，如果您的 `Outputs` 定义了名为 `ExampleOutputStream1` 和 `ExampleOutputStream2` 的输出流，则您的应用程序代码必须创建这两个流。类型：字符串长度限制：最小长度为 0。最大长度为 102400。必需：否 ** [ApplicationDescription](#API_CreateApplication_RequestSyntax) ** 应用程序的摘要描述。类型：字符串长度限制：最小长度为 0。最大长度为 1024。必需：否 ** [ApplicationName](#API_CreateApplication_RequestSyntax) ** Amazon Kinesis Analytics 应用程序的名称（例如，`sample-app`）。类型：字符串长度限制：最小长度为 1。最大长度为 128。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ** [CloudWatchLoggingOptions](#API_CreateApplication_RequestSyntax) ** 使用此参数配置 CloudWatch 日志流以监控应用程序配置错误。有关更多信息，请参阅[使用 Amazon CloudWatch 日志](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/cloudwatch-logs.html)。类型：[CloudWatchLoggingOption](API_CloudWatchLoggingOption.md) 对象数组必需：否 ** [Inputs](#API_CreateApplication_RequestSyntax) ** 使用该参数可配置应用程序输入。您可以将您的应用程序配置为接收来自单个流式传输源的输入。在此配置中，您会将此流式传输源映射到已创建的应用程序内部流。然后，您的应用程序代码可以像对表一样查询应用程序内部流（您可以将其视为连续更新的表）。对于流式传输源，您可以在该流上提供其 Amazon 资源名称（ARN）和数据格式（例如，JSON、CSV 等）。您还必须提供可由 Amazon Kinesis Analytics 代入以代表您读取此流的 IAM 角色。要创建应用程序内部流，您需要指定一个架构来将您的数据转换成 SQL 中使用的架构化版本。在架构中，您需要提供流式传输源中数据元素的必要映射，以记录应用程序内部流中的列。类型：[Input](API_Input.md) 对象数组必需：否 ** [Outputs](#API_CreateApplication_RequestSyntax) ** 您可以通过配置应用程序输出，将任一应用程序内部流的数据写入最多 3 个目的地。写入的目的地可以是 Amazon Kinesis 流、Amazon Kinesis Firehose 传输流、 AWS Lambda 目的地或三者的任意组合。在配置中，您可以指定应用程序内部流的名称、目标流或 Lambda 函数的 Amazon 资源名称 (ARN)，以及写入数据时使用的格式。您还必须提供 Amazon Kinesis Analytics 代表您写入到目标流或 Lambda 函数时代入的 IAM 角色。在输出配置中，您也可以指定输出流或 Lambda 函数 ARN。对于流目标，您可以指定流中数据的格式 (比如JSON、CSV)。您还必须提供 Amazon Kinesis Analytics 代表您写入到流或 Lambda 函数时代入的 IAM 角色。类型：[Output](API_Output.md) 对象数组必需：否 ** [Tags](#API_CreateApplication_RequestSyntax) ** 分配给应用程序的一个或多个标签的列表。标签是用于标识应用程序的键/值对。请注意，应用程序标签的最大数量包括系统标签。用户定义的应用程序标签的最大数量为 50。有关更多信息，请参阅[使用标签](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html)。类型：[Tag](API_Tag.md) 对象数组数组成员：最少 1 个物品。最多 200 项。必需：否 ## 响应语法 ``` { "ApplicationSummary": { "ApplicationARN": "string", "ApplicationName": "string", "ApplicationStatus": "string" } } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [ApplicationSummary](#API_CreateApplication_ResponseSyntax) ** 针对您的 `CreateApplication` 请求，Amazon Kinesis Analytics 会返回响应，其中包含其创建的应用程序摘要，包括应用程序的Amazon 资源名称 (ARN)、名称和状态。类型：[ApplicationSummary](API_ApplicationSummary.md) 对象 ## 错误 ** CodeValidationException ** 用户提供的应用程序代码（查询）无效。这可能是一个简单的语法错误。 ** message ** 测试 HTTP 状态代码：400 ** ConcurrentModificationException ** 由于对应用程序进行并发修改而引发的异常。例如，两个人尝试同时编辑同一个应用程序。 ** message ** HTTP 状态代码：400 ** InvalidArgumentException ** 指定的输入参数值无效。 ** message ** HTTP 状态代码：400 ** LimitExceededException ** 已超过允许的应用程序数量。 ** message ** HTTP 状态代码：400 ** ResourceInUseException ** 该应用程序不可用于此操作。 ** message ** HTTP 状态代码：400 ** TooManyTagsException ** 创建的应用程序具有太多标签，或者向应用程序添加过多的标签。请注意，应用程序标签的最大数量包括系统标签。用户定义的应用程序标签的最大数量为 50。 HTTP 状态代码：400 ** UnsupportedOperationException ** 由于不支持指定的参数或指定的资源对此操作无效，请求被拒绝。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/CreateApplication) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/CreateApplication) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/CreateApplication) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/CreateApplication) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/CreateApplication) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/CreateApplication) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/CreateApplication) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/CreateApplication) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/CreateApplication) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/CreateApplication) # DeleteApplication **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。删除指定的应用程序。Amazon Kinesis Analytics 会停止应用程序的执行并删除应用程序，包括任何应用程序构件 (例如应用程序内部流、引用表和应用程序代码)。此操作需要执行 `kinesisanalytics:DeleteApplication` 操作的权限。 ## 请求语法 ``` { "ApplicationName": "string", "CreateTimestamp": number } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ApplicationName](#API_DeleteApplication_RequestSyntax) ** 要删除的 Amazon Kinesis Analytics 应用程序名称。类型：字符串长度限制：最小长度为 1。最大长度为 128。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ** [CreateTimestamp](#API_DeleteApplication_RequestSyntax) ** 要获取此值，您可以使用 `DescribeApplication` 命令。类型：时间戳是否必需：是 ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误 ** ConcurrentModificationException ** 由于对应用程序进行并发修改而引发的异常。例如，两个人尝试同时编辑同一个应用程序。 ** message ** HTTP 状态代码：400 ** ResourceInUseException ** 该应用程序不可用于此操作。 ** message ** HTTP 状态代码：400 ** ResourceNotFoundException ** 无法找到指定的应用程序。 ** message ** HTTP 状态代码：400 ** UnsupportedOperationException ** 由于不支持指定的参数或指定的资源对此操作无效，请求被拒绝。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/DeleteApplication) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/DeleteApplication) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DeleteApplication) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/DeleteApplication) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DeleteApplication) + [AWS JavaScript V3 版 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DeleteApplication) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/DeleteApplication) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/DeleteApplication) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/DeleteApplication) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DeleteApplication) # DeleteApplicationCloudWatchLoggingOption **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。从应用程序中删除 CloudWatch 日志流。有关在 Amazon Kinesis Analytics 应用程序中使用 CloudWatch 日志流的[更多信息，请参阅使用 CloudWatch 亚马逊](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/cloudwatch-logs.html)日志。 ## 请求语法 ``` { "ApplicationName": "string", "CloudWatchLoggingOptionId": "string", "CurrentApplicationVersionId": number } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ApplicationName](#API_DeleteApplicationCloudWatchLoggingOption_RequestSyntax) ** Kinesis Analytics 应用程序的名称。类型：字符串长度限制：最小长度为 1。最大长度为 128。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ** [CloudWatchLoggingOptionId](#API_DeleteApplicationCloudWatchLoggingOption_RequestSyntax) ** 要删除`CloudWatchLoggingOptionId`的 CloudWatch 日志选项。可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 操作获取 `CloudWatchLoggingOptionId`。类型：字符串长度限制：最小长度为 1。最大长度为 50。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ** [CurrentApplicationVersionId](#API_DeleteApplicationCloudWatchLoggingOption_RequestSyntax) ** Kinesis Analytics 应用程序的版本 ID。类型：长整型有效范围：最小值为 1。最大值为 999999999。是否必需：是 ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误 ** ConcurrentModificationException ** 由于对应用程序进行并发修改而引发的异常。例如，两个人尝试同时编辑同一个应用程序。 ** message ** HTTP 状态代码：400 ** InvalidArgumentException ** 指定的输入参数值无效。 ** message ** HTTP 状态代码：400 ** ResourceInUseException ** 该应用程序不可用于此操作。 ** message ** HTTP 状态代码：400 ** ResourceNotFoundException ** 无法找到指定的应用程序。 ** message ** HTTP 状态代码：400 ** UnsupportedOperationException ** 由于不支持指定的参数或指定的资源对此操作无效，请求被拒绝。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DeleteApplicationCloudWatchLoggingOption) # DeleteApplicationInputProcessingConfiguration **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。从输入中删除 [InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html)。 ## 请求语法 ``` { "ApplicationName": "string", "CurrentApplicationVersionId": number, "InputId": "string" } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ApplicationName](#API_DeleteApplicationInputProcessingConfiguration_RequestSyntax) ** Kinesis Analytics 应用程序的名称。类型：字符串长度限制：最小长度为 1。最大长度为 128。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ** [CurrentApplicationVersionId](#API_DeleteApplicationInputProcessingConfiguration_RequestSyntax) ** Kinesis Analytics 应用程序的版本 ID。类型：长整型有效范围：最小值为 1。最大值为 999999999。是否必需：是 ** [InputId](#API_DeleteApplicationInputProcessingConfiguration_RequestSyntax) ** 要从中删除输入处理配置的输入配置的 ID。您可以使用[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html)操作获取应用程序 IDs 的输入列表。类型：字符串长度限制：最小长度为 1。最大长度为 50。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误 ** ConcurrentModificationException ** 由于对应用程序进行并发修改而引发的异常。例如，两个人尝试同时编辑同一个应用程序。 ** message ** HTTP 状态代码：400 ** InvalidArgumentException ** 指定的输入参数值无效。 ** message ** HTTP 状态代码：400 ** ResourceInUseException ** 该应用程序不可用于此操作。 ** message ** HTTP 状态代码：400 ** ResourceNotFoundException ** 无法找到指定的应用程序。 ** message ** HTTP 状态代码：400 ** UnsupportedOperationException ** 由于不支持指定的参数或指定的资源对此操作无效，请求被拒绝。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DeleteApplicationInputProcessingConfiguration) # DeleteApplicationOutput **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。从应用程序配置中删除输出目标配置。Amazon Kinesis Analytics 不再将数据从相应的应用程序内部流写入外部输出目标。此操作需要执行 `kinesisanalytics:DeleteApplicationOutput` 操作的权限。 ## 请求语法 ``` { "ApplicationName": "string", "CurrentApplicationVersionId": number, "OutputId": "string" } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ApplicationName](#API_DeleteApplicationOutput_RequestSyntax) ** Amazon Kinesis Analytics 应用程序的名称。类型：字符串长度限制：最小长度为 1。最大长度为 128。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ** [CurrentApplicationVersionId](#API_DeleteApplicationOutput_RequestSyntax) ** Amazon Kinesis Analytics 应用程序的版本。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 操作来获取当前的应用程序版本。如果指定的版本不是当前版本，则返回 `ConcurrentModificationException`。类型：长整型有效范围：最小值为 1。最大值为 999999999。是否必需：是 ** [OutputId](#API_DeleteApplicationOutput_RequestSyntax) ** 要删除的配置的 ID。无论是在创建应用程序时还是在稍后使用该[AddApplicationOutput](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_AddApplicationOutput.html)操作时，添加到应用程序的每个输出配置都有一个唯一的 ID。您需要提供 ID 以唯一标识要从应用程序配置中删除的输出配置。可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 操作来获取具体的 `OutputId`。类型：字符串长度限制：最小长度为 1。最大长度为 50。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误 ** ConcurrentModificationException ** 由于对应用程序进行并发修改而引发的异常。例如，两个人尝试同时编辑同一个应用程序。 ** message ** HTTP 状态代码：400 ** InvalidArgumentException ** 指定的输入参数值无效。 ** message ** HTTP 状态代码：400 ** ResourceInUseException ** 该应用程序不可用于此操作。 ** message ** HTTP 状态代码：400 ** ResourceNotFoundException ** 无法找到指定的应用程序。 ** message ** HTTP 状态代码：400 ** UnsupportedOperationException ** 由于不支持指定的参数或指定的资源对此操作无效，请求被拒绝。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/DeleteApplicationOutput) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/DeleteApplicationOutput) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DeleteApplicationOutput) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/DeleteApplicationOutput) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DeleteApplicationOutput) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DeleteApplicationOutput) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/DeleteApplicationOutput) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/DeleteApplicationOutput) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/DeleteApplicationOutput) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DeleteApplicationOutput) # DeleteApplicationReferenceDataSource **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。从指定的应用程序配置中删除引用数据源配置。如果应用程序正在运行，Amazon Kinesis Analytics 会立即删除您使用[AddApplicationReferenceDataSource](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_AddApplicationReferenceDataSource.html)该操作创建的应用程序内表。此操作需要执行 `kinesisanalytics.DeleteApplicationReferenceDataSource` 操作的权限。 ## 请求语法 ``` { "ApplicationName": "string", "CurrentApplicationVersionId": number, "ReferenceId": "string" } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ApplicationName](#API_DeleteApplicationReferenceDataSource_RequestSyntax) ** 现有应用程序的名称。类型：字符串长度限制：最小长度为 1。最大长度为 128。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ** [CurrentApplicationVersionId](#API_DeleteApplicationReferenceDataSource_RequestSyntax) ** 应用程序的版本。您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 操作来获取当前的应用程序版本。如果指定的版本不是当前版本，则返回 `ConcurrentModificationException`。类型：长整型有效范围：最小值为 1。最大值为 999999999。是否必需：是 ** [ReferenceId](#API_DeleteApplicationReferenceDataSource_RequestSyntax) ** 引用数据源的 ID。当您使用向应用程序添加参考数据源时，Amazon Kinesis Analytics 会分配一个 ID。[AddApplicationReferenceDataSource](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_AddApplicationReferenceDataSource.html)可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 操作来获取引用 ID。类型：字符串长度限制：最小长度为 1。最大长度为 50。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误 ** ConcurrentModificationException ** 由于对应用程序进行并发修改而引发的异常。例如，两个人尝试同时编辑同一个应用程序。 ** message ** HTTP 状态代码：400 ** InvalidArgumentException ** 指定的输入参数值无效。 ** message ** HTTP 状态代码：400 ** ResourceInUseException ** 该应用程序不可用于此操作。 ** message ** HTTP 状态代码：400 ** ResourceNotFoundException ** 无法找到指定的应用程序。 ** message ** HTTP 状态代码：400 ** UnsupportedOperationException ** 由于不支持指定的参数或指定的资源对此操作无效，请求被拒绝。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DeleteApplicationReferenceDataSource) # DescribeApplication **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。返回特定 Amazon Kinesis Analytics 应用程序的相关信息。如果您想检索账户中所有应用程序的列表，请使用 [ListApplications](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_ListApplications.html) 操作。此操作需要执行 `kinesisanalytics:DescribeApplication` 操作的权限。您可以使用 `DescribeApplication` 获取当前应用程序的版本 ID，从而调用其他操作，例如 `Update`。 ## 请求语法 ``` { "ApplicationName": "string" } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ApplicationName](#API_DescribeApplication_RequestSyntax) ** 应用程序的名称。类型：字符串长度限制：最小长度为 1。最大长度为 128。模式：`[a-zA-Z0-9_.-]+` 必需：是 ## 响应语法 ``` { "ApplicationDetail": { "ApplicationARN": "string", "ApplicationCode": "string", "ApplicationDescription": "string", "ApplicationName": "string", "ApplicationStatus": "string", "ApplicationVersionId": number, "CloudWatchLoggingOptionDescriptions": [ { "CloudWatchLoggingOptionId": "string", "LogStreamARN": "string", "RoleARN": "string" } ], "CreateTimestamp": number, "InputDescriptions": [ { "InAppStreamNames": [ "string" ], "InputId": "string", "InputParallelism": { "Count": number }, "InputProcessingConfigurationDescription": { "InputLambdaProcessorDescription": { "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" } }, "InputStartingPositionConfiguration": { "InputStartingPosition": "string" }, "KinesisFirehoseInputDescription": { "ResourceARN": "string", "RoleARN": "string" }, "KinesisStreamsInputDescription": { "ResourceARN": "string", "RoleARN": "string" }, "NamePrefix": "string" } ], "LastUpdateTimestamp": number, "OutputDescriptions": [ { "DestinationSchema": { "RecordFormatType": "string" }, "KinesisFirehoseOutputDescription": { "ResourceARN": "string", "RoleARN": "string" }, "KinesisStreamsOutputDescription": { "ResourceARN": "string", "RoleARN": "string" }, "LambdaOutputDescription": { "ResourceARN": "string", "RoleARN": "string" }, "Name": "string", "OutputId": "string" } ], "ReferenceDataSourceDescriptions": [ { "ReferenceId": "string", "ReferenceSchema": { "RecordColumns": [ { "Mapping": "string", "Name": "string", "SqlType": "string" } ], "RecordEncoding": "string", "RecordFormat": { "MappingParameters": { "CSVMappingParameters": { "RecordColumnDelimiter": "string", "RecordRowDelimiter": "string" }, "JSONMappingParameters": { "RecordRowPath": "string" } }, "RecordFormatType": "string" } }, "S3ReferenceDataSourceDescription": { "BucketARN": "string", "FileKey": "string", "ReferenceRoleARN": "string" }, "TableName": "string" } ] } } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [ApplicationDetail](#API_DescribeApplication_ResponseSyntax) ** 提供对应用程序的描述，例如应用程序 Amazon 资源名称（ARN）、状态、最新版本以及输入和输出配置详情。类型：[ApplicationDetail](API_ApplicationDetail.md) 对象 ## 错误 ** ResourceNotFoundException ** 无法找到指定的应用程序。 ** message ** HTTP 状态代码：400 ** UnsupportedOperationException ** 由于不支持指定的参数或指定的资源对此操作无效，请求被拒绝。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/DescribeApplication) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/DescribeApplication) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DescribeApplication) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/DescribeApplication) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DescribeApplication) + [AWS JavaScript V3 版 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DescribeApplication) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/DescribeApplication) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/DescribeApplication) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/DescribeApplication) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DescribeApplication) # DiscoverInputSchema **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。通过评估指定流式传输源 (Amazon Kinesis 流或 Amazon Kinesis Firehose 传输流) 或 S3 对象上的示例记录，推断架构。在响应中，该操作返回推断的架构以及该操作用于推断架构的示例记录。在为应用程序配置流式传输来源时，您可以使用此推断的架构。有关概念信息，请参阅[配置应用程序输入](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)。注意：使用 Amazon Kinesis Analytics 控制台创建应用程序时，控制台使用此操作来推断架构并将其显示在控制台用户界面中。此操作需要执行 `kinesisanalytics:DiscoverInputSchema` 操作的权限。 ## 请求语法 ``` { "InputProcessingConfiguration": { "InputLambdaProcessor": { "ResourceARN": "string", "RoleARN": "string" } }, "InputStartingPositionConfiguration": { "InputStartingPosition": "string" }, "ResourceARN": "string", "RoleARN": "string", "S3Configuration": { "BucketARN": "string", "FileKey": "string", "RoleARN": "string" } } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [InputProcessingConfiguration](#API_DiscoverInputSchema_RequestSyntax) ** [InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html) 用于在发现记录架构之前对记录进行预处理。类型：[InputProcessingConfiguration](API_InputProcessingConfiguration.md) 对象必需：否 ** [InputStartingPositionConfiguration](#API_DiscoverInputSchema_RequestSyntax) ** 您希望 Amazon Kinesis Analytics 根据指定流式传输源发现目的开始读取记录的时刻。类型：[InputStartingPositionConfiguration](API_InputStartingPositionConfiguration.md) 对象必需：否 ** [ResourceARN](#API_DiscoverInputSchema_RequestSyntax) ** 流式传输来源的 Amazon 资源名称（ARN）。类型：字符串长度限制：最小长度为 1。最大长度为 2048。模式：`arn:.*` 必需：否 ** [RoleARN](#API_DiscoverInputSchema_RequestSyntax) ** 可由 Amazon Kinesis Analytics 代入以代表您访问流的 IAM 角色的 ARN。类型：字符串长度限制：最小长度为 1。最大长度为 2048。模式：`arn:.*` 必需：否 ** [S3Configuration](#API_DiscoverInputSchema_RequestSyntax) ** 指定此参数可从 Amazon S3 对象中的数据发现架构。类型：[S3Configuration](API_S3Configuration.md) 对象必需：否 ## 响应语法 ``` { "InputSchema": { "RecordColumns": [ { "Mapping": "string", "Name": "string", "SqlType": "string" } ], "RecordEncoding": "string", "RecordFormat": { "MappingParameters": { "CSVMappingParameters": { "RecordColumnDelimiter": "string", "RecordRowDelimiter": "string" }, "JSONMappingParameters": { "RecordRowPath": "string" } }, "RecordFormatType": "string" } }, "ParsedInputRecords": [ [ "string" ] ], "ProcessedInputRecords": [ "string" ], "RawInputRecords": [ "string" ] } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [InputSchema](#API_DiscoverInputSchema_ResponseSyntax) ** 从流式传输来源推断出的架构。它识别流式传输来源中数据的格式，以及每个数据元素如何映射到在应用程序内部流中创建的相应列。类型：[SourceSchema](API_SourceSchema.md) 对象 ** [ParsedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) ** 一个元素数组，其中每个元素对应于流记录中的一行（流记录可以有多行）。类型：字符串数组的数组。 ** [ProcessedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) ** 由 `InputProcessingConfiguration` 参数中指定的处理器修改的流数据。类型：字符串数组 ** [RawInputRecords](#API_DiscoverInputSchema_ResponseSyntax) ** 为推断架构而采样的原始流数据。类型：字符串数组 ## 错误 ** InvalidArgumentException ** 指定的输入参数值无效。 ** message ** HTTP 状态代码：400 ** ResourceProvisionedThroughputExceededException ** 由于亚马逊 Kinesis Streams 的缘故，Dis ProvisionedThroughputExceededException covery 未能从直播来源获得记录。有关更多信息，请参阅[GetRecords](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_GetRecords.html)《亚马逊 Kinesis Streams API 参考》。 HTTP 状态代码：400 ** ServiceUnavailableException ** 该服务不可用。退后一步，重试该操作。 HTTP 状态代码：500 ** UnableToDetectSchemaException ** 数据格式无效。Amazon Kinesis Analytics 无法检测给定流式传输源的架构。 HTTP 状态代码：400 ** UnsupportedOperationException ** 由于不支持指定的参数或指定的资源对此操作无效，请求被拒绝。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DiscoverInputSchema) # ListApplications **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。返回您账户中的 Amazon Kinesis Analytics 应用程序列表。每个应用程序的响应都包括应用程序的名称、Amazon 资源名称（ARN）以及状态。如果响应返回 `HasMoreApplications` 值为 true，则可以通过在请求正文中添加 `ExclusiveStartApplicationName` 来发送另一个请求，然后将其值设置为上一个响应中的最后一个应用程序名称。如果您想了解有关特定应用程序的详细信息，请使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html)。此操作需要执行 `kinesisanalytics:ListApplications` 操作的权限。 ## 请求语法 ``` { "ExclusiveStartApplicationName": "string", "Limit": number } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ExclusiveStartApplicationName](#API_ListApplications_RequestSyntax) ** 列表开头应用程序的名称。在使用分页检索列表时，不需要在第一个请求中指定此参数。但是，在随后的请求中，您可以通过添加上一个响应中的最后一个应用程序名称，获取下一页的应用程序。类型：字符串长度限制：最小长度为 1。最大长度为 128。模式：`[a-zA-Z0-9_.-]+` 必需：否 ** [Limit](#API_ListApplications_RequestSyntax) ** 应用程序的最大数量类型：整数有效范围：最小值为 1。最大值为 50。必需：否 ## 响应语法 ``` { "ApplicationSummaries": [ { "ApplicationARN": "string", "ApplicationName": "string", "ApplicationStatus": "string" } ], "HasMoreApplications": boolean } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [ApplicationSummaries](#API_ListApplications_ResponseSyntax) ** `ApplicationSummary` 对象的列表。类型：[ApplicationSummary](API_ApplicationSummary.md) 对象数组 ** [HasMoreApplications](#API_ListApplications_ResponseSyntax) ** 如需检索更多应用程序，则返回 true。类型：布尔值 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/ListApplications) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/ListApplications) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/ListApplications) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/ListApplications) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/ListApplications) + [AWS JavaScript V3 版 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/ListApplications) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/ListApplications) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/ListApplications) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/ListApplications) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/ListApplications) # ListTagsForResource 检索分配给应用程序的键值标签列表。有关更多信息，请参阅[使用标记](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html)。 ## 请求语法 ``` { "ResourceARN": "string" } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ResourceARN](#API_ListTagsForResource_RequestSyntax) ** 要检索其标签的应用程序的 ARN。类型：字符串长度限制：最小长度为 1。最大长度为 2048。模式：`arn:.*` 必需：是 ## 响应语法 ``` { "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 响应元素如果此操作成功，则该服务将会发送回 HTTP 200 响应。服务以 JSON 格式返回以下数据。 ** [Tags](#API_ListTagsForResource_ResponseSyntax) ** 分配给应用程序的键值标签。类型：[Tag](API_Tag.md) 对象数组数组成员：最少 1 个物品。最多 200 项。 ## 错误 ** ConcurrentModificationException ** 由于对应用程序进行并发修改而引发的异常。例如，两个人尝试同时编辑同一个应用程序。 ** message ** HTTP 状态代码：400 ** InvalidArgumentException ** 指定的输入参数值无效。 ** message ** HTTP 状态代码：400 ** ResourceNotFoundException ** 无法找到指定的应用程序。 ** message ** HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/ListTagsForResource) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/ListTagsForResource) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/ListTagsForResource) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/ListTagsForResource) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/ListTagsForResource) + [AWS JavaScript V3 版 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/ListTagsForResource) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/ListTagsForResource) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/ListTagsForResource) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/ListTagsForResource) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/ListTagsForResource) # StartApplication **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。启动指定的 Amazon Kinesis Analytics 应用程序。创建应用程序后，必须以独占方式调用此操作才能启动应用程序。应用程序启动后，开始使用输入数据，对其进行处理，然后将输出写入配置的目的地。应用程序在 `READY` 状态下才能启动。您可以在控制台中或使用[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html)操作获取应用程序状态。启动应用程序后，您可以通过调用该[StopApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_StopApplication.html)操作来停止应用程序处理输入。此操作需要执行 `kinesisanalytics:StartApplication` 操作的权限。 ## 请求语法 ``` { "ApplicationName": "string", "InputConfigurations": [ { "Id": "string", "InputStartingPositionConfiguration": { "InputStartingPosition": "string" } } ] } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ApplicationName](#API_StartApplication_RequestSyntax) ** 应用程序的名称。类型：字符串长度限制：最小长度为 1。最大长度为 128。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ** [InputConfigurations](#API_StartApplication_RequestSyntax) ** 使用 ID 标识应用程序最开始使用的输入。Amazon Kinesis Analytics 开始读取与输入相关的流式传输源。您还可以指定流式传输源中 Amazon Kinesis Analytics 读取起始位置。类型：[InputConfiguration](API_InputConfiguration.md) 对象数组是否必需：是 ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误 ** InvalidApplicationConfigurationException ** 用户提供的应用程序配置无效。 ** message ** 测试 HTTP 状态代码：400 ** InvalidArgumentException ** 指定的输入参数值无效。 ** message ** HTTP 状态代码：400 ** ResourceInUseException ** 该应用程序不可用于此操作。 ** message ** HTTP 状态代码：400 ** ResourceNotFoundException ** 无法找到指定的应用程序。 ** message ** HTTP 状态代码：400 ** UnsupportedOperationException ** 由于不支持指定的参数或指定的资源对此操作无效，请求被拒绝。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/StartApplication) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/StartApplication) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/StartApplication) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/StartApplication) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/StartApplication) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/StartApplication) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/StartApplication) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/StartApplication) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/StartApplication) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/StartApplication) # StopApplication **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。暂停应用程序处理输入数据。只有当应用程序处于运行状态时，才可以暂停该应用程序。您可以使用该[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html)操作来查找应用程序状态。应用程序暂停后，Amazon Kinesis Analytics 不再从输入中读取数据，应用程序不再处理数据，并且不产生写入目标的输出。此操作需要执行 `kinesisanalytics:StopApplication` 操作的权限。 ## 请求语法 ``` { "ApplicationName": "string" } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ApplicationName](#API_StopApplication_RequestSyntax) ** 要停止的运行中应用程序的名称。类型：字符串长度限制：最小长度为 1。最大长度为 128。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误 ** ResourceInUseException ** 该应用程序不可用于此操作。 ** message ** HTTP 状态代码：400 ** ResourceNotFoundException ** 无法找到指定的应用程序。 ** message ** HTTP 状态代码：400 ** UnsupportedOperationException ** 由于不支持指定的参数或指定的资源对此操作无效，请求被拒绝。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/StopApplication) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/StopApplication) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/StopApplication) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/StopApplication) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/StopApplication) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/StopApplication) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/StopApplication) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/StopApplication) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/StopApplication) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/StopApplication) # TagResource 向 Kinesis Analytics 应用程序添加一个或多个键值标签。请注意，应用程序标签的最大数量包括系统标签。用户定义的应用程序标签的最大数量为 50。有关更多信息，请参阅[使用标签](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html)。 ## 请求语法 ``` { "ResourceARN": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ResourceARN](#API_TagResource_RequestSyntax) ** 向其分配标签的应用程序的 ARN。类型：字符串长度限制：最小长度为 1。最大长度为 2048。模式：`arn:.*` 是否必需：是 ** [Tags](#API_TagResource_RequestSyntax) ** 分配给应用程序的键值标签。类型：[Tag](API_Tag.md) 对象数组数组成员：最少 1 个物品。最多 200 项。是否必需：是 ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误 ** ConcurrentModificationException ** 由于对应用程序进行并发修改而引发的异常。例如，两个人尝试同时编辑同一个应用程序。 ** message ** HTTP 状态代码：400 ** InvalidArgumentException ** 指定的输入参数值无效。 ** message ** HTTP 状态代码：400 ** ResourceInUseException ** 该应用程序不可用于此操作。 ** message ** HTTP 状态代码：400 ** ResourceNotFoundException ** 无法找到指定的应用程序。 ** message ** HTTP 状态代码：400 ** TooManyTagsException ** 创建的应用程序具有太多标签，或者向应用程序添加过多的标签。请注意，应用程序标签的最大数量包括系统标签。用户定义的应用程序标签的最大数量为 50。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/TagResource) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/TagResource) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/TagResource) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/TagResource) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/TagResource) + [AWS JavaScript V3 版 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/TagResource) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/TagResource) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/TagResource) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/TagResource) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/TagResource) # UntagResource 删除 Kinesis Analytics 应用程序中的一个或多个标签。有关更多信息，请参阅[使用标记](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html)。 ## 请求语法 ``` { "ResourceARN": "string", "TagKeys": [ "string" ] } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ResourceARN](#API_UntagResource_RequestSyntax) ** 要删除标签的 Kinesis Analytics 应用程序 ARN。类型：字符串长度限制：最小长度为 1。最大长度为 2048。模式：`arn:.*` 是否必需：是 ** [TagKeys](#API_UntagResource_RequestSyntax) ** 要从指定应用程序中移除的标签键列表。类型：字符串数组数组成员：最少 1 个物品。最多 200 项。长度限制：最小长度为 1。最大长度为 128。是否必需：是 ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误 ** ConcurrentModificationException ** 由于对应用程序进行并发修改而引发的异常。例如，两个人尝试同时编辑同一个应用程序。 ** message ** HTTP 状态代码：400 ** InvalidArgumentException ** 指定的输入参数值无效。 ** message ** HTTP 状态代码：400 ** ResourceInUseException ** 该应用程序不可用于此操作。 ** message ** HTTP 状态代码：400 ** ResourceNotFoundException ** 无法找到指定的应用程序。 ** message ** HTTP 状态代码：400 ** TooManyTagsException ** 创建的应用程序具有太多标签，或者向应用程序添加过多的标签。请注意，应用程序标签的最大数量包括系统标签。用户定义的应用程序标签的最大数量为 50。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/UntagResource) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/UntagResource) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/UntagResource) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/UntagResource) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/UntagResource) + [AWS JavaScript V3 版 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/UntagResource) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/UntagResource) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/UntagResource) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/UntagResource) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/UntagResource) # UpdateApplication **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。更新现有的 Amazon Kinesis Analytics 应用程序。使用此 API，您可以更新应用程序代码、输入配置和输出配置。请注意，每次更新应用程序时，Amazon Kinesis Analytics 都会更新 `CurrentApplicationVersionId`。此操作需要 `kinesisanalytics:UpdateApplication` 操作权限。 ## 请求语法 ``` { "ApplicationName": "string", "ApplicationUpdate": { "ApplicationCodeUpdate": "string", "CloudWatchLoggingOptionUpdates": [ { "CloudWatchLoggingOptionId": "string", "LogStreamARNUpdate": "string", "RoleARNUpdate": "string" } ], "InputUpdates": [ { "InputId": "string", "InputParallelismUpdate": { "CountUpdate": number }, "InputProcessingConfigurationUpdate": { "InputLambdaProcessorUpdate": { "ResourceARNUpdate": "string", "RoleARNUpdate": "string" } }, "InputSchemaUpdate": { "RecordColumnUpdates": [ { "Mapping": "string", "Name": "string", "SqlType": "string" } ], "RecordEncodingUpdate": "string", "RecordFormatUpdate": { "MappingParameters": { "CSVMappingParameters": { "RecordColumnDelimiter": "string", "RecordRowDelimiter": "string" }, "JSONMappingParameters": { "RecordRowPath": "string" } }, "RecordFormatType": "string" } }, "KinesisFirehoseInputUpdate": { "ResourceARNUpdate": "string", "RoleARNUpdate": "string" }, "KinesisStreamsInputUpdate": { "ResourceARNUpdate": "string", "RoleARNUpdate": "string" }, "NamePrefixUpdate": "string" } ], "OutputUpdates": [ { "DestinationSchemaUpdate": { "RecordFormatType": "string" }, "KinesisFirehoseOutputUpdate": { "ResourceARNUpdate": "string", "RoleARNUpdate": "string" }, "KinesisStreamsOutputUpdate": { "ResourceARNUpdate": "string", "RoleARNUpdate": "string" }, "LambdaOutputUpdate": { "ResourceARNUpdate": "string", "RoleARNUpdate": "string" }, "NameUpdate": "string", "OutputId": "string" } ], "ReferenceDataSourceUpdates": [ { "ReferenceId": "string", "ReferenceSchemaUpdate": { "RecordColumns": [ { "Mapping": "string", "Name": "string", "SqlType": "string" } ], "RecordEncoding": "string", "RecordFormat": { "MappingParameters": { "CSVMappingParameters": { "RecordColumnDelimiter": "string", "RecordRowDelimiter": "string" }, "JSONMappingParameters": { "RecordRowPath": "string" } }, "RecordFormatType": "string" } }, "S3ReferenceDataSourceUpdate": { "BucketARNUpdate": "string", "FileKeyUpdate": "string", "ReferenceRoleARNUpdate": "string" }, "TableNameUpdate": "string" } ] }, "CurrentApplicationVersionId": number } ``` ## 请求参数请求接受采用 JSON 格式的以下数据。 ** [ApplicationName](#API_UpdateApplication_RequestSyntax) ** 要更新的 Amazon Kinesis Analytics 应用程序的名称。类型：字符串长度限制：最小长度为 1。最大长度为 128。模式：`[a-zA-Z0-9_.-]+` 是否必需：是 ** [ApplicationUpdate](#API_UpdateApplication_RequestSyntax) ** 描述应用程序的更新。类型：[ApplicationUpdate](API_ApplicationUpdate.md) 对象是否必需：是 ** [CurrentApplicationVersionId](#API_UpdateApplication_RequestSyntax) ** 当前应用程序版本 ID。要获取此值，您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 命令。类型：长整型有效范围：最小值为 1。最大值为 999999999。是否必需：是 ## 响应元素如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误 ** CodeValidationException ** 用户提供的应用程序代码（查询）无效。这可能是一个简单的语法错误。 ** message ** 测试 HTTP 状态代码：400 ** ConcurrentModificationException ** 由于对应用程序进行并发修改而引发的异常。例如，两个人尝试同时编辑同一个应用程序。 ** message ** HTTP 状态代码：400 ** InvalidArgumentException ** 指定的输入参数值无效。 ** message ** HTTP 状态代码：400 ** ResourceInUseException ** 该应用程序不可用于此操作。 ** message ** HTTP 状态代码：400 ** ResourceNotFoundException ** 无法找到指定的应用程序。 ** message ** HTTP 状态代码：400 ** UnsupportedOperationException ** 由于不支持指定的参数或指定的资源对此操作无效，请求被拒绝。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/UpdateApplication) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/UpdateApplication) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/UpdateApplication) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/UpdateApplication) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/UpdateApplication) + [AWS JavaScript V3 版 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/UpdateApplication) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/UpdateApplication) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/UpdateApplication) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/UpdateApplication) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/UpdateApplication) # 数据类型支持以下数据类型： + [ApplicationDetail](API_ApplicationDetail.md) + [ApplicationSummary](API_ApplicationSummary.md) + [ApplicationUpdate](API_ApplicationUpdate.md) + [CloudWatchLoggingOption](API_CloudWatchLoggingOption.md) + [CloudWatchLoggingOptionDescription](API_CloudWatchLoggingOptionDescription.md) + [CloudWatchLoggingOptionUpdate](API_CloudWatchLoggingOptionUpdate.md) + [CSVMappingParameters](API_CSVMappingParameters.md) + [DestinationSchema](API_DestinationSchema.md) + [Input](API_Input.md) + [InputConfiguration](API_InputConfiguration.md) + [InputDescription](API_InputDescription.md) + [InputLambdaProcessor](API_InputLambdaProcessor.md) + [InputLambdaProcessorDescription](API_InputLambdaProcessorDescription.md) + [InputLambdaProcessorUpdate](API_InputLambdaProcessorUpdate.md) + [InputParallelism](API_InputParallelism.md) + [InputParallelismUpdate](API_InputParallelismUpdate.md) + [InputProcessingConfiguration](API_InputProcessingConfiguration.md) + [InputProcessingConfigurationDescription](API_InputProcessingConfigurationDescription.md) + [InputProcessingConfigurationUpdate](API_InputProcessingConfigurationUpdate.md) + [InputSchemaUpdate](API_InputSchemaUpdate.md) + [InputStartingPositionConfiguration](API_InputStartingPositionConfiguration.md) + [InputUpdate](API_InputUpdate.md) + [JSONMappingParameters](API_JSONMappingParameters.md) + [KinesisFirehoseInput](API_KinesisFirehoseInput.md) + [KinesisFirehoseInputDescription](API_KinesisFirehoseInputDescription.md) + [KinesisFirehoseInputUpdate](API_KinesisFirehoseInputUpdate.md) + [KinesisFirehoseOutput](API_KinesisFirehoseOutput.md) + [KinesisFirehoseOutputDescription](API_KinesisFirehoseOutputDescription.md) + [KinesisFirehoseOutputUpdate](API_KinesisFirehoseOutputUpdate.md) + [KinesisStreamsInput](API_KinesisStreamsInput.md) + [KinesisStreamsInputDescription](API_KinesisStreamsInputDescription.md) + [KinesisStreamsInputUpdate](API_KinesisStreamsInputUpdate.md) + [KinesisStreamsOutput](API_KinesisStreamsOutput.md) + [KinesisStreamsOutputDescription](API_KinesisStreamsOutputDescription.md) + [KinesisStreamsOutputUpdate](API_KinesisStreamsOutputUpdate.md) + [LambdaOutput](API_LambdaOutput.md) + [LambdaOutputDescription](API_LambdaOutputDescription.md) + [LambdaOutputUpdate](API_LambdaOutputUpdate.md) + [MappingParameters](API_MappingParameters.md) + [Output](API_Output.md) + [OutputDescription](API_OutputDescription.md) + [OutputUpdate](API_OutputUpdate.md) + [RecordColumn](API_RecordColumn.md) + [RecordFormat](API_RecordFormat.md) + [ReferenceDataSource](API_ReferenceDataSource.md) + [ReferenceDataSourceDescription](API_ReferenceDataSourceDescription.md) + [ReferenceDataSourceUpdate](API_ReferenceDataSourceUpdate.md) + [S3Configuration](API_S3Configuration.md) + [S3ReferenceDataSource](API_S3ReferenceDataSource.md) + [S3ReferenceDataSourceDescription](API_S3ReferenceDataSourceDescription.md) + [S3ReferenceDataSourceUpdate](API_S3ReferenceDataSourceUpdate.md) + [SourceSchema](API_SourceSchema.md) + [Tag](API_Tag.md) # ApplicationDetail **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。提供对应用程序的描述，包括应用程序 Amazon 资源名称（ARN）、状态、最新版本以及输入和输出配置。 ## 内容 ** ApplicationARN ** 应用程序的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ** ApplicationName ** 应用程序的名称。类型：字符串长度限制：长度下限为 1。最大长度为 128。模式：`[a-zA-Z0-9_.-]+` 必需：是 ** ApplicationStatus ** 应用程序的状态。类型：字符串有效值：`DELETING | STARTING | STOPPING | READY | RUNNING | UPDATING | AUTOSCALING` 必需：是 ** ApplicationVersionId ** 请注意当前应用程序版本。类型：长整型有效范围：最小值为 1。最大值为 999999999。必需：是 ** ApplicationCode ** 返回应用程序中您对任何应用程序内部流执行数据分析而提供的应用程序代码。类型：字符串长度约束：最小长度为 0。最大长度为 102400。必需：否 ** ApplicationDescription ** 应用程序的描述。类型：字符串长度约束：最小长度为 0。最大长度为 1024。必需：否 ** CloudWatchLoggingOptionDescriptions ** 描述配置为接收应用程序消息的 CloudWatch 日志流。有关在 Amazon Kinesis Analytics 应用程序中使用 CloudWatch 日志流的[更多信息，请参阅使用 CloudWatch 亚马逊](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/cloudwatch-logs.html)日志。类型：[CloudWatchLoggingOptionDescription](API_CloudWatchLoggingOptionDescription.md) 对象数组必需：否 ** CreateTimestamp ** 创建应用程序版本的时间戳。类型：时间戳必需：否 ** InputDescriptions ** 描述应用程序输入配置。有关更多信息，请参阅[配置应用程序输入](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)。类型：[InputDescription](API_InputDescription.md) 对象数组必需：否 ** LastUpdateTimestamp ** 上次更新应用程序的时间戳。类型：时间戳必需：否 ** OutputDescriptions ** 描述应用程序输出配置。有关更多信息，请参阅[配置应用程序输出](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-output.html)。类型：[OutputDescription](API_OutputDescription.md) 对象数组必需：否 ** ReferenceDataSourceDescriptions ** 描述为应用程序配置的引用数据来源。有关更多信息，请参阅[配置应用程序输入](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)。类型：[ReferenceDataSourceDescription](API_ReferenceDataSourceDescription.md) 对象数组必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/ApplicationDetail) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/ApplicationDetail) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/ApplicationDetail) # ApplicationSummary **注意** 本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 [Amazon Kinesis Data Analytics API V2 文档](/kinesisanalytics/latest/apiv2/Welcome.html)。提供应用程序摘要信息，包括应用程序 Amazon 资源名称（ARN）、名称和状态。 ## 内容 ** ApplicationARN ** 应用程序的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ** ApplicationName ** 应用程序的名称。类型：字符串长度限制：长度下限为 1。最大长度为 128。模式：`[a-zA-Z0-9_.-]+` 必需：是 ** ApplicationStatus ** 应用程序的状态。类型：字符串有效值：`DELETING | STARTING | STOPPING | READY | RUNNING | UPDATING | AUTOSCALING` 必需：是 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/ApplicationSummary) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/ApplicationSummary) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/ApplicationSummary) # ApplicationUpdate 描述适用于现有 Amazon Kinesis Analytics 应用程序的更新。 ## 内容 ** ApplicationCodeUpdate ** 描述应用程序代码更新。类型：字符串长度约束：最小长度为 0。最大长度为 102400。必需：否 ** CloudWatchLoggingOptionUpdates ** 描述应用程序 CloudWatch 日志记录选项的更新。类型：[CloudWatchLoggingOptionUpdate](API_CloudWatchLoggingOptionUpdate.md) 对象数组必需：否 ** InputUpdates ** 描述应用程序输入配置更新。类型：[InputUpdate](API_InputUpdate.md) 对象数组必需：否 ** OutputUpdates ** 描述应用程序输出配置更新。类型：[OutputUpdate](API_OutputUpdate.md) 对象数组必需：否 ** ReferenceDataSourceUpdates ** 描述应用程序参考数据源更新。类型：[ReferenceDataSourceUpdate](API_ReferenceDataSourceUpdate.md) 对象数组必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/ApplicationUpdate) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/ApplicationUpdate) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/ApplicationUpdate) # CloudWatchLoggingOption 提供 CloudWatch 日志选项的描述，包括日志流 Amazon 资源名称 (ARN) 和角色 ARN。 ## 内容 ** LogStreamARN ** 用于接收应用程序消息的 CloudWatch 日志的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ** RoleARN ** 用于发送应用程序消息的角色的 IAM ARN。注意：要向写入应用程序消息 CloudWatch，所使用的 IAM 角色必须启用`PutLogEvents`策略操作。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/CloudWatchLoggingOption) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/CloudWatchLoggingOption) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/CloudWatchLoggingOption) # CloudWatchLoggingOptionDescription CloudWatch 日志选项的描述。 ## 内容 ** LogStreamARN ** 用于接收应用程序消息的 CloudWatch 日志的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ** RoleARN ** 用于发送应用程序消息的角色的 IAM ARN。注意：要向写入应用程序消息 CloudWatch，所使用的 IAM 角色必须启用`PutLogEvents`策略操作。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ** CloudWatchLoggingOptionId ** CloudWatch 日志选项描述的 ID。类型：字符串长度限制：长度下限为 1。最大长度为 50。模式：`[a-zA-Z0-9_.-]+` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/CloudWatchLoggingOptionDescription) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/CloudWatchLoggingOptionDescription) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/CloudWatchLoggingOptionDescription) # CloudWatchLoggingOptionUpdate 描述 CloudWatch 日志选项的更新。 ## 内容 ** CloudWatchLoggingOptionId ** 要更新的 CloudWatch 日志记录选项的 ID 类型：字符串长度限制：长度下限为 1。最大长度为 50。模式：`[a-zA-Z0-9_.-]+` 必需：是 ** LogStreamARNUpdate ** 用于接收应用程序消息的 CloudWatch 日志的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ** RoleARNUpdate ** 用于发送应用程序消息的角色的 IAM ARN。注意：要向写入应用程序消息 CloudWatch，所使用的 IAM 角色必须启用`PutLogEvents`策略操作。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/CloudWatchLoggingOptionUpdate) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/CloudWatchLoggingOptionUpdate) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/CloudWatchLoggingOptionUpdate) # CSVMappingParameters 提供当记录格式使用带分隔符的格式（如 CSV）时的其他映射信息。例如，以下示例记录使用 CSV 格式，其中记录使用“*\$1n”*作为行分隔符，使用逗号（“,”）作为列分隔符： `"name1", "address1"` `"name2", "address2"` ## 内容 ** RecordColumnDelimiter ** 列分隔符。例如，在 CSV 格式中，逗号（“,”）是典型列分隔符。类型：字符串长度限制：长度下限为 1。必需：是 ** RecordRowDelimiter ** 行分隔符。例如，在 CSV 格式中，*“\$1n”*是典型行分隔符。类型：字符串长度限制：长度下限为 1。必需：是 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/CSVMappingParameters) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/CSVMappingParameters) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/CSVMappingParameters) # DestinationSchema 描述将记录写入目标时的数据格式。有关更多信息，请参阅[配置应用程序输出](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-output.html)。 ## 内容 ** RecordFormatType ** 指定输出流上的记录格式。类型：字符串有效值：`JSON | CSV` 必需：是 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DestinationSchema) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DestinationSchema) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DestinationSchema) # Input 配置应用程序输入时，请指定流式源、创建的应用程序内部流名称以及二者之间的映射。有关更多信息，请参阅[配置应用程序输入](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)。 ## 内容 ** InputSchema ** 描述流式源中的数据的格式以及每个数据元素映射到所创建应用程序内部流中的相应列的方式。还用于描述引用数据来源的格式。类型：[SourceSchema](API_SourceSchema.md) 对象必需：是 ** NamePrefix ** 创建应用程序内部流时要使用的名称前缀。假设您指定了前缀 “MyInApplicationStream。” 然后，Amazon Kinesis Analytics 会创建一个或多个（根据`InputParallelism`您指定的数量）应用程序内流，名称MyInApplicationStream为 “\$1001”、MyInApplicationStream “\$1002” 等。类型：字符串长度限制：长度下限为 1。最大长度为 32。必需：是 ** InputParallelism ** 描述要创建的应用程序内部流的数量。您的源中的数据将路由到这些应用程序内部输入流。（请参阅[配置应用程序输入](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)。）类型：[InputParallelism](API_InputParallelism.md) 对象必需：否 ** InputProcessingConfiguration ** 输入的 [InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html)。在应用程序的 SQL 代码执行之前，输入处理器会在从流收到记录时转换记录。目前，唯一可用的输入处理配置为 [InputLambdaProcessor](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputLambdaProcessor.html)。类型：[InputProcessingConfiguration](API_InputProcessingConfiguration.md) 对象必需：否 ** KinesisFirehoseInput ** 如果流式源是一个 Amazon Kinesis Firehose 传输流，则标识该传输流的 ARN 和可让 Amazon Kinesis Analytics 代表您访问该流的 IAM 角色。注意：需要 `KinesisStreamsInput` 或 `KinesisFirehoseInput` 之一。类型：[KinesisFirehoseInput](API_KinesisFirehoseInput.md) 对象必需：否 ** KinesisStreamsInput ** 如果流式源是一个 Amazon Kinesis 流，则标识该传输流的 Amazon 资源名称（ARN）和可让 Amazon Kinesis Analytics 代表您访问该流的 IAM 角色。注意：需要 `KinesisStreamsInput` 或 `KinesisFirehoseInput` 之一。类型：[KinesisStreamsInput](API_KinesisStreamsInput.md) 对象必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/Input) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/Input) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/Input) # InputConfiguration 启动应用程序时，您需要提供此配置，该配置用于标识输入源以及您希望应用程序开始处理记录的输入源中的时间点。 ## 内容 ** Id ** 输入源 ID。可以通过调用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 操作来获取此 ID。类型：字符串长度限制：长度下限为 1。最大长度为 50。模式：`[a-zA-Z0-9_.-]+` 必需：是 ** InputStartingPositionConfiguration ** 您希望应用程序开始处理来自流式传输源的记录的时间点。类型：[InputStartingPositionConfiguration](API_InputStartingPositionConfiguration.md) 对象必需：是 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputConfiguration) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputConfiguration) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputConfiguration) # InputDescription 描述应用程序输入配置。有关更多信息，请参阅[配置应用程序输入](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)。 ## 内容 ** InAppStreamNames ** 返回映射到流式传输源的应用程序内流名称。类型：字符串数组长度约束：最小长度为 1。最大长度为 32。必需：否 ** InputId ** 输入与应用程序输入关联的 ID。这是 Amazon Kinesis Analytics 为您添加到您应用程序中的每个输入配置分配的 ID。类型：字符串长度限制：长度下限为 1。最大长度为 50。模式：`[a-zA-Z0-9_.-]+` 必需：否 ** InputParallelism ** 描述配置的并行度 (映射到流式传输源的应用程序内流的数量)。类型：[InputParallelism](API_InputParallelism.md) 对象必需：否 ** InputProcessingConfigurationDescription ** 应用程序代码运行之前，在此输入中的记录上执行的预处理器的描述。类型：[InputProcessingConfigurationDescription](API_InputProcessingConfigurationDescription.md) 对象必需：否 ** InputSchema ** 描述流式源中的数据的格式以及每个数据元素映射到所创建应用程序内部流中的相应列的方式。类型：[SourceSchema](API_SourceSchema.md) 对象必需：否 ** InputStartingPositionConfiguration ** 将应用程序配置为从输入流中读取数据的时间点。类型：[InputStartingPositionConfiguration](API_InputStartingPositionConfiguration.md) 对象必需：否 ** KinesisFirehoseInputDescription ** 如果 Amazon Kinesis Firehose 传输流被配置为流式源，则标识该传输流的 ARN 和可让 Amazon Kinesis Analytics 代表您访问该流的 IAM 角色。类型：[KinesisFirehoseInputDescription](API_KinesisFirehoseInputDescription.md) 对象必需：否 ** KinesisStreamsInputDescription ** 如果 Amazon Kinesis 流被配置为流式源，则标识 Amazon Kinesis 流的 Amazon 资源名称 (ARN) 和可让 Amazon Kinesis Analytics 代表您访问该流的 IAM 角色。类型：[KinesisStreamsInputDescription](API_KinesisStreamsInputDescription.md) 对象必需：否 ** NamePrefix ** 应用程序内部名称前缀。类型：字符串长度限制：长度下限为 1。最大长度为 32。必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputDescription) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputDescription) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputDescription) # InputLambdaProcessor 一个对象，其中包含用于预处理流中记录的 Lambda 函数的亚马逊资源名称 (ARN)，以及用于访问 [AWS L](https://docs.aws.amazon.com/lambda/) ambda 函数的 IAM 角色的 ARN。 AWS ## 内容 ** ResourceARN ** 用于处理流中记录的 [AWS Lambda](https://docs.aws.amazon.com/lambda/) 函数的 ARN。要指定相比最新版本较早的 Lambda 函数版本，请在 Lambda 函数 ARN 中包括 Lambda 函数版本。有关 Lambda 的更多信息 ARNs，请参阅[示例 ARNs](/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-lambda)：Lambda AWS 类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ** RoleARN ** 用于访问 Lambda 函数 AWS 的 IAM 角色的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputLambdaProcessor) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputLambdaProcessor) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputLambdaProcessor) # InputLambdaProcessorDescription 一个对象，其中包含用于预处理流中记录的 Lambda 函数的亚马逊资源名称 (ARN)，以及用于访问 [AWS L](https://docs.aws.amazon.com/lambda/) ambda 表达式的 IAM 角色的 ARN。 AWS ## 内容 ** ResourceARN ** 用于预处理流中记录的 [AWS Lambda](https://docs.aws.amazon.com/lambda/) 函数的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ** RoleARN ** 用于访问 Lambda 函数 AWS 的 IAM 角色的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputLambdaProcessorDescription) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputLambdaProcessorDescription) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputLambdaProcessorDescription) # InputLambdaProcessorUpdate [InputLambdaProcessor](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputLambdaProcessor.html)表示对用于预处理流中记录的更新。 ## 内容 ** ResourceARNUpdate ** 用于预处理流中记录的新 [AWS Lambda](https://docs.aws.amazon.com/lambda/) 函数的 Amazon 资源名称 (ARN)。要指定相比最新版本较早的 Lambda 函数版本，请在 Lambda 函数 ARN 中包括 Lambda 函数版本。有关 Lambda 的更多信息 ARNs，请参阅[示例 ARNs](/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-lambda)：Lambda AWS 类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ** RoleARNUpdate ** 用于访问 Lambda 函数 AWS 的新 IAM 角色的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputLambdaProcessorUpdate) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputLambdaProcessorUpdate) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputLambdaProcessorUpdate) # InputParallelism 描述要为指定流式源创建的应用程序内部流的数量。有关并行的信息，请参阅[配置应用程序输入](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)。 ## 内容 ** Count ** 要创建的应用程序内部流的数量。有关更多信息，请参阅[限制](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/limits.html)。类型：整数有效范围：最小值为 1。最大值为 64。必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputParallelism) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputParallelism) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputParallelism) # InputParallelismUpdate 提供并行度计数的更新。 ## 内容 ** CountUpdate ** 为指定流式传输源创建的应用程序内部流的数量。类型：整数有效范围：最小值为 1。最大值为 64。必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputParallelismUpdate) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputParallelismUpdate) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputParallelismUpdate) # InputProcessingConfiguration 提供处理器的描述，该处理器用于在您的应用程序代码处理流中记录之前预处理这些记录。目前，唯一可用的输入处理器为 [AWS Lambda](https://docs.aws.amazon.com/lambda/)。 ## 内容 ** InputLambdaProcessor ** [InputLambdaProcessor](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputLambdaProcessor.html) 用于在您的应用程序代码处理流中记录之前预处理这些记录。类型：[InputLambdaProcessor](API_InputLambdaProcessor.md) 对象必需：是 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputProcessingConfiguration) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputProcessingConfiguration) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputProcessingConfiguration) # InputProcessingConfigurationDescription 提供有关输入处理器的配置信息。目前，唯一可用的输入处理器为 [AWS Lambda](https://docs.aws.amazon.com/lambda/)。 ## 内容 ** InputLambdaProcessorDescription ** 提供有关关联的配置信息[InputLambdaProcessorDescription](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputLambdaProcessorDescription.html)。类型：[InputLambdaProcessorDescription](API_InputLambdaProcessorDescription.md) 对象必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputProcessingConfigurationDescription) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputProcessingConfigurationDescription) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputProcessingConfigurationDescription) # InputProcessingConfigurationUpdate 描述 [InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html) 的更新。 ## 内容 ** InputLambdaProcessorUpdate ** 提供 [InputLambdaProcessor](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputLambdaProcessor.html) 的更新信息。类型：[InputLambdaProcessorUpdate](API_InputLambdaProcessorUpdate.md) 对象必需：是 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputProcessingConfigurationUpdate) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputProcessingConfigurationUpdate) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputProcessingConfigurationUpdate) # InputSchemaUpdate 描述应用程序输入架构的更新。 ## 内容 ** RecordColumnUpdates ** `RecordColumn` 对象的列表。每个对象描述流式传输源元素到应用程序内部流中的相应列的映射。类型：[RecordColumn](API_RecordColumn.md) 对象数组数组成员：最少 1 个物品。最多 1000 项。必需：否 ** RecordEncodingUpdate ** 指定流式源中的记录的编码。例如，UTF-8。类型：字符串模式：`UTF-8` 必需：否 ** RecordFormatUpdate ** 指定流式源上的记录的格式。类型：[RecordFormat](API_RecordFormat.md) 对象必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputSchemaUpdate) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputSchemaUpdate) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputSchemaUpdate) # InputStartingPositionConfiguration 描述应用程序从流式传输源读取数据的时刻。 ## 内容 ** InputStartingPosition ** 流上的开始位置。 + `NOW` - 在流中最新的记录之后开始读取，从客户发出的请求时间戳开始。 + `TRIM_HORIZON` - 在流中最后一条未修剪的记录处开始读取，这是流中最早的记录。该选项不可用于 Amazon Kinesis Data Firehose 传输流。 + `LAST_STOPPED_POINT` - 从应用程序上次停止读取的位置继续读取。类型：字符串有效值：`NOW | TRIM_HORIZON | LAST_STOPPED_POINT` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputStartingPositionConfiguration) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputStartingPositionConfiguration) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputStartingPositionConfiguration) # InputUpdate 描述特定输入配置 (由应用程序 `InputId` 标识) 的更新。 ## 内容 ** InputId ** 要更新的应用程序输入的输入 ID。类型：字符串长度限制：长度下限为 1。最大长度为 50。模式：`[a-zA-Z0-9_.-]+` 必需：是 ** InputParallelismUpdate ** 描述并行度更新 (Amazon Kinesis Analytics 为特定流式传输源创建的应用程序内部流的数量)。类型：[InputParallelismUpdate](API_InputParallelismUpdate.md) 对象必需：否 ** InputProcessingConfigurationUpdate ** 描述输入处理配置的更新。类型：[InputProcessingConfigurationUpdate](API_InputProcessingConfigurationUpdate.md) 对象必需：否 ** InputSchemaUpdate ** 描述流式传输源中的数据格式，以及流式传输源上的每个记录元素映射到所创建应用程序内部流中相应列的方式。类型：[InputSchemaUpdate](API_InputSchemaUpdate.md) 对象必需：否 ** KinesisFirehoseInputUpdate ** 如果 Amazon Kinesis Firehose 传输流是要更新的流式传输源，则会提供更新的流 ARN 和 IAM 角色 ARN。类型：[KinesisFirehoseInputUpdate](API_KinesisFirehoseInputUpdate.md) 对象必需：否 ** KinesisStreamsInputUpdate ** 如果 Amazon Kinesis 流是要更新的流式传输源，则提供更新的流的 Amazon 资源名称 (ARN) 和 IAM 角色 ARN。类型：[KinesisStreamsInputUpdate](API_KinesisStreamsInputUpdate.md) 对象必需：否 ** NamePrefixUpdate ** Amazon Kinesis Analytics 为特定流式传输源创建的应用程序内部流的名称前缀。类型：字符串长度限制：长度下限为 1。最大长度为 32。必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/InputUpdate) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/InputUpdate) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/InputUpdate) # JSONMappingParameters 提供当 JSON 是流式源上的记录格式时的其他映射信息。 ## 内容 ** RecordRowPath ** 指向包含记录的顶层父级的路径。类型：字符串长度限制：长度下限为 1。必需：是 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/JSONMappingParameters) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/JSONMappingParameters) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/JSONMappingParameters) # KinesisFirehoseInput 将 Amazon Kinesis Firehose 传输流标识为流式源。您提供传输流的 Amazon 资源名称（ARN）和可让 Amazon Kinesis Analytics 代表您访问该流的 IAM 角色 ARN。 ## 内容 ** ResourceARN ** 输入传输流的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ** RoleARN ** 可由 Amazon Kinesis Analytics 代入以代表您访问流的 IAM 角色的 ARN。您需要确保该角色有必要的权限以访问流。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisFirehoseInput) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisFirehoseInput) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisFirehoseInput) # KinesisFirehoseInputDescription 描述在应用程序输入配置中配置为流式传输源的 Amazon Kinesis Firehose 传输流。 ## 内容 ** ResourceARN ** Amazon Kinesis Firehose 传输流的 Amazon 资源名称 (ARN)。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ** RoleARN ** 可由 Amazon Kinesis Analytics 代入以访问流的 IAM 角色的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisFirehoseInputDescription) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisFirehoseInputDescription) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisFirehoseInputDescription) # KinesisFirehoseInputUpdate 更新应用程序输入配置时，提供有关 Amazon Kinesis Firehose 传输流作为流式传输源的信息。 ## 内容 ** ResourceARNUpdate ** 要读取的输入 Amazon Kinesis Firehose 传输流的 Amazon 资源名称 (ARN)。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ** RoleARNUpdate ** 可由 Amazon Kinesis Analytics 代入以代表您访问流的 IAM 角色的 ARN。您需要向此角色授予必需的权限。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisFirehoseInputUpdate) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisFirehoseInputUpdate) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisFirehoseInputUpdate) # KinesisFirehoseOutput 配置应用程序输出时，将 Amazon Kinesis Firehose 传输流标识为目标。您提供流的 Amazon 资源名称（ARN）和可让 Amazon Kinesis Analytics 代表您写入流的 IAM 角色。 ## 内容 ** ResourceARN ** 要写入的目标 Amazon Kinesis Firehose 传输流的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ** RoleARN ** 可由 Amazon Kinesis Analytics 代入以代表您对目标流进行写入的 IAM 角色的 ARN。您需要向此角色授予必需的权限。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisFirehoseOutput) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisFirehoseOutput) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisFirehoseOutput) # KinesisFirehoseOutputDescription 对于应用程序输出，将 Amazon Kinesis Firehose 传输流标识为其目标。 ## 内容 ** ResourceARN ** Amazon Kinesis Firehose 传输流的 Amazon 资源名称 (ARN)。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ** RoleARN ** 可由 Amazon Kinesis Analytics 代入以访问流的 IAM 角色的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisFirehoseOutputDescription) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisFirehoseOutputDescription) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisFirehoseOutputDescription) # KinesisFirehoseOutputUpdate 使用[UpdateApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_UpdateApplication.html)操作更新输出配置时，提供有关配置为目标的 Amazon Kinesis Firehose 传输流的信息。 ## 内容 ** ResourceARNUpdate ** 要写入的 Amazon Kinesis Firehose 传输流的 Amazon 资源名称 (ARN)。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ** RoleARNUpdate ** 可由 Amazon Kinesis Analytics 代入以代表您访问流的 IAM 角色的 ARN。您需要向此角色授予必需的权限。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisFirehoseOutputUpdate) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisFirehoseOutputUpdate) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisFirehoseOutputUpdate) # KinesisStreamsInput 将 Amazon Kinesis 流标识为流式源。您提供流的 Amazon 资源名称（ARN）和可让 Amazon Kinesis Analytics 代表您访问该流的 IAM 角色 ARN。 ## 内容 ** ResourceARN ** 要读取的输入 Amazon Kinesis 流的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ** RoleARN ** 可由 Amazon Kinesis Analytics 代入以代表您访问流的 IAM 角色的 ARN。您需要向此角色授予必需的权限。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisStreamsInput) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisStreamsInput) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisStreamsInput) # KinesisStreamsInputDescription 描述在应用程序输入配置中配置为流式传输源的 Amazon Kinesis 流。 ## 内容 ** ResourceARN ** Amazon Kinesis 流的 Amazon 资源名称（ARN）。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ** RoleARN ** 可由 Amazon Kinesis Analytics 代入以访问流的 IAM 角色的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisStreamsInputDescription) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisStreamsInputDescription) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisStreamsInputDescription) # KinesisStreamsInputUpdate 更新应用程序输入配置时，提供有关 Amazon Kinesis 流作为流式传输源的信息。 ## 内容 ** ResourceARNUpdate ** 要读取的输入 Amazon Kinesis 流的 Amazon 资源名称 (ARN)。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ** RoleARNUpdate ** 可由 Amazon Kinesis Analytics 代入以代表您访问流的 IAM 角色的 ARN。您需要向此角色授予必需的权限。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisStreamsInputUpdate) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisStreamsInputUpdate) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisStreamsInputUpdate) # KinesisStreamsOutput 在配置应用程序输出时，将 Amazon Kinesis 流标识为目标。您提供流的 Amazon 资源名称（ARN），以及用于让 Amazon Kinesis Analytics 代表您写入流的 IAM 角色 ARN。 ## 内容 ** ResourceARN ** 要写入的目标 Amazon Kinesis 流的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ** RoleARN ** 可由 Amazon Kinesis Analytics 代入以代表您对目标流进行写入的 IAM 角色的 ARN。您需要向此角色授予必需的权限。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisStreamsOutput) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisStreamsOutput) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisStreamsOutput) # KinesisStreamsOutputDescription 描述了配置为应用程序输出目标的 Amazon Kinesis 流。 ## 内容 ** ResourceARN ** Amazon Kinesis 流的 Amazon 资源名称（ARN）。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ** RoleARN ** 可由 Amazon Kinesis Analytics 代入以访问流的 IAM 角色的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisStreamsOutputDescription) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisStreamsOutputDescription) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisStreamsOutputDescription) # KinesisStreamsOutputUpdate 使用[UpdateApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_UpdateApplication.html)操作更新输出配置时，提供有关配置为目标的 Amazon Kinesis 流的信息。 ## 内容 ** ResourceARNUpdate ** 您在其中写入输出的 Amazon Kinesis 流的 Amazon 资源名称（ARN）。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ** RoleARNUpdate ** 可由 Amazon Kinesis Analytics 代入以代表您访问流的 IAM 角色的 ARN。您需要向此角色授予必需的权限。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/KinesisStreamsOutputUpdate) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/KinesisStreamsOutputUpdate) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/KinesisStreamsOutputUpdate) # LambdaOutput 配置应用程序输出时，将 AWS Lambda 函数标识为目标。您提供函数的 Amazon 资源名称（ARN），以及用于让 Amazon Kinesis Analytics 代表您写入函数的 IAM 角色 ARN。 ## 内容 ** ResourceARN ** 要向其写入的目标 Lambda 函数的 Amazon 资源名称（ARN）。要指定相比最新版本较早的 Lambda 函数版本，请在 Lambda 函数 ARN 中包括 Lambda 函数版本。有关 Lambda 的更多信息 ARNs，请参阅[示例 ARNs](/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-lambda)：Lambda AWS 类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ** RoleARN ** 可由 Amazon Kinesis Analytics 代入以代表您对目标函数进行写入的 IAM 角色的 ARN。您需要向此角色授予必需的权限。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/LambdaOutput) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/LambdaOutput) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/LambdaOutput) # LambdaOutputDescription 对于应用程序输出，描述了配置为其目标的 AWS Lambda 函数。 ## 内容 ** ResourceARN ** 目标 Lambda 函数的 Amazon 资源名称 (ARN)。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ** RoleARN ** 可由 Amazon Kinesis Analytics 代入以对目标函数进行写入的 IAM 角色的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/LambdaOutputDescription) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/LambdaOutputDescription) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/LambdaOutputDescription) # LambdaOutputUpdate 使用[UpdateApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_UpdateApplication.html)操作更新输出配置时，提供有关配置为目标的 AWS Lambda 函数的信息。 ## 内容 ** ResourceARNUpdate ** 目标 Lambda 函数的 Amazon 资源名称 (ARN)。要指定相比最新版本较早的 Lambda 函数版本，请在 Lambda 函数 ARN 中包括 Lambda 函数版本。有关 Lambda 的更多信息 ARNs，请参阅[示例 ARNs](/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-lambda)：Lambda AWS 类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ** RoleARNUpdate ** 可由 Amazon Kinesis Analytics 代入以代表您对目标函数进行写入的 IAM 角色的 ARN。您需要向此角色授予必需的权限。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/LambdaOutputUpdate) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/LambdaOutputUpdate) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/LambdaOutputUpdate) # MappingParameters 如果在创建或更新应用程序时配置应用程序输入，请提供特定于流式源上的记录格式（如 JSON、CSV 或由某个分隔符分隔的记录字段）的其他映射信息。 ## 内容 ** CSVMappingParameters ** 提供当记录格式使用带分隔符的格式（如 CSV）时的其他映射信息。类型：[CSVMappingParameters](API_CSVMappingParameters.md) 对象必需：否 ** JSONMappingParameters ** 提供当 JSON 是流式源上的记录格式时的其他映射信息。类型：[JSONMappingParameters](API_JSONMappingParameters.md) 对象必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/MappingParameters) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/MappingParameters) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/MappingParameters) # Output 描述应用程序输出配置，在其中您标识应用程序内部流以及希望应用程序内部流数据写入到的目标。目标可以是 Amazon Kinesis 流或 Amazon Kinesis Firehose 传输流。有关应用程序可以写入的目标数的限制以及其他限制，请参阅[限制](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/limits.html)。 ## 内容 ** DestinationSchema ** 描述将记录写入目标时的数据格式。有关更多信息，请参阅[配置应用程序输出](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-output.html)。类型：[DestinationSchema](API_DestinationSchema.md) 对象必需：是 ** Name ** 应用程序内部流的名称。类型：字符串长度限制：长度下限为 1。最大长度为 32。必需：是 ** KinesisFirehoseOutput ** 将 Amazon Kinesis Firehose 传输流标识为目标。类型：[KinesisFirehoseOutput](API_KinesisFirehoseOutput.md) 对象必需：否 ** KinesisStreamsOutput ** 将 Amazon Kinesis 流标识为目标。类型：[KinesisStreamsOutput](API_KinesisStreamsOutput.md) 对象必需：否 ** LambdaOutput ** 将 L AWS ambda 函数标识为目标。类型：[LambdaOutput](API_LambdaOutput.md) 对象必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/Output) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/Output) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/Output) # OutputDescription 描述应用程序输出配置，其中包括应用程序内部流名称和写入流数据的目标。目标可以是 Amazon Kinesis 流或 Amazon Kinesis Firehose 传输流。 ## 内容 ** DestinationSchema ** 用于将数据写入目标的数据格式。类型：[DestinationSchema](API_DestinationSchema.md) 对象必需：否 ** KinesisFirehoseOutputDescription ** 描述配置为输出写入目标的 Amazon Kinesis Firehose 传输流。类型：[KinesisFirehoseOutputDescription](API_KinesisFirehoseOutputDescription.md) 对象必需：否 ** KinesisStreamsOutputDescription ** 描述配置为输出写入目标的 Amazon Kinesis 流。类型：[KinesisStreamsOutputDescription](API_KinesisStreamsOutputDescription.md) 对象必需：否 ** LambdaOutputDescription ** 描述配置为输出写入目标的 AWS Lambda 函数。类型：[LambdaOutputDescription](API_LambdaOutputDescription.md) 对象必需：否 ** Name ** 配置为输出的应用程序内部流的名称。类型：字符串长度限制：长度下限为 1。最大长度为 32。必需：否 ** OutputId ** 输出配置的唯一标识符。类型：字符串长度限制：长度下限为 1。最大长度为 50。模式：`[a-zA-Z0-9_.-]+` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/OutputDescription) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/OutputDescription) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/OutputDescription) # OutputUpdate 描述 `OutputId` 标识的输出配置的更新。 ## 内容 ** OutputId ** 标识要更新的特定输出配置。类型：字符串长度限制：长度下限为 1。最大长度为 50。模式：`[a-zA-Z0-9_.-]+` 必需：是 ** DestinationSchemaUpdate ** 描述将记录写入目标时的数据格式。有关更多信息，请参阅[配置应用程序输出](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-output.html)。类型：[DestinationSchema](API_DestinationSchema.md) 对象必需：否 ** KinesisFirehoseOutputUpdate ** 描述作为输出目标的 Amazon Kinesis Firehose 传输流类型：[KinesisFirehoseOutputUpdate](API_KinesisFirehoseOutputUpdate.md) 对象必需：否 ** KinesisStreamsOutputUpdate ** 描述作为输出目标的 Amazon Kinesis 流。类型：[KinesisStreamsOutputUpdate](API_KinesisStreamsOutputUpdate.md) 对象必需：否 ** LambdaOutputUpdate ** 将 L AWS ambda 函数描述为输出的目的地。类型：[LambdaOutputUpdate](API_LambdaOutputUpdate.md) 对象必需：否 ** NameUpdate ** 如果要为此输出配置指定不同的应用程序内部流，请使用此字段指定新的应用程序内部流名称。类型：字符串长度限制：长度下限为 1。最大长度为 32。必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/OutputUpdate) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/OutputUpdate) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/OutputUpdate) # RecordColumn 描述流式源中的每个数据元素到应用程序内部流中的相应列的映射。还用于描述引用数据来源的格式。 ## 内容 ** Name ** 在应用程序内部输入流或引用表中创建的列的名称。类型：字符串必需：是 ** SqlType ** 在应用程序内部输入流或引用表中创建的列的类型。类型：字符串长度限制：长度下限为 1。必需：是 ** Mapping ** 对流输入中数据元素的引用，或者引用数据来源。如果是，则此元素[RecordFormatType](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_RecordFormat.html#analytics-Type-RecordFormat-RecordFormatTypel)为必填项`JSON`。类型：字符串必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/RecordColumn) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/RecordColumn) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/RecordColumn) # RecordFormat 描述应该应用的记录格式和相关映射信息，以便在流中架构化记录。 ## 内容 ** RecordFormatType ** 记录格式的类型。类型：字符串有效值：`JSON | CSV` 必需：是 ** MappingParameters ** 如果在创建或更新应用程序时配置应用程序输入，请提供特定于流式源上的记录格式（如 JSON、CSV 或由某个分隔符分隔的记录字段）的其他映射信息。类型：[MappingParameters](API_MappingParameters.md) 对象必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/RecordFormat) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/RecordFormat) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/RecordFormat) # ReferenceDataSource 描述引用数据来源，方式是提供源信息（S3 桶名称和对象键名称）、创建的结果应用程序内部表名称以及要将 Amazon S3 对象中的对象素映射到应用程序内部表的所需架构。 ## 内容 ** ReferenceSchema ** 描述流式源中的数据的格式，以及每个数据元素如何映射到在应用程序内部流中创建的相应列。类型：[SourceSchema](API_SourceSchema.md) 对象必需：是 ** TableName ** 要创建的应用程序内部表的名称。类型：字符串长度限制：长度下限为 1。最大长度为 32。必需：是 ** S3ReferenceDataSource ** 标识 S3 桶和包含引用数据的对象。此外，还标识可由 Amazon Kinesis Analytics 代入以代表您读取此对象的 IAM 角色。Amazon Kinesis Analytics 应用程序仅加载一次引用数据。如果数据更改，您可以调用 `UpdateApplication` 操作来触发将数据重新加载到应用程序。类型：[S3ReferenceDataSource](API_S3ReferenceDataSource.md) 对象必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/ReferenceDataSource) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/ReferenceDataSource) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/ReferenceDataSource) # ReferenceDataSourceDescription 描述为应用程序配置的引用数据来源。 ## 内容 ** ReferenceId ** 引用数据源的 ID。这是 Amazon Kinesis Analytics 在您使用[AddApplicationReferenceDataSource](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_AddApplicationReferenceDataSource.html)该操作向应用程序添加参考数据源时分配的 ID。类型：字符串长度限制：长度下限为 1。最大长度为 50。模式：`[a-zA-Z0-9_.-]+` 必需：是 ** S3ReferenceDataSourceDescription ** 提供 S3 存储桶名称，即包含引用数据的对象键名称。它还提供了 IAM 角色的 Amazon 资源名称 (ARN)，Amazon Kinesis Analytics 可担任此角色读取 Amazon S3 对象以及填充应用程序内部引用表。类型：[S3ReferenceDataSourceDescription](API_S3ReferenceDataSourceDescription.md) 对象必需：是 ** TableName ** 由特定引用数据来源配置创建的应用程序内部表名称。类型：字符串长度限制：长度下限为 1。最大长度为 32。必需：是 ** ReferenceSchema ** 描述流式源中的数据的格式，以及每个数据元素如何映射到在应用程序内部流中创建的相应列。类型：[SourceSchema](API_SourceSchema.md) 对象必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/ReferenceDataSourceDescription) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/ReferenceDataSourceDescription) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/ReferenceDataSourceDescription) # ReferenceDataSourceUpdate 更新应用程序的引用数据来源配置时，此对象会提供所有更新的值 (例如源存储桶名称和对象键名称)、创建的应用程序内部表名称，以及要将 Amazon S3 对象中的数据映射到所创建应用程序内部引用表的更新映射信息。 ## 内容 ** ReferenceId ** 正在更新的引用数据来源的 ID。要获取此值，您可以使用 [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) 命令。类型：字符串长度限制：长度下限为 1。最大长度为 50。模式：`[a-zA-Z0-9_.-]+` 必需：是 ** ReferenceSchemaUpdate ** 描述流式源中的数据的格式，以及每个数据元素如何映射到在应用程序内部流中创建的相应列。类型：[SourceSchema](API_SourceSchema.md) 对象必需：否 ** S3ReferenceDataSourceUpdate ** 描述 S3 存储桶名称、对象键名称和 IAM 角色，Amazon Kinesis Analytics 可以担任此角色以代表您读取 Amazon S3 对象并填充应用程序内部引用表。类型：[S3ReferenceDataSourceUpdate](API_S3ReferenceDataSourceUpdate.md) 对象必需：否 ** TableNameUpdate ** 此更新创建的应用程序内部表名称。类型：字符串长度限制：长度下限为 1。最大长度为 32。必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/ReferenceDataSourceUpdate) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/ReferenceDataSourceUpdate) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/ReferenceDataSourceUpdate) # S3Configuration 提供 Amazon S3 数据源的描述，包括 S3 桶的 Amazon 资源名称 (ARN)、用于访问存储桶的 IAM 角色的 ARN 以及包含数据的 Amazon S3 对象的名称。 ## 内容 ** BucketARN ** 包含数据的 S3 存储桶的 ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ** FileKey ** 包含数据的对象的名称。类型：字符串长度限制：长度下限为 1。最大长度为 1024。必需：是 ** RoleARN ** 用于访问数据的角色的 IAM ARN。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/S3Configuration) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/S3Configuration) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/S3Configuration) # S3ReferenceDataSource 标识 S3 桶和包含引用数据的对象。此外，还标识可由 Amazon Kinesis Analytics 代入以代表您读取此对象的 IAM 角色。 Amazon Kinesis Analytics 应用程序仅加载一次引用数据。如果数据更改，您可以调用 [UpdateApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_UpdateApplication.html) 操作来触发将数据重新加载到应用程序。 ## 内容 ** BucketARN ** S3 桶的 Amazon 资源名称 (ARN)。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ** FileKey ** 包含引用数据的对象键名称。类型：字符串长度限制：长度下限为 1。最大长度为 1024。必需：是 ** ReferenceRoleARN ** 可由此服务代入以代表您读取数据的 IAM 角色的 ARN。此角色必须具有对象上的 `s3:GetObject` 操作权限以及允许 Amazon Kinesis Analytics 服务委托人代入此角色的信任策略。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/S3ReferenceDataSource) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/S3ReferenceDataSource) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/S3ReferenceDataSource) # S3ReferenceDataSourceDescription 提供存储桶名称，以及存储引用数据的对象键名称。 ## 内容 ** BucketARN ** S3 桶的 Amazon 资源名称 (ARN)。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ** FileKey ** Amazon S3 对象键名称类型：字符串长度限制：长度下限为 1。最大长度为 1024。必需：是 ** ReferenceRoleARN ** IAM 角色的 ARN，Amazon Kinesis Analytics 可以担任此角色以代表您读取 Amazon S3 对象并填充应用程序内部引用表。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：是 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/S3ReferenceDataSourceDescription) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/S3ReferenceDataSourceDescription) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/S3ReferenceDataSourceDescription) # S3ReferenceDataSourceUpdate 描述 S3 存储桶名称、对象键名称和 IAM 角色，Amazon Kinesis Analytics 可以担任此角色以代表您读取 Amazon S3 对象并填充应用程序内部引用表。 ## 内容 ** BucketARNUpdate ** S3 桶的 Amazon 资源名称 (ARN)。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ** FileKeyUpdate ** 对象键名称。类型：字符串长度限制：长度下限为 1。最大长度为 1024。必需：否 ** ReferenceRoleARNUpdate ** IAM 角色的 ARN，Amazon Kinesis Analytics 可以担任此角色读取 Amazon S3 对象并填充应用程序内部。类型：字符串长度限制：最小长度为 0。最大长度为 2048。模式：`arn:.*` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/S3ReferenceDataSourceUpdate) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/S3ReferenceDataSourceUpdate) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/S3ReferenceDataSourceUpdate) # SourceSchema 描述流式源中的数据的格式，以及每个数据元素如何映射到在应用程序内部流中创建的相应列。 ## 内容 ** RecordColumns ** `RecordColumn` 对象的列表。类型：[RecordColumn](API_RecordColumn.md) 对象数组数组成员：最少 1 个物品。最多 1000 项。必需：是 ** RecordFormat ** 指定流式源上的记录的格式。类型：[RecordFormat](API_RecordFormat.md) 对象必需：是 ** RecordEncoding ** 指定流式源中的记录的编码。例如，UTF-8。类型：字符串模式：`UTF-8` 必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/SourceSchema) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/SourceSchema) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/SourceSchema) # Tag 您可以定义并分配给资源的键值对（该值是可选的）。 AWS 如果您指定的标签已经存在，则标签值将替换为您在请求中指定的值。请注意，应用程序标签的最大数量包括系统标签。用户定义的应用程序标签的最大数量为 50。有关更多信息，请参阅[使用标签](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-tagging.html)。 ## 内容 ** Key ** 键值标签的键。类型：字符串长度限制：长度下限为 1。最大长度为 128。必需：是 ** Value ** 键值标签的值。值是可选的。类型：字符串长度约束：最小长度为 0。长度上限为 256。必需：否 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/Tag) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/Tag) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/Tag)