UpdateApplication - Amazon Kinesis Data Analytics 开发人员指南
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

UpdateApplication

注意

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

更新现有 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

要更新的 Amazon Kinesis Analytics 应用程序的名称。

类型: 字符串

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

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

:必需 是

应用程序更新

介绍应用程序更新。

类型:ApplicationUpdate 对象

:必需 是

当前应用程序版本 ID

当前应用程序版本 ID。您可以使用DescribeApplication操作,获取此值。

类型: 长整型

有效范围 最小值为 1。最大值为 9999999。

:必需 是

响应元素

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

Errors

代码验证异常

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

HTTP 状态代码:HTTP 状态代 400

ConcurrentModificationException

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

HTTP 状态代码:HTTP 状态代 400

InvalidArgumentException

指定的输入参数值无效。

HTTP 状态代码:400

ResourceInUseException

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

HTTP 状态代码:400

ResourceNotFoundException

找不到指定的应用程序。

HTTP 状态代码:400

UnsupportedOperationException

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

HTTP 状态代码:400

另请参阅

有关在特定语言的语言的特定语言中使用此 API 的更多信息Amazon开发工具包: