经过仔细考虑，我们决定停用适用于 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)。 本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 操作 支持以下操作： + [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)