AddApplicationInput - SQL 应用程序 Amazon Kinesis Data Analytics 开发人员指南
请求语法请求参数响应元素错误另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

AddApplicationInput

注意

本文档适用于 Amazon Kinesis Data Analytics API 版本 1，该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息，请参阅 Amazon Kinesis Data Analytics API V2 文档。

将流式传输源添加到您的 Amazon Kinesis 应用程序。有关概念信息，请参阅配置应用程序输入。

您可以在创建应用程序时添加流媒体源，也可以在创建应用程序后使用此操作添加流媒体源。有关更多信息，请参阅 。CreateApplication.

任何配置更新（包括使用此操作添加流式传输源）都会生成新版本的应用程序。您可以使用 DescribeApplication 操作来找到当前应用程序版本。

此操作需要执行 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

要将流式传输源添加到的现有 Amazon Kinesis Analytics 应用程序的名称。

类型: 字符串

长度约束：最小长度为 1。长度上限为 128。

模式：[a-zA-Z0-9_.-]+

：必需 是

CurrentApplicationVersionId

Amazon Kinesis Analytics 应用程序的最新版本。您可以使用 DescribeApplication 操作来找到当前应用程序版本。

类型: 长整型

有效范围：最小值为 1。最大值为 9999。

：必需 是

Input

这些区域有：输入将添加到。

类型：Input 对象

：必需 是

响应元素

如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。

错误

CodeValidationException

用户提供的应用程序代码（查询）无效。这可能是一个简单的语法错误。

HTTP 状态代码：400

ConcurrentModificationException

由于并发修改应用程序而引发的异常。例如，两个人试图同时编辑同一应用程序。

HTTP 状态代码：400

InvalidArgumentException

指定的输入参数值无效。

HTTP 状态代码：400

ResourceInUseException

应用程序不可用于此操作。

HTTP 状态代码：400

ResourceNotFoundException

找不到指定的应用程序。

HTTP 状态代码：400

UnsupportedOperationException

请求被拒绝，原因是不支持指定的参数，或者指定的资源对此操作无效。

HTTP 状态代码：400

另请参阅

有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息，请参阅以下内容：