AddApplicationVpcConfiguration - Amazon Managed Servics for Apache Flink(前身为 Amazon Kinesis Data Analytics for Apache Flink)

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

AddApplicationVpcConfiguration

向应用程序添加虚拟私有云(VPC)配置。应用程序可以使用 VPC 来安全地存储和访问资源。

请注意以下有关 Apache Flink 托管服务应用程序的 VPC 配置:

  • SQL 应用程序不支持 VPC 配置。

  • 将 VPC 添加到 Apache Flink 托管服务应用程序后,将无法再直接从互联网访问该应用程序。要允许应用程序访问互联网,请将互联网网关添加到您的 VPC。

请求语法

{ "ApplicationName": "string", "ConditionalToken": "string", "CurrentApplicationVersionId": number, "VpcConfiguration": { "SecurityGroupIds": [ "string" ], "SubnetIds": [ "string" ] } }

请求参数

请求接受采用 JSON 格式的以下数据。

ApplicationName

现有应用程序的名称。

类型:字符串

长度限制:长度下限为 1。长度上限为 128。

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

必需:是

ConditionalToken

用于实现应用程序更新强并发性的值。您必须提供 ApplicationVersionIDConditionalToken。使用 DescribeApplication 获得应用程序的当前 ConditionalToken。要获得更理想的并发支持,请使用 ConditionalToken 参数代替 CurrentApplicationVersionId

类型:字符串

长度限制:长度下限为 1。最大长度为 512。

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

必需:否

CurrentApplicationVersionId

要向其添加 VPC 配置的应用程序的版本。您必须提供 CurrentApplicationVersionIdConditionalToken。您可以使用 DescribeApplication 操作来获取当前的应用程序版本。如果指定的版本不是当前版本,则返回 ConcurrentModificationException。要获得更理想的并发支持,请使用 ConditionalToken 参数代替 CurrentApplicationVersionId

类型:长整型

有效范围:最小值为 1。最大值为 999999999。

必需:否

VpcConfiguration

要添加到应用程序的 VPC 的描述。

类型:VpcConfiguration 对象

必需:是

响应语法

{ "ApplicationARN": "string", "ApplicationVersionId": number, "OperationId": "string", "VpcConfigurationDescription": { "SecurityGroupIds": [ "string" ], "SubnetIds": [ "string" ], "VpcConfigurationId": "string", "VpcId": "string" } }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

ApplicationARN

应用程序的 ARN。

类型:字符串

长度限制:最小长度为 0。最大长度为 2048。

模式:arn:.*

ApplicationVersionId

提供当前应用程序版本。 ApplicationVersionId 每次更新应用程序时,适用于 Apache Flink 的托管服务都会更新。

类型:长整型

有效范围:最小值为 1。最大值为 999999999。

OperationId

可用于跟踪请求的操作 ID。

类型:字符串

长度限制:长度下限为 1。长度上限为 64。

VpcConfigurationDescription

新 VPC 配置的参数。

类型:VpcConfigurationDescription 对象

错误

ConcurrentModificationException

由于对应用程序进行并发修改而引发的异常。此错误可能是由于在未使用当前应用程序 ID 的情况下尝试修改应用程序所致。

HTTP 状态代码:400

InvalidApplicationConfigurationException

用户提供的应用程序配置无效。

HTTP 状态代码:400

InvalidArgumentException

指定的输入参数值无效。

HTTP 状态代码:400

ResourceInUseException

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

HTTP 状态代码:400

ResourceNotFoundException

无法找到指定的应用程序。

HTTP 状态代码:400

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: